dsh-sidebar-toggle
简体中文 ·
English
为 DeepSeek Harness（DSH）Web GUI 提供侧边栏分组模式的快捷切换：无需展开视图选项菜单，通过 Alt+R 快捷键或直接点击侧边栏分组标题（会话 / 工作区 / Sessions / Workspaces），即可在按工作区分组（workspace）与平铺会话列表（flat）之间一键来回切换。
功能与交互
- 全局快捷键
Alt+R：
- 在页面任意位置按下
Alt+R 即可切换侧边栏分组模式（workspace ↔ flat）。
- 自动避让输入法组合输入状态（
e.isComposing || e.keyCode === 229），不影响中文等 IME 选词。
- 点击侧边栏分组标题：
- 为侧边栏顶部标题文本（
[class*="sectionHeader"] [class*="sectionLabel"]，即中文界面的「会话」/「工作区」或英文界面的 Sessions / Workspaces）注入手型指针（cursor: pointer）与悬停透明度反馈（hover: opacity: 0.8）。
- 单击标题文本即刻切换分组视图（若标题处于隐藏态
sectionLabelHidden 则忽略点击）。
每次切换时，插件调用宿主 sidebar.workspaces 槽位的原生 setGroupBy action，并在浏览器控制台输出一行状态日志：
[dsh-sidebar-toggle] groupBy: workspace -> flat
[dsh-sidebar-toggle] groupBy: flat -> workspace
安装
从 npm 安装（预构建，免额外配置）：
dsh plugin --profile web add dsh-sidebar-toggle
安装后无需手动修改配置文件，插件自带的 cordis.patch.yml 会自动挂载生效；刷新 Web 页面即可使用。
从 GitHub 直装（源码安装，包内含 prepare 构建脚本，pnpm ≥ 10 首次安装需放行构建）：
dsh plugin --profile web add github:john-walks-slow/dsh-sidebar-toggle
# 若 pnpm 拦截构建脚本，按提示执行 pnpm approve-builds 或将 dsh-sidebar-toggle
# 加入 ~/.dsh/profiles/web/pnpm-workspace.yaml 的 allowBuilds / onlyBuiltDependencies 后重跑
权限与兼容
- 纯客户端插件：Host 侧
apply 为空实现，零 npm 运行时依赖；全部交互逻辑在浏览器端（lib/client.js）运行。
- 零外部权限：无外部服务、无网络请求、无本地文件系统读写、不读取任何会话内容。
- 复用宿主原生状态：通过 Cordis
slots 服务解析 sidebar.workspaces 槽位的 WorkspaceViewStoreHandle，直接调用宿主原生的 getSnapshot().groupBy 与 actions.setGroupBy()，与侧边栏自带的视图切换菜单完全同步。
- 卸载与热重载干净：通过
ctx.effect 与 window.__dshSidebarToggle.dispose() 管理生命周期，插件停用或重载时自动移除键盘/点击事件监听与注入的 <style> 节点。
- 降级安全：所有 store 解析均由
try/catch 保护；若宿主侧边栏尚未挂载或结构变化，操作静默空转，绝不阻断页面。
本地开发
npm run build # 由 src/client.js 包装生成 lib/client.js 并对 lib/index.js、lib/client.js 执行语法校验
本地以 link: 方式接入 web profile 调试：
dsh plugin --profile web add link:/path/to/dsh-sidebar-toggle
发新版
改动入库后一条命令完成版本号递增与打包（npm version 会自动 commit 并打 tag）：
npm run release # patch；较大更新改用：npm version minor 或 major
然后指纹发布并推送：
node ~/.agents/skills/npm-publish/scripts/publish-webauthn.cjs /tmp/dsh-sidebar-toggle-<新版>.tgz
git push --follow-tags
发布后用 npm view dsh-sidebar-toggle version 复验。
License
MIT
社区
