# dsh-codegraph

`dsh-codegraph` 是 DeepSeek Harness 的问题驱动代码解释插件。它让主智能体在图比文字更清楚时，委派一个只读、可续接的调查子智能体，并在 better-sidebar 中展示一张有焦点、可核查的代码架构图。

## 产品边界

- 一张图回答一个具体问题，默认突出 5–10 个节点，硬上限 30 个节点。
- 节点名称、关系与一句主旨默认可见；图说明、完整解释、证据路径和代码行号按需展开。
- 模型只提交 `dsh-codegraph.scene.v1` JSON；组件、样式和布局由插件固定实现。
- 用户继续在主对话提问；侧栏没有第二个输入框，也不是自由画布编辑器。
- Host 校验仓库边界和证据行，完整 Scene 不进入主智能体上下文。
- 不持续监听仓库重绘，也不建立独立 HTTP 或 WebSocket 服务。

当前兼容目标：DeepSeek Harness `0.1.2-alpha.1` 与 better-sidebar `0.17.1`。

## 开发

```sh
pnpm install
pnpm run typecheck
pnpm test
pnpm run build
pnpm run pack:check
```

alpha.1 的 DSH 子包尚未发布到 npm，本仓库的开发依赖会链接同级 `deepseek-harness` 源码；发布包只保留兼容 peer 范围。