归档增强助手csiroqa/dsh-archive-viewer

dsh-archive-viewer

DeepSeek Harness（DSH）的归档增强插件：自动定期归档空闲会话、文件夹归档整理、LLM 摘要沉淀经验库、会话收藏与便签，外加已归档会话的查看 / 恢复与一键关闭 dsh。

English: README.en.md

功能

归档管理

- 自动定期归档（host 半区）：ctx.interval 周期扫描空闲会话（非运行中、最后活跃早于 maxIdleDays、未 pin、未归档），幂等归档——日志、附件与工作区分组位置完整保留
- 文件夹归档：左栏文件夹树（全部归档 / 自定义文件夹 / 未分类 / 收藏 / 经验库），可新建、重命名、删除文件夹，会话可移入/移出；归属关系持久化在 $DSH_HOME/archive_snapshots/folders.json
- 批量操作：勾选多个会话后批量导出 ZIP / 生成摘要 / 恢复 / 移动
- 查看对话：直接读取归档会话日志（session.history，冷会话走持久化检查），支持分页加载更早
- 下载日志 ZIP：官方 session.export 端点
- 恢复会话（取消归档）：一键放回原工作区分组

经验库（LLM 摘要沉淀）

- 会话完成（running → idle）或手动点「生成摘要」时，用 ctx.llm.stream 生成结构化摘要（目标 / 关键决策 / 产出 / 可复用经验 / 遗留问题）
- 以 Markdown + JSON 写入 $DSH_HOME/archive_snapshots/，面板「经验库」视图支持全文搜索与重新生成
- 摘要模型走插件 config 的 provider / model（与 DSH 的 LLM 路由一致），未配置时点「生成摘要」会提示

收藏 + 便签

- 每个会话卡片可「☆ 收藏 / ★ 已收藏」、写便签；收藏视图展示所有收藏会话（含未归档）
- 持久化在 $DSH_HOME/archive_snapshots/bookmarks.json

其他

- 右上角「关闭 dsh」按钮：会话完成后可一键关闭 dsh，日志均已保存，重启后原样恢复
- 皮肤全适配：全部使用 shell 设计令牌（--dsw-alias- + --dsw-alias-state-business-primary 强调色），自动跟随任意皮肤；面板 Portal 到 document.body 避开侧边栏令牌覆盖

配置

插件行（cordis.patch.yml 的 archive-viewer insert 行）支持以下可选 config：

| 键 | 默认 | 说明 |
| --- | --- | --- |
| autoArchiveEnabled | true | 自动定期归档开关 |
| maxIdleDays | 7 | 会话空闲多少天后自动归档 |
| scanIntervalMinutes | 30 | 扫描周期（分钟） |
| pinnedSessionIds | [] | 永不自动归档的会话 id |
| summarizeEnabled | true | 自动摘要沉淀开关 |
| provider / model | 未配置 | 摘要模型路由（与 DSH 的 LLM 配置一致） |
| maxInputBytes | 65536 | 摘要输入字节上限 |
| maxOutputTokens | 1024 | 摘要输出 token 上限 |
| timeoutMs | 60000 | 摘要请求超时（毫秒） |

依赖：DSH 核心补丁（必读）

「恢复会话」与「关闭 dsh」依赖 DSH 核心新增的两个 RPC（截至 2026-08 官方尚未包含）：

- workspace.unarchiveSession —— 注册表级取消归档
- host.shutdown —— 经 CLI 启动器的 appExit 触发优雅关机

使用前请先应用补丁：

cd
git apply /path/to/dsh-archive-viewer/patches/0001-workspace-unarchive-and-host-shutdown-rpcs.patch

然后重启 dsh web（源码运行时 tsx 直接执行，无需构建；发布包安装的用户需重新构建受影响包）。补丁共 8 个文件：workspace 注册表、apiproxy 接口/校验/路由/实现、host schema 等。

若 DSH 官方后续合入这两个 RPC，补丁会变为空操作，可安全跳过。

安装

前置：Node.js >= 22、pnpm。

git clone https://github.com/csiroqa/dsh-archive-viewer.git
cd dsh-archive-viewer
pnpm install
pnpm build

安装进 web profile（link: 指向本目录）
dsh plugin --profile web add link:$(pwd)        # POSIX
dsh plugin --profile web add link:E:\path\to\dsh-archive-viewer   # Windows

重启 dsh web，浏览器 Ctrl+F5 硬刷新。

使用

1. 侧边栏底部（设置按钮上方）点击「已归档会话」打开面板
2. 左栏文件夹树切换视图；会话卡片：查看对话 / 生成摘要 / 收藏 / 便签 / 恢复 / 导出 ZIP
3. 勾选多个会话后底部批量操作条出现；「经验库」视图检索沉淀摘要
4. 会话头部右上角电源按钮 → 确认后关闭 dsh

安全说明

- 自动定期归档会无人值守地移动你的会话（默认空闲 7 天后），归档会话从所有会话列表与搜索中隐藏但日志完整保留，可随时恢复；如不希望自动归档，请把 autoArchiveEnabled 设为 false
- LLM 摘要会消耗模型 token：每次会话完成或点「生成摘要」都会发起一次模型请求，请确认插件 config 的 provider / model 与你的额度预期匹配
- 插件数据（文件夹、书签、摘要）保存在本机 $DSH_HOME/archive_snapshots/，请勿把该目录暴露给不可信进程

兼容性

- 平台：Windows / macOS / Linux（Node >= 22）
- 针对 DSH 0.1.1-rc.2 源码检出开发验证（含本地归档/关闭核心补丁）
- 客户端零框架类型依赖：不 import 任何 @deepseek-ai/ 值，全部结构类型，不随 DSH SDK 版本漂移
- 构建产物：tsdown（host 半区 lib/index.js + browser 半区 lib/client.js，标准 window.__ModuleLoader__.load 闭包工厂格式）

许可与使用声明

MIT License（见 LICENSE）。

欢迎任何人使用、修改、引用、或把本项目收录进自己的插件合集，只需：

- 保留 LICENSE 文件与版权声明
- 标明出处（本仓库链接）

相关

- DeepSeek Harness
- 同系列插件：dsh-schedule（cron 定时任务 + 状态监控）
- 插件形态参考 dsh-web-ui（dsh.bundle.patch + dsh.client 声明 + 槽位注册）