Skip to content

dsh-linked-workspace

Verified

dsh-linked-workspace · v0.9.0 · MIT · Web UI

Linked local ⇄ remote workspaces and SSH-backed remote directories for DeepSeek Harness: theme-aware split editor, file-type icons, and an agent tool that edits remote files directly.

Install

dsh plugin add dsh-linked-workspace

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Creators

Readme

dsh-linked-workspace

简体中文 · English

把已经建立好的 SSH 连接变成 DeepSeek Harness 里的远程目录或联动工作区:

  • 远程目录:设置 → 连接 → 添加远程目录,选主机和远端目录,右侧栏即可只读浏览目录与文件;远程目录视图不允许编辑,需要编辑请创建联动工作区。
  • 联动工作区:左侧「添加工作区」(或设置 → 连接 → 添加联动工作区)把本地目录与远端目录配对。该本地目录会注册成真正的 DSH 工作区,里面的会话通过 linked_workspace 工具直接读取、编辑远端文件;远端服务器只需 SSH,不需要安装任何 DSH 插件。右侧栏的「联动工作区目录」同时展示远端树(上)与本地树(下)。

面向 DSH 0.2.1-rc.4;侧边栏页面依赖 dsh-better-sidebar(v0.24+)。没有它时插件仍会加载(设置页可用),但侧边栏入口不会出现。

功能

连接与设置(设置 → 连接)

  • SSH 主机来自 dsh-ssh-tunnel 的 SSH Manager(~/.dsh/ssh-tunnel/hosts.json),也支持 ~/.ssh/config;密码/私钥只在 Host 进程内使用,永不返回给页面或模型。
  • 远程目录列表:添加(选主机 + 浏览远端目录)、测试、打开、移除。
  • 联动工作区列表:本地 ⇄ 远端路径、镜像开关(默认关闭)、后台同步(归档到 .remote,显示文件数/体积进度,可取消)、移除(可选同时移除 DSH 工作区、删除 .local/.remote)。开启镜像后首次立即检查,之后每 5 分钟自动比较远端与 .remote:下载新增/变更文件、删除远端已不存在的镜像文件、跳过未变更文件(.local/mirror-manifest.json),并排除 .git/node_modules/缓存目录;关闭镜像时允许两侧存在版本和文件差异。
  • 编辑器主题:显示模式分 系统 / 浅色 / 深色(默认系统:跟随 DSH 当前主题);指定主题为 9 张卡片(GitHub、Solarized、One、Dracula、Monokai、Nord、VS Code、Xcode、Catppuccin),每张卡同时包含浅色/深色版本,预览随模式卡选择实时切换。
  • 添加远程目录 / 添加联动工作区共用同一个表单,可在两处入口使用。
  • 文件打开方式(编辑器 / 系统默认应用 / 复制路径)由右侧栏工具栏的「打开选项菜单」切换并持久化。

左侧「添加工作区」

插件接管了 DSH 侧边栏/空白会话的目录选择 hole,弹窗提供两种模式:

  1. 本地工作区:填写或浏览本地目录(Windows 支持 C:/D:/E: 等盘符),填写工作区名称后创建普通 DSH 工作区。
  2. 远程联动:SSH 主机 + 远端目录 + 本地目录 + 镜像开关,创建后本地目录成为 DSH 工作区。

左侧工作区行不再带 ⇄ 标题前缀:插件用一份按 data-row-key 定位的样式表,把联动工作区行的宿主文件夹图标替换成链环图标(普通本地工作区不受影响)。这是对宿主行结构的唯一 DOM 级适配;如果 DSH 以后更改行结构,选择器会自然失配并回退到原来的文件夹图标,不破坏其他功能。

文档创建与编辑

文件内容面板现在支持 Markdown / PDF / DOCX / XLSX / PPTX(本地与远程文件均可):

  • Markdown:原始文本编辑、渲染预览、导出 PDF。
  • DOCX:按段落与表格编辑文字;保留段落样式,复杂行内格式可能被简化。
  • XLSX:工作表切换与单元格网格编辑;未修改的公式与样式保留。
  • PPTX:幻灯片切换与文本框编辑。
  • PDF:翻页、旋转/删除页面、编辑标题/作者元数据;页面由 PyMuPDF 渲染。
  • 在目录右键「新建文件」中输入支持的扩展名即可创建对应空白文档。
  • Office/PDF 操作需要 Python 3 及 python-docx、openpyxl、python-pptx、PyMuPDF;Markdown 不依赖 Python。可通过 DSH_OFFICE_PYTHON 指定解释器。

右侧栏入口

  • 联动工作区目录:只在联动工作区的会话中出现;点开后绑定该会话对应的联动工作区(不会打开另一个联动工作区),可编辑远程与本地文件。
  • 远程目录:只要设置 → 连接中至少添加了一个远程目录,任何工作区会话都能打开;只读浏览目录与文件,不允许编辑、传输、重命名或删除。
  • 两种入口都由右侧栏开始页的 + 菜单进入;非联动会话不会出现联动工作区目录选项。

右侧栏「联动工作区目录」

  • 面板固定在右侧栏最右边:上方远程目录树,下方本地目录树,两棵树根部都显示「所有文件」;本地树自动隐藏插件的 .local/.remote 内部目录。
  • 单击打开,双击固定:单击文件夹立即展开/折叠;单击文件直接在文件内容面板打开,再次单击其他文件会替换当前未固定的预览标签。双击文件可固定该标签,之后单击其他文件不会覆盖它;双击文件夹只保持展开。目录面板固定在最右侧,始终可见。
  • 面板布局:目录树是右侧固定面板(带工具栏按钮开/关,不再是标签页);会话面板与目录面板之间是文件内容面板,没有打开文件时显示「打开文件 / 从工作区目录树中选择文件」占位。
  • 工具栏(右键栏右上角):
    • 切换文件树:所有文件 / 已更改的文件 / 所有更改。更改列表来自远端与本地的 git status(分支、状态、暂存标记;删除项置灰)。
    • 在文件中搜索:搜索框输入 ≥2 个字符后,远端用 find、本地用目录遍历按文件名过滤,结果分「远程目录 / 本地目录」列出。
    • 打开选项菜单:编辑器 / 系统默认应用(把远端文件下载到临时目录后交给本机应用打开)/ 复制路径。
    • 传输按钮(双向):选中远端文件/文件夹时传输到本地 .remote;选中本地文件/文件夹时传输到远端对应相对路径(进入传输队列,一次一个任务并显示状态)。
    • 打开终端:远程按钮位于远程目录树右上角,打开本机终端并用系统 ssh 直接进入当前远程目录;联动工作区还会显示本地按钮,直接打开本地目录。远程终端首次连接可能需要确认主机指纹或输入密码。
    • 显示/隐藏隐藏文件:同时约束远程目录和本地目录;打开目录时默认显示隐藏项(包括 .local/.remote),可用按钮隐藏。
    • 刷新:重新拉取根目录、git 状态与搜索。
  • 不同文件类型使用不同彩色图标(JS/TS/Python/JSON/Markdown/Shell/YAML/图片/压缩包/配置文件等)。
  • 编辑器:行号、语法高亮(叠层渲染)、主题配色、Ctrl/Cmd+S 保存、冲突提示(重新加载/强制保存)、二进制与 >2 MB 文件只读保护、UTF-8/LF/CRLF/行数状态栏;内嵌内容面板不显示文件路径/保存工具条,未保存修改在文件标签前显示灰点。
  • 图片、CSV 与网页预览:PNG/JPG/GIF/WebP/BMP/ICO/AVIF/SVG 直接在内容面板按图片显示(最大 24 MB),支持按钮缩放、Ctrl/Cmd + 滚轮 缩放、适应窗口和 1:1 原始大小;CSV/TSV 默认按表格显示,可在「表格 / 源码」间切换,源码视图仍可编辑保存。超过 1000 行或 80 列时只展示截断后的表格。HTML/HTM 文件以沙箱 iframe 渲染网页预览(脚本禁用)。
  • 快捷键:Ctrl/Cmd+S 保存当前文件;Ctrl/Cmd+W 关闭当前标签(未保存时提示保存/放弃/取消);Ctrl+Tab / Shift+Ctrl+Tab 切换标签;Ctrl/Cmd+B 显示/隐藏目录面板;Ctrl/Cmd+Shift+F 打开文件搜索。
  • 自动保存:设置 → 连接 →「编辑器行为」中开启;停止输入约 1 秒后自动保存。关闭时使用 Ctrl+S 手动保存;未保存文件关闭前会弹窗,不会静默丢弃。
  • 多个文件同时打开:文件内容面板内最多同时打开 12 个标签;单击文件打开预览标签并替换未固定的预览,双击固定标签,重复点击同一文件聚焦原标签;本地文件与远端文件共用内部编辑器,本地文件可编辑保存。

运行中图标 / 本地技能

  • 联动工作区下若有正在运行的会话(本地会话 turn 进行中),左侧工作区的链环图标会变成蓝色;刷新间隔约 5 秒。
  • 联动会话运行在本地目录,因此本机安装的技能(~/.dsh/skills、~/.agents/skills、<local>/.dsh/skills、<local>/.agents/skills)可直接使用,不需要安装到远程目录。模型可用 linked_skills 工具 list/read,提示词也会明确说明。

右键菜单(文件/文件夹/根节点)

传输(下载到 .remote)、下载到默认文件夹、队列、打开、用记事本编辑、复制、粘贴、复制路径、移动到…(只允许移动到同一棵本地树或同一棵远程树内的目录)、重命名、删除、更改权限、新建(文件夹/文件)、属性。远端操作走 SFTP;本地目录的同类操作走本机文件系统。传输队列一次执行一个任务并显示排队/传输中/完成/失败状态。

联动工作区结构

<local>/
  .local/            # 按需创建(镜像清单等)
    mirror-manifest.json
  .remote/           # 可选:远端文件镜像存档(读取/保存时自动归档,可手动全量同步)

会话中的模型工具 linked_workspace 支持: list(列出联动工作区)、info、list_dir、read、write、replace、stat、mkdir、rename、delete、sync(启动后台镜像任务)。 path 相对远端根目录(或根内绝对路径);写入原子化,可用 if_modified_since 做乐观并发控制;会话工作目录落在某个联动工作区时会自动解析,跨工作区可用 workspace 参数指定。

界面

设置 → 连接

联动工作区目录:上远程、下本地

点击文件在新标签页打开远端编辑器

安装

dsh plugin --profile "$DSH_PROFILE" add "file:$PWD/dsh-linked-workspace"

或在 DSH 里使用 plugin_manager 的 install_bundle,目标填本目录绝对路径。安装后重启 DSH 桌面应用(新 Host 插件在进程启动时加载;会话记录保留)。之后:

  1. 左下角「账号菜单」→ 设置 →「连接」;
  2. 或直接点左侧工作区的「添加工作区」,选「远程联动」。

从 0.2.x 升级

0.3.0 起插件改名为 dsh-linked-workspace。安装新包后,首次启动会把旧的 $DSH_HOME/remote-workspace 数据目录迁移到 $DSH_HOME/linked-workspace(远程目录、联动工作区、主题设置、已知主机指纹都会保留);随后卸载旧包 dsh-remote-workspace 即可。

已打开的旧右侧栏「远程目录」标签页会在刷新后自动恢复(插件保留了两个隐藏的旧 tab 类型别名),标签标题也会自动改成「联动工作区目录」,新开的标签使用新的 dsh-linked-workspace 类型。

0.9.0 变化

编辑器内查找替换、本地⇄远端对比、多选与拖拽,以及刷新行为修复(第三轮评审):

  • 编辑器查找/替换:Ctrl/Cmd + F 打开查找条,支持区分大小写、上一个/下一个、命中计数、替换与全部替换;命中超过 5000 处时计数显示 5000+,全部替换仍作用于全文(实测 6000 处全部替换)。
  • 在目录处打开终端:目录右键菜单新增「在此打开终端」;terminal.open 支持 path 参数(校验必须在该联动工作区内),直接在该目录启动 shell(实测为 ssh -t … "cd <目录> && exec bash -l")。
  • 路径选择器过滤:本地/远端目录选择器支持输入过滤已加载条目,无匹配时给出提示。
  • 本地与远端对比:新增 fs.compare,返回「仅本地 / 仅远端 / 大小或时间不同(mtime 差 >2 秒)」三组,单次最多 4000 个文件、深度 12、每组最多 200 行并带 truncated 标记;对话框按组列出,点行可直接打开。
  • 树多选与批量操作:Ctrl/Cmd 点击切换选中、Shift 点击追加;右键菜单出现「传输所选的 N 项」「删除所选的 N 项」并弹确认框,逐项失败会聚合提示(外部已删除的文件会报「路径不存在」,其余照常删除)。
  • 拖拽:可在本地/远端两棵树之间拖动文件(远端文件走 fs.pullToLocal,本地文件走 fs.upload),也可把系统文件拖进任一树(fs.upload / local.import,最多 50 个、单个 64 MB)。浏览器不暴露文件路径、或把远端目录拖到本地树时会给出明确提示,不再静默失败。
  • 刷新节流:4 秒定时器改为每个目录最多 15 秒刷新一次,页面隐藏时暂停(实测间隔 18–19 秒),大目录不再每个 tick 都重列。
  • 未保存拦截:有未保存改动时注册 beforeunload,刷新/关闭窗口会弹确认。
  • 刷新保留已加载行:静默刷新把第一页与已加载行合并,不再截回 500(或 5000);5500 项目录在多个刷新周期后仍保持 5522 行。
  • 搜索截断提示:超过 200 条时显示「结果过多,仅显示前 200 条」。
  • 加载更多与计数修正:全部加载后「加载更多(剩余 0 项)」不再残留;查找计数满 5000 时显示 5000+,不再假装全文只有 5000 处。
  • 复核说明:上一轮报告的两项(右侧栏树无右键菜单、切换隐藏文件后不刷新)复测未能复现,本轮未改动。

0.8.3 变化

针对 0.8.2 分页与预览的后续修复(第二轮评审):

  • 文档预览同时删除内联 style,position:fixed 全屏覆盖层不再能把整页伪装成登录页(点击劫持/钓鱼面)。
  • 目录树刷新(本地树每 4 秒)只重取已加载的条目数,不再把「加载更多」的结果打回第一页。
  • 含隐藏文件时「加载更多」用服务端真实偏移,条目不再重复或遗漏;「剩余 N 项」按真实偏移计算。
  • fs.list 增加 5 秒列表缓存:翻页只读一次目录;写、建、改名、移动、删除、复制、传输后立即失效。
  • 目录复制中途失败会清理已复制的半成品并返回 FS_INCOMPLETE(原 FS_TOO_LARGE 只用于真实超限)。
  • 并发首次连接按「主机 + 地址」复用,主地址变化时不再把旧连接交给新地址请求,被替换的连接会释放。
  • 右侧栏树的数据源增加请求去重,重复加载不再重复发请求。
  • 目录选择器最多渲染 500 项并提示可直接输入路径;导出 PDF 的同名后缀最多尝试 999 次,超限报错而不是无限循环。
  • 测试:修复 test/host-api.mjs 自身两处断言缺陷(重复创建文件夹残留、把已存在当 400),全套 28 步通过。

0.8.2 变化

安全、数据完整性与大目录体验修复(三日评审轮):

  • 文档预览净化器先归一控制字符/空白/零宽字符再判 scheme,jav\tascript:、vbscript:、file:、data:text/html 不再可执行;只保留 http(s)/mailto/tel、相对链接与位图 data:image。
  • Windows junction 不再能绕过 .remote 包含性校验(改用 realpathSync.native);链接目录只删链接本身。
  • 远端复制 >64 MB 或读取不完整时直接报错,不再静默写入截断副本;工具读文件只在未截断时同步到 .remote。
  • local.read 只读取所需头部,不再把超大文件整体读入内存。
  • 工具 delete 可递归删除非空远端目录。
  • 目录列表分页(默认 500、最大 5000,返回 total/hasMore),树底「加载更多」;2 万项目录不再卡死。
  • 同步深度超限会标记为截断,不再把漏文件当成功。
  • 可访问性::focus-visible 焦点环、树行 treeitem/aria-level/aria-expanded、←/→ 折叠展开、添加工作区弹窗聚焦首字段 + Tab 循环 + Esc 关闭。
  • Excel 预览返回 totalRow/totalCol/truncated,并提示「仅显示前 200 行 × 40 列」「仅显示前 20 个工作表」。
  • 客户端构建缺 src/parts/* 文件时直接失败;移除 linked.update 死分支;HostPool 并发首连复用同一连接。

0.5.11 变化

远程目录的只读文件现在能看到代码内容;设置里「打开工作区」会跳转并关闭设置,远程目录「打开」会打开对应远程标签。

0.5.10 变化

本地工作区页签改为「输入框 + 浏览…」再展开目录选择;设置→连接移除「打开右侧栏」按钮。

0.5.9 变化

添加工作区弹窗的联动表单改用底部「取消 + 创建」;设置里的「创建联动工作区」表单标题/按钮同步,远程目录按钮改为「添加」。

0.5.8 变化

添加表单标题随类型显示「添加联动工作区」/「添加远程目录」;Ctrl+O/添加工作区的「本地工作区」页签提供本地目录 + 工作区名称两项并可创建普通本地工作区。

0.5.7 变化

点击“添加联动工作区”时表单锁定为联动模式,不再显示远程目录切换;点击“添加远程目录”时锁定为远程模式、不再显示联动切换和“工作区名称”字段。

0.5.6 变化

文案改为「直接浏览远端目录(只读)」;传输按钮支持远程→本地 .remote 与本地→远程双向;创建联动工作区不再强制生成 .local;本地路径选择器支持 C/D/E 等所有盘符;修复远程面包屑双斜杠。

0.5.5 变化

联动工作区目录只在联动会话出现并绑定当前工作区;远程目录成为独立的只读标签,任何会话只要配置了远程目录即可打开;空远程目录提示改为「还没有远程目录」。

0.5.4 变化

打开目录默认显示隐藏文件、目录面板默认开启;内嵌文件标签不再显示图标;去掉内容面板的路径/保存头部,未保存修改以灰点显示在标签前。

0.5.3 变化

主题改为 9 个主题家族(同名主题一张卡,浅/深版本随模式预览);右侧栏改为「文件内容面板 + 最右侧目录面板」布局,目录面板有开关、不再占标签页;本地文件可在内容面板内直接编辑(local.read/local.write),本地标签不显示图标。

0.5.2 变化

本地树的隐藏文件开关同时控制 .local/.remote;目录行改为单击选中、双击展开/打开,文件以后台标签打开且面板保持目录;主题模式卡与主题卡增加浅色/深色预览和标注;设置页「添加联动工作区」移到「添加远程目录」前面。

0.5.1 变化

编辑器主题改为 系统/浅色/深色 三模式(默认系统);联动工作区有运行中会话时链环图标变蓝;新增 linked_skills 本地技能桥与 skills.list/read API,联动会话直接使用本机技能,不需要装到远端。

0.5.0 变化

默认 GitHub 浅色主题;镜像同步默认关闭,开启后每 5 分钟自动检查远端与 .remote 差异;右侧栏新增传输按钮、显示/隐藏隐藏文件、右键菜单(传输/下载/记事本/复制粘贴/重命名/删除/权限/新建/属性)与传输队列;多个远端文件可同时以独立标签页打开。详见 CHANGELOG.md。

发布与市场更新

  • npm 包名 dsh-linked-workspace;发布新版本只需提升 package.json 的 version,然后推送 v* 标签。仓库内的 .github/workflows/release.yml 会在标签推送时自动执行 npm publish --access public(需要在 GitHub 仓库 Secrets 中配置 NPM_TOKEN)。
  • awesome-dsh-plugin(DSH 社区插件市场)读取 npm 的 latest 版本与仓库元数据;已收录后的版本升级会自动反映,无需重新提交条目。本仓库保留了可直接提交的 market/awesome-dsh-plugin-entry.yml。
  • dsh-plugin.org(DSH Plugin Hub)会定期扫描带 dsh-plugin topic 的公开仓库并读取 npm 包;发布新版本后同样自动刷新,无需重新登记。
  • 发布前可本地执行 npm run build && npm pack --dry-run 检查包内容。

安全

  • 凭据只存在于 Host 进程;API 只返回主机名、地址和工作区路径。
  • 主机指纹 TOFU:首次连接记录 SHA256,变化即拒绝。
  • 直接远程目录的读写限制在该目录内;联动工作区的工具限制在远端根目录内。
  • 单文件保存上限 8 MB;镜像同步在后台执行,默认最多 500 文件 / 50 MB(跳过超大文件),默认排除 .git/node_modules/各类缓存目录,单文件读取 30 s 超时,不再阻塞 HTTP 请求。右键「传输」与「下载到默认文件夹」单次最多 150 文件 / 15 MB(超限会提示未全部传输)。
  • 页面 HTTP API 只接受本机回环同源请求(远程部署时回落到 DSH connection 服务的 Host/Origin 鉴权)。

架构与开发

Client (浏览器)                          Host (DSH 进程)
设置→连接 / 右侧栏双树工作台 / 目录选择弹窗  →  POST /dsh-linked-workspace/api
主题 + 高亮 + 文件图标(src/parts/*)      工作区注册表 + 联动注册表 + SSH 连接池
  • lib/index.js — Host API、连接池、联动工作区、linked_workspace 工具、提示词段。
  • lib/ssh.js — SSH/SFTP、远端命令执行(exec)、主机发现、TOFU 指纹。
  • lib/git.js — 远端/本地 git status(porcelain 解析)与文件名搜索。
  • lib/linked.js — 联动工作区持久化、.local/.remote 布局、镜像读写。
  • src/client.js + src/parts/* → scripts/build-client.mjs → lib/client.js(单文件浏览器 bundle)。
  • docs/API.md — API 契约;docs/VERIFY.md — 手测清单。
node scripts/build-client.mjs       # 重新生成 lib/client.js
node --check lib/index.js lib/ssh.js lib/linked.js
node test/linked.test.mjs           # 联动文件系统单测(node --test)
node test/parts.test.mjs            # 主题/高亮/图标单测
node test/client-smoke.mjs          # 客户端 bundle 注册自检
node test/git.test.mjs              # 远端/本地 git 状态与搜索(含真实 SSH 只读检查)
node test/ssh-smoke.mjs             # 真实 SSH 传输自检
node test/host-api.mjs              # 真实 SSH 下的完整 Host API(21 步,含后台同步与右键操作)

License

MIT © 2026 Huangjh