🐋 鲸鱼记事本（dsh-whale-report）

你的 Agent 年度报告：从会话事件日志里长出来的数据新闻官。 日报 / 周报 / 月报 / 年报 / 任意区间，一份就能发朋友圈。

它能干嘛

对 DSH 说一句，立刻得到一份报告：

给我一份周报 ｜ 这个月我干了啥 ｜ 去年我和鲸鱼的故事

报告内容全部来自你自己的会话事件日志（只读，绝不改写历史）：

• ⚙️ 干了多少活：会话数、回合数、子代理次数、工具使用排行
• 🔥 烧了多少 token：输入/输出/缓存命中/思考，四个口袋分开记账
• 🌙 作息画像：24 小时活跃热力条 + 熬夜指数 + 人设评语（守夜鲸/模范鲸）
• ⚠️ 惊魂时刻：危险命令清单（rm -rf、force push、删库……）原样列出，逐条带时间
• 🧵 会话标题：这段日子你在忙什么的记忆切片

立即体验（不用装插件，一条命令）

pnpm install && pnpm build
pnpm report                # 周报（最近 7 天）
pnpm report -- --daily     # 日报
pnpm report -- --monthly   # 月报
pnpm report -- --yearly    # 年报
pnpm report -- --all       # 从有史以来到现在
pnpm report -- --from 2026-08-01 --to 2026-08-14   # 自定义区间

脚本直接读 ~/.dsh/sessions/*/session.jsonl.zstd（多帧 zstd 逐帧解压）， 与插件共用同一个报告引擎（src/stats.ts），引擎行为由 12 个单测锁定。

装成插件

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

装好后有两个入口：

🐋 专属面板（v0.2，主入口 —— 不是聊天里的 skill）

重启后 Web GUI 右下角会出现鲸鱼按钮 → 点开是「鲸鱼记事本」抽屉面板：

• 日报/周报/月报/年报/自定义区间，一键生成
• 报告渲染成统计卡片 + 24 小时作息热力条 + 惊魂清单（DSH 主题配色）
• 导出 PDF（浏览器打印）→ 直接发群发朋友圈
• 「历史」页：所有报告落库保存，随时回看、删除

面板不经过聊天：走插件自己的 /whale/api 路由（本机同源围栏）， 由官方 client-modules 接缝装载的浏览器 half 渲染。

💬 聊天路径（保留）

也可以直接说"给我一份周报"——whale_report 工具会把 markdown 报告发到对话里。

插件走官方接缝：ctx.sessionQuery（listSessions + readSession）， 零补丁、零核心改动，卸载即净。报告生成时还会把 whale/report 事件 写回会话日志——记事本会记下它自己写的账。

项目结构 = 你的教材

文件	你学到什么
src/stats.ts	报告引擎：纯函数聚合、事件宽容解析、可单测的数据层
src/report.ts