Dsh CLI Switch — AI skill for Claude Code

dsh-cli-switch

**⚠️ 开发中（WIP）· Work in Progress**

本仓库处于早期开发阶段：M1（opencode-cli 文本对话）+ M2（claude-cli 完全剥壳）冒烟通过，**工具执行链路尚未开放**（设计见 ROADMAP M4 专题 A）。欢迎围观、试用、提 issue——但**不建议生产使用**；接口与行为可能随时变更，恕不另行通知。

DeepSeek Harness 的 LLM provider 层插件：把各家本地 AI CLI（claude / opencode / gemini / cursor / codex…）接成 DSH 的"模型后端"，模型选择器里一键热切换。

**定位一句话**：壳是 DSH 的（agent loop、工具、沙箱、日志、UI 全归 DSH），芯是各家 CLI 里的模型——各家 CLI 在本插件中只保留"思考 + 生成 tool_use"的能力，手和脊髓全部截掉换成 DSH 的。

**状态**：M1 冒烟通过（2026-08-20：opencode-cli 文本对话 + 不落盘 + T5' 剥壳实证）；**M2 冒烟通过（同日：claude-cli 完全剥壳——SDK 路线工具往返 + 生产环境 24 工具全可见零泄漏 + 不落盘）**；**M3 冒烟通过（2026-08-21：五家 route 全在模型选择器 + opencode/claude 回归 + gemini/cursor 快速失败；codex 因区域封锁未达快速失败，入 M4）**。计划见 [ROADMAP.md](ROADMAP.md)，冒烟证据见 [docs/smoke/m1.md](docs/smoke/m1.md)、[docs/smoke/m2.md](docs/smoke/m2.md) 与 [docs/smoke/m3.md](docs/smoke/m3.md)。

---

1. 背景与生态位

• DSH（deepseek-ai/deepseek-harness）是 DeepSeek 官方 agent harness，2026-08-13 发布，7 天 16.6 万星，MIT / TypeScript / Cordis 插件架构，"Everything is a Plugin"。
• DSH 官方已在 subagent 层做了 claude-code / codex 集成（dsh-subagent-claude-code 用 Agent SDK、dsh-subagent-codex 用 codex app-server）——那是"临时工"模式：one-shot 委派任务给产品、拿回最终答案，一个任务一个进程，官方明确不做流式/续传。
• 本插件做的是 provider 层——"模型脑"模式：产品只当模型通道，持续会话、工具执行、沙箱审批、会话日志、UI 渲染全部是 DSH 的。这个生态位还没人做。
• 已存在的 katsos/dsh-claude-cli（4 星）验证了 claude 单家剥壳可行，本插件是其泛化版本。

2. 核心概念：剥壳 = 截肢 + 接管反射弧

任何完整 agent（有脑有手有循环）塞进 LLM provider 插槽时：

部件	SDK 家族（claude）	ACP 家族（opencode/cursor/gemini）	处置
脑（模型思考 + tool_use 决策）	✔	✔	保留——这正是 provider 的职责
脊髓（自己的 agent loop）	✘	✘	砍掉——DSH 的 agent loop 接管驱动（ACP 家族：loop 在 agent 侧，客户端只收通知，见"双层现实"）
手（内置工具）	✘ disallowedTools 按名前缀过滤（R3 实证：'*' 会把我们声明的工具也移除）	✘ 项目级 opencode.jsonc tools:{...:false} 按名禁用（R1 实证 8 原生全移除）	剁掉——模型看不到任何原生工具
记忆/设置/MCP/钩子	✘	✘	清除——统一走 DSH 的会话与凭据体系
假手（MCP bridge）	＋ tool_use 流式回客户端（input_json_delta，R3）→ DSH 执行	＋ 工具由 agent 服务端执行，客户端只收 tool_call 通知（R4）	接上——DSH 工具伪