本项目遵循 Semantic Versioning 与 Keep a Changelog 风格。
- 海报从「可选附加物」明确为默认交付物:除非用户明确说不要海报,否则
Step 8b必须生成output/poster_<...>_<lang>.svg。
- 补充 SVG XML escaping 与生成后解析校验要求,防止动态文本里的裸
&/</ HTML 实体导致浏览器打开海报时报 XML 错误。
2.5.3 - 2026-06-07
Cursor 内容元数据增强 — 不只检测 workspace/key,也读取 composer 标题、项目、时间和变更规模信号。
- Cursor
composer.composerHeaders解析:从本地state.vscdb读取allComposers[].name/subtitle/createdAt/lastUpdatedAt/workspaceIdentifier/trackedGitRepos/totalLinesAdded/totalLinesRemoved,用于关键词、项目分布、Cursor composer 数和本地协作强度。 - Cursor plan/topic 线索:读取
composer.planRegistrykeys 作为 spec/plan 主题信号,不把它们当精确 session 计数。 - 报告模板显式加入 Cursor:多模型编排表、Top 项目表和编排模式统计都新增 Cursor 维度。
- Cursor
.cursor配置扫描示例避免使用 zsh 特殊变量path,改为project_path,防止破坏PATH。 - Cursor SQLite 示例改为直接
sqlite3 "file:...?mode=ro&immutable=1",避免 shell 变量含空格导致命令不可执行。
2.5.2 - 2026-06-07
月度 / 阶段报告 — 支持按指定月份或时间范围分析 AI 编码效果变化。
- 时间窗口模式(解决 #3):支持
2026-05、2026-03 到 2026-05、最近30天/last 30 days等表达。 - 统一窗口过滤协议:Claude / Codex / Kiro / Trae / Antigravity / Cursor / GitHub / 本地 git 的可过滤数据都按
[REPORT_START, REPORT_END_EXCL)半开区间统计。 - 阶段变化章节:指定窗口时,对比上一等长周期或窗口内前后半段,解释 active days、AI sessions、verified tokens、GitHub contributions、local commits、项目/工具重心的变化。
- 窗口化输出文件名:指定月份或日期范围时生成
output/profile_<REPORT_SLUG>_<DATE>.md与output/poster_<REPORT_SLUG>_<DATE>_<lang>.svg,避免覆盖同一天的全量报告。
- Claude
modelUsage明确为 all-time 聚合,月度报告优先使用dailyModelTokens;无法按窗口切分的字段只作为 all-time context 或降级说明。 - GitHub 与本地 git 从硬编码 365 天扩展为默认 365 天、指定窗口时按用户窗口统计。
- README zh/en 增加月度报告触发词、输出文件名和 Roadmap 说明;
--diffRoadmap 文案改为“与上次生成报告对比”,避免和时间窗口过滤混淆。
2.5.1 - 2026-05-28
6 引擎全员到齐 — 新增 Cursor 支持,至此已覆盖 6 个主流 AI 编程工具。
- Cursor (Anysphere) 部分支持 — SKILL.md
Step 3e:~/Library/Application Support/Cursor/User/{workspaceStorage,globalStorage}/state.vscdb的composer.*/aiService.*/aichatkeys(VS Code fork,跟 Trae 同架构)+ 项目.cursor/{rules,mcp.json}/.cursorrules。token 权威在 Anysphere 云端 dashboard,本 skill 不联网,本地仅参考估算。 - 新触发词:「分析我的 Cursor 使用情况」/ "summarize my Cursor history"。
- Step 6.1 / 6.2 / 6.4 字段、Step 6.4 综合分数与多工具编排(升级到 6 工具五选 N)、降级表、红线段落均同步加入 Cursor 项。
- README zh/en 顶部 hero 句、版本徽章 (
v2.5.1)、「支持的 AI 编程工具」表都加上 Cursor 行。 - plugin.json + marketplace.json description 反映 6 工具支持。
2.5.0 - 2026-05-28
「四引擎」时代 — 从 Claude+Codex 双引擎扩展到 4 个 AI 编程工具。
- Kiro (AWS) 完整支持 — SKILL.md
Step 3b:~/.kiro/sessions/cli/*.{json,jsonl}+~/.local/share/kiro-cli/data.sqlite3+~/.kiro/{agents,skills,steering,prompts,settings}。 - Trae (ByteDance) 部分支持 — SKILL.md
Step 3c:~/Library/Application Support/Trae/User/{workspaceStorage,globalStorage}/state.vscdb(chat 元数据)+ 项目.trae/{rules,skills}。Trae token 用量走云端 API,本 skill 保持离线,token 数字默认缺失。 - Gemini Antigravity (Google) 支持 — SKILL.md
Step 3d,来自社区 PR #1 by @BaekElk19:~/.gemini/antigravity/brain/<uuid>/每任务 metadata +task.md/implementation_plan.md/walkthrough.md。token 不可得时按 task/artifact 计数 + text-scale 估算(明确标注 non-billing)。 - 新触发词:「分析我的 Kiro / Trae / Antigravity 使用情况」/ "summarize my Kiro / Trae / Antigravity history"。
- 多工具编排升级:Step 6.4 综合分数与编排模式从「双引擎」扩展为「多引擎」,支持 Claude + Codex + Kiro + Trae + Antigravity 五选 N。
- 降级策略表新增 Kiro / Trae / Antigravity 缺失时的处理。
- GitHub Discussions 开启,新增
Show your profile引导。 .github/ISSUE_TEMPLATEYAML form:bug / feature / new-tool-support。- CHANGELOG.md(本文件)。
- README badges + Roadmap + FAQ + 对比表 + Community CTA。
- README 整段重写,按热门项目模版(用户语言开场 + 受众矩阵 + 30 秒装上 + 对比同类)。
- GitHub Topics 6 → 20,新增
kirotraeclaude-skillreadme-generator等。 - plugin / marketplace.json description 反映 4 工具支持。
- #2 Add Kiro + Trae.ai support。
2.4.0 - 2026-05-08
链式传播海报 — 海报自带「金句 + 徽章 + 安装 CTA」三件套,看到的人能立刻生成自己的。
- SVG 海报渲染 (
Step 8b) — 1080×1920 竖屏,6 个英雄数字 + Evolution timeline。 - AI 自评金句(Tone A-F):把 token 量换算成「等于 N 万遍《红楼梦》」破圈类比。
- 身份徽章自动判定:TWO-ENGINE / CACHE MASTER / SKILL BUILDER / POLYGLOT / TOKEN WHALE 等。
- 30 秒安装 CTA:海报底部直接放 install 命令 + 仓库 URL。
- 海报双语:自动按提问语言出中/英版,技术术语保留英文。
- 🎉 阮一峰《科技爱好者周刊》第 395 期 — 2026-05-08。
- Skill description 多行 YAML(
>folded /|literal)解析 bug。之前用head | grep会静默截断到只剩>。
- 💎 Token 经济学 作为第 10 个维度:cache leverage / 模型迁移 / 月度趋势 / 模型迁移注解。
- 作为 Claude Code Plugin 发布(两行命令安装)。
- 允许读取
message.content用于关键词与协作风格深度分析(不写进报告原文)。
从「炫数据」到「讲故事」 —— 报告重心从堆 token 量改为讲 AI-Native 成长弧线。
- 🚀 Velocity & Leverage —— AI 让你快了多少、广了多少。
- 🔧 AI 基础设施 —— 你给 AI 造了什么工具。
- 🧬 Evolution 曲线 —— AI 用法的成长弧线时间线。
- Session 架构分析:plan-first 占比、context 管理、effort 切换。
- 双工具编排模式:每个项目标注 Claude 主导 / Codex 主导 / 双引擎。
- GitHub 贡献优先,token 表降级到「参考」。
- 初始版本:Readme.skill 作为 Claude Code / Codex CLI 的 skill,从本地数据生成 AI-Native 开发者画像。
- 10 个维度的 Markdown profile。
- 默认匿名 + OWASP-style 正则清洗。