前言¶
DeepSeek Harness（DSH）在 0.2.1-rc.3 起，单条会话侧已支持改名、置顶、归档、fork、导出等操作。会话文件按 workspace 分散存放时，缺少一个能跨目录浏览、筛选、查看详情，并统一处理删除与回收站的界面。npm 包 dsh-session-butler（产品展示名 Threadloom）由维护者 leoriczhao 发布，分类为客户端插件，专门补齐「统一管理面 + 回收站优先的删除」这一层。
这是什么¶
Threadloom 是 DeepSeek Harness 的会话管理插件：在多个 workspace 间列出会话、按条件筛选、查看详情、批量移入回收站或恢复，并提供只读 agent 工具供模型查询会话信息；写操作（删除、恢复、永久清理）不通过模型工具暴露。
- npm 包名：
dsh-session-butler - 当前版本：0.1.0（已发布到 npm）
- 许可证：MIT
- 兼容 DSH：
>=0.2.1-rc.2 <0.3.0-0（见包内engines.dsh） - 目录页：skillhub.cn/plugins/leoriczhao/dsh-session-butler
- 源码：github.com/leoriczhao/dsh-session-butler
改名、置顶、归档、取消归档仍使用 DSH 官方 UI；本插件管理页不重复提供这些能力，批量范围在 M3 阶段限定为删除与恢复。
核心功能¶
下面按 README 中已标注完成的能力说明（M1–M4 发布验收均已完成）。
跨 workspace 列表与筛选¶
主面板与侧栏提供「会话管理」入口。支持按标题、路径、id 过滤，并按 workspace、归档状态、子代理等维度筛选。
会话详情¶
行内展示 cwd、状态、时间、所属 workspace；详情弹窗可查看轮数、步骤、消息数、工具调用、token、日志字节、血缘树、preset、enrichment 等（以 stat 与事件折叠为准）。
删除、回收站与恢复¶
删除采用回收站优先策略：可先移入回收站，再恢复或经二次确认后永久删除。子代理会话支持级联删除；fork 产生的会话永不级联删除。运行中的会话需先归档再删；迁移中的会话拒绝删除。回收站保留 30 天，文档说明首版不自动清理；永久删除在默认配置下为 disabled。
/session-butler 命令¶
Host 侧提供 CLI 子命令，支持 list、trash、restore、purge 等操作，与管理页能力对齐。
Web 管理页与同源桥¶
通过 /session-butler 相关路由打开回收站与管理界面；批量操作经同源桥 trash-many / restore-many 执行，逐项返回结果。
只读 agent 工具¶
向 agent 注册只读工具 session_butler_list、session_butler_detail，用于列举与查看会话；删除、恢复等写操作不进入模型工具面。
明确不做的事¶
决策记录中已定：不做跨 workspace 移动会话；fork 不重做；首版无全文内容检索；不提供独立 CLI 子命令包（使用 /session-butler 与 Web 即可）。
安装与启用¶
从 npm 安装指定版本（或使用 DSH Web 的 Plugins 页安装）：
dsh plugin --profile <profile> add dsh-session-butler@0.1.0
将 <profile> 换成你实际使用的 DSH profile 名称。安装前请确认本机 DSH 版本落在 >=0.2.1-rc.2 <0.3.0-0 区间内。插件以当前 DSH 进程权限访问会话与 workspace 数据，安装前应自行查阅源码与 MIT 许可证。
管理页依赖 Web 客户端模板。若需在隔离环境验证，README 建议先建临时 web profile，再本地路径或 npm 包安装后启动带 Web 的 DSH（示例使用 --port 3099），从侧栏进入「会话管理」。日常 profile 不建议直接挂载开发中的本地路径，除非你在做插件开发。
典型用法¶
命令行¶
在已安装插件的 profile 下，通过 DSH 的 /session-butler 命令列出、移入回收站、恢复或 purge。具体参数与输出格式见仓库 docs/usage.md（同时作为插件详情 meta）。
Web 界面¶
启动带 Web 的 DSH 后，从侧栏打开会话管理：筛选会话、打开详情弹窗、多选后批量 trash 或 restore；在回收站页执行恢复或永久删除（永久删除需配置允许且经确认）。
Agent 只读查询¶
在支持 DSH 插件工具的会话中，模型可调用 session_butler_list、session_butler_detail 获取跨 workspace 的会话列表与详情，便于整理上下文而不触发删改。
适用场景与注意¶
适合：长期使用多个 workspace、会话数量多，需要统一查看、筛选、批量清理或从回收站恢复的场景；希望在 agent 侧只读查阅会话元数据、由人在 Web 或命令行执行删改的场景。
注意：
- 插件与 DSH 同进程、同权限，会读写会话存储与回收站状态；企业或敏感环境请先审计
src/host与桥接逻辑。 - 兼容范围由
engines.dsh声明，升级 DSH 到 0.3.0 前需关注上游是否仍满足 semver 区间。 - 社区目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态遵循「一切皆插件」，Threadloom 是其中的会话管理扩展之一。
结尾¶
Threadloom 把分散在各 workspace 的 DSH 会话收拢到同一管理面，用回收站优先的删除管线、Web 页、命令与只读 agent 工具分工，避免在官方 UI 已覆盖的改名/归档能力上重复造轮子。进一步了解架构与发布流程，可阅读仓库内的 docs/architecture.md、docs/usage.md。
