npm.io
0.2.25-rc.6 • Published 23h ago

@veewo/dsh-adapter

Licence
Version
0.2.25-rc.6
Deps
0
Size
161 kB
Vulns
0
Weekly
0
Stars
3

@veewo/dsh-adapter

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

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

架构

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-startclaw context --host dsh,恢复绑定计划并注入紧凑 workflow 快照(systemPrompt.contextclaw:workflow);
  • agent/turn-stoppingclaw hook auto-doc --host dsh,捕获 turn 报告 (knowledgeDispatch 经 DSH 原生 subagent 分发为后续工作项)。

安装

# 仓库内(本包是 private workspace 包,尚未发布到 npm)
npm run export:dsh-plugin     # 生成 dist/dsh-plugin/claw-kit-dsh-adapter-<v>.tgz
npm run install:dsh-plugin    # dsh plugin --profile web add <tarball>(可 --profile 指定)
# 重启 DSH Host 后生效;验证组合:dsh --profile web --dump-config

发布到 npm 后直接:dsh plugin --profile web add @veewo/dsh-adapter

前置条件:claw CLI 已安装且版本与仓库对齐(claw --version), CLI 需支持 --host dsh(见 claw-kit 仓库的 dsh host 支持)。

工具

claw_run

  • operation:点号形式(plan.createplan.starttask.doneplan.doneplan.showsearchcontext 等);
  • args:操作字段(snake_case,与 Cindy 适配器的操作目录一致);
  • 会话身份与 workspace 由插件从 exec.agent 锻造,模型不得传 session/host/workdir;
  • 返回紧凑 guidance + goalSync(已自动消费的 goal hostAction 列表)。

Skills

安装即投递 7 个 skills(ctx.skills bundled provider,无需手动复制):

  • shared 同步:planningconfigcreate-claw-skillclaw-kit-docnpm 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-adapter 再重新 install:dsh-plugin(版本号即更新信号)。

测试

npm run build -w @veewo/dsh-adapter
npm test -w @veewo/dsh-adapter

覆盖:operation→daemon input 映射、hostActions 消费(含 fail-open)、 白名单 compact、ClawSession 协议(open/request/串行化/诊断忽略)。

已知限制

  • systemPrompt.context 注入的是「最近一次 session-start 快照」:单会话 TUI 精确, 并发 web 会话收敛到最后一个写入者;
  • 进度投影(update_plan → sessionProjections/UI)为 P2,当前以紧凑 guidance 承载;
  • knowledgeDispatch 的 DSH 原生 subagent 分发尚未实现(turn 报告已捕获)。

Keywords