前言¶
在 DSH Web GUI 里，会话被归档后，如果还要回看对话、恢复会话、整理标签，或者关闭当前 dsh 进程，单纯依赖侧边栏和日志文件会比较分散。下面介绍的 dsh-archive-viewer 是一个面向 DSH Web GUI 的插件：它提供一个「已归档会话」面板，用于查看、搜索、筛选、恢复已归档会话，并在右上角提供一键关闭 dsh 的入口。
这是什么¶
keepermttl/dsh-archive-viewer 是一个 MIT License 的 DSH Web GUI 插件，当前版本为 3.0.0-test（测试版）。
它解决的主要问题是：已归档会话缺少集中查看和恢复入口，标签整理、日志查看、日志导出、关闭 dsh 等操作分散在不同地方。这个插件把这些能力放到一个侧边栏面板里。
核心功能¶
查看 / 恢复归档会话¶
插件会在侧边栏底部、设置按钮上方提供「已归档会话」入口。打开后，可以查看归档会话的标题、最后活跃时间、所属工作区、运行中/空白状态等信息。
「恢复会话」会把已归档会话放回原工作区分组，位置原样保留。
搜索、排序与标签筛选¶
搜索框支持关键词即时过滤，范围包括标题、会话 ID、工作区，不区分大小写。开启「内容」模式后，会逐页扫描每段会话最近的对话，每会话扫描页数可在设置中调整。
工具栏支持按以下方式排序：
- 最近更新
- 名称
- 会话 ID
排序可切换升序/降序。
标签筛选收纳在「筛选」按钮菜单内，支持：
- 多选标签
- AND / OR 模式
- 标签搜索
标签筛选可以和关键词搜索叠加使用。
归档会话自定义标签¶
用户可以为每个归档会话添加或删除自定义标签。标签数据持久化在 DSH profile 目录下的 dsh-archive-viewer-tags.json，并通过本地 HTTP API 读写：
GET /api/archive-viewer/tags
POST /api/archive-viewer/tags
POST /api/archive-viewer/tags 支持 add、remove、clearHidden 等操作。
内嵌 AI 助手¶
面板底部提供可折叠的 AI 助手小窗口，用于调用 DSH 标准模式 agent，帮助检索会话、添加标签、整理归档。
AI 助手默认工作区为：
E:\dsh-ai-workspace
也可以在设置中修改 AI 工作区。
AI 助手使用的会话会自动归档为内部 helper 会话，不会出现在侧边栏和归档面板中。点击「新对话」会安全删除上一个 helper 会话，不会误删用户会话。
隐藏临时检索标签¶
agent 检索命中后，会自动给会话添加隐藏标签 agent检索，并切换到对应筛选。该标签不会显示在会话徽章上，取消勾选后自动清除。
查看对话日志与导出¶
插件支持查看归档会话对话日志，读取 session.history，并支持分页加载更早内容。
日志导出使用官方 session.export 端点，可下载 ZIP 文件。
界面与设置¶
插件支持列表竖列和横排网格两种排列方式。
面板顶部的介绍文本可以关闭，也可以在设置中重新开启。
设置项即时持久化，保存在浏览器 localStorage 中，键为：
dsh-archive-viewer:settings:v1
可设置项包括：
- 语言
- 排序
- 排列
- 内容搜索
- AI 模式
- AI 模型与思考强度
- AI 工作区
- 标签筛选模式
- 介绍文本显隐
- 恢复默认
插件支持中英双语，默认跟随浏览器语言自动切换，也可以在设置中手动覆盖。
皮肤适配方面，插件使用 shell 设计令牌，并将面板 Portal 到 document.body，避免受皮肤侧边栏作用域的令牌覆盖影响。
安装与启用¶
前置依赖¶
需要：
- Node.js >= 22
- pnpm
DSH 核心补丁依赖¶
「恢复会话」与「关闭 dsh」依赖 DSH 核心新增的两个 RPC：
workspace.unarchiveSession
host.shutdown
截至 2026-08，官方尚未包含这两个 RPC。
如果需要使用这两个功能，使用前需先应用补丁，并重启 dsh web。发布包安装用户需重新构建受影响包。
安装命令¶
POSIX 环境下的安装/构建命令如下：
git clone https://github.com/keepermttl/dsh-archive-viewer.git
cd dsh-archive-viewer
pnpm install
pnpm build
dsh plugin --profile web add link:$(pwd)
执行完成后，重启 dsh web，并在浏览器中按 Ctrl+F5 硬刷新。
典型用法¶
1、侧边栏底部（设置按钮上方）点击「已归档会话」，打开归档会话面板。
2、在搜索框输入关键词，即时过滤标题、会话 ID、工作区；点击「内容」后，同时搜索对话内容。每会话扫描页数可在设置中调整。
3、在工具栏选择排序方式（最近更新 / 名称 / 会话 ID），并切换升序/降序；点击「筛选」按钮打开标签筛选菜单，可按标签多选、选择 AND / OR、搜索标签。
4、点击齿轮按钮打开设置，调整语言、排序、排列、内容搜索、AI 模式、AI 模型与思考强度、AI 工作区、标签筛选模式、介绍文本显隐，或点击「恢复默认」。
5、在单个会话行上执行操作：
查看对话
恢复会话
下载日志 (ZIP)
复制 ID
标签
6、在面板底部打开「AI 助手」，直接与 DSH agent 对话，让它检索会话、添加标签或整理归档；点击「新对话」会删除上一个 AI helper 会话。
7、在会话头部右上角点击电源按钮，确认后关闭 dsh。
适用场景与注意¶
适合已经在 DSH Web GUI 中产生较多归档会话、需要集中查看和恢复会话的开发者。
使用这个插件时需要注意：
- 当前版本为
3.0.0-test（测试版）。 - 「恢复会话」与「关闭 dsh」依赖 DSH 核心新增 RPC，截至 2026-08 官方尚未包含。
- 插件以当前 dsh 进程权限运行，安装前应检查源码和许可证。
- 从旧版本升级后，需要重启
dsh web，因为 host 半区新增了标签存储与/api/archive-viewer/tags本地 API。 - 该插件针对 DSH
0.1.0-rc.5源码检出开发验证。 - 客户端不 import 任何
@deepseek-ai/*值。
结尾¶
dsh-archive-viewer 把 DSH Web GUI 中较分散的归档会话查看、恢复、标签整理、日志导出和关闭 dsh 操作集中到一个面板中。它适合作为 DSH 插件生态中的一个实用工具，用于处理已归档会话的日常管理。
项目仓库：
https://github.com/keepermttl/dsh-archive-viewer
插件目录线索：
https://www.skillhub.cn/plugins/keepermttl/dsh-archive-viewer
上述目录页来自插件线索，社区目录与 DeepSeek / 幻方无官方从属关系，不应理解为官方应用商店。
