前言¶
在 DeepSeek Harness（DSH）里做智能体或项目开发，工作区通常绑在本机磁盘上。若代码和运行时其实在 Linux 服务器或 Windows 下的 WSL 里，常见做法是本机开终端 SSH 进去，再单独在远端装一套工具链；模型与服务商配置还要在两边各维护一份。DSH 社区插件 dsh-remote-dock（维护者 Lee-Eee-Eee，MIT 许可）在本地 DSH 侧栏增加「远程」入口：连上 SSH 主机或 WSL 发行版后，目标上的完整 DSH 界面嵌入本地主区，文件读写与命令执行都在目标环境中完成。
这是什么¶
dsh-remote-dock 为 DeepSeek Harness 添加远程工作区能力。一句话定位：把任意可通过 SSH 访问的 Linux 主机或本机 WSL 发行版，变成可在本地 DSH 面板里管理、探测、安装并使用的远程 DSH 实例。
- 仓库：Lee-Eee-Eee/dsh-remote-dock
- 社区目录：skillhub.cn 插件页
- 分类：客户端（Web 侧注入，安装后侧栏出现「远程」）
DSH 生态采用「一切皆插件」思路；社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。安装第三方插件前，应自行查看源码与许可证，并理解插件随当前 DSH 进程权限运行。
核心功能¶
以下能力均来自项目 README 与 package.json 说明。
SSH 与 WSL 目标管理¶
插件会发现 SSH 配置中的主机和本机 WSL 发行版，也支持手动添加目标。SSH 连接沿用本机密钥、agent 与跳板机配置，不要求在插件里重新录入一套账号体系。
远程环境准备（无需 sudo）¶
选择目标后可「探测环境」，检查 Node、DSH、tmux 以及磁盘与 CPU 等信息。若缺少 Node 或 DSH，可先打开「查看安装计划」，确认步骤后再安装到用户目录，无需 sudo。自动安装依赖目标侧具备 bash、tar，以及 curl 或 wget。
模型配置移植¶
远程尚未配置可用模型时，可用「移植本地配置」：选择服务商、默认模型和 API 密钥组，写入前会备份远程原文件；预览仅显示名称和数量，并排除本机浏览器会话凭据。密钥组会复制实际密钥值，只应写入你信任的目标。
连接与会话管理¶
点击「连接」后，主区打开目标上的 DSH，项目与会话由嵌入界面管理。面板内支持重载、全屏、重启或停止远程 DSH；重新连接时优先恢复已有实例，SSH 隧道断开后会自动重试。多个目标可同时保持连接，切换目标即切换对应机器上的 DSH。关闭面板或退出本地 DSH 时，远程进程可保留，之后可再连回。
安装与启用¶
宿主 DSH 需要 0.2.1-rc.2 或更新版本；运行环境需 Node 22.x（≥ 22.19.0） 或 24 及以上。
在插件管理器中添加以下来源（当前 README 指定版本 v0.1.5）：
github:Lee-Eee-Eee/dsh-remote-dock#v0.1.5
安装后重启 DSH 并刷新页面，侧栏会出现 远程。
若终端已能运行 dsh，也可用命令行安装（将 desktop 换成当前宿主实际使用的 profile；网页版通常用 web）：
dsh plugin --profile desktop add "github:Lee-Eee-Eee/dsh-remote-dock#v0.1.5"
装到其他 profile 的插件不会出现在当前宿主中。若曾使用旧名 dsh-remote，需先在当前 profile 移除旧版，再添加上述 GitHub 来源；新旧两份只应启用一份。dsh-remote-workspace@0.1.0-alpha.* 属于其他 npm 项目，与本仓库无关。
典型用法：首次连接¶
下面步骤与 README「首次连接」一致，可按顺序复现。
- 添加目标：打开「远程」，在 SSH 主机或 WSL 发行版旁点
+，或用「添加目标」填写 SSH 别名或主机信息。 - 探测环境：选中目标，点「探测环境」。缺少 Node 或 DSH 时，打开「查看安装计划」，确认后再安装。
- 准备模型：远程尚无可用模型时，打开「移植本地配置」，选择服务商、默认模型和 API 密钥组，点「写入并重启」。远程已配置好则可跳过。
- 连接：点「连接」，在主区使用远程 DSH 并选择远程项目。连接后右侧即目标机器上的 DSH；若已移植配置，模型与服务商与本机选择一致。
连接后常用操作：
| 操作 | 作用 |
|---|---|
| 重载 | 刷新远程界面 |
| 重启 | 重新启动目标上的 DSH |
| 停止远程 | 结束目标实例并断开本地连接 |
| 关闭面板 / 退出本地 DSH | 保留远程进程，之后可重新连接 |
环境要求与注意¶
| 环境 | 要求 |
|---|---|
| DSH 宿主 | 0.2.1-rc.2 或更新 |
| 宿主 Node | 22.x（≥ 22.19.0），或 24 及以上 |
| SSH 目标 | Linux x86_64 / arm64；密钥或 agent 免交互登录 |
| WSL | Windows 与发行版回环可达；支持 mirrored 网络或启用 localhost forwarding 的 NAT 网络 |
适用场景：需要在远程 Linux 或 WSL 里跑与本地一致的 DSH 工作流，又希望在本机一个界面里切换多台目标；希望免 sudo 在用户目录补齐 Node/DSH，并一次性把本机模型配置拷到远端。
常见问题（摘自 README）：
- 安装后没有「远程」：确认装到了当前 profile，重启 DSH 并刷新。
- SSH 失败：在本机终端确认
ssh <别名>可免交互登录，且服务器允许端口转发；不支持密码交互提示。 - 界面能开但模型不可用：检查远程模型配置，或用「移植本地配置」写入后重启远程 DSH。
更细的连接架构、认证与排错见仓库内 技术参考。
结尾¶
dsh-remote-dock 把 SSH 主机与 WSL 发行版纳入本地 DSH 的「远程」面板：发现目标、探测与无 sudo 安装、模型配置移植，以及嵌入式的远程 DSH UI，适合在多机开发时减少重复配置。进一步了解可访问 社区目录页 与 GitHub 仓库；问题反馈请走 Issues，并附上 DSH 版本、目标类型与脱敏后的错误信息。
