dsh-knj-session-management
DSH 会话管理插件：归档/恢复/删除持久化会话，按工作区控制会话数量上限，提供体积治理面板。解决会话只增不减导致的 session_projcache.json 膨胀与 web 界面卡顿。
为什么需要它
DSH 的会话只增不减：session.list 基于磁盘扫描、SQLite FTS 索引与 workspace header 索引都会随会话数线性变慢；更关键的是 session_projcache.json（JSON 存储后端，每次写入全量序列化+原子重写）会随会话数膨胀——本机 425 个会话时达到 270MB，任何 checkpoint 写都同步阻塞约 1.5 秒，表现为新建/切换会话卡顿。
DSH 宿主没有会话删除/归档 API，本插件补上这个能力，并且三处索引全部自动跟随（见设计文档）。
功能
- 归档：把
sessions/<ws>/<id>/ 移到 archive-sessions/<ws>/<id>/（可逆，不释放磁盘，会话从列表消失，projcache 记录清除）
- 恢复：把归档会话移回原位置（投影缓存冷读自动重建）
- 永久删除：彻底移除归档目录（不可逆，释放磁盘，需二次确认）
- 自动策略：每工作区保留最近 N 个会话，超限自动归档最旧的非运行会话
- 未分组/失效工作区：
_no-cwd 会话与工作区路径已删除的会话都会被显式列出并支持管理
- 体积面板：显示 projcache 体积、各工作区会话数与归档统计
- 蒸馏衔接：归档/删除前可一键复制
wiki-distill 蒸馏指令，先把会话沉淀进知识库再清理，知识不丢（蒸馏本身由既有 wiki-distill skill 完成，本插件只做编排）
- 跨卷支持：归档区配置到其他盘符时自动回退 copy+rm（Windows EXDEV 防护）
- 侧栏即时同步：归档/恢复/删除/自动策略执行后，客户端立即让宿主重拉会话列表基线（
sessions.refresh() / workspaces.refresh()，见 src/client-sync.ts），左边栏当场消失/重现，无需重启 dsh web。宿主只对"自己改的会话"推送列表帧，本插件直接移动文件宿主无感知，所以必须主动重拉；旧版本因此要重启才刷新
安装
# 一条命令同时安装插件与菜单宿主 dsh-knj-menu（已声明为 npm 依赖，版本自动配套）
dsh plugin --profile web add dsh-knj-session-management dsh-knj-menu
配置（cordis.patch.yml）
- insert:
- id: dsh-knj-session-management
name: 'dsh-knj-session-management'
config:
maxSessionsPerWorkspace: 60 # 每工作区保留上限，0 关闭自动归档
enabled: true # 自动归档总开关
# archiveRoot: '' # 归档区，默认 $DSH_HOME/profiles/<profile>/dsh-session-archive（历史目录，改名后保持兼容）
开发
npm install
npm run check # typecheck + build
npm pack # 打 tgz
设计文档
- 行为契约：
openspec/changes/add-session-archive-management/specs/session-archive/spec.md
- 技术决策：
openspec/changes/add-session-archive-management/design.md
- 交互设计：
openspec/changes/add-session-archive-management/interactions.md
