代码库知识图谱GongYuanCaiJi/dsh-understand-anything

🧠 dsh-understand-anything

简体中文 | English

License
DSH
上游

一句话：让 AI 先看懂整个代码库，再回答你的问题——生成知识图谱，聊代码、查影响、做架构分析、生成新手上手指南。

移植自 Egonex-AI/Understand-Anything（MIT），
skills / agent 层逐字保留，只适配 DeepSeek Harness 的插件机制。

✨ 功能

- 🕸️ 交互式知识图谱 —— 扫描代码库，产出 knowledge-graph.json（架构、依赖、调用关系、复杂度）
- 💬 /understand-chat 聊天问答 —— 基于图谱回答代码库问题，不把整个文件塞进上下文
- 🔍 /understand-diff 改动影响分析 —— 当前改动影响了哪些组件、有哪些风险
- 🧭 /understand-onboard 新手上手指南 —— 为新人生成项目导读
- 🏛️ /understand-domain 业务领域提取 —— 从代码中识别业务领域、流程与步骤
- 📚 /understand-knowledge 知识库分析 —— 分析 Karpathy 模式的 LLM wiki 知识库
- 🎨 /understand-figma 设计稿分析 —— 通过 Figma API 生成设计知识图谱
- 🌐 多语言 —— --language zh 生成中文摘要、标签与说明

📸 效果

在一个中型仓库里：

/understand

[Phase 1/7] Scanning project...
[Phase 2/7] Analyzing files (12 batches)...
[Phase 4/7] Assembling knowledge graph...
✅ Graph written to .ua/knowledge-graph.json (847 nodes, 1,204 edges)

然后：

/understand-chat 这个项目怎么处理登录的？

auth.ts 中的 login() 通过 authService.authenticate() 校验凭据，
成功后在 sessionStore 建立会话，并在 middleware 里拦截未带 token 的请求……

📦 安装

dsh plugin --profile  add github:GongYuanCaiJi/dsh-understand-anything

安装时 prepare 会跑结构校验；首次运行 /understand 时，skill 会按上游流程用 pnpm
构建分析引擎（@understand-anything/core）。若 pnpm 拦下构建步骤，在 profile 的
pnpm-workspace.yaml 里把本套件加入 allowBuilds（本套件自带的 pnpm-workspace.yaml
已包含 tree-sitter 语法的 allowBuilds）。

从本地目录安装：

git clone https://github.com/GongYuanCaiJi/dsh-understand-anything.git
cd dsh-understand-anything && npm install
dsh plugin --profile  add .

需要 Node.js ≥ 22 与 pnpm ≥ 10（上游要求）。

🚀 使用

分析当前代码库（生成 .ua/knowledge-graph.json）
/understand

中文分析
/understand --language zh

增量更新（只重新分析改过的文件）
/understand

问代码库问题
/understand-chat 这个项目的架构是怎么样的？

分析当前改动的影响
/understand-diff

生成新手指南
/understand-onboard

分析引擎与技能文本均为上游英文原文，未做翻译（移植规则：100% 原样复制）。

⚠️ 没搬什么（web 应用不搬）

上游包含完整的 web 应用，dsh 插件形态承接不了——这是能力边界，不是取捨：

- homepage/ 官网、packages/dashboard 交互式看板、packages/viewer 独立查看器
—— 均未搬入本套件。需要看板/查看器请到
上游仓库 获取。
- Claude Code 专属的 hooks/（提交后自动更新）、平台安装脚本与各平台清单未搬入。
- 逐字保真清单见 THIRD_PARTY_NOTICES.md（242 档 SHA-256 可自验）。

📜 License

MIT。上游 Understand-Anything ©
Yuxiang Lin · Infinite Universe, Inc.；本移植 © GongYuanCaiJi（dsh port）。
如果这个项目对你有帮助，请也给上游点个 star ⭐

English

简体中文
一句话：让 AI 在回答之前先理解整个代码库——生成知识图谱，然后聊天、差异分析、探索架构，并帮助新成员上手。

将 Egonex-AI/Understand-Anything
（MIT）移植为 DeepSeek Harness 插件。
技能/代理层逐字保留；仅将插件机制适配为 dsh。

✨ 功能特性

- 🕸️ 交互式知识图谱——将代码库扫描为 knowledge-graph.json（架构、依赖、调用图、复杂度）
- 💬 /understand-chat——基于图谱回答代码库问题，无需将整个文件塞入上下文
- 🔍 /understand-diff——分析你当前更改的影响
- 🧭 /understand-onboard——为新团队成员生成上手引导
- 🏛️ /understand-domain——提取业务领域、流程和步骤
- 📚 /understand-knowledge——分析 Karpathy 模式的 LLM wiki
- 🎨 /understand-figma——通过 REST API 从 Figma 生成设计知识图谱
- 🌐 多语言——--language zh 生成中文摘要、标签和描述

📦 安装

dsh plugin --profile  add github:GongYuanCaiJi/dsh-understand-anything

prepare 会在安装时运行结构检查；首次执行 /understand 时，该技能会按照上游流程
使用 pnpm 构建分析引擎（@understand-anything/core）。如果 pnpm 阻止了构建步骤，
请将此包添加到该 profile 的 pnpm-workspace.yaml 中的 allowBuilds（随附的
pnpm-workspace.yaml 已允许 tree-sitter 语法）。

本地安装：

git clone https://github.com/GongYuanCaiJi/dsh-understand-anything.git
cd dsh-understand-anything && npm install
dsh plugin --profile  add .

需要 Node.js ≥ 22 和 pnpm ≥ 10（上游要求）。

🚀 使用方法

/understand                # 分析当前代码库 → .ua/knowledge-graph.json
/understand --language zh  # 中文分析
/understand-chat ...       # 询问有关代码库的问题
/understand-diff           # 分析当前更改的影响
/understand-onboard        # 生成上手引导

分析引擎和技能文本保持上游英文（移植规则：100% 逐字复制）。

⚠️ 未移植的内容（Web 应用）

上游附带一个完整的 Web 应用，而 dsh 插件无法承载它——这是能力边界，而非选择：

- homepage/（营销网站）、packages/dashboard（交互式仪表盘）、
packages/viewer（独立查看器）——未包含。请从
上游仓库获取。
- Claude Code 专属的 hooks/（提交后自动更新）、平台安装脚本和
平台清单未包含。
- 逐字保真清单：THIRD_PARTY_NOTICES.md
（242 个文件，可通过 SHA-256 验证）。

📜 许可证
麻省理工学院。上游 Understand-Anything ©
Yuxiang Lin · Infinite Universe, Inc.；本移植版本 © GongYuanCaiJi（dsh 移植）。
如果这个项目对你有帮助，也请给上游点个星 ⭐