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。

目录

• 功能
• 兼容性
• 前置条件
• 范围与限制
• 安装
• 开发与验证
• 文档
• 边界
• 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 本仓库（或使用 .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，不随仓库分发）作为提交前的第一道闸。

文档

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

边界

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

License

MIT — 见 LICENSE。