Neo-ZQYY/docs/audit/changes/2026-04-20__legacy-untracked-cleanup-review.md

变更审计记录：2026-04-20 工作区遗留未跟踪文件清理前评审

字段	值
日期	2026-04-20 06:41:48
分类	现状记录与处理建议（不实施移动/删除）
触发背景	新会话开启时 /audit 预扫描发现 6 个未跟踪文件，均非本次会话产物
覆盖文件数	6（均为未跟踪）
高风险文件数	0
新迁移 SQL	0
代码→文档缺失	0

操作摘要

本次审计为"现状评审"，不产生任何代码/数据/文件移动变更。工作区中存在 6 个未跟踪文件/目录，经主会话已读内容与文件时间戳比对，均为前几轮会话（2026-04-11 ~ 2026-04-13）遗留的探索性/临时产物：

• 2 个为 Playwright MCP / 字体补丁流程的工具产物目录（.playwright-mcp/ / apps/miniprogram/.font_patch_tmp/）
• 2 个为小程序 TDesign 字体 BOM 修复相关的 PowerShell 脚本与检查报告（apps/miniprogram/inspect-wechat-font.ps1 / apps/miniprogram/inspect_wechat_font_report.txt）
• 2 个为根目录下 Excel 结构分析中间产物（excel_analysis_report.txt / sheet_structure.txt），与 tmp/2025年1-6月.xlsx 等飞球后台导出配套

由于跨会话累积，主会话无其产生时的语义上下文，本次仅做"现状记录 + 处理建议"，不做 .gitignore 调整、不做文件移动、不做删除。实际清理动作由用户后续决定后单独执行并写入新的审计记录。

预扫描快照

{
  "scanned_at": "2026-04-20 06:40:49",
  "total_files": 6,
  "all_files": [
    ".playwright-mcp/",
    "apps/miniprogram/.font_patch_tmp/",
    "apps/miniprogram/inspect-wechat-font.ps1",
    "apps/miniprogram/inspect_wechat_font_report.txt",
    "excel_analysis_report.txt",
    "sheet_structure.txt"
  ],
  "high_risk_files": [],
  "risk_tags": ["root-file"],
  "new_migration_sql": [],
  "code_without_docs": [],
  "audit_required": true
}

变更文件（现状记录，未变更）

1. .playwright-mcp/（目录，2026-04-11 ~ 04-12 产物）

• 内容：19 个 console-*.log（每个 143~980 字节）+ 4 个 page-*.yml（每个约 922 KB ~ 931 KB，合计约 3.6 MB）
• 用途：Playwright MCP 工具自动产物——浏览器 console 日志与页面快照
• 建议：加入 .gitignore；目录内容可选择性归档或清理，不应入仓
• 风险：无

2. apps/miniprogram/.font_patch_tmp/（目录，2026-04-13 产物）

• 内容：1 个 t.ttf（505 KB）
• 用途：小程序字体补丁流程的临时产物，与 inspect-wechat-font.ps1 流程相关联
• 建议：加入 .gitignore；ttf 二进制不应入仓
• 风险：无

3. apps/miniprogram/inspect-wechat-font.ps1（32 行 PowerShell）

• 内容：函数 Write-NoBomFile，用 TrimStart([char]0xFEFF, [char]0x200B, [char]0x0000) 清除 BOM 与零宽字符，强制以 UTF-8 无 BOM 重写指定文件；明确处理两个路径：
  • .\miniprogram\miniprogram_npm\tdesign-miniprogram\icon\icon.wxss
  • .\node_modules\tdesign-miniprogram\miniprogram_dist\icon\icon.wxss
• 用途：修复 TDesign 小程序图标库 wxss 文件的 BOM 问题（微信小程序对 BOM 敏感）
• 建议：若后续仍需使用，移入 apps/miniprogram/scripts/ 并补 README（说明触发时机、使用方式）；若已不再使用，归档到 _DEL/apps/miniprogram/
• 风险：无

4. apps/miniprogram/inspect_wechat_font_report.txt

• 用途：上述 ps1 脚本生成的字体检查报告（一次性探测产物）
• 建议：随 ps1 决定去留；单独作为报告价值低，优先归档
• 风险：无

5. excel_analysis_report.txt（根目录，300 行）

• 内容：tmp/2025年1-6月.xlsx 的 Excel 结构分析报告，11 个 Sheet（订单表/台费表/商品表/用户表/会员卡/使用记录表/充值记录表/优惠券使用记录表/助教超休/助教服务/流水构成），列出每个 Sheet 的列名、行数、样本数据，以及消费/充值/助教相关字段汇总
• 关联：git status 显示 tmp/2025年1-6月.xlsx 等飞球后台导出 xlsx 在仓库中
• 违规点：按 CLAUDE.md 文件归属规则，分析产物不应放根目录
• 建议：移入 tmp/（仓库约定的临时分析目录）
• 风险：低（仅路径违规，无业务逻辑影响）

6. sheet_structure.txt（根目录，343 行）

• 内容：同一 xlsx 的结构分析，英文标题开头（EXCEL FILE STRUCTURE ANALYSIS），内容与 excel_analysis_report.txt 高度重叠，仅样本行数略多（每 Sheet 3 行 vs 2 行）
• 违规点：同上，根目录违规
• 建议：移入 tmp/；与 excel_analysis_report.txt 疑似重复产物，可合并或去重
• 风险：低

数据库变更

无。

风险与回滚

• 整体风险：零。本次审计不移动、不删除、不修改任何文件
• 预扫描风险标签：仅 root-file 一项，由 excel_analysis_report.txt + sheet_structure.txt 的根目录位置触发
• 回滚策略：不适用（无任何实际变更）

验证

• 无代码变更，无需跑测试
• 无 SQL 变更，无需 SQL 校验
• 主会话已读取预扫描 JSON、ps1 脚本内容、两个目录内容清单、两个 txt 报告的结构性信息，现状描述可溯源

合规检查

项	状态
高风险文件识别	零项高风险
迁移 SQL 回滚脚本	不适用（无 SQL 变更）
DDL 基线同步	不适用（无数据库变更）
代码→文档映射	不适用（无代码变更，预扫描 code_without_docs: []）
docs/database/ 同步	不适用（无 schema 变更）
CLAUDE.md 文件归属规则	指出 2 个根目录违规（待用户决策后修正）

下一步建议

用户根据本记录择一决策后再执行实际清理（每个决策单独再写一份审计记录）：

1. 立即清理：一次性提交 .gitignore 补丁（忽略 .playwright-mcp/ 与 .font_patch_tmp/），把两份根目录 txt 移入 tmp/，把 ps1 与 report 移入 apps/miniprogram/scripts/ 或 _DEL/apps/miniprogram/
2. 分批清理：先加 .gitignore 防止继续积累，再逐个决定剩余 4 项去留
3. 暂不处理：维持现状，等下一次相关功能改动时顺带清理

无论选择哪条，实际动作发生时会由新的 /audit 审计覆盖。

---

实际执行记录（2026-04-20 追加）

用户确认方案 1「立即清理」，本节记录同日实际执行的动作、验证结果与回滚路径。本节为原记录的执行段，不另开审计文件。

执行步骤

步骤 1 — .gitignore 补丁

在「临时与缓存」节的 *.jsonl 之后追加两条：

# Playwright MCP 浏览器日志与页面快照
.playwright-mcp/

# 小程序字体补丁临时目录
apps/miniprogram/.font_patch_tmp/

步骤 2 — 文件归位

来源路径	目标路径	动作
apps/miniprogram/inspect-wechat-font.ps1	apps/miniprogram/scripts/inspect-wechat-font.ps1	新建 apps/miniprogram/scripts/ 目录后 mv
apps/miniprogram/inspect_wechat_font_report.txt	apps/miniprogram/scripts/inspect_wechat_font_report.txt	同上目录，与 ps1 绑定
excel_analysis_report.txt（根目录）	tmp/excel_analysis_report.txt	mv
sheet_structure.txt（根目录）	tmp/sheet_structure.txt	mv

.playwright-mcp/ 与 apps/miniprogram/.font_patch_tmp/ 本身保留不动，由新 .gitignore 规则从 git 视野中隐藏，内容由用户后续按需清理。

最终 diff 摘要

• 修改：.gitignore（+7 行，两段忽略规则）
• 修改：docs/audit/audit_dashboard.md（由 gen_audit_dashboard.py 刷新，130 条记录）
• 新建：apps/miniprogram/scripts/inspect-wechat-font.ps1、apps/miniprogram/scripts/inspect_wechat_font_report.txt
• 新建：tmp/excel_analysis_report.txt、tmp/sheet_structure.txt
• 删除（对应位置清空）：apps/miniprogram/inspect-wechat-font.ps1、apps/miniprogram/inspect_wechat_font_report.txt、excel_analysis_report.txt、sheet_structure.txt

执行后验证

执行 git status --short 确认：

• .playwright-mcp/ 和 apps/miniprogram/.font_patch_tmp/ 不再出现在未跟踪列表中（.gitignore 生效）
• 根目录不再存在 excel_analysis_report.txt / sheet_structure.txt，已出现在 tmp/ 下
• apps/miniprogram/scripts/ 作为新未跟踪目录出现，含 ps1 与 report 两个文件
• 预扫描触发的 root-file 风险标签源头已消除

回滚路径

如需撤销：

# 撤回 gitignore 追加
git checkout .gitignore

# 还原 4 个文件的位置
mv apps/miniprogram/scripts/inspect-wechat-font.ps1 apps/miniprogram/
mv apps/miniprogram/scripts/inspect_wechat_font_report.txt apps/miniprogram/
rmdir apps/miniprogram/scripts
mv tmp/excel_analysis_report.txt ./
mv tmp/sheet_structure.txt ./

未覆盖风险

• apps/miniprogram/scripts/ 是新建目录，尚未补 README。如日后要把 ps1 纳入常规流程，需补说明文档（触发时机 / 执行步骤 / 预期结果），但当前只作归档不强制补
• tmp/ 下 Excel 分析产物与已存在的 revenue_report* 等历史产物混放，未做二次整理；本次不清理 tmp/ 历史沉积，保持用户既定清理节奏
• .playwright-mcp/ 与 .font_patch_tmp/ 的目录内容未清空，仅从 git 视野隐藏；磁盘占用约 3.6 MB + 505 KB，需要时用户手动删除