dsh-workspace
简体中文 | English
DeepSeek Harness（DSH）的远程工作区插件：在 DSH 里管理 SSH 主机，打开远程终端、浏览和编辑远程文件、查看远程 Git，并把远程目录添加为工作区，让 Agent 的读写和命令都作用在远程机器上。
功能
- 主机管理：多层分组、组默认值继承、跳板机链、SOCKS5 / HTTP 代理；首次连接记录主机指纹（TOFU），之后指纹变化会拦截
- 凭据保险箱：密码、私钥等敏感字段用主密码加密（AES-256-GCM + scrypt）后保存在本机；可选「在本机记住」自动解锁（Windows 用 DPAPI 保护）
- SSH 终端：交互式终端，页面与侧边栏共用同一会话，断线自动重连
- 文件管理（原「远程文件」，本地与远程工作区通用）：目录树、Monaco 编辑器（语法高亮、Ctrl+S 保存、冲突检测）、Markdown / HTML / 图片预览、右键菜单（新建 / 上传 / 下载 / 重命名 / 复制 / 粘贴 / 删除 / 复制路径）；可接管 DSH 自带的「文件」侧栏
- Git 仓库（原「远程 Git」，本地与远程工作区通用）：改动（暂存 / 放弃 / 提交）、diff、带分叉图的提交历史；可查看任意分支，本地分支不检出也能直接修改和提交
- 检查更新：全局配置里一键检查 GitHub 最新版本并下载安装（GitHub 不通时回退 npm 官方源），也可上传离线 .tgz 包升级
- 添加工作区：接管 DSH 的「添加工作区」弹窗，可选本机目录（快捷位置 + 盘符）或远程主机目录（按分组展示）
- 远程 Agent 工具：远程工作区会话里，Agent 的 read / write / edit / glob / grep / bash 都在远程主机上执行，本地会话不受影响
依赖
| 依赖 | 说明 |
|---|---|
| DSH | >= 0.1.5-rc.2（同时兼容 0.1.x 与 0.2.x；开发基于 DSH Desktop 2.0.16 / 宿主 0.2.0-rc.1） |
| Node.js | >= 20 |
DSH-better-sidebar（npm 包 dsh-better-sidebar） |
侧边栏相关功能依赖这个插件（右侧栏里的远程文件、远程 Git、SSH 终端）。请先安装并启用它 |
安装
1. 先安装侧边栏插件
dsh plugin --profile add dsh-better-sidebar
2. 安装 dsh-workspace
从 npm 安装最新版（命令不带版本号，自动装最新一版）：
dsh plugin --profile add @yh4922/dsh-workspace
也可以装 Releases 里的最新安装包，或下载后用本地路径安装（文件名带版本号）：
dsh plugin --profile add https://github.com/yh4922/dsh-workspace/releases/latest/download/dsh-workspace.tgz
dsh plugin --profile add /path/to/yh4922-dsh-workspace-<版本>.tgz
` 是要安装到的 profile，例如web`- 升级：先
dsh plugin --profile remove @yh4922/dsh-workspace，再用上面的命令安装。对同一个包/地址再装一次时，插件管理器判断不出这次装的是哪个包（依赖值没有变化），会回滚并提示「无法从依赖变更中确定安装了哪一个包」 - 0.7.7 及更早版本的用户：当时的包名是
dsh-workspace，请先dsh plugin --profile remove dsh-workspace再装新包名；否则会同时存在两个包，运行的仍是旧代码 - DSH Desktop：
desktopprofile 不能用命令行管理，请在「插件管理」→「添加插件」里填入@yh4922/dsh-workspace或上面的地址；升级同样是先移除、再添加（插件管理里没有「更新」按钮） - 本插件依赖
ssh2，其中有原生构建脚本。pnpm 拦下构建时，在插件管理的失败界面点「允许这些脚本并重试」；命令行安装则按提示放行ssh2、cpu-features - 不能直接从 Git 仓库地址安装：仓库里没有编译产物（
lib/）
卸载
dsh plugin --profile remove dsh-workspace
> 在 DSH Desktop 运行时卸载或升级本插件，曾导致 DSH 崩溃。建议先退出 DSH 再操作。
使用
- 左侧栏打开「远程工作区」，第一次使用时设置主密码
- 新建主机（可以放进分组），点「测试连接」确认能连上
- 在「主机 / 文件 / 终端 / 连接日志」几个页签里管理主机、浏览文件、打开终端
- 点 DSH 的「添加工作区」（「全局配置」页签里的「接管『添加工作区』」需开启，默认开启），选择远程主机和目录，即可创建远程工作区
- 在会话右侧栏可以打开「文件管理」「Git 仓库」（本地与远程工作区都可用）；远程工作区会话还有「SSH 终端」
- 「全局配置」页签里还有自动解锁开关，以及版本信息、更新日志等链接
开发
pnpm install
pnpm typecheck
pnpm test
pnpm build
- 真机集成测试默认跳过，设置
DSHWS_IT=1并通过环境变量提供测试主机后运行pnpm test:it - 目前构建脚本（
scripts/）没有放进仓库，单独克隆后暂时不能完整执行pnpm build
打包与发布
| 命令 | 用途 |
|---|---|
npm run pack:dev |
开发调试包：版本号为「下一个 patch-dev.时间戳」，只放在本机 pack/，不改 package.json、不推送 |
npm run release -- [patch\|minor\|major] |
正式发布：累加版本号，把 CHANGELOG.md 的「未发布」定稿为新版本，构建打包，提交并推送 tag，创建附带安装包的 GitHub Release，并把同一个包发布到 npm |
npm run release -- --dry-run --allow-dirty |
发布演练：只检查、构建和打包（不发 npm、不提交不推送），结束后还原 |
发布前要求：在 main 分支、没有未提交改动、与远程同步，「未发布」下已写好本次的更新日志，且本机已 npm login（发布到 registry.npmjs.org，未登录会在前置检查阶段直接失败）。
安全说明
- 凭据只保存在本机，并用主密码加密；主密码本身不落盘
- 远程工作区会话的系统提示词会要求 Agent：没有用户明确要求时，不执行 commit、push、
reset --hard、rebase - 远程命令不受本机沙箱约束，只读沙箱模式下会拒绝写入和 bash
许可证
MIT
