← 返回列表
⚠ 装前注意
DeepSeek Harness Web GUI 的多根工作区插件：给 DSH…
基本兼容但装前注意：未发布到 npm registry，仅可从源码安装 · 最近上游提交 2026/8/16 · 已提供中文文档
综合分
32
GitHub 分
32
用户评分
—
★ Stars
1
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add luoyu-xingu/dsh-multi-root未发布到 npm registry，仅可从源码安装，改用 GitHub 源安装
信任档位：已验证本站已于 2 天前真实安装成功（L4 · 真实安装）
- 是什么
- dsh 原生插件 · tool
- 装得上吗
- 本站已真实安装成功（L4 · 真实安装，非静态推断）
- 安全吗
- 本站尚未对该插件做风险分级（暂未覆盖，不等同于无风险）
- 还在维护吗
- 更新放缓：最近一次提交在 40 天前
档位由下列信号合成：本站实装验证（真实安装，当前最高到 L4）· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →
🟢实装验证通过· 2026/9/23
由本站实装验证器在真实 dsh 环境安装成功，非静态推断。
数据截至 2026/9/23（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
安装兼容性检查⚠ 装前注意
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。
✗npm 包@luoyu_xingu/dsh-multi-root（未发布到 npm，仅可源码安装）
✓Node 引擎要求 ^22.19.0 || >=24.0.0 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明
未发布到 npm registry，仅可从源码安装
验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/23 08:30:54
依赖的 DSH / Cordis 模块
@deepseek-ai/cordis@deepseek-ai/dsh-client-locale@deepseek-ai/dsh-client-runtime@deepseek-ai/dsh-client-ui-slots@deepseek-ai/dsh-host-webserver@deepseek-ai/dsh-llm@deepseek-ai/dsh-system-prompt@deepseek-ai/dsh-tools用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
由 DeepSeek 最新模型翻译生成dsh-multi-root DeepSeek Harness Web GUI 的多根工作区插件：给 DSH 挂载多个独立文件夹，在侧边栏面板中统一管理，并让 agent 通过受控的宿主侧工具跨所有已登记根目录做列举 / 读取 / 写入 / glob——相当于 VS Code 多根工作区之于 DSH。 所有根一律平等：没有主工作区之分，根集合对所有会话与 agent 全局共享。 以 cordis profile bundle 形式热插拔安装，不改任何 DSH 源码。 能力 - 侧边栏入口 多根（Roots），在中间列打开管理面板。 - 挂载任意数量的文件夹（路径输入或宿主目录浏览器；Windows 上浏览从 盘符级开始——先选 C:、D:… 再逐级进入；Linux/macOS 从家目录开始， 可沿「上一级」直达文件系统根 /），可选显示别名。 - 支持重命名、移除、排序；每行显示目录实时状态（可用 / 目录缺失）。 - 根目录持久化在 ~/.dsh/dsh-multi-root.json（目录 0700、文件 0600、 原子写入）——GUI 与 agent 共享同一份配置。 - 注册进 DSH 工具链的 agent 工具： | 工具 | 用途 | | --- | --- | | workspace_roots | 列出全部已挂载根（id、名称、路径、状态）。 | | workspace_root_list | 列举某根目录内的一个目录。 | | workspace_root_read | 读取某根目录内的文本文件（256 KB 上限，截断会报告）。 | | workspace_root_write | 在某根目录内写入（新建或覆盖）文本文件，自动创建父目录。 | | workspace_root_glob | 在某根目录内做 glob 匹配（结果有数量上限）。 | - 系统提示词段落向每个 agent 宣告插件与工具（announceToAgent: false 可关闭；enabled 为总开关）。 - 双语界面文案（中 / 英），跟随文档语言。 安装与启动 插件是 cordis bundle 包，在 web profile 中激活。二选一获取，然后按下述 方式启动 GUI。 方式一：npm 安装（发布后的正式版本——任意平台，推荐） 1. 安装插件到 web profile（底层是 pnpm 语义） dsh plugin --profile web add @luoyu_xingu/dsh-multi-root 2. 启动 web GUI（Ctrl+C 停止；--port 可改端口） dsh web 在浏览器打开 dsh web 打印的地址（默认 http://127.0.0.1:3080）。侧边栏 出现 多根（Roots）入口，点击即可挂载文件夹。可用 dsh plugin --profile web ls @luoyu_xingu/dsh-multi-root 验证安装。 后续升级： dsh plugin --profile web update @luoyu_xingu/dsh-multi-root dsh web # 重启 卸载： dsh plugin --profile web remove @luoyu_xingu/dsh-multi-root 方式二：源码下载（clone 本仓库） git clone https://github.com/luoyu-xingu/dsh-multi-root.git cd dsh-multi-root pnpm install pnpm build # 类型检查 + 产出 lib/（宿主半区 + 客户端 bundle） 把本地 checkout 安装进 web profile；file: 安装为自包含拷贝 （无 junction 外链，node_modules 里不保留绝对路径） dsh plugin --profile web add file: Windows 示例：dsh plugin --profile web add file:E:/dsh_plugins/dsh-multi-root dsh web 改代码后重新部署——构建 → 把新 lib/ 同步进 profile 的自包含拷贝 → 重启： pnpm build PowerShell： Copy-Item lib\* $env:USERPROFILE\.dsh\profiles\web\node_modules\@luoyu_xingu\dsh-multi-root\lib\ -Recurse -Force bash： cp -r lib/* ~/.dsh/profiles/web/node_modules/@luoyu_xingu/dsh-multi-root/lib/ dsh web # 重启 安装或每次重新构建后都需重启 dsh web——web profile 禁用了 cordis HMR 服务，文件变更不会热加载；宿主还会按启动时的文件哈希校验 bundle rev，旧进程 对旧 rev 返回 404（bundle script ... failed to load）。 使用 1. 点击侧边栏 多根 入口。 2. 用路径输入或「浏览」对话框挂载文件夹（Windows 上先选盘符），可给每个 根起别名。 3. 让 agent 跨文件夹工作——它会用 workspace_roots 发现根，再用其余 workspace_root_ 工具在根内操作。 安全模型 本插件有意绕过 DSH 文件沙箱：其操作以宿主进程权限运行。因此信任边界 就是根目录集合本身，且每次操作都会强制执行： - 根目录只能是用户在 GUI 中挂载的目录；agent 永远不能自行挂载或移除。 - 所有路径以根相对方式拼接，经 fs.realpath 规范化，并要求落在已登记根 目录内部。路径穿越（..、绝对路径、盘符）与符号链接逃逸在读取和写入 （写入还会校验解析后的父目录）时都会被拒绝。 - glob 从不跟随符号链接；后续若用匹配结果做读写，读写门会再次校验。 - 读取上限 256 KB、写入上限 5 MB、列举上限 500 项、glob 结果上限 1000 项—— 模型输出保持有界。 - 所有 /api/dsh-multi-root/ 路由仅限 loopback 并带浏览器同源标记， LAN 暴露的部署无法访问。 - 配置文件不含密钥，但仍以 0600 权限原子写入。 已知限制：工具以宿主用户权限运行、消耗真实磁盘——覆盖已存在文件前先向用户 确认。目录浏览器会列出宿主目录（这是选择器的数据源，本身仅限 loopback）。 配置 宿主插件接受 schemastery 校验的配置（组合入口）： multi-root: enabled: true # 路由、工具、提示词段落的总开关 announceToAgent: true # 向 agent 宣告插件的系统提示词段落 hotReload: true # 宿主半区监听自身 lib/，构建后原位重挂载 开发 pnpm install pnpm typecheck # tsc -b（host/client 两个 program）+ 测试 program pnpm test # vitest run（store / fs-ops / tools / client 冒烟） pnpm build # 声明产物 + tsdown（lib/ 宿主半区 + lib/client.js） 结构：src/index.ts 为宿主半区（存储、路由、工具、提示词段落）， src/client/ 为浏览器半区（侧边栏入口、面板），src/core/ 为共享类型。 客户端 bundle 是面向 GUI __ModuleLoader__ 的 closure-factory 产物，并带 构建期纯度门（仅平台种子模块可保持 external）。 License MIT