前言¶
在 DeepSeek Harness（DSH）里，会话归档后通常要从列表里「恢复」才能继续看完整对话。若你只想核对某次归档里的工具调用、压缩前的原文，或按工作区筛一批历史会话，反复取消归档再改回去既麻烦，也容易误改状态。下面介绍的 dsh-archive-viewer 是维护者 qinu321 发布的客户端插件：对已归档会话做只读查看，归档标志在浏览期间不会被改动。
这是什么¶
dsh-archive-viewer（npm 包名 dsh-archive-viewer）是已归档 DSH 会话的只读查看器。它挂在 Web 客户端「会话管理」一侧，打开弹窗即可浏览归档列表、阅读完整对话（含工具调用、上下文压缩点等），无需先取消归档。分类属于 DSH 生态里的客户端插件；社区目录页见 skillhub.cn，源码与说明在 GitHub 仓库。许可证为 MIT。
核心功能¶
入口与列表¶
侧边栏在「会话管理」右侧：展开时显示图标与「查看归档」整行，收起为窄条时仅图标（悬停有同名提示），点击打开查看器弹窗。
归档列表展示标题、创建时间、所属工作区、日志大小、缺失标记；支持按标题 / 会话 ID / 工作区搜索，以及按工作区筛选。列表数据来自 DSH 客户端已有的会话快照，打开即渲染，不设条数上限、不向宿主分页拉取；界面每次渲染 200 行，点「显示更多」仅在前端追加行，不发起额外请求。
完整对话与压缩点¶
右栏可读用户消息、助手消息（思考过程可折叠）、工具调用与结果（参数与结果可展开）、轮次边界，以及注入的上下文与系统事件摘要。只有用户亲手输入的内容标为「用户」；时间快照、后台任务通知、技能目录等系统上下文与「别的会话转述」分别单独标注，注入上下文默认折叠。
若会话发生过上下文压缩，压缩处显示「上下文压缩」卡片（可展开查看折叠了哪些记录及摘要），压缩前的对话仍按原文展示；被剪枝的旧工具结果也保留原文。
只读与恢复¶
界面横幅标明只读。除「恢复并继续对话」外无写操作：该按钮会取消归档并打开会话，在此之前归档状态不会被修改。
界面文案随 DSH 语言切换，支持中英双语。
安装与启用¶
将插件装进指定 profile（命令会把参数转发给该 profile 的 pnpm，成功后登记 dsh.profile.bundles 并自动启用）：
dsh plugin --profile <你的 profile> add dsh-archive-viewer
重启 dsh web 后生效（宿主侧在启动时加载 bundle）。
也可在 DSH 插件面板安装，或使用工具：
plugin_manager { action: "install_bundle", target: "dsh-archive-viewer" }
本地开发时，把 target 换成插件目录的绝对路径，会装成 link: 依赖；仅改 client.js 且 pnpm run dev:web 在跑时，前端可热更新。
卸载：
dsh plugin --profile <你的 profile> remove dsh-archive-viewer
或 plugin_manager { action: "remove_bundle", target: "dsh-archive-viewer" }。移除后入口与面板消失，归档状态与会话内容不受影响。
配置¶
插件默认不带 Config 面板（零依赖、不引入 Schemastery）。若数据目录或排除名单与默认不一致，可在 profile 的 patch 里写：
- id: dsh-archive-viewer
config:
dshHome: 'D:\dsh-home' # 非标准数据目录；默认 $DSH_HOME，再退回 ~/.dsh
excludeWorkspacePaths: [] # 覆盖默认的内部会话排除名单（默认 ["aik_auto_memory_use"]）
典型用法¶
- 按上文命令安装并重启
dsh web。 - 在 Web UI 侧边栏「会话管理」旁打开「查看归档」。
- 用搜索或工作区筛选定位目标归档，选中后在右侧阅读对话与工具轨迹；需要继续编辑时再点「恢复并继续对话」。
更细的数据来源、路由与只读保证见仓库内 docs/INTERNALS.md。
适用场景与注意¶
适合需要审计或回顾已归档会话、又不想动归档状态的 DSH 用户（例如对照某次工具链、查看压缩前后原文）。
兼容性：README 写明已在 DSH 0.2.2-alpha.2（Web UI）验证；package.json 要求宿主 dsh 版本 >=0.2.0-rc.1。若宿主缺少 webServer / workspaceRegistry / sessionQuery 任一能力，插件保持未激活且不抛错。
DSH 生态主张「一切皆插件」；skillhub.cn 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。插件随当前 DSH 进程权限访问本地会话数据，安装前建议浏览源码与 MIT 许可证后再决定是否启用。
结尾¶
dsh-archive-viewer 把归档会话从「必须先恢复才能看」变成「只读打开即可查」。目录页：https://www.skillhub.cn/plugins/qinu321/dsh-archive-viewer；仓库：https://github.com/qinu321/dsh-archive-viewer。
