2.8 KiB
2.8 KiB
审计记录:MD 占位符修正 + 临时文件清理
- 日期:2026-02-14 (Asia/Shanghai)
- Prompt-ID:P20260214-103000
原始原因
上下文传递续接,继续完成 Task 1(全量 API JSON 刷新 + 字段分析 + MD 文档增强)的收尾工作:
- 修正 5 个 API 文档中 v2 脚本自动插入的占位符描述("新发现字段,N/100 条记录中出现")为正式中文说明
- 合并 member_stored_value_cards 中 electricityCardDeduct/rechargeFreezeBalance 大小写重复字段
- 去除 group_buy_packages 中重复的 type 行
- 清理 25 个
_raw.json临时文件和 3 个临时脚本 - 更新比对报告
直接原因
v2 脚本自动补充新字段时使用了占位符描述,需要人工替换为有业务含义的中文说明。member_stored_value_cards 的 electricityCardDeduct/rechargeFreezeBalance 是已有小写字段的驼峰变体,需合并去重。group_buy_packages 的 type 字段已存在于原始文档,自动插入导致重复行。
Changed
| 文件 | 变更类型 |
|---|---|
docs/api-reference/endpoints/assistant_service_records.md |
修正 2 个新字段占位符描述 |
docs/api-reference/endpoints/table_fee_transactions.md |
修正 3 个新字段占位符描述 |
docs/api-reference/endpoints/store_goods_master.md |
修正 4 个新字段占位符描述 |
docs/api-reference/endpoints/member_stored_value_cards.md |
合并去重 + 修正 5 个新字段描述 |
docs/api-reference/endpoints/group_buy_packages.md |
去除重复 type + 修正 5 个新字段描述 |
docs/api-reference/assistant_service_records.md |
修正 2 个新字段占位符描述 |
docs/api-reference/table_fee_transactions.md |
修正 3 个新字段占位符描述 |
docs/api-reference/store_goods_master.md |
修正 4 个新字段占位符描述 |
docs/api-reference/member_stored_value_cards.md |
合并去重 electricityCardDeduct/rechargeFreezeBalance |
docs/api-reference/group_buy_packages.md |
去除重复 type + 修正 5 个新字段描述 |
docs/reports/api_json_vs_md_report_20260214.md |
更新报告时间戳、修正 member_stored_value_cards 和 group_buy_packages 条目 |
docs/api-reference/samples/*_raw.json (25 个) |
删除临时原始响应文件 |
scripts/full_api_refresh_20260214.py |
删除(v1 脚本,已被 v2 取代) |
scripts/_tmp_check_tp.py |
删除临时脚本 |
scripts/fix_md_cleanup.py |
删除一次性清理脚本 |
Risk/Verify
- 风险:纯文档修正,无运行时影响
- 验证:
grep -r "新发现字段" docs/api-reference/应返回 0 结果 - 验证:
ls docs/api-reference/samples/*_raw.json应无文件 - 验证:
ls scripts/_tmp_check_tp.py scripts/fix_md_cleanup.py scripts/full_api_refresh_20260214.py应全部不存在