会话自动归档 SolidiFact/dsh-auto-archive

dsh-auto-archive

一个 DeepSeek Harness (dsh) web 插件，每晚一次，把已经完成、且三周没用过的会话归档，不打扰你。

来自 SolidiFact 的社区插件，不是 DeepSeek 官方产品。

归档哪些会话

只有同时满足以下条件的会话才会被归档：

- 21 天没有任何活动（用 dsh 自己的最后活动时间）；
- 目标（如果有）已完成：目标处于进行中、已暂停或已阻塞，都会保留会话；
- 所有待办事项都已完成；
- 下一轮没有排队的内容；
- 未打开、未运行、未固定，也未在 @michengai/dsh-archive-manager 中加星（装了那个插件时，加星状态会被尊重）；
- 是顶层会话（子代理的会话跟随其父会话）。

状态读不出来的会话会保留。空会话（打开过、从未使用）没有未完成的事，所以一旦闲置就会被归档。

为什么可以放心让它一直跑

- 归档不删除任何东西。 在 dsh 里它只是把会话隐藏起来，点一下就能恢复（比如从归档管理器的页面）。
- 每晚一次，在安静时段（默认本地时间 03:30 到 05:30）。如果有会话正在运行，就跳过这次检查，十分钟后再试。
- 每个会话在归档前都会重新检查一遍，而且从不要求 dsh 停止工作：有活动在跑的会话，dsh 自己就会拒绝归档。
- 加星的会话读不出来，意味着当晚不归档，而不是「没有加星」。
- 每晚最多 200 个，最旧的优先。
- 做的每件事都有记录：每晚在 ~/.dsh/auto-archive/ledger.jsonl 写一行 JSON，列出每个被归档会话的标题和最后活动时间，以及保留了多少、为什么保留。

某次安装上的实测结果

在一个真实安装上做 dry run，共 769 个会话（dsh 0.1.7-rc.2）：

| | 会话数 |
| 会归档（已完成，闲置 21 天以上） | 105 |
| 保留：最近 21 天用过 | 442 |
| 保留：子代理会话 | 186 |
| 保留：已归档 | 21 |
| 保留：待办未完成 | 11 |
| 保留：目标被阻塞 | 1 |
| 保留：状态读不出来 | 2 |
| 保留：已打开 | 1 |

安装

已在 dsh 0.1.7-rc.2 上测试。

1. 把 index.mjs 复制到你的 dsh web 配置档文件夹，命名为 auto-archive.mjs （例如 ~/.dsh/profiles/web/auto-archive.mjs）。
2. 把它加进该配置档的 cordis.patch.yml。想先看看它会做什么，就先开 dry run，并让它在 dsh 启动一分钟后跑一遍：

- insert:
- id: auto-archive
name: './auto-archive.mjs'
config:
dryRun: true
passOnStart: true

3. 重启 dsh web，等一分钟，读 ~/.dsh/auto-archive/ledger.jsonl 的最后一行。列表看着没问题了，就把 config: 块删掉。

设置

| 设置 | 默认值 | |
| idleDays | 21 | 会话完成后，多少天没有活动就归档 |
| runAt | "03:30" | 每晚窗口打开的本地时间 |
| windowHours | 2 | 窗口保持打开多久 |
| maxPerRun | 200 | 一晚最多归档多少会话 |
| dryRun | false | 只判断并记录，不归档任何内容 |
| passOnStart | false | dsh 启动一分钟后额外跑一轮 |
| ledger | ~/.dsh/auto-archive/ledger.jsonl | 每晚的记录写在哪里 |

Tests

node --test

License

Copyright 2026 SolidiFact. Licensed under the Apache License, Version 2.0; see LICENSE.