# 仓库噪音清理基线（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/**` 反向依赖治理
- 巨型热点文件拆分