跳转至

工程内 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 同步,请勿在站点侧修改)