前言¶
在 DeepSeek Harness（DSH）里跑完一轮多轮对话和工具调用后，界面通常能感知上下文压力，却很难一眼看清：这轮会话实际走了多少轮、调了哪些工具、Token 如何拆分、缓存命中率多少、按官网标价算下来大概花多少钱。事后写复盘、给同事同步，也往往要从日志或记忆里拼细节。
下面介绍社区插件 dsh-session-recap（维护者 SAS-159，分类：客户端）。它把当前会话整理成一张 会话复盘卡片，并在 Composer 区域提供一键导出 Markdown 或独立 HTML，数据只在浏览器内从会话已有信息推导，不发起外网请求。
这是什么¶
dsh-session-recap 是一个 DSH bundle（npm 包名 dsh-session-recap，当前版本 0.1.0，许可证 MIT）。定位是：把任意一次 Harness 会话变成可分享的 recap card，汇总轮次、步数、工具调用、Token 拆分、缓存命中率，以及按 DeepSeek Flash 官网定价估算的低谷价–高峰价花费区间。
插件挂在 Web 会话 UI 的 conversation.composer.dock 槽位，紧挨内置的活动与用量 pill 之后出现一个入口 pill；点开即可查看卡片并复制或下载。
核心功能¶
卡片上展示的内容与 README 示意图一致，主要包括：
- 会话统计：轮次、步数、耗时、工具调用次数（来自
useProjection('sessionStats')）。 - Token 拆分：未缓存输入、缓存读取、缓存写入、输出等（来自
useProjection('tokenUsage')），并给出缓存命中率。 - 工具使用：从 Chat 快照的
legacy.nodes中汇总tool-call行，按工具名分组。 - 花费预估：按 DeepSeek 官方定价 的 DeepSeek Flash 列表价（USD/1M tokens）计算区间；高峰时段为工作日 UTC 01:00–04:00 与 06:00–10:00，会话总价以低谷–高峰范围显示。定价常量在
client.js顶部PRICE，官网调价时需自行更新。 - 导出：一键复制 Markdown、下载
.md、下载自包含.html，便于事后分析、团队同步或写文章说明 agent 行为。
与「只有上下文压力、没有账单视角」的默认体验相比，这张卡直接回答：这轮会话做了什么、大概花了多少。
隐私与兼容¶
卡片数据完全来自当前页面已开放的会话信息，在浏览器本地渲染；除用户点击下载外不写盘，会话之间不持久化，无遥测、无额外存储。
兼容 DSH 桌面版 / Web 版（platform: web）。若 react-dom 不可用，客户端会退回就地面板而非 portal；若部分 projection 缺失（较旧构建），仍可从 Chat 快照单独渲染卡片。
安装与启用¶
社区市场经 dshmarket 与 awesome-dsh-plugin 策展收录后，可在市场 UI 安装，或使用官方文档中的命令（profile 为 web）：
dsh plugin --profile web add dsh-session-recap
仓库也自带 format-1 市场索引 market/index.json：用静态 HTTP 服务托管后，在 Plugins → Discover → Index sources 添加该索引 URL 即可从自定义索引安装。本地开发 bundle 时可用 plugin_manager 的 install_bundle 指向构建产物目录；仓库已提交 dist/，从索引或已发布 npm 包安装通常无需本地 build。
安装前请自行查看 GitHub 仓库 源码与 MIT 许可证。插件以当前 DSH 进程权限运行，与任何客户端插件一样，只应安装你信任的来源。
典型用法¶
- 在 DSH Web 界面正常完成一轮或多轮对话（含工具调用）。
- 在 Composer 停靠区找到会话复盘入口 pill（位于内置 activity / usage pill 之后），打开卡片。
- 核对轮次、Token 拆分、缓存命中率与预估花费区间；需要留档时选择 复制 Markdown、下载 .md 或 下载 .html。
定价逻辑与高峰时段规则以仓库 client.js 与 README「How it works」表为准；官方价变动时维护者或使用者需同步更新 PRICE 常量。
适用场景与注意¶
适合：需要量化单次 agent 会话成本与行为的开发者；要写 post-mortem、团队周报或技术文章、需要可分享结构化摘要的场景。
注意：
- 花费为按列表价的估算区间，不是账单对账；模型与时段需与当时实际调用一致才有参考价值。
- 无网络、无上报的设计意味着卡片不会自动同步到云端，导出文件由用户自行保管。
- 社区目录 SkillHub 插件页 与 GitHub 为同一项目的不同入口；安装命令与行为以仓库 README 为准。
DSH 生态强调「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-session-recap 把当前会话的轮次、工具、Token 与缓存、预估花费收成一张本地生成的复盘卡，并支持 Markdown / HTML 导出，补上了「花了多少钱、干了什么」这一层可观测性。
