GongYuanCaiJi/dsh-understand-anything

dsh-understand-anything is a native plugin built specifically for DeepSeek Harness, ported verbatim from the MIT-licensed upstream Egonex-AI/Understand-Anything while only the packaging and plugin mechanism are adapted to dsh. Its core capability is a single slash command, /understand, which scans the current codebase and writes a structured knowledge-graph.json capturing architecture, dependencies, call graphs, and complexity. Around that graph the plugin exposes six more commands: /understand-chat for grounded question answering without dumping full files into context, /understand-diff for impact analysis of uncommitted changes, /understand-onboard for new-member guides, /understand-domain for business-domain extraction, /understand-knowledge for Karpathy-pattern LLM wikis, and /understand-figma for design knowledge graphs fetched via the Figma REST API. Installation is done through dsh plugin --profile <profile> add github:GongYuanCaiJi/dsh-understand-anything, or by cloning locally, running npm install, and adding the directory; a --language zh flag switches summaries, tags, and descriptions to Chinese.

The typical workflow starts with running /understand in a project root, which streams seven phases (scanning, batched file analysis, graph assembly) and lands a graph such as 847 nodes with 1,204 edges on a medium-sized repository. Once the graph exists, developers ask architecture or login-flow questions through /understand-chat, request impact notes for their current diff via /understand-diff, or generate onboarding material with /understand-onboard for incoming teammates. The intended audience is engineers onboarding into unfamiliar repositories, reviewers performing change-impact analysis, tech leads producing architecture briefs, and small teams that want a reusable, queryable view of their code without standing up the upstream web app. The graph output is also machine-readable, so downstream tools can consume .ua/knowledge-graph.json directly.

Hard requirements are Node.js ≥ 22 and pnpm ≥ 10, matching upstream; on the first invocation the skill compiles @understand-anything/core with pnpm, and if pnpm blocks build scripts the user must add the package to allowBuilds in the profile's pnpm-workspace.yaml (the bundled config already permits the tree-sitter grammars). The license is MIT, with a third-party notices manifest covering 242 files whose SHA-256 hashes can be re-verified, and analysis-engine plus skill text remain in upstream English without translation. Explicitly excluded by design are the upstream homepage site, the interactive packages/dashboard, the standalone packages/viewer, the Claude Code-specific hooks/ directory, and platform install scripts or manifests — users needing a graphical dashboard must fetch those from the upstream repository rather than expecting them inside this dsh plugin.