workspace-groups-remote/README_ZH.md

12 KiB
Raw Permalink Blame History

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 之下,不污染其它插件。

安装 / 迁移

  1. 从 profile 里移除旧的两个 bundle(workspace-groups-local 与 @zhangfengshun/dsh-remote-ssh)。
  2. 改装本包,并完全重启 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。

基本使用

  1. 点击工作区标题栏的「新建分组」,再把项目拖进去。
  2. 在项目或分组的 ⋯ 菜单中管理分组、外观和文件夹。
  3. 在项目的「文件夹…」弹窗中添加文件夹或选择默认根目录。

「新增总目录工作区」经确认后添加独立入口。旧工作区和会话仍在原处,不会迁移会话或删除旧入口。如果总目录创建成功但注册失败,提示会列出已创建的路径;保持名称和文件夹不变重试会复用经校验的链接。

解除 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。