@veewo/dsh-claw-kit

DSH（DeepSeek Harness）的 claw-kit 适配器：一个 claw_run 工具，通过 claw session open --host dsh 常驻 daemon 执行 .claw 工作流操作，自动消费 CLI 生成的 hostActions（进度投影 + DSH 原生 Goal 同步），并只返回紧凑 guidance。

与 Codex 适配器共享同一份 hostActions 协议（schemaVersion: 1， update_plan / create_goal / update_goal）；区别在于 Codex 用模型求值的 code-mode driver 信封消费，这里在 claw_run 工具内部消费——不需要信封、不需要 模型 eval、工具面固定为一个工具。

Goal 动作遵循共享状态转换合同：create_goal 只在没有原生未完成 Goal 时创建； blocked 只允许由 active 发起，complete 允许由 active 或 blocked 发起。DSH 原生 Goals 没有 blocked 状态，因此将合法的 blocked 映射为原生完成；后续恢复会 创建新的原生 Goal。重复 action ID 与不匹配的状态均为 no-op。

架构

DSH 会话
  └─ claw_run 工具（本插件注册）
       └─ ClawSession（常驻子进程：claw session open <workdir> <sessionId> --host dsh）
            └─ claw/execute（JSON-RPC over stdio）
                 └─ CLI daemon → 返回 { output, hostActions, knowledgeDispatch }
                      ├─ consumeHostActions：create_goal/update_goal → DSH ctx.goals
                      └─ compactClawOutput：白名单字段（stage/nextsteps/notes/nextTask/
                         commandHints/askUser/planSummary/planStatus）→ 模型

生命周期钩子（fail-open）：

• agent/session-start → claw context --host dsh，恢复绑定计划并注入紧凑 workflow 快照（systemPrompt.context 名 claw:workflow）；
• 无 turn-stopping 钩子：终态 plan mutation 写入 adapter 私有 final journal；统一的 claw-kit claim 流程随后调用 DSH collector 发布按时间排序的 report，knowledgeDispatch 经 DSH 原生 subagent 自动分发。

安装

# 已发布到 npm：直接安装（重启 DSH Host 后生效；验证组合：dsh --profile web --dump-config）
dsh plugin --profile web add @veewo/dsh-claw-kit

仓库内本地开发可用 tarball 流程（等价安装面）：

npm run export:dsh-plugin     # 生成 dist/dsh-plugin/veewo-dsh-claw-kit-<v>.tgz
npm run install:dsh-plugin    # dsh plugin --profile web add <tarball>（可 --profile 指定）

前置条件：claw CLI 已安装且版本与仓库对齐（claw --version）， CLI 需支持 --host dsh（见 claw-kit 仓库的 dsh host 支持）。

工具

claw_run：

• operation：点号形式（plan.create、plan.start、task.done、plan.done、 plan.show、search 等）；
• args：操作字段（snake_case，与 daemon canonical contract 对齐）；
  • plan.start：goal、requirements、questions、acceptance、rules、 key_decisions、references: [{ path, why }]、add_tasks；
  • plan.edit：上述 plan 字段，以及 summary、对应的 remove_* 字段、 retrospective、what_worked、issues、follow_ups、status；需要保持 mutation 顺序时可直接传 canonical operations 数组；
  • plan.resume：可选 plan_id；plan.done：完整 closeout 字段；
  • task.add：单个 title/detail 或批量 tasks；task.done：单个 id/choice 或批量 tasks；
• 已映射 operation 遇到目录外参数会立即报 Unsupported ... argument(s)，不再静默丢弃；
• 会话身份与 workspace 由插件从 exec.agent 锻造，模型不得传 session/host/workdir；
• 返回紧凑 guidance + goalSync（已自动消费的 goal hostAction 列表）。

Skills

安装即投递 8 个 skills（ctx.skills bundled provider，无需手动复制）：

• shared 同步：planning、config、create-claw-skill、feature-architecture、claw-kit-doc （npm run sync:shared-skills 维护，勿手改——AUTO-GENERATED banner）；
• Host 特定（本包手写）：using-claw-kit（claw_run 单路线主入口）、 researcher（recall → code index → exact source 调查顺序 + 可选 subagent 委派）、 update（CLI + adapter 联合升级，见 skills/update/SKILL.md）。

更新安装时若 pnpm 报旧 tarball ENOENT，先 dsh plugin --profile <name> remove @veewo/dsh-claw-kit 再重新 install:dsh-plugin（版本号即更新信号）。

测试

npm run build -w @veewo/dsh-claw-kit
npm test -w @veewo/dsh-claw-kit

覆盖：operation→daemon input 映射、hostActions 消费（含 fail-open）、Todo 投影与空表清理、 按 agent 隔离的 workflow snapshot、完整 canonical mutation 映射、白名单 compact、 ClawSession 协议（open/request/串行化/启动错误透传/真实 timeout）。

已知限制

• systemPrompt.context 按 DSH agent scope 保存和读取 workflow snapshot， 并发 Web 会话不会共享全局 last-writer 状态；
• 进度投影（update_plan → sessionProjections/UI）为 P2，当前以紧凑 guidance
  • DSH 原生 todo dock 承载。