前言¶

在 DeepSeek Harness（DSH）里做智能体开发时，常见情况是同一台机器上要切换 Claude Code、Codex、OpenCode OMP 等多套 CLI 会话，远程环境还要走 SSH。原生 DSH 会话各自独立，侧边栏和对话界面也不一致，查历史工具调用、审批与导出往往要分开操作。

下面介绍社区插件 dsh-remote-agents（维护者 FrankieeW，分类为客户端）。它把上述代理的本地与 SSH 对话放进统一工作区，保留 DSH 原生的侧边栏与对话界面，并支持工具审批与持久化历史。本文为非官方社区插件说明，与 DeepSeek 无从属关系；安装前请自行查看源码与 MIT 许可证，插件以当前 DSH 进程权限运行。

这是什么¶

dsh-remote-agents 的定位是：面向 DSH 的「本地与 SSH 智能体舰队工作台」。官方 README 概括为：为 Claude Code、Codex 和 OMP 提供统一的 DSH 工作区，支持本地与 SSH 对话、工具审批和持久化历史；原生 DSH 会话仍共用同一侧边栏并保留原有对话界面。

项目声明为独立开发与维护的非官方社区插件，用户消息与模型输出不会被翻译或改写。当前 npm 包版本为 0.5.0；0.5.0 将后端迁至 Rust 侧车（sidecar），DSH 界面与状态文件格式保持不变。

核心功能¶

统一工作区与会话¶

可在同一侧边栏中浏览 Claude Code、Codex、OMP 的会话，包括嵌套的本地工作区以及独立的 SSH 工作区。各代理的对话页签按产品定制，例如：

• Claude：Chat / Tools / To-dos
• Codex：Chat / Plan / Changes
• OMP：Chat / Tasks / Tools / Models（0.5.0 起增加按会话的 Models 页签）

OMP 的 Models 页签用于该会话所在机器与工作区范围内的内置/自定义角色、项目覆盖、预设、提供商连接与自定义模型定义；配置管理需要 OMP 18.18.x（见仓库文档 docs/omp-model-configuration.md）。

对话内 / 命令（Rust 后端执行）¶

在 Claude Code、Codex、OMP 对话中可使用由后端处理的 / 命令，支持键盘补全与状态/帮助，且失败时保留草稿、不会作为模型提示发送。0.5.0 列出的命令包括：/help、/status、/model、/effort、/permissions、/rename、/pin、/archive、/new、/stop、/export。详见 docs/unified-chat.md#conversation-commands。

工具调用归档与导出¶

新的本地与 SSH 轮次提供完整工具归档：按 16 次调用分页浏览、搜索完整输入/结果、以 UTF-8 安全页面阅读长值，并可将单轮全部工具导出为 JSONL。较旧的本地 OMP 轮次可从原始会话文件恢复。详见 docs/tool-history.md。

标题、差异与界面细节¶

• 根据首条提示自动生成标题，支持手动重命名保护，并提供显式 Use automatic title 操作。
• 结构化文件差异、工具筛选、OMP 任务阶段与各代理设置标签；Composer、草稿、审批与中断在各视图间可用。
• OMP 工具、阶段、Markdown 与思考层级采用与 DSH 明暗主题一致的语义色。行为与限制见 docs/agent-ui.md。

SSH 目的地¶

SSH 目标支持 alias、user@host、host:port、ssh://… 等形式；保存前会测试连接，并按机器记录连接结果，支持安全重命名与移除。

版本线说明¶

安装与启用¶

在当前运行的 DSH 配置中，通过插件管理器安装 dsh-remote-agents@latest，或固定为 dsh-remote-agents@0.5.0。

若显式使用 web 配置，可在终端执行：

dsh plugin --profile web add dsh-remote-agents@latest

桌面应用应在应用内插件管理器安装到其已有配置；上述命令不会更新桌面应用的配置。

package.json 要求 Node.js >= 22，DSH >= 0.2.2-rc.1 且 < 0.3.0。从 0.4.1 升级至 0.5.0 时，现有状态文件格式不变，会话、工作区与机器登记应可保留。

典型用法¶

安装并启用后，工作区侧栏会出现统一的本地与 SSH 会话列表。可按代理类型打开对应对话页签，在 Composer 中发起本地或远程轮次；需改模型、权限或 Effort 时，在输入框使用 /model、/permissions、/effort 等命令（由后端处理，不进入模型上下文）。

OMP 会话可在 Models 页签中为当前机器/工作区配置角色与提供商；在 Tools 或归档视图中分页查看工具调用，必要时将单轮工具导出为 JSONL。外部会话支持重命名、固定、归档/恢复、保留消息全文搜索以及 Markdown/JSON 导出（0.4.0 起的能力在 README 变更日志中有说明）。

SSH 工作区配置远程主机后，界面会显示主机标识与远程项目目录，便于确认对话实际运行位置（README 截图使用演示夹具，不代表真实生产环境）。

适用场景与注意¶

适合：需要在单一 DSH 界面中并联管理 Claude Code、Codex、OMP 的本地与 SSH 对话，并依赖持久历史、工具审批、完整工具归档与会话级 OMP 模型配置的用户。

注意：

1. 社区插件，非 DeepSeek 官方出品；目录站点 skillhub.cn 与 GitHub 为公开信息来源，使用前请审阅代码与 MIT 许可证。
2. 插件权限等同安装它的 DSH 进程，涉及 SSH 与本地 CLI 时发现与调用，请仅在信任的环境中启用。
3. 需要 OMP 按会话模型管理时，确认 OMP 版本满足 18.18.x 要求。
4. 若需继续使用纯 JavaScript 后端，可安装 dsh-remote-agents@0.4.1，勿与 0.5.0 混用时期望新特性。

结尾¶

dsh-remote-agents 把多代理、多环境的对话收敛到 DSH 统一工作区，并在 0.5.0 用 Rust 侧车承载重负载后端逻辑，同时保持状态与界面兼容。进一步了解功能与截图见仓库 README 与 docs/。

• 社区目录：https://www.skillhub.cn/plugins/FrankieeW/dsh-remote-agents
• 源码与文档：https://github.com/FrankieeW/dsh-remote-agents