dsh-graph

September 3, 2026 · View on GitHub

把工作组织成目标看板的 DeepSeek Harness（DSH）插件——基于图的目标管理（Graph-based Goal Management）。

单包发布：npm 包名 dsh-graph（当前版本 v0.8.3）。一个包同时提供：

面向 agent 的 28 个 graph_* 工具（覆盖目标全生命周期）+ /api/dsh-graph* REST 端点；
浏览器二维泳道看板（lib/client.js），渲染进 conversation.view 槽。

数据以文件 + 事件流形式落在工作区 .dsh-graph 目录，git 友好、可审计。

核心概念

基于图的目标管理：目标是自足实体——自然语言任务 + 动态生成的取证计划与质量判据；任务类型不预先模板化，结构化的是生命周期与求值语义。
四阶段生命周期：描述 → 收集 → 执行 → 确认，由引擎强制的状态机：draft → planning → collecting → ready → in_progress → review → delivered（任意阶段可进入 blocked）。
判据先于执行：进入执行前先登记质量判据，评审按逐条判据核验产出物。
上下文卡片：目标 Runner 的种子上下文，生命周期 empty → collecting → filled → reviewed；形态分文本 / 文件 / 图片 / 数据。
排期：Backlog（暂存池）↔ Version（批量质量管理）↔ 独立目标（standalone）；看板泳道顺序是展示态，可拖拽调整。
换会话交接：graph_handoff 生成交接文档（board 投影 + 长期记忆 + 环境事实），graph_claim_supervisor 由新会话接管。

当前功能状态

更新强调：目标被外部编辑后，看板卡片播放更新强调动画；弹窗打开期间的变化在关闭弹窗时补播；系统开启 reduced-motion 时降级为静态高光。
浅色主题：看板、弹窗与抽屉完整适配浅色 / 深色两套主题（跟随 DSH 主题变量）。
信息收集：目标详情弹窗的上下文卡片区显示「🔎 信息收集」。
卡片标题：直接显示目标标题，无 🎯 前缀。
弹窗交互：从弹窗内容开始框选文本并拖到弹窗外松开，不会误关闭弹窗。

安装

dsh plugin --profile <name> add dsh-graph

需要 Node ≥ 22（包内 core 为编译后 .js）。已发布版本经 npm 与 dsh-market 生态（dsh-market / DshMarketPlace / DSH Get，见 docs/release-handbook.md）分发。

提供的工具

28 个 graph_* 工具，按功能分组：

分组	工具
目标生命周期	`graph_create_goal` · `graph_rename_goal` · `graph_amend_goal` · `graph_set_goal_type` · `graph_transition` · `graph_archive_goal` · `graph_unarchive_goal` · `graph_delete_goal` · `graph_postpone_goal`
质量判据	`graph_set_criteria`
上下文卡片	`graph_add_card` · `graph_fill_card` · `graph_review_card` · `graph_bind_collect_card` · `graph_delete_card`
排期	`graph_move_goal`
执行派发	`graph_start_attempt` · `graph_set_directive` · `graph_record_attempt_handoff`
校验 / 对账	`graph_validate` · `graph_rebuild`
状态汇报	`graph_report_status` · `graph_report_supervisor_status`
评审裁决	`graph_resolve_accept`
历史讨论	`graph_add_comment`
换会话	`graph_handoff` · `graph_claim_supervisor`
帮助	`graph_help`

各工具具体含义见 dsh-graph-host/README.md 或 graph_help。

看板（浏览器客户端）

浏览器二维泳道看板：横向为生命周期阶段列（描述 / 收集 / 执行 / 确认 / 交付 / 阻塞），每个版本一条泳道，另有 Backlog 与独立目标区；支持拖拽排期、判据 / 上下文卡片抽屉、graph_report_status 与 graph_report_supervisor_status 的实时状态显示、阻塞折叠等。以下为虚构演示数据（nebula-notes）截图：

看板总览

目标详情弹窗

数据目录

<workspace>/.dsh-graph：跟随调用会话的 workspace（session.header.cwd），数据落在每个项目自己的 .dsh-graph，git 友好。包含 backlog/、goals/、versions/、events.jsonl（事件流，唯一事实源）等。首次触达某 workspace 自动生成骨架，幂等、不建 demo 数据；.dsh-graph 也可配置为独立 Git 仓库（见 docs/ 与 scripts/migrate-dsh-graph-repo.sh）。

仓库结构（monorepo）

core/——核心层源码（唯一事实源），经 scripts/sync-core.sh 编译成 dsh-graph-host/core/*.js 进发布包。可基于core开发各类UI / CLI / REST / agent 工具，核心层不依赖 DSH。
dsh-graph-host/——单包发布物：index.js（工具 + REST 端点）、lib/client.js（看板）、cordis.patch.yml（dsh.bundle）、supervisor-guide.md、README.md、LICENSE。
schema/、docs/、scripts/——数据 / 设计文档 / 构建脚本。

开发

bash scripts/sync-core.sh          # 修改 core 后同步进包
node --test core/tests/*.test.ts   # 全量测试

# 复现 README 截图（虚构演示数据，写仓库外 /tmp，不提交 mock .dsh-graph）：
node scripts/dsh-graph-mock-seed.mjs --validate               # 生成 nebula-notes mock 数据
CWD=/tmp/dsh-graph-mock-demo bash scripts/dev-dsh-instance.sh run --port 3082  # 测试实例（开「看板」tab）
# 截图：同一次 seed、同一实例、固定视口——看板全景 → screenshot/screenshot-1.png；
# 点击 g-006 卡片打开目标详情弹窗 → screenshot/screenshot-2.png