Kimi DeepSeek Subagent

让 Kimi Work／Kimi Code 把任务委派给现有的 DeepSeek Harness Desktop，并共享同一批工作区与持久会话。

这不是一次性 DeepSeek 聊天接口，也不是修改 Kimi 内部模型配置的 workaround。项目由 Harness 内的 MCP 桥接插件和 Kimi 侧插件组成，支持真实 Agent 执行、进度查看、消息注入、取消与断电后的同会话恢复。

功能

• 委派任务到 Harness 工作区，新会话正确归入对应项目；

• continue 找回当前工作区最近的 DS 会话，不静默创建替代会话；

• 跟进、steering、非唤醒式上下文注入、取消；

• 持久事件游标、超时请求去重、冷会话结果读取；

• DeepSeek Key 留在 Harness，Kimi 只接触独立的本地桥接令牌；

• 支持 Kimi Work 个人插件和 Kimi Code mcp.json；

• 安装器、安装 Skill、诊断工具和真实恢复测试可重复使用。

Related MCP server: dsh-web-bridge-mcp

已验证环境

• DeepSeek Harness Desktop / CLI：0.2.1-rc.3

• Kimi Work 个人插件格式

• Kimi Work／Kimi Code 的 stdio MCP，以及独立认证启动器

• Node.js 24

Harness 仍处于 developer preview。其他版本默认拒绝安装；不要在未审查 API 变化时使用 --allow-untested。

在其他 PC 上安装：推荐方式

1. 安装并配置好 Harness Desktop 和 Kimi，确保 Harness 已能正常调用模型。

2. 克隆本仓库并进入目录：

   git clone https://github.com/Alvin20350/DSH_MCP_For_Kimiwork.git
   cd kimi-deepseek-subagent

3. 在 Kimi 中打开该目录，对它说：

   阅读 AGENTS.md 和 skills/dsh-subagent-installer/SKILL.md，按其中的流程在这台电脑安装并验收这套系统。

   Kimi 会检查路径与版本、执行安装、提示必要的重启，并分别报告安装、加载、委派、分组和恢复结果。

也可以完全手动安装，详见 迁移与安装指南。

安装后启用

1. 完全重启 Harness Desktop。Kimi 侧启动器会自行读取用户环境令牌，不依赖 Kimi 后台进程继承。

2. Kimi Work：在插件“个人”页点击 DeepSeek 子代理的 ＋；旧版本用户点击“更新”。

3. Kimi Code：新建会话，让 MCP 与 Skill 生效。

4. 确认目标项目已经注册为 Harness 工作区。

日常使用

直接对 Kimi 说：

• “让 DS 在当前工作区检查测试失败原因，完成后只汇报结论。”

• “查看 DS 当前进度。”

• “把不要修改公开接口注入刚才的 DS 会话。”

• “取消 DS 当前任务，但保留会话。”

• “continue。”

continue 只恢复原会话并报告状态，不会自动发起新的模型工作。明确说“继续完成 DS 的未完成任务”才会继续执行，并要求先检查已有修改和测试状态，避免重复副作用。

诊断

安装依赖后，可随时运行：

npm ci --prefix packages/harness-plugin
node scripts/doctor.mjs

对已注册工作区做一次最小真实委派：

node scripts/doctor.mjs --delegate "/absolute/path/to/workspace"

成功应看到 DS_DELEGATE_OK、WORKSPACE_GROUP_OK，以及与原会话一致的 CONTINUE_OK。

项目结构

packages/harness-plugin/          Harness 内的 MCP 桥接插件
packages/personal/deepseek-subagent/
                                  Kimi Work 插件与运行 Skill
packages/kimi-code/               Kimi Code MCP 配置
skills/dsh-subagent-installer/    给安装者 Kimi 使用的安装 Skill
scripts/install.mjs              可重复执行的安装器
scripts/doctor.mjs               独立诊断与真实委派检查
scripts/live-smoke.mjs           隔离的真实断电恢复测试
scripts/check-repo.mjs           仓库交付契约检查
docs/                            架构、安装与发布文档
.github/workflows/test.yml       GitHub Actions CI

安全边界

• 桥接仅监听 127.0.0.1，不要暴露到局域网或公网。

• 桥接令牌不是 DeepSeek Key，不能提交到仓库或写入提示词。

• 默认只允许已注册工作区；额外根目录需要明确配置。

• 高风险审批只能由用户在 Harness Desktop 中处理。

• 实时完整过程在 Harness 中查看，Kimi 获取压缩状态和持久结果，避免编排 token 被事件流耗尽。

详见 架构与恢复契约 和 安全说明。

开发与验证

npm ci --prefix packages/harness-plugin
npm run check
npm test

CI 不调用真实 DeepSeek。真实隔离联调使用 scripts/live-smoke.mjs，会创建并清理临时 DSH_HOME，不使用现有会话。

发布

本项目已包含 .gitignore、MIT License、安全说明、变更记录和 GitHub Actions。发布与升级流程参见 GitHub 发布检查单。