本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-whale-report

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-whale-report

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 哪些 session 最贵？
• 为什么突然开始 retry？
• 是哪次任务把成本拉高的？
• 这周有什么值得改的？
• session event logs

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

装好后能立刻出第一份报告吗？

能，但首次打开面板或调用聊天工具时会先读取本机会话日志并建索引（src/tools.ts:206-226）；启动 3 秒后会后台预热全部会话，再次生成报告 0.1-0.3 秒返回（src/tools.ts:206-226, README.md:189-191）。

数据来源是自己的还是云端？

完全本地，只读。插件通过 ctx.sessionQuery 读取本机 DSH 会话存档，不写回任何会话历史，卸载即净（src/index.ts:26-34, README.md:206）。

报告里的费用是怎么算的？准吗？

按官方峰谷价（北京 9-12/14-18 高峰、空闲 2:1）从 DeepSeek 定价页实时抓取，6 小时缓存，抓不到自动回退内置价；这是估算口径，以平台账单为准（src/pricing.ts:22-232, README.md:251）。

报告生成会调用模型吗？

不会。所有统计、洞察、IMPROVE 建议都是本地确定性规则，生成报告 mode=local，input/output/cache/total token 全为 0；任何视图都不会因为打开报告而额外消耗模型额度（src/tools.ts:320-327, README.md:147）。

某个会话日志坏了会影响整份报告吗？

不会。损坏会话被跳过并标记为 corrupt-log 或 read-failed，跳过数计入 partial 数据，markdown/HTML/面板三处都有 DATA PARTIAL 提示，被跳过会话不计入 sessions/subagentSessions 也不进 Improve 证据（src/tools.ts:182-198, README.md:117）。

卸载插件后数据会留下吗？

不在 DSH 主数据里留下。插件把报告历史放在自己的 whale 域（reports / session_index / period_stats 三张表），卸载插件会随域一起清除；主会话历史插件从不动（src/state.ts:83-91, src/index.ts:31-33）。

报告支持哪几种周期？

日报（今天 0:00 起）、24 小时滚动、周报（本周一 0:00 起）、月报（本月 1 日起）、年报（本年 1 月 1 日起）、自定义任意 from/to（ISO 格式）。自然周期 key 用 day-/24h-/wk-/mo-/yr- 前缀隔离，互不串扰（src/report.ts:36-80, README.md:162-170）。

报告能导成什么格式？

面板 Web 视图（含 IMPROVE 区）、HTML 可打印页、PDF（浏览器打印）、PNG 主图（不含 IMPROVE 区）、PNG 会话轨迹图（仅会话轨迹与会话索引）；导出全程本地完成（README.md:174-178, docs/ARCHITECTURE.md）。

— 源: plugin_wiki.faq_json

兼容性

• DSH: >=0.1.0-rc.7
• Node: >=22.19.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则