@cocofhu/dsh-aio-agent
English | 中文
在 DeepSeek Harness（DSH）里用 Cursor、Claude Code、Codex、OpenCode、CodeBuddy 或 Kimi Code 运行会话。每个 Agent 作为一个模式出现在模式菜单中，它的模型出现在原生模型菜单中。这类会话的每一轮都交给 DSH 所在机器上的 Agent CLI 执行。Cursor、Claude Code、Codex、OpenCode 和 CodeBuddy 每轮启动一个进程，使用 CLI 的 JSON 流模式（cursor-agent --print、claude -p、codex exec --json、opencode run --format json、codebuddy --print），可报告 token 用量，并按 id 续接 CLI 自己的会话；Kimi Code 经由 Agent Client Protocol（ACP）运行。DSH 只负责展示对话和记录会话日志，不会调用自己的模型。
安装
打开 插件 → 添加插件，输入 github:cocofhu/dsh-aio-agent，点击 安装，再点 立即启用。也可以在终端执行：
dsh plugin add github:cocofhu/dsh-aio-agent
用 npm pack 打出的发布包（cocofhu-dsh-aio-agent-<版本>.tgz）也可以填路径或 URL 安装。升级时先卸载再安装新版，配置保留在 profile 中。
然后在运行 DSH 的机器上安装并登录需要的 Agent：
| Agent | 安装 | 登录 |
|---|---|---|
| Cursor | curl https://cursor.com/install -fsS \| bash |
cursor-agent login |
| Claude Code | npm install -g @anthropic-ai/claude-code |
claude auth login |
| Codex | npm install -g @openai/codex |
codex login |
| OpenCode | npm install -g opencode-ai |
opencode auth login |
| CodeBuddy | npm install -g @tencent-ai/codebuddy-code |
运行 codebuddy 后执行 /login；~/.codebuddy/models.json 中的模型无需登录 |
| Kimi Code | curl -fsSL https://code.kimi.com/kimi-code/install.sh \| bash |
kimi acp --login |
未安装或未登录的 Agent 不会出现在模型菜单里，也不会报错；它的配置页会列出上面的步骤，并提供复制按钮。
使用
- 新建会话时，在模式菜单中选择 Cursor、Claude Code、Codex、OpenCode、CodeBuddy 或 Kimi Code。
- 在模型菜单中选择该 Agent 的模型，或保留默认值。Agent 提供推理等级时（Codex、OpenCode 的 variant、Kimi Code 的思考开关），在 推理等级 中选择；Codex 列出的模型和等级与它自己的选择器一致（
~/.codex/models_cache.json）。 - 照常发送消息，回复会随 Agent 输出实时显示。排队消息在当前轮结束后依次运行；点击队列行的发送会中断当前 CLI 调用，并续接同一 CLI 会话处理这条消息。停止会取消当前调用及其工具进程，保留尚未发送的队列，直到再次发送消息。工具调用显示为原生的终端、读取、写入和编辑步骤。
对话上下文保存在 CLI 一侧：之后每一轮都续接第一轮建立的 CLI 会话，DSH 重启后也一样。
在输入框键入 /，可以调用当前工作区或用户目录里已有的技能。扫描范围包括 .dsh/skills、.agents/skills、.claude/skills、.claude/commands、.cursor/skills、.codex/skills、.opencode/skills、.codebuddy/skills 和 .kimi/skills（先项目，再主目录下的同名目录）。选中 /技能名 后，胶囊会高亮，右侧栏打开对应的 SKILL.md。发送时会把技能说明注入给 CLI，因此一个 Agent 也能用到它自己不会扫描的目录里的技能。CLI 用自己的 Skill 工具加载技能时，对话里显示为可展开的原生技能卡片。
/resume 续接本机已经存在的 CLI 会话。弹窗先列出当前工作区，再列出其他工作区，每条包含标题、时间和短 ID。也可以直接输入 /resume <会话 ID>。之后的轮次会把这个 ID 交给 CLI（--resume、codex exec resume、opencode run --session，Kimi Code 则用 ACP 的 session/load）。DSH 保留自己的对话记录，不会把 CLI 的历史整段导入。续接之后，对话里会出现一张续接卡片，输入框上方会一直显示「正在续接」和会话标题，侧边栏标题也会改成它。
配置
插件 → AIO Agent 中每个 Agent 是一个可单独开关的组件；关闭后，它的模式和模型都会移除。点击 配置 打开该 Agent 的页面：
- 状态：显示「已就绪」及模型数量；DSH 无法启动它时，显示安装和登录步骤。重新检测 会重新读取状态。
- 默认模型：会话未选择模型时使用。
- 启动命令：替换内置的可执行文件，例如
"/opt/Cursor Agent/cursor-agent"或/opt/codex --profile work，后面附加的选项会保留；含空格的路径要加引号。 - 自动批准权限请求：Agent 在执行操作前（如运行命令）发起请求时，开启则批准，关闭则拒绝。Agent 无需请求就能执行的操作，由它自身的设置决定。
保存的值写入 profile 的 cordis.patch.yml，从下一轮开始生效，无需重新加载。
会话日志
JSON 流的每一行以 plugin:dsh-aio-agent/stream、双向的每一条 ACP 消息以 plugin:dsh-aio-agent/acp 记录在会话日志中，敏感字段已脱敏。权限应答记录为 plugin:dsh-aio-agent/permission，DSH 会话与 CLI 会话的绑定关系记录为 plugin:dsh-aio-agent/binding。
已知限制
- Codex 和 OpenCode 在一条回复或一次工具调用完成后才上报，所以它们的文本按整条消息出现，而不是逐字流式显示。
- 用本插件旧版本（经由 ACP）开始的 Claude Code、Codex 或 OpenCode 会话，会在一个新的 CLI 会话中继续；DSH 中的对话记录保留。
- 输入框中的访问模式不会限制外部 Agent。
- 状态无法区分「未安装」和「未登录」。
开发
npm test # node --test
npm run build:logos # 把 assets/provider-logos 重新内联进 lib/client.js
npm pack # 打出 tarball，在「添加插件」中安装做本地试用
测试使用 PATH 中的 DSH 安装（或 DSH_ROOT），通过受控 CLI 覆盖六种后端的真实 Agent 循环。安装 OpenCode、CodeBuddy 并设置 DEEPSEEK_API_KEY 后，可以显式运行排队、队列发送和停止的实测：
DSH_AIO_LIVE_TESTS=1 node --import ./test/dsh-runtime.mjs --test test/live-driver.test.js
实测使用临时工作区和 CLI 配置，会产生 DeepSeek API 调用费用。
品牌图标来自 lobe-icons（MIT），详见 assets/provider-logos/README.md。
许可证
MIT
