提交

AGENTS.md

@@ -181,6 +181,27 @@ pnpm clean:dev                # strip demo data for fresh start
 - **Color tokens** (web-admin): Primary `#10b981`, dark `#059669`, bg `#ecfdf5`. Fresh Mint palette. **Do NOT use miniprogram colors in web-admin.**
 - **Tree display**: dropdown shows node name; selected/input/table shows full path (spaced slash separator).
 
+## Knowledge Graph (代码知识图谱)
+
+项目已生成代码知识图谱，用于理解模块间依赖关系、追踪修改影响范围。
+
+### 图谱位置
+
+| 项目 | 报告 | 可视化 | 数据 |
+|------|------|--------|------|
+| 后端 | `backend/graphify-out/GRAPH_REPORT.md` | `backend/graphify-out/graph.html` | `backend/graphify-out/graph.json` |
+| 前端 | `web-admin/graphify-out/GRAPH_REPORT.md` | `web-admin/graphify-out/graph.html` | `web-admin/graphify-out/graph.json` |
+
+### 使用方式
+
+- **浏览器**：直接打开 `*/graphify-out/graph.html` 查看交互式图谱
+- **AI Agent 查询**：已配置 MCP 服务（graphify），可通过工具调用查询图谱
+- **手动更新**：`./scripts/update-graph.sh [backend|frontend|all]`
+
+### Agent 更新规则
+
+完成代码修改后（新建文件、修改函数签名、新增/删除 import、重构模块），Agent SHALL 执行 `./scripts/update-graph.sh` 增量更新图谱，确保图谱与代码保持同步。如果只修改了单个项目（backend 或 web-admin），只需更新对应项目即可。
+
 ## Important Constraints
 
 - **Language**: User communication in Chinese (简体中文) when user writes in Chinese.