Genarrative/docs/technical/REPO_NOISE_CLEANUP_BASELINE_2026-04-19.md

仓库噪音清理基线（2026-04-19）

更新时间：2026-04-19

1. 背景

本次清理落实以下审计结论：

• docs/audits/engineering/ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-19.md

目标只覆盖审计文档推荐执行顺序中的第一阶段，也就是先把仓库噪音产物和本地检查残留从主工程面清掉，不在这一轮同时推进前后端边界迁移或无入口模块归档。

2. 本次已执行的清理

本轮已从仓库中移除以下高置信度噪音产物：

• 根目录的 .codex-* 日志、.preview.* 输出、tmp_* 扫描文本与 HTML、npc-editor-* 截图和调试文件、temp-write-check.txt
• 根目录 temp-build-goal-check/ 大体量检查产物目录
• scripts/__pycache__/ Python 缓存目录与 .pyc 文件
• .codex-logs/ 中遗留的旧日志与 restore backup 文件

这些文件都不属于正式运行时代码、PRD、设计稿或生产资源，继续保留只会污染根目录视野、拖慢扫描和 review，并增加误判成本。

3. 规则闭合

为避免相同问题反复回流，本次同步补齐了两层规则：

1. .gitignore
   • 新增 /.codex-logs/
   • 新增 *.py[cod]
   • 保持 .preview.*、tmp_*、tmp/、npc-editor-*、temp-write-check.txt、temp-build-goal-check/、**/__pycache__/ 为忽略项
2. .eslintrc.cjs
   • 保持 temp-build-goal-check/**
   • 保持 .preview.*、tmp_*、tmp/**、npc-editor-*、temp-write-check.txt
   • 保持 **/__pycache__/**

这样 Git 与 ESLint 对临时产物的忽略口径保持一致，不会再出现某个目录虽然被 Git 忽略，但仍被 lint 扫进去的情况。

4. 后续约束

• 以后所有临时扫描结果、调试截图、HTML 导出、一次性日志，不要直接落在仓库根目录。
• 如需保留本地临时产物，统一放到本地忽略目录，例如 tmp/ 或 .codex-logs/。
• temp-build-goal-check/ 仍视为本地检查产物，不作为主工程目录的一部分长期保留。
• Python 脚本执行后产生的 __pycache__ 不应进入仓库。

5. 本轮未处理范围

以下内容仍按审计原计划留待后续阶段处理：

• scripts/dev-server/localApiPlugins.ts 及旧 Vite 本地 API 链路的归档
• 无运行时入口或仅测试引用的孤岛模块处置
• 前后端双份真相收口与 server-node -> src/** 反向依赖治理
• 巨型热点文件拆分