工作区侧边栏 yuhangkang/dsh-ide-sidebar

dsh-ide-sidebar

IDE 式工作区切换侧边栏插件（Web / 浏览器 GUI 客户端 bundle）

IDE-style workspace switcher sidebar for DSH (DeepSeek Harness).

将 DSH 默认侧边栏替换为 IDE 式工作区切换器：左上角悬浮下拉一键切换工作区，下方会话列表随工作区过滤，用状态灯直观标记完成 / 待确认，并提供工作区 / 会话搜索、创建工作区、重命名、删除、归档等能力。

dsh-plugin 生态：本插件已遵循 DeepSeek Harness 官方贡献规范，以实现分发包的形式发布，给仓库打上 dsh-plugin topic 以便发现。

快速安装

cd "$DSH_HOME/profiles/web"
dsh plugin --profile web add dsh-ide-sidebar

然后把这个依赖追加到你 profile package.json 的 dsh.profile.bundles 末尾：

"dsh": {
"profile": {
"bundles": [ "dsh-base", /* ... /, "dsh-ide-sidebar" ]
}
}

重启 dsh web。详细安装 / 卸载见下文「安装 / 卸载」。

npm i dsh-ide-sidebar（来自 registry.npmjs.org）也可直接安装。

Changelog

| 版本 | 说明 |
| v0.1.0 | 首次发布：IDE 式工作区切换器核心功能（下拉切换 / 过滤 / 状态灯 / 搜索 / 管理） |
| v0.1.1 | README banner 改用绝对 raw URL；新增 .gitignore（防止 .npmrc 泄露）；清理旧 banner |

Releases: github.com/yuhangkang/dsh-ide-sidebar/releases

Overview

解决什么问题？ DSH Web GUI 原生侧边栏以全局会话列表为主，缺少多工作区的高效导航。对日常同时维护多个工作区（项目）的用户，频繁来回切换会话成本高。本插件把侧边栏升级为类 IDE 的工作区视角：

- 顶部悬浮下拉，当前工作区一目了然，一键切换；
- 会话按工作区过滤，只看到当前上下文相关的会话；
- 每个会话带状态灯（完成 🔵 / 待确认 🟠），扫描进度一目了然；
- 内置搜索：既搜工作区，也搜会话；支持重命名 / 删除 / 归档 / 新建工作区。

适合谁？ 需要多工作区并行、频繁切换的 DSH Web 重度用户 / Agent 开发者。

Features

- 左上角悬浮下拉工作区切换器（idebar-switcher）
- 会话列表按工作区过滤
- 三级状态灯：完成（brand 蓝）/ 待确认（warn 琥珀，脉冲动效）
- 工作区搜索 + 会话搜索
- 工作区管理：添加、重命名、删除、归档
- 会话管理：重命名、删除
- 纯浏览器端 bundle，无 host 行为，无额外服务端依赖

Compatibility

- 平台：仅 web（DSH 浏览器）
- DSH 版本：dsh >= 0.1.0-rc（对齐 @deepseek-ai/dsh-client-runtime 与 dsh-client-ui-sidebar 的当前 RC 接口）
- 注入依赖：@deepseek-ai/dsh-client-runtime、@deepseek-ai/dsh-client-ui-sidebar（由运行时的注入 seam 提供；react >= 17 作为 peerDependency）
- 驱动说明：本仓库为独立 bundle（cordis.patch.yml + lib/），不修改官方包源码
- 最后验证：v0.1.0 于 2026-08 在 web profile 实测加载成功
- ⚠️ 不含“出错红灯”功能（该功能依赖动态插件 host RPC，常驻 bundle 无此通道）

Install & Uninstall

安装（方式一：dsh plugin，推荐）

cd "$DSH_HOME/profiles"
dsh plugin --profile web add dsh-ide-sidebar

然后把 dsh-ide-sidebar 追加到 profile package.json 的 dsh.profile.bundles 末尾，重启 dsh （web）。

安装（方式二：手动挂载）

1. 把本插件目录放到 pnpm 可解析位置，并在 $DSH_HOME/profiles/node_modules/dsh-ide-sidebar 建立符号链接（hoisted 布局）；
2. 在 profile package.json：
- dependencies 加 "dsh-ide-sidebar": ""
- dsh.profile.bundles 数组追加 "dsh-ide-sidebar"
3. 重启 dsh。

⚠️ 所有写入的配置文件务必 UTF-8 无 BOM。

卸载

1. 从 profile package.json 的 bundles 移除 dsh-ide-sidebar 行；
2. 移除 dependencies 中的对应依赖；
3. 删除 $DSH_HOME/profiles/node_modules/dsh-ide-sidebar 链接；
4. 重启 dsh。

快速开始

1. 按任一方式安装并重启 dsh；
2. 打开 Web GUI，左上角出现当前工作区名 + 下拉箭头；
3. 点击下拉 → 在工作区之间切换，或搜索 / 新建 / 重命名 / 归档工作区；
4. 会话列表随当前工作区过滤，观察状态灯：🔵 已完成，🟠 待确认。

配置

本插件 无配置项，全部行为内建。注入的 DSH service（@deepseek-ai/dsh-client-runtime、@deepseek-ai/dsh-client-ui-sidebar）由运行环境自动提供，不读环境变量、无用户数据。

若后续需要，会在此新增 dsh-ide-sidebar 配置命名空间。

权限与数据

- 纯浏览器侧插件，apply()（Host half）为空实现，不访问宿主进程、不读写文件系统、不触碰本地凭据；
- 读取 DSH 客户端运行时已暴露的 Session / Workspace 列表（由 dsh-client-runtime 注入）以渲染 UI；
- 所有会话操作（归档 / 重命名 / 删除 / 新建）均通过 DSH 已授权的客户端接口执行，本插件不新增网络出口；
- 不收集任何日志与遥测；
- 主题遵循 DSH 的 design tokens（--dsw-），无外部请求。

故障排查

| 症状 | 可能原因 | 处理 |
| 侧边栏未变化 | 未加入 bundles 或 dsh 未重启 | 确认 dsh.profile.bundles 含 dsh-ide-sidebar 并重启 |
| 疑似依赖未注入 | profile 缺 dsh-client-runtime / dsh-client-ui-sidebar | 这些是 run 自带 bundle，确认 profile 以 dsh-base 起步 |
| 图标 / 样式错乱 | 主题 tokens 与当前 DSH 主题不匹配 | 反馈 Issue 并提供 DSH 版本与主题名 |
| BOM 出错导致加载失败 | 配置文件被写入了 BOM | 用无 BOM 编码重写 package.json，重启 |

遇其它问题，请到仓库 Issues 反馈，附 DSH 版本、web 控制台报错与截图。

开发

git clone https://github.com/yuhangkang/dsh-ide-sidebar.git && cd dsh-ide-sidebar
本插件为普通 JS bundle，无需 TypeScript 编译本地验证：参照「Install（方式二）」手动挂载到 profile 后重启 dsh

- 入口 lib/index.mjs（Host，空实现）
- 客户端 UI lib/client.js（React，通过 window.__ModuleLoader__ 加载）
- 类型 lib/index.d.mts
- 挂载点 cordis.patch.yml → insert ide-sidebar

欢迎 Issue 与 PR。

许可证与安全

- License：MIT
- Security：安全问题请私信仓库维护者，避免在公开 Issue 中泄露凭据 / 私有信息。
- 第三方插件会以你的权限运行——请自审源码，勿在存放敏感 key 的环境乱试陌生插件。

仓库：https://github.com/yuhangkang/dsh-ide-sidebar Topics：dsh-plugin、deepseek-harness、dsh —— 可在 github.com/topics/dsh-plugin 被发现。