前言¶

DeepSeek Harness（DSH）里会话一多，侧栏往往只剩时间和自动标题，很难按项目或任务分组，也不容易一眼看出哪条在等工具、哪条在等你点批准。手动重命名可以，但容易被后续自动标题覆盖；多工作区并行时，更需要一种和官方 rename 同路径、又能持久保留「分类 + 标题」格式的做法。

下面介绍社区插件 dsh-session-organizer（维护者 xanderVIA）：在侧栏增加「整理」入口，用 |分类|标题 命名、颜色标签、钉住保护、运行状态徽章，以及可选的抢焦点与 AI 总结。DSH 生态主张「一切皆插件」；SkillHub 等目录站由社区维护，与 DeepSeek / 幻方无官方从属关系。

这是什么¶

dsh-session-organizer 是给 DSH 会话侧栏用的客户端插件（package 版本 1.0.0，MIT 许可证）。它在「工作区」区头增加整理面板，把分类、改名、颜色、排序和状态展示集中在一处，并通过官方 sessions.using(id) → binding.session.rename(title) 写标题，避免与侧栏重命名行为不一致。

声明兼容 DSH >=0.2.0-rc.1 <0.3.0-0；README 注明在 DSH 0.2.0-rc.2 上实测。

核心功能¶

分类与标题¶

每条会话有分类下拉框，写入标题格式 |分类|标题，走官方 rename，持久且不会被自动标题覆盖。面板里可「＋ 新增」自定义分类；双击分类名就地改名（颜色与会话跟随）；用 × 删除分类时，用到该分类的会话回落「未分类」。

颜色与侧栏¶

每个分类可设颜色：拖动取色、输入 #RRGGBB、或使用「标准黑」等预设；新建分类默认无颜色，近黑会自动吸附成纯黑。侧栏可把分类颜色画到标题上（只改内联 color，可一键还原）。分类列表、颜色、排序等存在浏览器 localStorage（键前缀 dsh-session-organizer:*），换浏览器或清缓存会丢失；钉住列表在磁盘上，不受影响。

钉住与批量操作¶

钉住（📌）的会话在批量整理、AI 总结、修剪名字时会被跳过，除非先解开。

一键自动整理与 AI 总结¶

「⚡ 一键自动整理」按关键词、首句、所属工作区打分判分类，再重判一次并写入；手选过的分类会保留。

「✨ AI 精确总结」调用 dsh-session-titler 的 POST /session-titler/propose，读取整段会话重新起名。未安装该可选依赖时，按钮会报错提示。

排序、归档与状态¶

支持按最近活跃、最早活跃、分类、名字、工作区排序，钉住的排前面；归档会话默认隐藏。

标题前显示状态徽章，例如 ⟳ 已用时、! 待回复、✓ 刚跑完。判定「在跑」时会看 sessionStats.openStep、sessionStats.pendingCalls、subagentTiming.pendingTurnStart 等字段；连续两轮轮询确认后才判完成，避免只认 openStep 把等工具/等子代理误判为已完成。

抢焦点¶

有会话开始等你答题或批准时，可自动把 DSH 窗口前置并跳到该会话（强度可配置）。右下角通知点击直接跳到会话，桌面版需按 docs/notify-focus.md 给 dsh-notify-windows 的 launcher 打补丁；不打补丁时插件其余功能不受影响。

安装与启用¶

插件以当前 DSH 进程权限运行，安装前应自行查看 GitHub 源码与 MIT 许可证。

从 GitHub 安装（README 推荐写法）：

dsh plugin --profile <你的 profile> add github:<你的用户名>/dsh-session-organizer

本地链接（开发）：

dsh plugin --profile <你的 profile> add link:E:/path/to/dsh-session-organizer

桌面版若 profile 由应用独占，请在应用内「插件」页安装，或安装后重启 DSH（宿主半是进程内模块，只刷新页面不够）。

装好后，左侧「工作区」区头会出现 🗂 图标按钮，点开即为整理面板。

卸载：

dsh plugin --profile <你的 profile> remove dsh-session-organizer

再删除 <DSH_HOME>\session-organizer\ 目录可清掉钉住与抢焦点配置。

典型用法¶

1. 打开整理面板，为常用项目「＋ 新增」分类并设颜色。
2. 在会话行选择分类，或写满 |分类|标题 后由插件经 rename 持久化。
3. 对暂时不要参与批量改名的会话点钉住。
4. 需要批量归类时，用「一键自动整理」；需要读全对话起名时，先装好 dsh-session-titler，再用「AI 精确总结」。
5. 若希望只在等你答题/勾选时抢焦点，保持默认；若要扩展策略或关闭，编辑 <DSH_HOME>\session-organizer\settings.json。

settings.json 示例：

{ "autoFocus": "question", "staleMs": 25000, "gapMs": 15000 }

• autoFocus：question（默认，只在等你答题/勾选时抢焦点）/ all（再加上工具调用卡住超过 staleMs 且审批策略是 ask）/ off
• gapMs：两次抢焦点的最小间隔

钉住列表路径：<DSH_HOME>\session-organizer\locked.json。

适用场景与注意¶

适合长期在 DSH 里开多条智能体会话、按项目或工作区做侧栏管理的开发者。区头按钮、状态徽章、侧栏上色通过 DOM 注入实现，上游 UI 改版后可能需要插件跟进；侧栏结构认不出时会静默跳过，不影响 DSH 本身。状态徽章依赖投影缓存字段名，跨大版本可能需要更新。「跳转到会话」依赖 uiWorkspace 服务；没有侧栏面板的宿主只会前置窗口，不跳转。

结尾¶

dsh-session-organizer 把分类命名、颜色、钉住、运行态和可选抢焦点收进侧栏整理面板，并与官方重命名路径对齐。目录页：https://www.skillhub.cn/plugins/xanderVIA/dsh-session-organizer；源码与完整说明：https://github.com/xanderVIA/dsh-session-organizer。