GriddyCode 开发者指南

GriddyCode 是一款支持高度自定义的代码编辑工具，通过模块化设计实现语法高亮、主题定制和命令行交互等核心功能。本文将从功能模块角度介绍其核心架构与使用方法，帮助开发者快速掌握配置与扩展技巧。

核心功能入口：命令行启动机制

gcode 可执行文件是 GriddyCode 的核心启动入口，位于项目根目录下的 cli/ 目录。通过该工具可直接唤起编辑器并加载目标文件或目录，支持通过命令行参数快速定位工作区。

→ 启动命令示例（需提前将 cli/gcode 添加至系统 PATH）：

gcode [文件路径或目录路径]

该命令会初始化编辑器环境并加载指定资源，未指定路径时默认打开空工作区。

定制化引擎：配置系统架构

GriddyCode 的定制能力通过 AppData 配置目录实现，包含语法高亮规则与主题样式两大核心模块，均采用 Lua 脚本作为配置载体。

→ 语法高亮配置
路径：AppData/langs/
该目录下的 Lua 文件定义不同编程语言的语法规则，例如 toml.lua 用于 TOML 文件的关键字识别与高亮映射。配置示例：

-- 为常量定义应用 "reserved" 样式
highlight("const", "reserved")

→ 主题样式配置
路径：AppData/themes/
主题文件通过 Lua 表结构定义界面元素颜色，例如创建 dracula.lua 实现深色主题：

local theme = {
    background = "#282a36",  -- 背景色
    foreground = "#f8f8f2",  -- 文本色
    -- 其他元素颜色配置...
}
return theme

项目资源地图：核心目录解析

GriddyCode 采用扁平化目录结构组织核心资源，关键路径功能如下：

• src/：存放项目核心源代码，包含编辑器渲染、事件处理等基础功能实现。
• docs/：技术文档目录，包含 API 说明与扩展开发指南。
• .gitignore：版本控制忽略规则文件，排除临时文件与环境配置。
• README.md：项目概述文档，包含快速启动与基础功能说明。

扩展开发：插件与工具链

项目支持通过 Lua 脚本扩展功能，plugins/ 目录下可放置自定义插件。例如通过编写语法分析插件扩展语言支持，或开发主题切换工具增强用户体验。工具链配置文件 Cargo.toml 位于 Tools/ 目录，用于管理 Rust 编写的辅助工具编译依赖。

→ 插件开发流程：

1. 在 plugins/ 创建功能目录
2. 编写 Lua 扩展脚本实现核心逻辑
3. 通过 require 语句在主程序中加载插件

通过以上模块的灵活组合，开发者可构建符合个人习惯的代码编辑环境，同时支持通过社区贡献扩展工具生态。