Files
Neo-ZQYY/docs/audit/changes/2026-02-14__md-placeholder-fix-cleanup.md

2.8 KiB
Raw Permalink Blame History

审计记录MD 占位符修正 + 临时文件清理

  • 日期2026-02-14 (Asia/Shanghai)
  • Prompt-IDP20260214-103000

原始原因

上下文传递续接,继续完成 Task 1全量 API JSON 刷新 + 字段分析 + MD 文档增强)的收尾工作:

  1. 修正 5 个 API 文档中 v2 脚本自动插入的占位符描述("新发现字段N/100 条记录中出现")为正式中文说明
  2. 合并 member_stored_value_cards 中 electricityCardDeduct/rechargeFreezeBalance 大小写重复字段
  3. 去除 group_buy_packages 中重复的 type 行
  4. 清理 25 个 _raw.json 临时文件和 3 个临时脚本
  5. 更新比对报告

直接原因

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 应全部不存在