DeepSeek Harness 插件

dsh-session-roots

DSH plugin (pure, no core changes): a session may write several project folders declared by a VS Code-style workspace file beside its cwd; the web half adds 'Open Workspace from File' and 'Add Folder(英文原文)

跳到安装方式

来源信息

GitHub 仓库
yan4342/dsh-session-roots
最近更新
2026年8月16日
分类
工具与能力
GitHub stars
0
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/yan4342/dsh-session-roots
插件名:dsh-session-roots
作者:yan4342

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器2 个文件
README.md来源说明 · 只读预览

dsh-session-roots

让一个 DSH 会话同时可写多个项目文件夹。项目集由一个工作区文件声明——直接复用 VS Code 的多根工作区格式(*.code-workspace),支持现有 VS Code 工作区文件拿来即用。

特性

  • 多根可写:会话可写文件夹 = 会话目录 + 工作区文件声明的文件夹。fs 工具全平台支持;shell 工具(Windows 上 bash/pwsh)同样支持
  • 侧边栏新增两个入口

- 从文件打开工作区添加工作区 按钮菜单里选择任意 .code-workspace,其所在目录注册为一个工作区(命名 = 目录名) ![alt text](assets/从文件打开工作区.png) - 将文件夹添加到工作区:工作区行 菜单里把任意文件夹加进工作区 ![alt text](assets/将文件夹添加到工作区.png)

  • 权限自动跟随:工作区文件增删文件夹、会话结束、卸载插件,shell 写入权限自动同步增删,不留残留

安装

任选一种方式,装完重启 dsh web 并硬刷新浏览器(Ctrl+Shift+R)。安装即用,无需手改任何配置文件。

方式一:git clone + 本地安装(当前可用)

git clone <仓库地址> dsh-session-roots
dsh plugin --profile web add file:D:/你克隆到的路径/dsh-session-roots

> file: 必须写绝对路径(相对路径会被拒绝)。

方式二:GitHub 直接安装(推荐)

无需 clone,直接从 GitHub 拉取:

dsh plugin --profile web add https://github.com/yan4342/dsh-session-roots

> 仓库内即完整源码,无需本地构建(纯 JS,无编译步骤)。

使用

1. 声明工作区文件:放在会话目录下(优先级从高到低): - dsh-workspace.json(也可写成 { "source": "<绝对路径>" } 指向任意位置的 .code-workspace) - *.code-workspace(VS Code 格式,现有文件直接可用)

``json { "folders": [ { "path": "." }, { "path": "../legado-with-MD3" } ] } ``

相对路径按文件所在目录解析(与 VS Code 一致);缺失或非目录的条目自动跳过。改文件即改项目集,可随仓库提交。

2. 从文件打开工作区:侧边栏"工作区"标题栏点 + → "从文件打开工作区" → 选 .code-workspace → 该文件所在目录注册为一个工作区,命名 = 目录名(如 legado) 3. 将文件夹添加到工作区:工作区行 菜单 → "将文件夹添加到工作区" → 选目录 4. /workspace 随时查看

卸载

dsh plugin --profile web remove dsh-session-roots

重启 dsh web 生效。写入权限会自动清理;会话目录里的 dsh-workspace.json 不再生效,可自行保留或删除。

常见问题

  • 侧边栏插件列表里出现两个条目? 正常——一个是业务入口,一个是文件系统服务,装好即用,无需分别管理。
  • 从工作区文件删掉文件夹后,shell 还能写它吗? 不会,权限会立即撤销。
  • 进程被强杀(taskkill / 断电)后有权限残留? 极少数情况可能残留,用管理员执行 icacls <目录> /remove:g <SID> 清理(SID 见 icacls <目录> 输出里的 S-1-4-* 条目)。
  • 工作区文件放哪? 会话启动时的目录下。换目录就换项目集。

已知限制

  • shell 多根写入仅 Windows:Linux/macOS 的 shell 仍只认会话目录(fs 工具所有平台支持)
  • "从文件打开工作区"入口定位官方界面文案:官方改版后该入口可能回退为原生行为,不影响其他功能
  • 首次使用时打开文件夹选择器可能很慢:后续打开会正常。
  • 依赖 DSH 的接口:DSH 大版本升级后可能需要跟进

License

MIT