jacjackai/dsh-control

dsh-control — DSH 自操作技能

让 AI Agent 通过一条命令操作本机 DSH (DeepSeek Harness) 的工作区与会话：列出/打开/关闭工作区、新建会话、给指定会话投递指令、多席扇出收独立意见、任务卡派工——全部走 DSH 宿主的官方 HTTP RPC，非浏览器模拟。

📌 版本状态（2026-09-15）：本仓库是早期公开快照，冻结在 v1.0.0（适配 DSH 0.1.1-rc.2）。
它演示了完整的理念与用法，但与最新的 DSH 宿主不兼容——新版宿主改变了 RPC 面并加入了
browser-trust 鉴权，本快照的调用方式已不能直接使用。后续大幅演进在私有版本中进行，不再对外发布。
欢迎把它当作设计参考自行适配；issue 仍开放，但功能性 PR 请先开讨论。

这是一个 Agent Skill（SKILL.md + CLI 脚本），适用于任何能执行 shell 命令并读取技能目录的 Agent 环境（Claude Code、DSH 等）。

它能做什么

dshctl status                     # 全局总览：所有工作区 × 会话一张表
dshctl ws open my-task            # 开一个工作区（自动落到 ~/dsh-workspaces/my-task）
dshctl session create --workspace  --title "工位名"
dshctl session prompt  "任务" --yes          # 给会话派活
dshctl session wait                           # 阻塞等完成，回收回复
dshctl dispatch  -f card.json --yes           # 按结构化任务卡派工
dshctl fanout -f q.md --seats "甲席,乙席,丙席" \
--models "vyce:claude-sonnet-4-6,justwork:gpt-5.6-luna" \
--workspace  --yes                          # 多模型独立评审
dshctl fanout-collect                    # 回收各席意见，产出实名汇总

典型闭环：建工位 → 派任务卡 → wait 回收 → 按验收标准亲验产物。所有变更操作有确认闸门（--yes）和审计日志（audit.jsonl）。

安装

1. 确认本机 DSH Web 正在运行（默认 http://127.0.0.1:3080）
curl -s http://127.0.0.1:3080/ -o /dev/null -w '%{http_code}\n'   # 应返回 200

2. 把本目录复制到你的技能目录
cp -r dsh-control ~/.claude/skills/dsh-control    # Claude Code / DSH
或 ~/.agents/skills/ 等你的环境对应目录

3. 自检
python3 ~/.claude/skills/dsh-control/scripts/dshctl.py --version
python3 ~/.claude/skills/dsh-control/scripts/dshctl.py ws list

要求：Python 3.9+（零第三方依赖）。

配置（环境变量，均可选）

| 变量 | 默认 | 说明 |
|---|---|---|
| DSH_BASE | http://127.0.0.1:3080 | DSH Web 宿主地址 |
| DSH_TOKEN | 空 | 宿主配置了鉴权时注入 Authorization: Bearer |
| DSH_WORKSPACE_ROOT | ~/dsh-workspaces | 技能自建工作区的统一根目录 |
| DSH_CONTROL_AUDIT | /audit.jsonl | 审计日志路径 |

⚠️ 安全须知（务必阅读）

- DSH Web 的 RPC 在本机默认零鉴权，本工具等价于"操控你 DSH 的全部会话与工作区"。不要把 DSH_BASE 指向公网地址，不要转发 3080 端口；若经反代暴露，务必加鉴权并配置 DSH_TOKEN。
- session archive 是单向操作：这版 DSH 没有 unarchive 接口，归档后会话从 GUI 全局消失且不可恢复。技能层已把它列为红线，仅在明确要求时执行。
- 变更类操作默认需要 --yes 确认；被 Agent 使用时，建议保留这个闸门而不是图省事常驻 --yes。

协议兼容性

本快照已验证适配 DSH 0.1.1-rc.2，且仅限该版本。RPC 协议逆向自 DSH 的 @deepseek-ai/dsh-client-connection 包（方法名与 payload schema 与 Web GUI 完全一致）。注意：从 0.1.5-rc.1 起，宿主 RPC 面整体迁移（方法路径、payload 包裹层、鉴权 fence 均有变化），本快照不适用。 是否发布适配新宿主的版本尚未决定——见上方版本状态。

目录结构

dsh-control/
├── SKILL.md            # 面向 Agent 的技能说明（触发时机、命令、安全规则）
├── README.md           # 本文件（面向人）
├── LICENSE
└── scripts/
└── dshctl.py       # 唯一入口 CLI（零依赖）

运行期产物：audit.jsonl（审计）与 runs/（扇出记录）生成在技能目录内。

License

MIT