前言¶
用 DeepSeek Harness（DSH）做智能体开发时，会话日志里会不断出现 write、edit、str_replace_editor 等写入类工具调用，但宿主本身并不直接给出「生成了多少行代码、文档写了多少、改动的采纳率、按模型分摊的成本」这类汇总。若要复盘效率或核对花费，往往只能翻日志或靠外部脚本，口径也不统一。
output-overview 是社区维护的 DSH 第三方插件：读取本机 ~/.dsh/sessions 下的会话历史，离线聚合代码与文档产出、两种采纳率以及按轮次归集的成本，并通过 Web 设置面板与 HTTP API 展示。计算全部在本机完成，不访问外部服务。DSH 生态主张「一切皆插件」；SkillHub 等目录页由社区独立维护，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
维护者：MarchingWorkhorse。仓库：Output-Overview，目录页：SkillHub - Output-Overview。当前 package 版本 0.3.1，许可证 MIT。
插件通过宿主挂载的 ctx.sessionQuery 只读会话日志，识别文件写入操作并做近似重放统计；在 web profile 下依赖内置的 webServer 注册路由与前端面板。分类上在目录中常归为「记忆」类，实际能力侧重产出统计与成本归集，而非长期记忆存储。
核心功能¶
下面指标口径均来自插件 README，窗口过滤（全部 / 今天 / 最近 7 / 30 天 / 自定义 from/to）只计窗口期操作；内容重放仍用全量历史以保证「代码存活」判定准确。
| 指标 | 说明 |
|---|---|
| 生成代码行数 | write 全文行数 + 编辑工具新增行数；按扩展名排除文档类文件 |
| 文档统计 | .md、.markdown、.mdx、.txt、.rst、.adoc 的文件数与生成行数 |
| 采纳率（代码存活） | 重放全部写入/编辑并做行级来源追踪：窗口内生成且现仍存活的行数 ÷ 窗口内生成行数 |
| 采纳率（工具执行） | 写入类工具调用成功执行的比例；被拒、报错或无结果算不采纳；只读 view 不计入 |
| 成本 | 按轮次归集 token 成本（未缓存输入 / 缓存读 / 缓存写 / 输出），再按该轮生成的代码/文档行数比例分摊；无写入的轮次计入「对话开销」；默认以人民币（CNY，¥）显示，可按配置汇率由 USD 折算 |
| 展示维度 | 总览卡片、按会话、按日期、按文件 Top 榜；面板含最近 14 天趋势与文件 Top 10 |
README 中给出过某真实环境示例（37 个会话）：生成代码 12,604 行，代码存活采纳率 80.5%，工具执行采纳率 88.0%，文档 58 个 / 4,682 行，总成本 ¥58.06（含代码、文档、对话开销分项，按 1 USD = 6.70 CNY 折算）。该数字仅作口径说明，不代表你的环境结果。
安装与启用¶
安装命令须使用资料原文（web profile）：
dsh plugin --profile web add https://github.com/MarchingWorkhorse/Output-Overview.git
装好后重启 DSH（插件进入 bundle 栈，需进程重载）。打开 Web 界面 设置 → 产出总览 即可查看面板。
本地开发调试可用目录路径安装（Windows 示例为 junction 链接，改代码后重启生效）：
dsh plugin --profile web add D:\path\to\output-overview
兼容性：README 记载在 DSH 0.1.5-rc.1（web profile） 已验证。headless 等 profile 无 Web 面板意义，文档标明未测试。
典型用法¶
Web 面板¶
- 进入 设置 → 「产出总览」。
- 顶部可多选工作区（点击列表项切换；「全部工作区」清空选择）、开关子代理会话、选择时间范围。
- 下方查看趋势表与文件 Top 10。成本以 ¥ 显示并注明汇率。选定工作区后，所有卡片（含总成本）只统计该工作区的会话；右上角会显示「N 个会话（全部 M）」。
- 点 「定价配置」 可从会话日志提取模型列表、填四类单价、选单价币种（USD/CNY）、默认模型、显示币种与汇率，保存并重算 写入
~/.dsh/output-overview-config.json（优先于cordis.patch.yml）。
HTTP API¶
汇总数据：
GET /output-overview/api/summary
常用查询参数：
workspace=<cwd>：可重复，实现多选（缺省为全部）。subagents=false：控制是否计入子代理会话。from=<ms>&to=<ms>：自定义时间窗（epoch 毫秒，双闭区间）。refresh=1：刷新缓存。
返回中包含代码/文档/采纳率/成本聚合；所有指标（含成本与会话数）均跟随工作区过滤——sessionCount 为所选工作区会话数，全库总数为 totalSessionCount。成本字段已按 displayCurrency 折算（costs.currency、costs.fx.rate 标注币种与汇率）。
定价与币种覆盖：
GET /output-overview/api/config
POST /output-overview/api/config
POST 保存后 summary 缓存自动失效。
定价与币种（YAML 可选）¶
除面板外，也可在 profile 的 cordis.patch.yml 中配置（改完需重启）。多模型分表计价示例（节选）：
- id: output-overview
config:
pricing:
default: glm-5.3-flash
unit: CNY
models:
glm-5.3-flash:
hit: 0.11
miss: 0.42
write: 1.4
out: 1.4
currency:
code: CNY
symbol: "¥"
fx: 6.7
默认内置一档 glm-5.3-flash（USD 报价：输入 $0.06 / 缓存读 $0.01725 / 缓存写 $0.21 / 输出 $0.21）。显示默认 CNY，汇率默认 1 USD = 6.70 CNY（README 标注 2026-10-12 牌价）。
适用场景与注意¶
适合谁：需要在同一 Web 界面里按工作区、时间范围查看 DSH 生成代码/文档规模、采纳率与模型成本分摊的开发者；也适合用 HTTP API 做二次展示或脚本拉数。
权限与数据：插件以当前 DSH 进程权限 运行，能读 ~/.dsh/sessions 与会话内的工具参数。安装前应自行审阅 源码与 MIT 许可证。文档说明：统计路由为 GET、不执行 shell、不访问外网、不收集遥测；唯一写操作是面板保存定价时原子写入 ~/.dsh/output-overview-config.json。
统计局限：编辑重放按字面量子串替换语义执行；若文件被 AI 以外手段修改，极端情况下指标可能偏差。被拒绝或执行失败的写入不计入生成行数。
结尾¶
output-overview 把 DSH 会话里的写入类工具调用转成可读的产出总览与成本分项，并集中在 设置 → 产出总览 与 /output-overview/api/* 接口中，适合在本机离线复盘 AI 辅助开发的「写了多少、留了多少、花了多少」。
- 目录页：https://www.skillhub.cn/plugins/MarchingWorkhorse/Output-Overview
- GitHub：https://github.com/MarchingWorkhorse/Output-Overview
