会话回看器 ruoyu0088/dsh-chat-viewer

DSH Chat Viewer

以只读方式查看 DeepSeek Harness（DSH） 的历史会话：左边是所有会话（按 workspace 分组），点开后中间是这个会话里的所有提问（过长的截断显示），再点一条提问，右边显示它的回答 （Markdown 渲染、图像直接显示）、可折叠的思考过程和可视化的工具调用。

中间上方可以搜索提问或回答，也可以跨全部会话搜索。数据直接来自 %USERPROFILE%\.dsh\sessions 下的 zstd 压缩 JSONL 日志，只读，不会写入或锁定 DSH 的会话库。

功能

- 三栏布局：所有会话 / 提问列表 / 回答；两栏可折叠（VSCode 风格），状态记在 localStorage。
桌面端两栏可拖动调宽、双击恢复默认；窄屏时会话栏变为抽屉，手机宽度下两栏都变为抽屉。
- 中英双语：顶栏切换中文/English，默认跟随浏览器语言，选择记在 localStorage；只翻译界面，不翻译提问、回答和工具输出原文。
- 快速启动：会话列表只读每个日志的头部第一帧 + session_projcache 元信息，不解析完整日志；点开某个会话时才解析并缓存它的全部内容。
- 会话分组：按 workspace 显示；置顶、归档、进行中、模型、提问数、最后活动时间。
- 提问列表：真实用户提问、中途插话（steer）、自动继续、进行中标记；回答字数、工具数、思考字数、待办数、压缩次数、图片数。
- 回答渲染：Markdown、GFM 表格、KaTeX 数学公式、highlight.js 语法高亮、代码块复制/折叠、「原文」切换、搜索高亮。
- 思考过程：assistant/message 里的 reasoning 块默认折叠，按步骤展示，不污染回答正文。
- 工具调用卡片：外层工具区默认折叠并懒加载；展开后每张卡也默认折叠，只显示标题行。
提供“折叠全部 / 展开全部”、关键字过滤，以及可选的“包含输出”匹配范围。
- 图片：Markdown 本地图片、DSH image 内容块、@image: / MEDIA: 路径、附件 id；点击放大、缺图提示；/file 只允许图片、限制 40 MB。
- 搜索：当前会话的提问/回答/全部；跨全部会话；搜索结果按会话分组。
- 跟随最新：每 3 秒检查日志；新提问自动进列表，正在生成的回答会继续长出来。
- 只读安全：只监听 127.0.0.1；/file 与 /api/ 校验 Host 头；不执行任何 DSH 命令。

数据来源

DSH 的会话存储与 Hermes 的 SQLite state.db 完全不同，是事件溯源 + 追加式 zstd JSONL：

%USERPROFILE%\.dsh\
sessions\
--C-Users-alice-Documents-project--\ # 规范化后的工作目录
session-<uuid>\
session.v4.jsonl.zstd # 当前格式；也可能是 .jsonl / .v3 / .v2 ...
storages\
workspace.json # workspace、置顶、归档、会话列表 session_projcache\sessions\<session-id>.json # 标题、模型、token、turn outline

- 文件是多个独立 Zstandard 帧首尾拼接：头部一帧，之后每个持久化批次一帧。
Python 3.14 的 compression.zstd.decompress 能一次解开所有帧。
- 日志是追加式的：压缩（compaction）不会覆盖旧历史，只追加新的摘要事件；所以查看器直接按时间顺序展示全部记录，不需要像 Hermes 那样从 active/compacted 多层消息重建。
- 当前支持 v4 日志；同一个会话目录有多个代际时，自动选择版本号最高的文件（压缩优先）。
- 正在写入的会话，最后一帧可能是未完成帧；查看器会忽略它，等下一次刷新再读完整帧。

启动与懒加载

- 列表阶段：只读每个日志的第一个 Zstandard 帧（session header，几百字节）和 session_projcache 里的标题/模型/token/sessionStats.turns/titleInput.count，再加上 workspace.json 的置顶/归档；不解压完整日志。
- 提问数：取 max(sessionStats.turns, titleInput.count, turnOutline.turns 数)。
sessionStats.turns 不含中途插话，titleInput.count 含；取最大值后与本机全量解析结果逐条一致。
- 点开会话：第一次请求 /questions 或 /turn 时才解压、解析并缓存该会话；后续请求直接复用缓存，只有日志文件变化时才重新解析。
- 解压方式：用 zstd.ZstdFile 流式读取拼接帧，而不是 zstd.decompress()。
DSH 日志由几千个独立小帧组成；同一个 8 MB / 5,731 帧 / 30 MB 解压结果的会话，
zstd.decompress() 约 9.9 秒，ZstdFile 约 0.14 秒。尾帧不完整时保留已解出的完整前缀。
- JSONL 解析：仍是标准库 json.loads 逐行解析（同例子 9,344 行约 0.25 秒），没有引入第三方 JSON 库；瓶颈在 zstd 的调用方式，不在 JSON。
- 工具卡：tool/call / tool/result 的正文、diff、命令输出只在打开具体提问、并且展开 “工具调用”时，才通过 /api/turn/{sid}/{seq}/calls 渲染；不会在解析整个会话时为所有轮次预先格式化，也不会在回答首次显示时创建几十上百张卡片。
- 因此启动开销与历史总量基本无关；代价是第一次点开一个很大的会话需要等它解析完（本机最大会话约 30 MB 解压后，首次打开约 0.6 秒），之后就是缓存的。

提问 / 回答的配对

- 一条 user/message 且 source.kind === "user" 开启一条提问。
- 注入消息不是提问、也不结束当前回答： runtime-context、skill-catalog、time-context、user-approval 等 source.kind 不是 user 的消息会被跳过。
- 两条真实用户消息之间的所有 assistant/message 文本块拼成回答。
- 中途插话（一轮回答进行中用户又发话）：DSH 会再追加一条 user/message，但没有新的 turn/start；查看器把它识别为「插话」，单独成为一条提问，后续回答归到这条提问下。
- 自动继续：如果一轮开始后还没有用户提问就出现助手输出，会生成一条「自动继续」提问，避免内容丢失。
- 思考块（reasoning）与回答正文分开；工具调用用 tool/call.callId 与 tool/result.message.toolCallId 配对。
- 工具卡还会关联 job/registered / job/settled，显示后台任务状态与耗时。

工具调用怎么显示

| 调用 | 显示方式 |
| pwsh / bash | 命令（PowerShell/Bash 高亮）+ 输出 + stderr + exit N 徽章 + job 状态/耗时 |
| read | 文件路径、行号范围、内容（自动去掉 DSH 的 N: 行号前缀，按后缀高亮） |
| write | 写入路径 + 内容（按后缀识别语言） |
| edit / patch | 路径 + diff 视图（-old / +new） |
| glob / grep | pattern、path + 结果 |
| ask_user_question | 问题、选项、用户选中的选项，以及自定义文字回答 |
| todo_write | 清单（✓ / ▸ / ○ / ×），并显示本轮最新待办 |
| web_search / web_fetch | 查询/URL + 结果文本 |
| present | 交付文件列表 |
| skill | 技能名 + 技能内容 |
| subagent / subagent_fork | 子代理描述/提示词 + 结果 |
| workflow | 工作流名称 + JS 脚本 + 结果 |
| load_workspace_dependencies / job_ / schedule_ / goal_ 等 | 参数与结果 JSON（美化） |
| 其他 | 参数 JSON + 结果文本/JSON，统一兜底 |

每个代码块都可单独复制；超过 22 行自动折叠，可「展开全部」。
结果里的 MEDIA: 图片、<type>image</type> 或 image 内容块会直接显示。

工具卡默认折叠。外层“工具调用”展开后才请求
/api/turn/{sid}/{seq}/calls；每一张工具卡默认也只显示标题行（序号、工具名、摘要、
状态徽章），点标题行或箭头展开参数/命令/输出/diff/图片等正文。折叠的卡不会创建正文 DOM，只有实际展开的卡才构建正文，因此 200+ 次调用的轮次也能先快速看到工具列表。

工具区顶部有：

- 折叠全部 / 展开全部：只作用于当前过滤后可见的卡片；
- 过滤框：即时匹配工具名、摘要、路径、命令/参数；勾选 包含输出 时再匹配命令输出、 diff、错误文本、用户选择等结果内容，取消勾选只搜工具头部/参数；
- 计数：显示 N / 共 M。

回答流式更新时，已展开的外层工具区和单卡状态会保留；工具调用集合变化时用 calls_revision 检测，并自动重新加载当前轮的工具卡。

DSH 特有信息

- 思考过程：折叠在回答上方，按 step 分段。
- workspace：会话按工作目录分组，显示完整路径。
- 模型 / token：会话列表与回答头部显示模型；token 总量来自 session_projcache。
- 进行中：最后一个 turn/start 还没有 turn/end 时，显示「进行中/正在生成」。
- 上下文压缩：compaction/summary 显示为独立的折叠卡片，保留压缩前的完整历史。
- ask_user_question：用户的选择与自定义回答直接显示在工具卡里，不需要去翻 JSON。
- job 耗时：job/settled 的 startedAt/finishedAt 换算成毫秒/秒。

运行

需要 Python 3.14+（标准库自带 compression.zstd），不需要安装任何第三方 Python 包。

双击 run.bat 即可。它按以下顺序寻找 Python，找到就启动，不需要改脚本：

1. 环境变量 DSH_VIEWER_PYTHON（可选，指向任意 Python 3.14+ 的 python.exe）
2. 本机开发环境 C:\pixi_env\.pixi\envs\default\python.exe
3. py -3.14
4. PATH 上的 python（版本必须 ≥ 3.14）

所以在当前机器上仍然是双击直接运行；换机器时通常也不用改。

命令行等价写法：

py -3.14 server.py
:: 或
python server.py

常用参数：

python server.py --port 8790 :: 换端口（默认 8766，避开 Hermes 查看器的 8765）
python server.py --no-open :: 不自动开浏览器
python server.py --home D:\dsh-home :: 指定 DSH home（默认 %USERPROFILE%\.dsh 或 $DSH_HOME）

想让 run.bat 固定使用某个解释器，设置环境变量即可，例如：
set DSH_VIEWER_PYTHON=C:\Python314\python.exe。

启动后先出现会话列表（只读元信息）；点开某个会话后才读取它的完整日志，右侧/中栏会显示 “正在读取会话日志”。本机最大的会话首次打开约 0.6 秒，之后走缓存。

界面快捷键

- Ctrl+B：三态循环（全部显示 → 隐藏会话栏 → 全部隐藏 → 全部显示）
- Ctrl+Shift+B：只折叠/展开提问栏
- /：聚焦搜索（提问栏折叠时先展开）
- j / k / ↑ / ↓：切换提问
- Esc：搜索框失焦 / 关闭抽屉
- 顶栏语言下拉：切换中文 / English
- 回答区按钮：跳到回答、复制问答、复制提问、复制回答、原文

API

| 路径 | 说明 |
| GET /api/meta | DSH home、会话数、提问数、workspace 数、已加载会话数 |
| GET /api/chats | 所有会话的元信息（不解析完整日志；标题/目录/模型/token/提问数/置顶/归档/进行中/loaded） |
| GET /api/chats/{sid}/questions?q=&scope=q\|a\|all | 该会话的提问列表；首次调用解析完整日志并缓存 |
| GET /api/turn/{sid}/{seq} | 单条提问：提问、回答、思考、压缩摘要、待办；工具卡只返回 call_count / calls_revision，不含卡片正文 |
| GET /api/turn/{sid}/{seq}/calls | 展开“工具调用”时才调用：返回这一轮渲染好的工具卡（命令/diff/文件内容/图片等） |
| GET /api/search?q=&scope=&sid=&limit= | 跨会话搜索（首次搜索会解析所有会话） |
| GET /file?path=<绝对路径> | 只读提供图片文件（唯一允许的读取类型） |
| GET /attachment?id=<附件id>&sid=<会话id> | 只读提供 DSH 图片附件（在已知附件目录中查找） |

seq 是 DSH 事件日志里的序号；前端用 <sid>:<seq> 作为提问的唯一 id。

安全边界

- 只监听 127.0.0.1；/file 与 /api/ 校验 Host 头（默认只接受 loopback，防 DNS rebinding）。
- /file 只允许图片后缀（png/jpg/jpeg/gif/webp/bmp/svg/ico/avif），≤ 40 MB； SVG 额外加 Content-Security-Policy: sandbox；永不返回其它文件。
- /attachment 只在 DSH 已知附件目录中按 id 查找，不接受任意路径。
- 会话日志以只读方式读取，不写入、不加锁；DSH 可以同时运行。
- 不执行日志里的任何命令；工具结果只作为文本/Markdown 显示。

与 Hermes 版的差异

| | Hermes Chat Viewer | DSH Chat Viewer |
| 存储 | SQLite state.db | 追加式 zstd JSONL |
| 轮次重建 | 需要处理 active/compacted、压缩副本、注入消息 | 事件流直接分组；压缩只追加摘要 |
| 提问识别 | display_kind + 注入前缀 | user/message.source.kind === "user" |
| 思考过程 | 不显示 | 折叠显示 |
| 工具调用 | terminal / patch / 批量外壳 | pwsh / edit / ask_user_question / todo_write 等 |
| 分组 | 所有 Chat | 按 workspace 分组 |
| 运行 | Python + SQLite | Python 3.14 + 标准库 zstd |

文件

| 文件 | 作用 |
| server.py | 标准库 HTTP 服务（无第三方依赖），提供 API + 静态文件 + /file / /attachment |
| lib/dsh.py | 读取 zstd JSONL、解析事件、构建提问/回答/工具卡、缓存与搜索 |
| static/index.html | 三栏页面骨架 |
| static/app.js | 前端逻辑（列表、搜索、高亮、图像、工具卡、跟随刷新、可调宽布局） |
| static/i18n.js | 英文源文案 + 中文词典、语言检测与切换 |
| static/style.css | 样式（浅色/深色自动、抽屉式响应布局） |
| static/vendor/marked/12.0.2/ | Markdown 渲染（第三方，版本固定，离线可用） |
| static/vendor/katex/0.16.11/ | KaTeX 数学公式（js/css/字体，第三方，离线可用） |
| static/vendor/highlight.js/11.10.0/ | highlight.js 语法高亮（js/css，第三方，离线可用） |
| static/vendor/LICENSES/ / static/vendor/README.md | 第三方版本、来源和许可证 |
| run.bat | 自动查找 Python 3.14+ 并启动浏览器（优先本机 pixi 环境） |
| THIRD_PARTY_NOTICES.md | marked / KaTeX / highlight.js 的版本与许可说明 |
| README.en.md | 英文 README |
| tests/ | 解析器单测、HTTP 冒烟、可选 jsdom 页面测试 |

测试

cd tests
py -3.14 test_parser.py
py -3.14 smoke.py

页面测试（可选，需要 jsdom；先启动查看器）：

cd tests
npm install
node ui.js

详见 tests/README.md。

已知限制

- 格式：主要针对 v4 的 user/message / assistant/message / tool/call / tool/result 结构。
更早的 v3 日志若使用 tool-result 包装，工具结果可能只显示为普通注入消息；同一会话目录存在 v4 时会自动选 v4。
- zstd：必须用 Python 3.14+；Python 3.12 没有 compression.zstd。
- 首次打开：会话列表只读元信息；第一次点开一个大会话需要解析完整日志（本机最大的约 30 MB 解压后、0.6 秒左右），之后走缓存。正在写入的会话在文件变化后会重新解析这一条会话。
- 全局搜索：第一次跨会话搜索要按顺序解析所有会话，可能较慢；当前会话内搜索通常已有缓存。
- 元信息缺失：没有 session_projcache 的会话，列表里的提问数先显示 0，点开后用真实值修正。
- 实时尾帧：正在写入、尚未完成的 zstd 帧会被忽略，下一次刷新（3 秒内）再读；不会报错。
- 附件：图片附件按 id 在 .dsh/attachments、.dsh/media、.dsh/storages/ 等已知目录里查找；找不到时显示「图像文件已不存在」，不影响其它内容。
- 子代理：子会话若单独落盘，会作为独立会话出现在左侧；暂未做父子树折叠。
- 只读：没有删除、编辑、重命名、导出会话的功能。