12 KiB
English · 简体中文
dsh-better-workspace-group
DeepSeek Harness 工作区分组插件。基于 z-col/dsh-workspace-groups 二次开发,让工作区、文件夹和会话在侧栏里更容易整理和使用。
合并包:workspace-groups-remote
本仓库已把两个 DSH 插件合并为一个可安装的 bundle(包名 workspace-groups-remote):
- workspace-groups(本仓库原有内容):侧边栏分组管理 + 会话标签条。宿主半边由
src/构建为lib/groups.js,客户端半边在src/client/groups-client.ts。 - @zhangfengshun/dsh-remote-ssh 2.4.45(MIT,© ZhangFengshun):原样收录于
vendor/dsh-remote-ssh/。其宿主半边不打包、以lib/remote-ssh/index.js文件形式发布——它必须从宿主模块表解析@deepseek-ai/schemastery(其 Config 依赖 DSH 分支 schemastery 的.volatile())。发布出的宿主文件带一组本地补丁,构建时由scripts/patch-remote-ssh.mjs打上,vendor 树保持原样(见下文「重复的远程文件夹」「安全加固」)。其客户端在上游是自注册的模块加载器 bundle,构建时由scripts/build-remote-ssh-client.mjs提取出工厂函数,由合并后的客户端入口(src/client/index.ts)与分组客户端一并应用。
重复的远程文件夹——本合并包已修复
上游的 createRemoteWorkspace 按 remotePath 原始字符串比对已有记录,同一个远程目录换个写法(~/proj 与 /home/u/proj 与 proj/)就会再注册一条工作区记录、一个本地镜像、一个原生工作区,界面上就是同一个远程项目出现两个文件夹行。本包分两层修复:
- 宿主侧(构建时补丁,
scripts/patch-remote-ssh.mjs):注册时先比轻度规范化后的写法;对不上时走一次 SSH 把路径解析成规范形式(pwd -P+$HOME)再比对,存入的也用规范写法。解析失败不拦创建(退回上游行为)。补丁行为由npm run test:patch覆盖;vendor 树保持原样,上游更新仍可直接替换。 - 客户端(分组侧):添加云端文件夹时,若已有成员由同一工作区支撑、或指向同一连接 + 同一远程目录,一律拒绝,不再只看镜像路径。
已经产生的重复不会自动合并(会话归属各自的工作区)。解除成员关联会保留其工作区;删除重复远程记录需要单独明确选择「连工作区一起删」,操作前请核对目标入口。
安全加固(同一组补丁)
2026-11-11 审查发现的问题,同样由构建时补丁修复,行为由 npm run test:patch 覆盖(含把生成的终端 wrapper 真跑起来的端到端用例):
- ssh 选项注入:所有内部连接都经
sshArgv构建,现已在user@host目标前插入--,以-开头的用户名/主机名(如-oProxyCommand=...,可经 remote_ssh 工具的内联参数到达)不再会被 ssh 当成选项在本机执行命令。终端 wrapper 自建的参数同样加了--。 - POSIX 密码传递:
sshpass -p(密码出现在进程列表里,同机所有用户可见)改为sshpass -e,密码走SSHPASS环境变量,与 Windows 侧口径一致。 - 终端 wrapper 的信任域:生成的
dsh-remote-shell原先认任意目录下的.remote-ssh.json且完全关闭主机密钥校验;现只认当前目录确为已注册镜像根(~/.dsh/remote-workspaces的直接子目录,正是宿主自己写标记的位置)时才自动连接,校验改为accept-new,且 remotePath 以 base64 编码传给远端 shell,目录名里的引号/$()只作数据、不再能逃逸成命令。 - 远端路径越界:
localToRemote现会先把./..段按字面折叠,..爬出镜像根的路径直接拒绝,不再把 fs 请求映射到远端工作区之外。 - 写回护栏 fail-closed:读不到工作区设置时本次不推送(并经
writeBackFailure通道报错),不再在护栏(writeBack/writeBackExclude)根本没被评估的情况下照推。
lib/index.js(源文件 bundle/index.js)只做组合:在同一 fiber 上加载两个插件。cordis.patch.yml 只插入一行,并原样保留 remote-ssh 对 better-sidebar / terminal-controller 的 shell 覆盖。
Remote-SSH 设置页(1.3.0)
设置页由本仓库可维护源码组件提供(src/client/rssh-settings/),构建期由 scripts/build-remote-ssh-client.mjs 按锚点断言替换上游编译产物中的设置小节,vendor 树保持原样。页面为「我的连接 / 添加连接 / 远程工作区 / 高级设置」四个分区;远程工作区与高级设置默认收起,折叠只改变可见性,不清空草稿、不触发保存,收起的高级设置不显示内部保存按钮。
- 我的连接:每卡独立测试(成功 / 成功带 warning / 失败与诊断分别显示),删除前卡内确认并明确连接名与影响范围。
- 添加连接:保留全部字段与条件显示(密钥显示私钥路径、密码显示遮罩输入并隐藏私钥路径),端口非法明确报错而不是静默回退 22;ProxyJump 收进默认收起的「更多连接选项」。
- 从系统 SSH 配置导入:多选弹窗,逐项检查保存结果,分别统计成功 / 失败,部分失败可只重试失败项(成功项不重复提交)。
- 远程工作区:每个工作区独立写回、写回排除、同步范围、同步排除与体积上限(GiB),按工作区 ID 保存;有未保存设置时拉取 / 推送会被阻止并提示先保存。
- 高级设置:终端 node 路径、写回策略与新工作区同步默认值;与工作区独立配置分开读写,互不覆盖。
新文案使用独立的 dsh-remote-ssh-settings 命名空间(中英文),样式限定在 .rsui-root 之下,不污染其它插件。
安装 / 迁移
- 从 profile 里移除旧的两个 bundle(
workspace-groups-local与@zhangfengshun/dsh-remote-ssh)。 - 改装本包,并完全重启 DSH。
已有数据不受影响:~/.dsh/workspace-groups.yaml 与 $DSH_HOME 下的 sidecar、dsh-remote-ssh 设置命名空间、~/.dsh/remote-ssh/ 都照常工作。若以前在 remote-ssh 的 bundle 行里写过配置,现在改为嵌套写法 config: { remoteSsh: { ... } }(连接配置本来就存在 DSH 设置里,不受影响)。
验证
npm install
npm run build
npm run verify:bundle # 对构建产物做组合检查(含 vendor 完整性指纹 + 客户端真执行冒烟)
npm run verify # 全套:tsc + vitest + verify:bundle + 补丁行为测试
vendor 里的上游测试也能原地跑(需先让其依赖可解析:在仓库根执行 ln -s ../../node_modules vendor/dsh-remote-ssh/node_modules,再在 vendor/dsh-remote-ssh 里运行 node tests/run-all.mjs)。已知的非 Windows 环境既存失败:分组插件有 6 个 folders 测试使用 C:\ 路径、remote-ssh 有几个套件假设 WSL / Windows 路径语义——在未合并的上游里同样失败,与合并无关。
已知取舍
- 加载耦合:两半作为一个包加载,任一半导入失败,整包(含分组)都会起不来。这是「只装一个包」的代价;要隔离失败域需要宿主支持按半懒加载,目前没有这个承诺。
- shell 覆盖对所有安装生效:合并包带着 remote-ssh 对
better-sidebar/terminal-controller的 shell 覆盖,装这个包等于同时接管 profile 的终端 shell 集成(镜像终端自动连接靠的就是它)。宿主补丁引擎在未来版本里遇到覆盖目标不存在时如何处理,未验证——已列入真机清单。 - 首次连接新 SSH 主机不做指纹确认(
accept-new,与 VS Code Remote-SSH 相同的默认):内部通道首次连接即信任主机密钥,之后密钥变化会大声失败。终端 wrapper 已由补丁从no提升到同一accept-new口径。
维护
vendor 代码不是 fork:更新 remote-ssh 时,把 vendor/dsh-remote-ssh/ 换成新版上游树,跑 npm run vendor:manifest 重新记录其 sha256 指纹清单,再重新构建;客户端提取脚本带锚点断言,上游若改了 bundle 包裹形式会直接报错。设置页替换同样带锚点断言:上游设置小节的结构一旦变化,构建会失败而不是静默沿用旧界面。vendor 之外的本地改动:src/client/GroupsBrowser.tsx 把可空 ref 的判断改成显式写法(pending !== null && ...),因为 fork 的 tsc 类型步骤不接受可选链写法,语义不变;以及上文的防重复成员检查(src/core/folders.ts、addRemoteFolderTo)。宿主补丁脚本同样带锚点断言,上游改动锚点代码时会直接报错。
预览
已实现的功能
- 工作区分组:按「分组 → 项目 → 会话」浏览,支持新建、重命名、删除、折叠和置顶分组。
- 拖拽整理:把项目拖入或移出分组,并调整分组、项目的显示顺序。
- 分组外观:设置分组颜色和图标;新增「材料与实验」图标分区,包含实验操作、材料结构、表征测试和功能器件图标。
- 一个项目多个文件夹:为项目添加额外文件夹、选择默认根目录,会话会按工作目录归入对应文件夹。
- 本地与远程目录:本地工作区和已注册的 SSH 远程工作区都可以创建文件夹;远程操作失败时不会误建到本地镜像。
- 会话标签栏:打开、切换、固定、重命名、拖动排序和关闭会话标签,支持关闭其他标签及右侧标签。
- 侧栏布局优化:默认工作区固定在底部;各行的数量、时间和操作按钮统一右对齐;外观弹窗内容可滚动。
- 搜索与保存:保留分组层级搜索会话,分组、排序、标签和文件夹设置都会保存,刷新或重启后仍然有效。
安装
Desktop 环境:
dsh plugin --profile desktop add github:newbieQQ/dsh-better-workspace-group
Web 环境将 desktop 改为 web。安装完成后,完全重启 DSH 或对应的 Web profile。
基本使用
- 点击工作区标题栏的「新建分组」,再把项目拖进去。
- 在项目或分组的
⋯菜单中管理分组、外观和文件夹。 - 在项目的「文件夹…」弹窗中添加文件夹或选择默认根目录。
「新增总目录工作区」经确认后添加独立入口。旧工作区和会话仍在原处,不会迁移会话或删除旧入口。如果总目录创建成功但注册失败,提示会列出已创建的路径;保持名称和文件夹不变重试会复用经校验的链接。
解除 member 文件夹关联会保留其工作区和会话,因此该工作区可能重新独立显示,即使它是空入口。侧栏和文件夹弹窗都先让用户确认此结果。不会根据侧栏会话数自动清理:既有记录无法可靠区分插件新建的 member 和用户独立注册的工作区。删除远程记录仍是单独的明确选择,会尝试清理未共用的本地镜像与注册;聊天文件及服务器上的原目录保留。
需要按路径或名称自动分组时,可参考 workspace-groups.example.yaml 配置 ~/.dsh/workspace-groups.yaml。不配置也不影响手动分组。
卸载
dsh plugin --profile desktop remove workspace-groups-local
致谢与许可
原项目由 zcol 开发并以 MIT 许可发布。本仓库在其基础上增加了材料与实验图标、底部默认工作区、统一行尾布局、远程工作区文件夹等功能。
原始作品 © 2026 zcol;本仓库修改 © 2026 newbieQQ。详见 LICENSE 和 NOTICE.md。