dsh-session-manager
English: README_EN.md
A local DSH plugin that gives the left workspace a Codex-style session list.
它只接管左侧工作区中的会话行与会话菜单，不修改 DSH/Harness 源码，不接管右侧 sidebar。
本插件是一个可关闭的左侧 UI 覆盖层，不会成为 DSH 会话数据的第二真相源：会话、工作区归属、置顶、归档、当前选择等状态始终由 DSH 宿主服务读写，插件只做投影与宿主服务调用。详见 PLUGIN-CONTRACT.md。
目录
功能
- 保留原生 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 本仓库（或使用 .tgz）做本地开发安装。完整步骤见 docs/DEPLOY.md。
已发布到 npm：@pianner/dsh-session-manager（npm i @pianner/dsh-session-manager）。本地开发仍可用 clone 或 link: 依赖引入。
开发与验证
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，不随仓库分发）作为提交前的第一道闸。
文档
边界
本插件只操作 [data-slot="sidebar.workspaces"] 左侧会话区；不修改或接管右侧功能区。
License
MIT — 见 LICENSE。
