dsh-sidebar-remote
单一可安装的 DSH Web 聚合插件——自动集成 dsh-better-sidebar + @dsh-ssh/dsh-ssh，使 SSH 远程工作区的文件、预览、传输、终端和 Git 真正运行在远端，本地工作区保持原侧边栏行为不变。
无额外 UI、无独立入口。装好即忘：侧边栏自动区分本地与远程会话。
安装
# 本地路径
dsh plugin --profile web add /path/to/remote-sidebar-plugin
# tarball（推荐换机部署）
npm pack
dsh plugin --profile web add ./dsh-sidebar-remote-0.2.1.tgz
# 发布后（npm）
dsh plugin --profile web add dsh-sidebar-remote
单次安装即可。cordis.patch.yml 会自动挂载聚合插件，上游两个插件通常已随 profile 安装。
移除：dsh plugin --profile web remove dsh-sidebar-remote
更新
本包未发布 npm，更新渠道与安装渠道一致。更新后必须重启 dsh web（Host 半边无热重载），并硬刷新浏览器（Ctrl+Shift+R）避免沿用旧 client bundle：
# git URL 安装者：重新解析 git 依赖到最新 main（prepare 脚本自动重建）
cd ~/.dsh/profiles/web && pnpm update dsh-sidebar-remote
# tarball / 本地路径安装者：仓库不含 tgz 产物，需自行打包新版本
git clone https://github.com/zijun-T/dsh-sidebar-remote.git && cd dsh-sidebar-remote
npm install && npm pack # 生成 dsh-sidebar-remote-<新版本>.tgz
dsh plugin --profile web add ./dsh-sidebar-remote-<新版本>.tgz
# 核对已生效版本（profile 目录下）
grep '"version"' node_modules/dsh-sidebar-remote/package.json
0.2.x 之间插件 id、设置命名空间与 cordis.patch.yml 挂载方式均未变化，覆盖安装 + 重启即可，无需任何迁移。
远程语义
| 功能 | 远端实现 |
|---|
| 文件树 / 浏览 | SFTP readdir + stat 探测 |
| 读取 / 编辑 / 保存 | Sftp.readText → applyLiteralEdit → writeFileAtomic |
| 上传 / 下载 | Sftp.createWriteStream / createReadStream，失败清理 |
| 预览 | /sidebar/remote/html/<sid>/<path> + 相对资源同路由 |
| 终端 | SshConn.shell PTY，30s 重连优雅期 |
| Git | git -C <cwd> --no-pager -c color.ui=false 经 SshConn.exec |
本地会话零回归：不建立 SSH 连接，沿用原 dsh-better-sidebar 行为。
换机部署
不需要重新构建。客户端在挂载时向 GET /sidebar/remote/root 取回权威占位根，一份 bundle 可服务任意部署。
迁移 ~/.dsh/settings.yaml 即可带走主机配置与侧边栏偏好；私钥 / known_hosts 不自动迁移，新设备上手动复制 ~/.ssh/* 或走 TOFU 对话重建。
验证
npm install
npm run typecheck
npm test # 102 tests / 14 suites，无需网络与远端主机
npm run build
npm pack --dry-run
真机端到端：
DSH_ORIGIN=http://127.0.0.1:3080 \
DSH_HOST_ID=<settings.yaml 里的主机 id> \
DSH_REMOTE_PATH=/path/on/remote \
DSH_EXPECT_ENTRY=<该目录下必然存在的名字> \
npm run verify:live # 14 项断言
依赖
| 组件 | 版本 |
|---|
| DSH | 0.1.1-rc.2（Cordis ^4.0.1） |
dsh-better-sidebar | 0.17.1 |
@dsh-ssh/dsh-ssh | 0.1.3 |
| Node | >=22 |
详细架构设计与接口差距分析见 docs/。
提示词路径改写(sandbox:policy)
远程会话的 cwd 是占位符路径(<remoteRoot>/<hostId>/<base64url(remoteCwd)>),DSH core 会把它原样嵌入模型提示词的 sandbox:policy context。自 0.2.1 起,插件在组装期把占位符改写回真实远程路径:
- 主路径:经
deepseek-harness-zh_pro 的 registerAssembleRewriter 注册「assemble 返回后」改写器(与上下文中文化同流水线,运行于翻译之后);该包缺失时回退为直接包装 systemPrompt.assemble。
- 兜底路径:
agent/pre-step 监听器(prepend: true)对 decision.messages 做同样替换。
- 替换映射由
remoteCwdMapOf() 构建:host 端 ctx.sessions.list() 返回活会话数组(不是客户端 getSnapshot() 的 { byId } 形状,两者均兼容),占位符 cwd 经 routeByCwd() 映射为真实 remoteCwd。
验证:远程会话对话的上下文注入中 sandbox:policy 显示真实远程路径(如 /home/ubuntu/MedFluent),Host 日志输出 rewriter: replaced "<占位符>" → "<真实路径>"。
