dsh-chat-manager

DSH 的用户级插件，Web UI 与桌面端通用：侧边栏拆成「工作区」「聊天」两块，聊天会话按日期自动建文件夹，会话可以从菜单删除，删掉的会话在设置页里还能恢复或彻底删掉。

功能特性

• 双区域侧边栏：左栏上为工作区、下为聊天区，视觉风格一致。工作区保留 DSH 原生的全部行为（搜索、视图选项、拖拽、展开/收起）；聊天区里的会话不要求挂在某个工作区，可以用「添加聊天」新建，也能按标题或内容搜索。

  

• 新会话打开到哪：焦点在工作区时，开进那个工作区；焦点在聊天会话、或没有焦点时，开进聊天区。

• 聊天文件夹自动归档：新聊天会话落在系统文档目录的 DSH/年-月-日/ 下。发出第一句话后，LLM 顺着内容起一个 2–4 个英文小写单词的子文件夹（起不出来时退回本地规则），代理之后的文件读写默认都在这个子文件夹里。日期文件夹本身不会出现在工作区区域。

• 删除会话：工作区与聊天区的会话菜单都新增了红色「删除会话」（垃圾桶图标，二次确认）。删除会清掉会话日志、工作区账目席位、聊天登记与归档集合引用，但会话文件夹原样留在磁盘上，产物不丢。

  

  

• 已归档会话管理：设置面板新增「已归档会话」，列出会话标题与最近更新时间，可「恢复」（回到原工作区位置）或「删除」（走完整删除流程）。

  

版本要求

插件依赖 DSH 0.2 的 bundle 层 + client-modules 装载机制，要求 DSH ≥ 0.2.0-rc.2（package.json 的 engines.dsh；开发对照 0.2.1-alpha.1）。0.2 桌面端与 dsh web 跑的是同一套 Web 前端与同一套插件机制，因此插件代码只有一份，桌面端同样可用。

从 0.1.x 时代装过插件的，先读「从旧版升级」——仓库目录结构和插件包位置都变了。

前置依赖

# Node.js：22.19+（或 24+，DSH 上游的 engines 要求）

# pnpm：DSH 的 plugin 命令会转发给 profile 里的 pnpm
npm install -g pnpm

# DSH CLI（桌面端自带运行时与 CLI，可跳过）
npm install -g @deepseek-ai/dsh

安装

两种界面各自有独立的 profile，需要分别安装：

第 1 步：克隆并构建（两种界面共用）

git clone https://github.com/tvrpdfe/dsh-chat-manager.git
cd dsh-chat-manager
npm install
npm run build

仓库根目录就是插件包本身（package.json 声明 dsh.bundle.patch），所以之后安装命令直接指向这个克隆目录即可。 插件包随仓库分发构建产物 lib/，但仍建议自己跑一次 npm install && npm run build，保证产物与本机 Node 版本一致。

第 2 步：装到你用的界面

Web UI：

dsh plugin --profile web add "link:$(pwd)"

（bash 与 PowerShell 里 $(pwd) 都会展开成当前目录；也可以用绝对路径，例如 dsh plugin --profile web add "link:F:/workdir/dsh-chat-manager"。）

桌面端：

桌面端 profile 由 Electron 应用独占管理，CLI 明确拒绝 dsh plugin --profile desktop ...（会报 profile "desktop" is managed exclusively by the Electron application），所以只能在桌面端界面里装：

1. 打开桌面端侧边栏 插件 页 → 添加插件；
2. 输入上面克隆目录的绝对路径（例如 F:\workdir\dsh-chat-manager），或直接填 https://github.com/tvrpdfe/dsh-chat-manager；
3. 安装完成后完全退出桌面应用再启动（宿主半、层装配与客户端 bundle rev 都随进程重启更新）。

安装成功的前提是包根目录的 package.json 声明了 dsh.bundle.patch——本仓库根目录就是插件包，所以直接填仓库地址即可；旧版（插件包在 packages/ 子目录里）的仓库地址会被判为「这个包没有声明组合包」。

第 3 步：重启并强刷

1. Web UI：重启宿主进程（dsh web），浏览器打开后按 Ctrl+F5。
2. 桌面端：完全退出桌面应用再启动。

（这一步对两端都必要：宿主半、层装配与客户端 bundle rev 都随宿主进程重启更新。）

卸载

Web UI：

dsh plugin --profile web remove dsh-chat-manager

桌面端： 在桌面端侧边栏 插件 页找到 dsh-chat-manager，删除（CLI 不能操作 desktop profile）。

然后在对应界面重启：Web UI 重启 dsh web，桌面端完全退出再启动。侧边栏恢复内置 ui-workspace。

卸载只摘掉插件层；聊天文件夹、登记表与归档记录都保留。

桌面端界面被插件搞坏、连插件页都打不开时：设置 → 通用 里有「禁用第三方插件、备份 profile patch 并重启」的恢复入口。

从旧版升级

0.1.x 时代的插件有两处不同：插件包在 packages/dsh-chat-manager/ 子目录里，且用的是旧版 DSH 的装载方式。升级要先卸旧、再按新路径装：

# 1) 拿新源码（旧安装是 link: 指向本克隆的话 git pull 即可）
cd dsh-chat-manager
git pull

# 2) 卸掉旧安装（Web UI；桌面端在桌面端「插件」页里删除）
dsh plugin --profile web remove dsh-chat-manager

# 3) 构建
npm install
npm run build

# 4) 按新的仓库根路径重装（Web UI；桌面端在同一页填仓库根路径）
dsh plugin --profile web add "link:$(pwd)"

第 2 步的 pnpm remove 偶发在 Windows 上以 pnpm 原生崩溃收场（日志里是一串 exit code 大数字）。这种时候 profile 的 dependencies 已经改好了，只差层栈没更新——检查 ~/.dsh/profiles/<profile>/package.json：dsh.profile.bundles 里应当有 dsh-chat-manager，没有就手工补进数组末尾（插件管理器平时也是这么写的）。

最后按「第 3 步：重启并强刷」执行一次（Web UI 还要 Ctrl+F5）。

使用说明

• 新建聊天：点聊天区头部的「添加聊天」，或焦点在聊天会话/无焦点时点「新建会话」；会话自动落在 文档/DSH/当天日期/ 下，第一句话后生成 slug 子文件夹。
• 删除会话：会话「⋯」菜单 → 红色「删除会话」→ 二次确认。删除后行立即消失（不整页刷新），文件夹与其中文件留在磁盘。
• 已归档会话：设置 → 已归档会话。每行显示「工作区名：会话名」与最近更新时间，可「恢复」或「删除」。
• 聊天区搜索：标题子串匹配始终可用；内容命中依赖部署侧的 session-query 索引，若该索引被配置为 openAt: "never"（本机当前部署即如此），宿主会记一条 [dsh-chat-manager] content search failed 警告并只返回标题匹配，搜索框行为不变。

数据位置

升级

link: 装的插件，代码就在你的克隆目录里：git pull 后重新 npm install && npm run build，再按「第 3 步：重启并强刷」执行（依赖与层注册不用重做）。

开发与验证

• 源码用 TypeScript/TSX 维护（src/，浏览器半是内置 ui-workspace 客户端源码的分叉 + 插件 addon），构建产物为 Harness 加载的 JS bundle：npm install && npm run build（esbuild：宿主 ESM + 客户端 __ModuleLoader__.load 工厂 bundle）。
• 类型门禁：npm run verify（= npm run typecheck + 重建 lib/ + 下面的 bundle 门禁）零错误；产物改动后跑 node --check lib/index.js lib/client.js。
• 构建：npm run build = esbuild 出 lib/ + node scripts/verify-bundle.mjs 门禁。门禁断言：lib/client.js 的 require 集合全部落在平台 seed 词内（react、react/jsx-runtime、react-dom、react-dom/client、@deepseek-ai/cordis、@deepseek-ai/dsh-client-store、@deepseek-ai/dsh-client-ui-slots、@deepseek-ai/dsh-client-ui-primitives、@deepseek-ai/dsh-client-ui-dockkit）；不含 0.1.x 图标/hook 名；CSS 哈希类名以 m 开头，且逐张样式表校验「改名后的类必须出现在本表选择器里、不得残留未哈希的 .local」（断言只看选择器位置：注释与引号字符串先被剥离，否则注释里的类名会喂饱「必须出现」那条造成假绿；复合选择器只改首个类名会让整条规则失效——行菜单因此曾在鼠标移入时跳到窗口左上角并消失）；工厂 id 等于包名；产物必须比源码新（任何 src/**、scripts/build.mjs、package.json 比 lib/*.js 新即失败并提示重建——门禁只认产物，不会替你重建）。
• 分叉对照：node scripts/fork-diff.mjs 把 src/client/ 与上游 ui-workspace 客户端源码逐字节对比，记录写入 .scratch/std-fork-diffs/（空 diff = 与上游一致），并打印锚定的上游 commit。
• 改完重建 + 重启验证实例：浏览器半改 src/client/ 后 npm run build 重启 dsh（bundle rev 随启动图更新）+ Ctrl+F5；宿主半改 src/index.ts 后重启 dsh 即可。
• 真机验证（headless Chrome，可用 $DSH_CHROME 指定 Chrome 路径）：.scratch/ 下的 CDP 探针脚本（boot 探针：无失败页 + 双区域渲染 + 零 console 错误；accept5-menu-mouse.mjs：真实鼠标滑行下菜单锚定不漂移、可点中「删除会话」；accept6-delete-durable.mjs + accept6-phase2.mjs：设置页删除后磁盘会话目录消失、宿主重启不复活；accept7-row-menu-delete.mjs + accept7-phase2.mjs：行菜单上的删除确认（用自建非空白会话，空白行没有动作条）；菜单探针：会话菜单项各出现一次、删除确认框；设置页探针：已归档会话 tab 注册、相对时间渲染；宿主路由探针）；共享 tools/cdp-lib.mjs。验证实例要与实盘应用隔离 $DSH_HOME（把 ~/.dsh 复制成一次性副本、按原名重建一个 junction 再 DSH_HOME=<副本> dsh --profile cmtest --port 3199 --no-open），否则两个宿主会互相覆盖同一份 storages。
• 需求与规格：.scratch/chat-manager/spec.md；领域词汇：CONTEXT.md；命名时序决策：docs/adr/0001-chat-folder-naming.md。

许可证

MIT（插件包 package.json 声明 license: MIT）。