麦麦省钱助手 v2.5.2

🍟 McD Saver v2.5.2（麦麦省钱助手）

修复 README 的 Release 徽章链接失效。

修复

• README 中英 Release 徽章链接指向不存在的 tag：徽章文字为 v2.5.1，链接却指向 releases/tag/v2.5.2。新增断言：徽章文字与链接目标必须同版本（tests/test_consistency.py::test_readme_badge_links_match），避免手工回填版本号时只改一半。

质量

• 329 项测试全过（Ubuntu 3.9/3.11/3.13 + Windows 3.9）
• 发布产物：英文发行包 mcd-saver-v2.5.2.zip + 中文说明 麦麦省钱助手-v2.5.2-发布说明.md（GitHub 资产名为 mcd-saver-v2.5.2-release-notes-zh.md）

反馈

问题与建议请走仓库讨论区或 Issue：https://github.com/yuxinlaile/McD-saver/discussions

在线试算（免登录）：https://yuxinlaile.github.io/McD-saver/demo.html
完整变更：CHANGELOG.md

---

社区开源项目，与麦当劳中国官方无隶属关系；不做自动下单与无人值守自动化。

麦麦省钱助手 v2.5.1

🍟 McD Saver v2.5.1（麦麦省钱助手）

修复 v2.5.0 引入的 CI 步骤错误。

修复

• CI 的发布产物校验必然失败：压缩包 .zip 按设计不入库，CI 浅克隆中不存在，build_releases.py --verify 会对每个版本报「缺少英文压缩包」。新增 --no-zip-check：只校验目录命名、中文说明与索引覆盖；CI 改用 --verify --no-zip-check，本地仍跑完整校验（含 SHA-256）。

质量

• 328 项测试全过（Ubuntu 3.9/3.11/3.13 + Windows 3.9）
• 发布产物：英文发行包 mcd-saver-v2.5.1.zip + 中文说明 麦麦省钱助手-v2.5.1-发布说明.md（GitHub 资产名为 mcd-saver-v2.5.1-release-notes-zh.md）

反馈

问题与建议请走仓库讨论区或 Issue：https://github.com/yuxinlaile/McD-saver/discussions

在线试算（免登录）：https://yuxinlaile.github.io/McD-saver/demo.html
完整变更：CHANGELOG.md

---

社区开源项目，与麦当劳中国官方无隶属关系；不做自动下单与无人值守自动化。

麦麦省钱助手 v2.5.0

🍟 McD Saver v2.5.0（麦麦省钱助手）

全仓文档同步，把「靠人记」的更新点改成自动守卫。

修复

• workbuddy.md 统计与里程碑同步：提交数、用例数、发布版本数此前停在 2026-10-20（265 项 / 23 版），版本里程碑止于 v2.3.0；现按实测更新为 327 项 / 33 个发布版本（截至 v2.4.3），并补齐 v2.3.1–v2.5.0 八条里程碑
• README 中英「项目结构」遗漏一级目录：补 config/ 与 examples/
• SKILL.md 目录树 workbuddy.md 行缩进错位：对齐修正

改进

• 测试计数守卫扩面：4 处 → 7 处，新增 CONTRIBUTING.md、docs/index.html、MCP_INTEGRATION.md
• 新增流程文档守卫：check_toc.py / audit_readme.py / sync_readme.py --check / build_releases.py --verify 四条命令必须同时出现在 CONTRIBUTING.md、PR 模板与 CI 中
• 新增 workbuddy.md 事实守卫：单元测试数须等于 README 徽章、发布版本数须与 releases/ 实际目录数一致、版本里程碑表须含当前版本
• 新增 README 结构守卫：中英「项目结构」块须覆盖仓库全部一级目录
• CI 增加发布产物校验（build_releases.py --verify），PR 模板补齐四条自检命令

质量

• 322 → 327 项测试全过
• 发布产物：英文发行包 mcd-saver-v2.5.0.zip + 中文说明 麦麦省钱助手-v2.5.0-发布说明.md（GitHub 资产名为 mcd-saver-v2.5.0-release-notes-zh.md）

反馈

问题与建议请走仓库讨论区或 Issue：https://github.com/yuxinlaile/McD-saver/discussions

在线试算（免登录）：https://yuxinlaile.github.io/McD-saver/demo.html
完整变更：CHANGELOG.md

---

社区开源项目，与麦当劳中国官方无隶属关系；不做自动下单与无人值守自动化。

麦麦省钱助手 v2.4.3

🍟 McD Saver v2.4.3（麦麦省钱助手）

修复非中文 Windows 下中文输出崩溃，补齐券相关的排错条目。

修复

• 非中文 Windows 下中文输出崩溃：控制台编码为 cp1252 时，python demo.py 与各 CLI 打印中文抛 UnicodeEncodeError，命令整体失败。新增 scripts/console.py，11 个入口在 main() 开头把非 UTF-8 的 stdout/stderr 切到 UTF-8（errors="replace" 兜底），已是 UTF-8 的流不动；新增 tests/test_console.py（5 项，含「所有入口统一兜底」守卫）

文档

• references/error-handling.md 的「常见问题排查」补 3 条与券相关的条目：券不在本店/本渠道可用、未达使用门槛、不在可用时段或已过期，均按「症状 → 原因 → 怎么办」组织（关闭 #6）

质量

• 317 → 322 项测试全过
• 发布产物：英文发行包 mcd-saver-v2.4.3.zip + 中文说明 麦麦省钱助手-v2.4.3-发布说明.md（GitHub 资产名为 mcd-saver-v2.4.3-release-notes-zh.md）

反馈

问题与建议请走仓库讨论区或 Issue：https://github.com/yuxinlaile/McD-saver/discussions

在线试算（免登录）：https://yuxinlaile.github.io/McD-saver/demo.html
完整变更：CHANGELOG.md

---

社区开源项目，与麦当劳中国官方无隶属关系；不做自动下单与无人值守自动化。

麦麦省钱助手 v2.4.0

🍟 McD Saver v2.4.0（麦麦省钱助手）

贡献流程标准化、README 事实核对、版本递增的重复执行保护。

新增

• CODE_OF_CONDUCT.md（改编自 Contributor Covenant 2.1）；README「参与贡献 / Contributing」重写为四条标准入口（报 Bug / 提需求 / 改代码 / 补文档算例），分别链接 Issue 模板、PR 模板与行为准则
• scripts/audit_readme.py：README 事实一致性审计——命令速查表 ↔ CLI 子命令双向校验、反引号中的脚本路径存在性、用例数与 pytest --collect-only 实测一致、Python 版本三方一致（README / pyproject.toml / CI 矩阵）、许可证声明与 LICENSE 一致；已接入 CI
• CI 增加 sync_readme.py --check 步骤，确保 README 的近期版本区块与 CHANGELOG 不脱节

修复

• 版本递增的重复执行保护：执行环境重试同一条命令时，version.py --apply 会连跳两位（曾出现 2.3.2 → 2.3.3 → 2.4.0 的空档）。现写入 .git/RELEASE_PENDING 待发布标记：同一版本未打 tag 前重复执行只跳一格，打 tag 后自动放行，--force 可强制前进
• README 事实核对（基线 v2.3.3）：发现 9 处不一致并修复——用例数 10 处仍写 309（实际 319）、Python 运行要求只写在徽章里（正文无声明，已在「快速开始」补「运行要求」段）
• CONTRIBUTING.md 的提交自检清单补入 python scripts/audit_readme.py

质量

• 309 → 319 项测试全过
• 发布产物：英文发行包 mcd-saver-v2.4.0.zip + 中文说明 麦麦省钱助手-v2.4.0-发布说明.md（GitHub 资产名为 mcd-saver-v2.4.0-release-notes-zh.md）

反馈

问题与建议请走仓库讨论区或 Issue：https://github.com/yuxinlaile/McD-saver/discussions

在线试算（免登录）：https://yuxinlaile.github.io/McD-saver/demo.html
完整变更：CHANGELOG.md

---

社区开源项目，与麦当劳中国官方无隶属关系；不做自动下单与无人值守自动化。

麦麦省钱助手 v2.4.2

🍟 McD Saver v2.4.2（麦麦省钱助手）

修复遗留的工程债：负金额解析、重试限速、验证记录落盘、CI 平台覆盖与文档数字。

修复

• 退款与重试链路修复：silent_cost._parse_amount 的正则忽略负号，退款单会被当成正常消费计入客单价；现保留符号（含 -¥12.50 这类形态），消费画像新增 refund_order_count，退款不计入总支出与客单价。mcd_client._post 的 _throttle() 原本在重试循环之外，429 退避后的重试不计入滑动窗口，现每次实际发出的请求（含重试）都过限速器。Retry-After 此前被截到 30s，服务器要求等待更久时会提前重试；现指数退避部分仍封顶 30s，但尊重服务器指示至 300s 硬上限
• verify_run.py 覆写入库样例：默认输出改为 examples/verified-run.local.md（.gitignore 已覆盖），更新入库样例需显式 --out examples/verified-run.md；examples/verified-run.md 中不可达的 HTML 引用改为「本地生成，不入库」
• 覆盖率报告数字过期：按实测（317 项测试 / 79% / 497 行未覆盖）重写 docs/coverage-report.md

改进

• CI 增加 Windows job（windows-latest + Python 3.9）：跑测试并校验 install.ps1 的安装结果，覆盖此前只能在 Windows 触发的分支；覆盖率门槛 70% → 78%
• install.ps1 增补 README.md / CHANGELOG.md，装成技能包后仍带说明与变更记录
• CHANGELOG 顶部注明：1.0.0 / 1.1.0 为未发行里程碑（无 tag 与 releases/ 产物），历史条目中的 docs/development-log.md 已于 v2.2.2 并入 workbuddy.md

质量

• 310 → 317 项测试全过
• 发布产物：英文发行包 mcd-saver-v2.4.2.zip + 中文说明 麦麦省钱助手-v2.4.2-发布说明.md（GitHub 资产名为 mcd-saver-v2.4.2-release-notes-zh.md）

反馈

问题与建议请走仓库讨论区或 Issue：https://github.com/yuxinlaile/McD-saver/discussions

在线试算（免登录）：https://yuxinlaile.github.io/McD-saver/demo.html
完整变更：CHANGELOG.md

---

社区开源项目，与麦当劳中国官方无隶属关系；不做自动下单与无人值守自动化。

麦麦省钱助手 v2.4.1

🍟 McD Saver v2.4.1（麦麦省钱助手）

Star History 图表改用第三方渲染，移除仓库内的自绘链路。

变更

• Star History 图改回 star-history.com 渲染：README 中英改用 api.star-history.com/svg 图表，并注明该图由对方服务端定期抓取缓存、可能滞后数小时到一天，当前星数以顶部实时 Stars 徽章为准
• 移除自绘链路：scripts/gen_star_chart.py、docs/assets/star-history.svg、.github/workflows/star-chart.yml、tests/test_star_chart.py

质量

• 319 → 310 项测试全过
• 发布产物：英文发行包 mcd-saver-v2.4.1.zip + 中文说明 麦麦省钱助手-v2.4.1-发布说明.md（GitHub 资产名为 mcd-saver-v2.4.1-release-notes-zh.md）

反馈

问题与建议请走仓库讨论区或 Issue：https://github.com/yuxinlaile/McD-saver/discussions

在线试算（免登录）：https://yuxinlaile.github.io/McD-saver/demo.html
完整变更：CHANGELOG.md

---

社区开源项目，与麦当劳中国官方无隶属关系；不做自动下单与无人值守自动化。

麦麦省钱助手 v2.3.3

🍟 McD Saver v2.3.3（麦麦省钱助手）

Star 曲线加入每日自动重算。

改进

• 新增 .github/workflows/star-chart.yml：每日 11:17（UTC+8）自动运行 scripts/gen_star_chart.py 重算 docs/assets/star-history.svg，内容有变化时自动提交（无变化则跳过），支持手动触发
• README 的 Star History 段落注明曲线由 CI 每日重算，并附第三方 star-history.com 的同款曲线链接

质量

• 309 项测试全绿
• 发布产物：英文发行包 mcd-saver-v2.3.3.zip + 中文说明 麦麦省钱助手-v2.3.3-发布说明.md（GitHub 资产名为 mcd-saver-v2.3.3-release-notes-zh.md）

反馈

问题与建议请走仓库讨论区或 Issue：https://github.com/yuxinlaile/McD-saver/discussions

在线试算（免登录）：https://yuxinlaile.github.io/McD-saver/demo.html
完整变更：CHANGELOG.md

---

社区开源项目，与麦当劳中国官方无隶属关系；不做自动下单与无人值守自动化。

麦麦省钱助手 v2.3.2

🍟 McD Saver v2.3.2（麦麦省钱助手）

Star 曲线改为仓库内自绘，参与贡献段落重写。

改进

• Star 曲线改为自绘：新增 scripts/gen_star_chart.py，从 GitHub API 的打星时间渲染 docs/assets/star-history.svg（纯标准库、无第三方依赖），README 的 Star History 段落改用该本地图，不再依赖第三方 star-history.com 的服务端缓存；随时可用 python scripts/gen_star_chart.py 重算
• 参与贡献段落重写（中英各一处）：改为三类可直接上手的方向（工作流与文档 / 中英校对 / 测试与算例），每项给出具体入口与命令，并保留提交前自查清单

质量

• 300 → 309 项测试全过（新增 9 项：按天累计序列、SVG 渲染、仓库内图表资产与 README 引用守卫）
• 发布产物：英文发行包 mcd-saver-v2.3.2.zip + 中文说明 麦麦省钱助手-v2.3.2-发布说明.md（GitHub 资产名为 mcd-saver-v2.3.2-release-notes-zh.md）

反馈

问题与建议请走仓库讨论区或 Issue：https://github.com/yuxinlaile/McD-saver/discussions

在线试算（免登录）：https://yuxinlaile.github.io/McD-saver/demo.html
完整变更：CHANGELOG.md

---

社区开源项目，与麦当劳中国官方无隶属关系；不做自动下单与无人值守自动化。

麦麦省钱助手 v2.3.1

🍟 McD Saver v2.3.1（麦麦省钱助手）

README 精简与同步守卫。

改进

• 「近期版本」区块改为自动生成：从 CHANGELOG 提取最近 3 个版本的要点写入 README 中英，发版时自动刷新；区块长度固定 3 行，不再随发版增长
• 移除 README 中的内部流程说明：「发布产物与版本策略 / Release artifacts」整节删除（中英各一处），相关内容保留在 releases/README.md 与 CONTRIBUTING.md
• 新增 README 同步守卫（10 项）：近期版本区块与 CHANGELOG 一致、环境变量表与代码双向互校、SKILL.md 目录树路径存在、README 与 references/tools.md 工具集合一致、Markdown 相对链接可达、试算页示例数据条数与 README 表述一致
• references/tools.md 的「主题活动」表统一为三列格式，使工具清单可被自动比对

质量

• 290 → 300 项测试全过
• 发布产物：英文发行包 mcd-saver-v2.3.1.zip + 中文说明 麦麦省钱助手-v2.3.1-发布说明.md（GitHub 资产名为 mcd-saver-v2.3.1-release-notes-zh.md）

反馈

问题与建议请走仓库讨论区或 Issue：https://github.com/yuxinlaile/McD-saver/discussions

在线试算（免登录）：https://yuxinlaile.github.io/McD-saver/demo.html
完整变更：CHANGELOG.md

---

社区开源项目，与麦当劳中国官方无隶属关系；不做自动下单与无人值守自动化。