dsh-remote-file-system
模型可见的远程文件工具 read_remote、write_remote、edit_remote，经 ssh 读写远程主机文件。write_remote 只允许新建，绝无覆写分支；文件后端 RemoteFileSystem 不继承 FileSystem，仅借用 @deepseek-ai/dsh-fs 的类型词表与 FsError。标准可安装的 dsh host 插件。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-remote-file-system@0.1.0Remote File System 以 dsh-remote-file-system 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
模型可见的远程文件工具 read_remote、write_remote、edit_remote，经 ssh 读写远程主机文件。标准可安装的 dsh host 插件。
DSH 只有本地文件系统的读写能力，而读写远程文件只能用 PowerShell 再套 bash 的 ssh 命令，非常容易出错。这个插件提供了三条可在模型中直接调用的远程文件工具，读写远程文件无需再套 ssh 命令。并将兼容 dsh-edit-diff 和 dsh-write-rule-guard 的优化显示与规则检查。
| 工具 | 作用 | 关键语义 |
|---|---|---|
| read_remote | 读远端 UTF-8 文本，行号分页 | offset、limit、totalLines，与原生 read 一致 |
| write_remote | 远端新建文件 | 只允许新建，目标已存在即拒绝，绝无覆写分支 |
| edit_remote | 远端字面替换 | 唯一匹配，多现拒绝，未命中报错；支持 replace_all |
ssh 目标与远程路径合在一个 file_path 字段，沿用「别名:路径」前缀，别名取自 ~/.ssh/config：
wsl:~/x.md
myserver:/etc/hosts
只收绝对路径或 ~/ 开头；裸相对路径直接拒绝。
从 GitHub 安装：源码在 src/，lib/ 不入仓库，安装时 npm 会触发 prepare 脚本现场构建。
dsh plugin --profile web add github:better-er/dsh-remote-file-system
从 npm 安装：包内已含构建产物 lib/index.js，安装时不再构建。
dsh plugin --profile web add dsh-remote-file-system
两种方式装完都会自动挂载，重启 DSH web 后启用，无需手工编辑任何文件。
dsh plugin --profile web remove dsh-remote-file-system
彻底移除，重启 DSH web 后不再加载。
文件后端 RemoteFileSystem 刻意不继承 @deepseek-ai/dsh-fs 的 FileSystem 与 cordis Service，避免「继承即注册」污染会话 ctx.fs；只借用 dsh-fs 类型词表与 FsError。字节经 base64 再经 ssh 传输。
pnpm install # 装依赖，含 devDeps 类型与 esbuild
pnpm run build # esbuild 打包 host 半身到 lib/
pnpm run typecheck
node smoke/verify.mjs # 手动组装最小 cordis 组合，对 wsl 冒烟三工具
@deepseek-ai/dsh-fs、dsh-tools、dsh-system-prompt 版本 0.1.2-rc.1，@deepseek-ai/cordis 版本 4.0.2。构建必须把这些包 external，与 host 共享单一 cordis 与 dsh-fs 实例；否则双原型会让 instanceof FsError 与 Service 标识错位。