会话侧栏管理 NianjunZou/dsh-session-manager

dsh-session-manager

English: README_EN.md

一个本地 DSH 插件，给左侧工作区加上 Codex 风格的会话列表。
它只接管左侧工作区中的会话行与会话菜单，不修改 DSH/Harness 源码，不接管右侧 sidebar。

本插件是一个可关闭的左侧 UI 覆盖层，不会成为 DSH 会话数据的第二真相源：会话、工作区归属、置顶、归档、当前选择等状态始终由 DSH 宿主服务读写，插件只做投影与宿主服务调用。详见 PLUGIN-CONTRACT.md。

目录

- 功能
- 兼容性
- 前置条件
- 范围与限制
- 安装
- 开发与验证
- 文档
- 边界
- License

功能

- 保留原生 workspace 分组、展开/折叠和工作区级操作。
- 用插件自己的 Codex 风格会话行替换原生会话行。
- 统一提供固定/取消固定、重命名、分叉、归档/取消归档、复制 Session ID、复制工作目录。
- 隐藏原生会话行及原生重复置顶入口，避免第三方插件互相覆盖。
- 独立“置顶会话”区 + “项目会话”分块；运行/等待/完成未读状态区分。

兼容性

针对 DSH desktop 的 web client 开发与测试，目标版本线 0.2.0-rc.2。其它 DSH 版本可能因客户端 DOM/服务契约变化而需适配。

前置条件

- macOS 上的 DSH desktop。
- Node.js ≥ 20（跑测试用）。
- 运行 browser 回归（npm run test:browser）需要本地 Playwright 浏览器（npx playwright install chromium）。

范围与限制

- 只接管左侧 [data-slot="sidebar.workspaces"] 的会话行与会话菜单；不接管右侧 sidebar，不改 DSH/Harness 源码或 ASAR。
- 暂不提供：永久删除会话、跨工作区移动、原生“未读”状态的持久化写入——这些在目标 DSH 版本缺少可调用的公开写接口，待其提供后再评估。
- 卸载与回滚见 docs/DEPLOY.md。

安装

从 npm 安装：dsh plugin --profile <profile> add @pianner/dsh-session-manager，并在 dsh.profile.bundles 中加入 @pianner/dsh-session-manager，重启 DSH。也可 clone 本仓库做本地开发安装。完整步骤见 docs/DEPLOY.md。

当前受支持的安装渠道只有 git clone 本仓库后，在 DSH profile 中以 link: / file: 依赖（或直接指向本地目录）引入；本插件尚未发布到 npm 或 dshmarket。

开发与验证

npm test # 静态 + fixture/contract 回归
npm run test:browser # 独立临时 Chrome 下的 DOM/服务回归
npm run verify # node --check + npm test + 插件契约检查

仓库的 CI（.github/workflows/ci.yml 的 leak-scan）会在 push/PR 时扫描本机路径与密钥，防止敏感内容进入仓库。本地可另装一个 pre-commit 防护（放在 .git/hooks/pre-commit，不随仓库分发）作为提交前的第一道闸。

文档

- docs/USAGE.md — 使用说明
- docs/DEPLOY.md — 安装 / 部署 / 卸载
- PLUGIN-CONTRACT.md — 本地 DSH 插件契约

边界

本插件只操作 [data-slot="sidebar.workspaces"] 左侧会话区；不修改或接管右侧功能区。

License

MIT — 见 LICENSE。