session-report-anthropics-claude-plugins-official

1. 基本信息

项目	内容
名称	session-report
作者/维护者	Anthropic（`claude-plugins-official` 官方市场“内部插件”目录）
来源链接	https://github.com/anthropics/claude-plugins-official/tree/main/plugins/session-report
许可证	Apache-2.0（来自 GitHub API，明确）
GitHub Stars	32,268（来自 GitHub API；数字属整个 `claude-plugins-official` 仓库，不代表本插件自身热度）
Forks	3,597（同上，属整仓库口径）
官方安装数	10,837 次安装（来自 claude.com 官方插件页 `claude.com/plugins/session-report`，该数字专属本插件）
最新版本	未获取（该插件目前缺少 `.claude-plugin/plugin.json` 清单，无版本字段可读，详见第 11 章）
安装方式	`/plugin install session-report@claude-plugins-official`，或在 Claude Code 的 `/plugin > Discover` 中浏览安装

2. 功能介绍与亮点

session-report 会读取本机 ~/.claude/projects 下的 Claude Code 会话 transcript（.jsonl），统计 token 用量、缓存命中率、子代理（subagent）调用、各 skill 的用量占比、以及开销最高的若干条 prompt，随后生成一份自包含单文件 HTML 报告（内嵌排序表格、可展开明细、柱状图），并由 Agent 自动撰写 3–5 条“异常发现”与若干条“优化建议”嵌入报告叙事部分。

核心亮点：

数据处理与报告生成全部在本地完成，不依赖任何外部服务；
支持自定义统计窗口（24h/7d/30d/all）；
报告文件可直接用浏览器打开，也可发给团队成员查看，无需额外工具。

3. 适用场景

固定分类：元技能与 Agent 增强。

面向重度使用 Claude Code 的开发者与团队：想弄清楚每周 token/cache 开销花在了哪个项目、哪个 skill、哪条 prompt 上；想知道 cache 命中率是否偏低、哪类 subagent 调用成本偏高；需要一份可读、可分享的用量复盘材料，而不是原始 JSON 数字。

4. 跨 Agent 兼容性

Claude Code：原生支持 ✅ —— 由 Anthropic 官方为 Claude Code 插件系统开发，直接读取 Claude Code 专有的 ~/.claude/projects transcript 格式。
Codex：不支持 ❌ —— 分析脚本硬编码依赖 Claude Code 的 transcript 目录结构与 JSONL 字段格式，Codex 的会话记录不是同一格式，无法直接读取。
OpenClaw：未验证 —— 未获取到该平台的 transcript 存储方式与本插件的兼容性证据。
Hermes Agent：未验证 —— 同上，未发起专门验证。

5. 推荐理由

它是 Anthropic 官方亲自出品、直接解决“Claude Code 到底把 token 花在哪了”这个真实痛点的工具：一条命令安装，全程本地运行不产生任何数据外发风险，生成的报告比裸 JSON 更直观，还能把优化建议直接写进报告里，省去自己翻 transcript 找问题的功夫。

6. 评分

维度	分数	说明
受欢迎程度	8	官方 claude.com 插件页显示已有 10,837 次安装，且属 Anthropic `claude-plugins-official` 市场“内部插件”目录（非第三方投稿），信任背书强
可用性	7	一条命令即可安装，SKILL.md 步骤清晰、脚本自带无需额外依赖；但目前有两个已知未修复问题拉低体验（见第 11 章）
安全性	9	逐项见下

安全检查清单： ① Shell 命令及权限范围——仅执行本地 Node 脚本读取 ~/.claude/projects 下的 .jsonl 文件并写入本地 HTML 文件，无越权操作；② 联网外发数据——分析脚本本身未发现任何网络请求；生成的报告页面会从 Google Fonts CDN 加载字体资源，属静态资源加载，不涉及用户数据外传；③ API key/凭据——不需要任何凭据；④ 可疑指令——SKILL.md 与脚本中均未发现异常指令；⑤ 作者信誉——Anthropic 官方；⑥ License——Apache-2.0，明确；⑦ 最近维护——插件所属仓库 2026-07-18 仍有提交，插件本体自 2026-04-08 创建以来有过后续改进，但存在两个分别开放于 2026-05-15、2026-05-25 且至今未修复的 issue。

7. 跟同类 Skills 相比的优势

对比对象	定位	与本技能的差异
ccusage	独立 CLI，解析同样的本地 transcript，输出终端表格/JSON 成本报表，是社区里公认的 Claude Code 用量分析事实标准	需要单独 `npm` 安装并手动运行命令，产出的是静态数字表，不生成可视化、可分享的单文件报告，也不含 Agent 自动撰写的异常/优化叙事
agentic-actions-auditor（Trail of Bits）	面向 Agent 执行动作的安全审计，检查危险操作与权限越界	关注点是“安全合规”而非“成本/效率”，两者互补但不重叠

session-report 的差异化在于：随 Claude Code 插件系统一键安装、零配置、生成交互式 HTML 报告，并由 Agent 直接把“哪个项目/skill 占比异常”“cache 命中率是否偏低”这类判断写成一句话叙事，省去用户自己翻数字表格找结论的步骤。

8. 用户评价

官方 claude.com 插件页面显示该插件已有 10,837 次安装，但页面未展示具名用户评价或评分。已核实收录该插件的第三方 Claude 插件聚合站点（如 claudemarketplaces.com、mcpservers.org）同样只提供插件元信息，未见具名评论。该技能目前在第三方平台尚无具名用户评价。

9. 其他补充

报告输出为自包含单文件 HTML（内嵌 JS 用于排序、展开/折叠、柱状图渲染），可直接用浏览器打开，也可作为文件分享给团队成员。未见多语言支持说明。作为 Anthropic 内部插件，其变更遵循 claude-plugins-official 仓库的标准 PR 流程；该仓库文档要求所有插件必须含 .claude-plugin/plugin.json 清单，但本插件目前缺失该文件（见第 11 章）。

10. 安装使用方式

Claude Code 插件系统：运行 /plugin install session-report@claude-plugins-official，或在 /plugin > Discover 中浏览并安装。
安装后：无需重启 Claude Code，直接在对话中提出“生成本周的 session report”之类的请求即可触发该 skill；也可指定统计窗口，如“生成最近 30 天的用量报告”。
报告默认生成在当前工作目录，文件名形如 session-report-20260718-1200.html，用浏览器打开即可查看。

11. 注意事项

已知未修复问题一：该插件缺少 .claude-plugin/plugin.json 清单文件，会导致它在 Claude Code Desktop 的技能列表中以两个不同命名空间（形如 <git-SHA>:session-report 与 session-report:session-report）重复出现，属已确认的显示类缺陷（GitHub issue #2022，开放于 2026-05-25，截至本次核实仍未修复，此前一次修复 PR 已被关闭但未合并）。
已知未修复问题二：分析脚本硬编码读取 ~/.claude/projects，若通过 CLAUDE_CONFIG_DIR 环境变量将配置目录重定向到非默认路径，脚本会读取错误位置而拿不到数据（GitHub issue #1869，开放于 2026-05-15，同样尚未修复）。
生成的报告完全基于本地 transcript，不上传云端；但报告内容可能包含项目名称、prompt 片段等信息，若要分享给团队之外的人，建议先自行审查内容再发送。
运行分析脚本依赖 Node.js（Claude Code 运行环境通常已自带）。