dsh-claude-code

dsh-claude-code

在 DSH 里用 Claude Code 驱动会话，轨迹实时可见





DSH 默认只用 DeepSeek。装上 dsh-engine-switch + 本插件，
预设列表就多一个「Claude Code」——选中它用 Claude Code 驱动，选其它用 DeepSeek。

✨ 能干什么

• 🎯 一键接入 Claude Code：注册一个 claude-code 引擎（ClaudeCodeAgent + 预设），交给 dsh-engine-switch 按预设路由，零配置自动对上。
• 📡 轨迹实时可见：文本、思考、工具调用与结果，每一步都实时流进 DSH 会话。
• 📊 上下文占用可见：把 Claude Code 的 token 用量与模型上下文窗口写进 DSH 会话日志（TokenUsage + request/context），像 DSH 原生一样在界面显示上下文占用比例。
• 🔐 权限桥接：DSH 的沙箱模式 + 审批策略，映射到 Claude 的权限回调（工作区内写放行、区外弹审批）；AskUserQuestion 用 DSH 的选择题 UI 作答。
• 🧰 工具与沙箱都来自 Claude Code：预设只当路由键，不把 DSH 的 persona / 工具透传过去。
• ⏯️ 精确续接：Claude 会话 id 旁路持久化，续聊接回同一个 Claude 会话。
• 🌐 子代理照旧 DeepSeek：不管主会话选了谁，子代理都走 DeepSeek。

🔌 一句话：本插件不自己替换主循环——它只定义一个 claude-code 引擎，交给 dsh-engine-switch 负责「预设 → 引擎」路由、切换与续接。预设只是路由键：切到它，工具、沙箱、人设都来自 Claude Code，DSH 保留日志与界面。

🚀 安装

先装 dsh-engine-switch（它提供本插件依赖的 ctx.engineSwitch 服务，peer 依赖不会自动装）：

dsh plugin --profile web add github:Yuki-takuya-kun/dsh-engine-switch \
  && dsh plugin --profile web add github:Yuki-takuya-kun/dsh-claude-code

要求：PATH 里有 pnpm；本机有可用的 claude CLI（已登录）或 ANTHROPIC_API_KEY。

⚙️ 启用

编辑 ~/.dsh/profiles/web/cordis.patch.yml：

- id: dsh-engine-switch
  config:
    enabled: true
    # 可选：claude-code 引擎的选项：
    engines:
      claude-code:
        executable: claude
        # env: { ANTHROPIC_API_KEY: sk-... }  # 未登录时用

重启 web 应用。预设列表出现「Claude Code」：选中它 → Claude Code，选其它 → DeepSeek。

⚙️ 配置

这些是 claude-code 引擎的选项，写在 dsh-engine-switch 的 config.engines["claude-code"] 下：

🔍 原理（可选阅读）

• 本插件在 apply() 里 ctx.engineSwitch.register(claudeCodeEngine) 注册 claude-code 引擎（inject: ["engineSwitch"]）。
• 每轮跑一次 Claude Code；SDK 事件被转成 DSH 会话事件（turn / step / assistant / tool 等），实时流式。
• 权限经 canUseTool 回调桥接：工作区内写放行、区外弹审批；AskUserQuestion 用 DSH 选择题 UI 作答。

📄 许可证

MIT。第三方组件见 THIRD_PARTY_NOTICES.md。