dsh-plugin-uw

> 联合工作区插件 — 将多个目录合并到一个会话中，让 AI 助手同时访问所有成员目录。

[English](./README.en.md) | 中文

  

---

解决什么问题

做前后端联调的时候，代码通常散落在好几个仓库里——前端、后端、公共类型定义各在各的目录。AI 要完成一次跨端修改，得同时看到并修改所有这些目录的文件。

只挂一个目录，AI 看不到别的仓库，跨端任务根本做不了。挂一个大目录（比如整个主目录）呢，又得承受上下文爆炸的代价：工具扫描和文件检索扩散到无数无关文件里，既浪费 token、又降低回答质量，还给了远超实际需要的目录权限。

联合工作区让你把恰好需要的几个目录合并进一个会话。AI 同时访问所有成员目录，但范围始终精确可控——它只看到你选定的目录，看不到范围外的任何文件。

简介

dsh-plugin-uw（联合工作区插件）允许你在 DSH Web GUI 中将多个目录合并到一个会话中。一个主目录（primary）加一个或多个成员目录（members）组成一个联合工作区（union workspace），AI 助手可以同时访问所有成员目录的文件。

截图

功能

• 联合工作区 — 将两个或更多目录组合到一个会话中，AI 助手可同时访问所有成员目录。
• 两种权限预设：

• 侧边栏集成 — 点击侧边栏底部的 ⛓ 图标打开管理面板。
• 管理面板 — 侧边栏右侧面板，两个标签页：

- 工作区：创建、删除、修改联合工作区，以及成员目录管理。 - 文件浏览：以树形结构浏览成员目录（懒加载，支持递归展开）。

• 快速升级 — 已有会话可通过 /uw 命令升级为联合工作区，或从会话头部按钮打开创建面板。
• 持久化存储 — 联合工作区定义保存在 ~/.dsh/union-workspaces.json，重启后依然有效。
• 自动匹配 — 在侧边栏打开的工作区如果标题匹配某个联合工作区，自动标记为该联合工作区。
• 成员目录工具 — 注册了 uw_read、uw_write、uw_edit、uw_delete、uw_move 五个工具，AI 助手可直接通过成员目录路径读写、删除、移动文件，不受沙箱限制。所有成员目录均可读写、删除、移动。
• @ 提及 — 聊天框输入 @ 会自动搜索所有成员目录的文件，方便快速引用。

安装

通过 DSH 插件命令安装

# 从 GitHub 安装
dsh plugin add github:lcgash/dsh-plugin-uw

# 或指定 profile 安装（将 <name> 替换为你的 profile 名称）
dsh plugin --profile <name> add github:lcgash/dsh-plugin-uw

从 npm 安装

# 全局安装
npm install -g dsh-union-workspace

# 或安装到 DSH profile（将 <name> 替换为你的 profile 名称）
dsh plugin --profile <name> add dsh-union-workspace

从源码安装

# 克隆仓库
git clone https://github.com/lcgash/dsh-plugin-uw.git
cd dsh-plugin-uw

# 安装依赖
npm install

# 构建
npm run build

# 安装到 DSH profile（将 <name> 替换为你的 profile 名称）
dsh plugin --profile <name> add link:$(pwd)

安装后，在 cordis.patch.yml 中应包含以下插件行：

- insert:
    - id: union-workspace
      name: 'dsh-union-workspace'

使用

1. 在侧边栏底部点击 ⛓ 图标，或输入 /uw 命令。 2. 选择创建模式： - 快速模式：选择多个目录，自动生成名称。 - 自定义模式：设置名称、选择成员目录、选择权限预设。 3. 创建成功后，在侧边栏会出现对应的工作区。 4. 点击侧边栏的工作区，打开的新会话会自动应用联合工作区。 5. 在会话头部右侧点击 ⛓ 按钮，展开成员目录文件列表面板。 6. AI 助手可通过 uw_read / uw_write / uw_edit / uw_delete / uw_move 工具直接读写、删除、移动成员目录中的文件（标准 read / write / edit 工具受沙箱限制只能访问主目录）。

开发

# 构建
npm run build

# 类型检查
npm run typecheck

架构

• Host 端（src/index.ts）— 运行在 DSH Node.js 进程中，持有联合工作区存储（~/.dsh/union-workspaces.json），提供 /api/dsh-union-workspace/* 路由，并在会话启动时应用权限预设。
• Client 端（src/client/index.ts）— 运行在 Web GUI 中，注册本地化字典、设置页面、会话头部按钮、/uw 命令，并通过 DOM 注入挂载覆盖层和文件面板。
• 路由（src/routes.ts）— REST API 端点，用于列出、同步、标记和浏览联合工作区。
• 工具（src/tools.ts）— 注册 uw_read、uw_write、uw_edit 三个模型工具，用于读写成员目录文件，绕过沙箱的单根限制。
• 存储（src/store.ts）— 基于文件的持久化存储，支持数据清洗和迁移。

License

Apache-2.0