项目知识地图
由 Markdown 元数据生成。不要手工编辑;在仓库根目录运行
node docs/.vitepress/scripts/knowledge.mjs generate。
docs/ 是 AGENTS.md 的按需知识扩展。已知主题时直接读取正文和必要源码;归属不清时使用下面的地图或离线检索。
离线检索:node docs/.vitepress/scripts/knowledge.mjs search "问题或代码符号";反向映射:node docs/.vitepress/scripts/knowledge.mjs impact "仓库相对路径"。
共 207 个主题;默认 CLI 搜索只返回 current,使用 --all 明确包含规划与历史。
按源码根与模块定位
分组由主题的 code_paths 和真实目录派生;同一主题可关联多个模块,各组数量不能相加。关联不等于完整调用图;仅引用源码根的概览不会扩散到每个子模块。
| 源码根 | 目录分组 | 关联主题 |
|---|---|---|
| ColorVision | 15 | 60 |
| UI | 14 | 122 |
| Engine | 6 | 100 |
| Native | 4 | 14 |
| Plugins | 6 | 16 |
| Projects | 5 | 15 |
| Web | 3 | 20 |
| Scripts | 2 | 17 |
| AndroidWebViewApp | 2 | 1 |
| Drivers | 1 | 1 |
| packages | 1 | 1 |
| SDK | 2 | 1 |
| src | 3 | 7 |
| 仓库与知识基础设施 | 4 | 21 |
按能力领域补充检索
跨源码模块的问题仍可从能力领域进入;这不是另一套按读者身份编排的手册。
- AI 共治与知识维护 — 4 个主题;工作边界、知识维护、文档与源码冲突、检索验收。
- 平台与架构 — 14 个主题;宿主架构、模块责任、扩展分流与权限边界。
- UI 与图像交互 — 38 个主题;属性编辑器、窗口组件、图像交互和绘制扩展。
- 设备、服务与结果 — 20 个主题;设备服务、MQTT、模板宿主和结果展示。
- 流程编排与执行 — 11 个主题;流程编辑、节点运行、参数传递与完成语义。
- 算法与模板 — 39 个主题;算法平台、传统模板、计算适配和规划中的能力。
- Copilot — 11 个主题;Agent会话、工具契约、上下文、恢复和MCP边界。
- 客户项目 — 11 个主题;客户包、业务流程、协议对接与结果留存。
- 插件与扩展 — 12 个主题;插件发现、生命周期、已有插件和集成边界。
- 构建与交付 — 30 个主题;构建环境、交付契约、发布脚本和更新。
- 运行与现场排查 — 17 个主题;安装使用、设备配置、现场故障、日志和数据管理。
