dsh-sidebar-toggle

简体中文 · English

为 DeepSeek Harness（DSH）Web GUI 提供侧边栏分组模式的快捷切换：无需展开视图选项菜单，通过 Alt+R 快捷键或直接点击侧边栏分组标题（会话 / 工作区 / Sessions / Workspaces），即可在按工作区分组（workspace）与平铺会话列表（flat）之间一键来回切换。

功能与交互

1. 全局快捷键 Alt+R：
   • 在页面任意位置按下 Alt+R 即可切换侧边栏分组模式（workspace ↔ flat）。
   • 自动避让输入法组合输入状态（e.isComposing || e.keyCode === 229），不影响中文等 IME 选词。
2. 点击侧边栏分组标题：
   • 为侧边栏顶部标题文本（[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

社区

• 感谢 LINUX DO 社区提供的交流环境。