🧠 dsh-understand-anything

简体中文 | English

一句话：让 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（本套件自带的 已包含 tree-sitter 语法的 allowBuilds）。