配置来源：cordis.patch.yml 的 config（初始值）＋设置面板写入的覆盖值（持久化在 ~/.dsh/storages/session-archive/config.json，优先级更高，面板改完立即生效）。

键	默认	说明
`enabled`	`true`	总开关
`containerName`	`（空）`	留空 = 会话文件夹直接放工作区根目录；填名字则多一层容器
`nameTemplate`	`【{kind}-{summary}】`	命名模板，支持 `{kind}` `{summary}` `{date}` `{time}`
`minChars` / `maxChars`	`15` / `30`	名称长度（字）
`extractCode`	`true`	代码是否单独存文件
`extractLongText`	`false`	非代码长文本是否单独存成 `文本-N-M.后缀`（与聊天记录同目录）
`blacklist`	`[]`	黑名单关键词，标题或首条消息命中则不建文件夹
`includeSubagents`	`false`	是否给子代理会话也建文件夹
`settleMs`	`1500`	会话创建后等待多久落盘（毫秒）
`tickMs`	`20000`	兜底扫描间隔（毫秒）
`refreshMs`	`60000`	同一会话重排程最小间隔（毫秒）
`compressAfter`	`0`	聊天记录超过 N 条后，旧内容转入 `聊天记录-历史-.md`；`0` 关闭
`cleanupHistoryDays`	`0`	历史文件保留天数，超期删除；`0` 永久保留
`writeSessionJson`	`true`	是否写 `session.json`
`absorbWorkspaceRoot`	`true`	把工作区根目录的其它文件夹/文件收进会话文件夹（仅当该工作区只有一个会话）
`divertWorkspaceFiles`	`false`	是否连带把工作区根目录的散文件也分流（默认关闭，避免搬走你自己的文件和脚本；会话文件夹根目录始终自动归位）
`dirs.chat/code/other`	`聊天记录.md` / `（空）` / `（空）`	产物名；`code`/`other` 留空 = 直接平铺在会话文件夹里，填了才建子目录

设置面板：http://127.0.0.1:/dsh-session-archive（同源页面，含保存、立即归档全部、查看状态、自检四个按钮）。也可直接调 JSON 接口：GET/POST /dsh-session-archive/api/config。

dsh-session-archive

同名套件的其他儲存庫