前言¶

在 DSH（DeepSeek Harness）里跑 Agent，会话结束后往往只剩一堆事件日志。翻日志能知道「做了什么」，却很难快速回答：哪些 session 最贵、为什么突然 retry、夜里跑了多少、这周有什么值得改。

常见做法是开 log viewer 或自建 dashboard，前者要人工筛，后者往往还要再调模型做「点评」，结论不稳定、也额外花 token。dsh-whale-report（深迹 DeepTrace）走另一条路：只读本地 session event logs，用确定性聚合和显式规则生成日报、周报、月报、年报或自定义区间报告，生成报告本身不消耗模型调用。

下面介绍这个插件的定位、能力与安装用法。

这是什么¶

dsh-whale-report 是 DSH 生态下的记忆类插件，维护者为 SenmuuuuW，GitHub 仓库 SenmuuuuW/dsh-whale-report（约 28 stars）。npm 包名 dsh-whale-report，当前版本 0.5.2，MIT 许可证。

一句话定位：Your Agent, in numbers——把 DSH 的 session、token、cost、tool call、风险与异常，转成可读的 Agent 报告。它不是 log viewer，也不是普通 dashboard；核心是确定性洞察与协作复盘，只读、不改写历史。

报告能回答什么¶

一次报告按 SEE → NOTICE → TRACE → IMPROVE 走完闭环：

1. SEE：总览成本、调用、模型与异常
2. NOTICE：10 条 Finding 规则 + Whale Note 标出值得看的问题
3. TRACE：Session Drilldown 追到具体会话
4. IMPROVE（v0.5）：只读建议 + 证据 + VERIFY 计划，为后续自动回验预留

支持的预设周期如下：

核心能力¶

计量与成本¶

报告覆盖费用、token、会话活跃度、工具调用、风险信号等维度，要点如下：

• Cost：按 DeepSeek 官方峰谷价分段计算（2026-08-17 起高峰 9–12 / 14–18 为谷时 2 倍；定价页实时抓取、6h 缓存、内置价兜底），按模型与会话分账，带峰谷占比与「挪到谷时约省 ¥X」估算
• Live session：进行中会话 30s 刷新实时计费，右上角显示峰/谷徽标
• Tokens：input / output / cache read / reasoning，按模型拆分
• Activity：小时级热力图（GitHub contribution 风格），含峰值时段、夜猫指数
• Tool calls & Tool health：调用明细与高频工具（≥30 次）失败率分级
• Retry bursts：同一命令连续重复 ≥3 次，附错误摘要样本
• Dangerous operations：红级（不可逆破坏）/ 黄级（需留意），仅匹配命令首行
• Secret scan：6 类常见密钥模式存在性检测，只报有无、不存原文
• Baseline & Trends：较上周期对比、多周期趋势曲线；进行中周期标记 LIVE
• Provider balance：DeepSeek 平台实时余额（key 仅在本机服务端使用）

v0.5.0 起 usage accounting 口径：total = input(miss) + cacheRead(hit) + output，reasoning 只作 output breakdown；费用 = miss×输入价 + hit×缓存价 + output×输出价。

确定性洞察，零额外 LLM token¶

统计与洞察不由另一个 AI 随机点评，而基于 session event logs、确定性聚合、显式规则与可复现的报告生成。同一份数据 → 同一份结论；报告生成标注为 REPORT GENERATION · 0 TOKENS · LOCAL DETERMINISTIC。

10 条 Finding 规则：深夜消耗、峰谷时段成本、重试风暴、缓存命中率变化、致命级操作、需留意操作、会话碎片化、疑似密钥、费用趋势、工具健康。每条带阈值、归因与估算口径。

4 条 IMPROVE 规则（v0.5，只读、不自动改配置）：

每条建议带 evidence（metrics / affectedSessions / 置信度）与 verificationPlan（基线 → 目标、窗口）。v0.5 只落 DETECTED / DISMISSED；Apply / self-healing 为后续版本预留。

另有 协作复盘（COLLABORATION REVIEW）：观察需求漂移、迟到约束、上下文碎片化，最多 3 条，样本不足不展示。

只读与安全边界¶

• 绝不改写 session 历史；统计排除 DeepTrace 自身的 whale/* 事件
• 修复建议只输出方案与命令模板，需人工确认
• Secret Scan、危险命令、用户纠正信号均不保存原文
• 损坏日志优先只读 salvage，无法恢复时仅披露会话 id 与粗分类原因
• API 只服务本机 loopback

导出¶

• Web 报告面板（含 IMPROVE 与 DATA PARTIAL 提示）
• PNG 主报告（不含会话轨迹与 IMPROVE 区）
• 会话轨迹单独 PNG
• HTML（含 IMPROVE 章节）
• PDF（浏览器打印面板报告）

安装与启用¶

需要 DSH web 端环境。v0.5.0 针对 DSH 0.1.1-rc.2 验证（peer 范围 >=0.1.1-rc.2 <0.2.0）；升级 dsh 后重启 web 实例即可。Node 要求 ^22.19.0 || >=24.0.0。

推荐：DSH 插件安装（注册进 dsh web，完整功能）：

dsh plugin --profile web add "github:SenmuuuuW/dsh-whale-report"

安装后重启 dsh web 使宿主代码生效；客户端 bundle 随插件自动更新。

备选：npm 包安装（仅依赖，不自动注册插件）：

npm install dsh-whale-report

npm install 不会自动注册为 DSH 插件；Web UI、whale_report 工具与实时计费需用上面的插件安装方式。npm 方式适合直接 import 报告引擎或用 CLI 生成报告。

插件以当前 dsh 进程权限运行，安装前建议阅读源码与 MIT 许可证，确认只读边界符合你的安全要求。

典型用法¶

面板与对话¶

两个入口：

1. 面板：装了 better-sidebar 时在「+」菜单打开「深迹」Tab；未装时右下角悬浮按钮兜底
2. 对话：直接说「给我一份周报」——whale_report 工具输出 markdown 报告

数据走官方接缝（ctx.sessionQuery + storage domain），卸载即净。

CLI 本地体验（无需装插件）¶

克隆仓库后可用 CLI 直接读本机会话存档（~/.dsh/sessions/*/session.jsonl.zstd），与插件共用同一报告引擎：

pnpm install && pnpm build
pnpm report                  # 周报（最近 7 天）
pnpm report -- --daily       # 日报；或 --monthly / --yearly / --all
pnpm report -- --from 2026-08-01 --to 2026-08-14   # 自定义区间

适用场景与注意¶

适合谁：长期在 DSH 上跑 Agent、需要定期复盘成本、工具健康、风险信号与协作摩擦的开发者；希望报告可复现、不额外花 LLM token 的团队。

当前边界（README 如实说明）：

• 会话跳转：报告提供 Session ID 复制，尚未实现一键跳回原会话
• 费用为估算：按官方峰谷价分段，以平台账单为准
• IMPROVE 为只读建议：Apply / self-healing / 自动 Verify 闭环未实现
• PNG 主报告导出暂不含 IMPROVE 区（HTML / PDF / markdown / 面板已含）

DSH 社区目录 SkillHub 是独立站点，与 DeepSeek / 幻方无官方从属关系；插件遵循 DSH「一切皆插件」的生态思路，非官方应用商店分发。

结尾¶

dsh-whale-report 把 Agent 行为变成可检视、可度量、可改进的数字报告：确定性规则替代随机点评，只读边界保护历史数据，六类周期覆盖从日报到自定义区间。若你已在 DSH 上积累大量会话，值得装一份做定期复盘。

• 目录页：https://www.skillhub.cn/plugins/SenmuuuuW/dsh-whale-report
• GitHub：https://github.com/SenmuuuuW/dsh-whale-report