工程内 Markdown 文件清单¶
- 生成时间:2026-09-23(Asia/Shanghai)
- 扫描范围:
/home/rain/Documents/services/token_proxy下全部.md(已排除venv/、__pycache__/),共 15 个(截至 2026-09-23 14:04 扫描时点;其后增减见备注——当前实况仍为 15 个:删 2、增 2) - 「删除影响」判据:先查有无活跃消费者(被脚本读取 / Hook 按路径查找 / slash 命令引用),再判内容能否再生
| # | 文件名(相对工程根) | 起了什么作用 | 删除了有什么影响 |
|---|---|---|---|
| 1 | docs/HANDOFF.md(8.8 KB) |
交接快照;由 SessionStart Hook 注入每个新会话首轮 |
核心,勿删。sessionstart-hook/session-start-inject.py 运行时按此路径查找,缺失即不注入——不报错、静默失效,新会话将失去交接上下文 |
| 2 | docs/SOP.md(225 KB) |
主变更档案,46 节累积:代理部署、计价、Hook 体系、事故与决策记录 | 不可再生。全部历史决策与事故证据丢失;多个 Hook 脚本 docstring 以「见 SOP 某节」溯源,溯源链断裂(仅文档引用,不影响运行) |
| 3 | autostart/SOP.md(18.4 KB) |
token_proxy 开机自启 + 每日 00:00 报表任务的变更方案与回滚步骤 | 自启与定时任务已在运行、不受影响;但 install-autostart.sh 的回滚提示指向本文件第 7 章,删除后失去部署依据与回滚步骤 |
| 4 | net_static_ip/SOP_静态IP.md(10.3 KB) |
网卡静态 IP 固化(netplan + NetworkManager)SOP | 网络配置不受影响;set_static_ip.sh 的提示语引用本文件,删除后改动网卡时无操作依据 |
| 5 | cost_audit/20260916-token成本-巡检报告.md(6.6 KB) |
2026-09-16 的 B 类成本巡检结论快照 | 无任何引用。丢失该日巡检结论;原始数据在 logs/ 未动,可重新算出 |
| 6 | reports/daily-review-20260923.md(11.4 KB) |
/cost 当日审查产出(四段事实 + 评估 + 建议) |
可再生。由 daily_review.py 生成:同日重跑 /cost 覆盖重建,历史日期可用 --date 重算 |
| 7 | daily-cost-review-20260923/SOP.md(5.0 KB) |
日度成本审查(daily_review.py + /cost)上线的变更档案 |
无引用,功能继续运行。丢失该变更的背景、验证与回滚说明 |
| 8 | turn-seq-fix-20260923/SOP.md(7.8 KB) |
轮次口径修复(新增 turn_seq 字段)的变更档案 |
无引用。HANDOFF 中「04:51 前步/轮不可比」的依据在此,删除后该口径结论失据 |
| 9 | hook-restore-20260923/SOP.md(6.0 KB) |
Hook 守卫脚本误删恢复档案;第 6 章是守卫脚本离线回归的唯一用例表 | 无引用,但 54 项回归集已丢失,删此文件后守卫脚本再改动将无任何回归依据,建议保留 |
| 10 | output-cost-20260923/SOP.md(11.3 KB) |
执行效率规则落地 + 提问对照卡的变更档案 | 无引用。规则本体在 ~/.trae-cn/user_rules/、不受影响;丢失实施与回滚说明 |
| 11 | output-cost-20260923/rule-agent-efficiency.md(1.3 KB) |
全局规则《执行效率与输出成本约束》的工程内写入源 | 有运行时依赖:apply_changes.py / verify_changes.py 读它安装与校验。删除后无法重装/校验该规则(已装规则本身仍生效) |
| 12 | output-cost-20260923/提问对照卡.md(2.1 KB) |
提问方式 ↔ 步数/成本对照参考(含实测数据) | 有运行时依赖:verify_changes.py 的校验对象,删除将使该校验失效 |
| 13 | ~~output-cost-20260923/backup/README.md~~(已删除) |
该次变更的备份台账(2 条) | 已于 09-23 22:27 随整个 backup/ 目录删除 |
| 14 | ~~docs-read-hook/backup/README.md~~(已删除) |
PreToolUse Hook 变更的备份台账(含 hooks.json 两个历史版本的回滚命令) |
已于 09-23 22:27 随整个 backup/ 删除;随之放弃 hooks.json 的两个历史回滚点 |
| 15 | posttooluse-guard/README.md(2.1 KB) |
PostToolUse Hook 组件说明(状态、字段口径、修复记录) |
无引用。删除后该组件的行为边界(tool_name 口径、WRITE_TOOLS 白名单)无书面说明 |
备注¶
- 本清单文件自身(
md-文件清单.md)无引用者,可随时删除或重新生成。 - 扫描后新增:
md-inventory-20260923/backup/README.md——本次「清理 backup + 生成清单」变更的备份台账(仅 1 条:docs/HANDOFF.md修订前版本),属过程留档,确认无误后可删。 - 已删除:14:03 删
hook-restore-20260923/backup/、turn-seq-fix-20260923/backup/;22:27 按台账判据删docs-read-hook/backup/(6 文件)、output-cost-20260923/backup/(3 文件),删前留/tmp/token_proxy_purge_20260923.tar.gz保险包。daily-cost-review-20260923/backup/更早已由用户删除。 - 仍存续的 backup 目录 1 个:
md-inventory-20260923/backup/(过程留档,3 条台账)——无活跃消费者,确认无误后可整目录删除。 - 2026-10-02 补记:
md-inventory-20260923/backup/、handoff-bootstrap-20260923/backup/、mi-model-20260924/backup/三个目录已按各自台账判据确认并整体删除(判据与影响见backlog-20261002/SOP.md第 5.1 节)。此后工程内无残留 backup 目录,备份台账随各主题目录自身维护。 另:新增常驻工程glob-grep-guard/(Hook 脚本,非 md,故不计入本清单的 md 总数)。 - 引用关系由脚本一次扫描得出(工程内
.py/.sh/.json+~/.trae-cn/的user_rules、commands、hooks.json、各SKILL.md),非人工推测。
来源:
/home/rain/Documents/services/token_proxy/md-文件清单.md| 最后更新:2026-10-02 15:18(由build/sync.py同步,请勿在站点侧修改)