SOP：修正 wrapup.py 的 miss 阈值注释残留¶

变更日期：2026-10-07　　执行人：Agent（用户授权）　　对象：cost_audit/wrapup.py

1. 背景¶

2026-10-07 把收尾自查的 miss 检测阈值由 5000 上调为 20000（依据：5000 会命中中段步的 7.6%，过频；20000 = 历史 16063 个中段步的 P99 ≈ 1.0%）。实现侧常量已同步为 DEFAULT_MISS_THRESHOLD = 20000，但两处面向使用者的文本未同步，仍显示「默认 5000」：

docstring 用法示例（第 14 行）
argparse 的 --miss-threshold help（第 305 行）

后果：使用者按 --help 或读 docstring 会以为默认值是 5000，与实际行为不符。

2. 目标¶

wrapup.py 的两处说明文本与实参一致（均为 20000）；脚本行为不变（默认阈值本就已经是 20000）。

可验证状态：python3 cost_audit/wrapup.py --help 显示「默认 20000」，且全文再无「默认 5000」。

3. 前置条件¶

对 cost_audit/wrapup.py 有写权限（文件属主 rain，本机可写）；
python3 可用（已验证）；
无其他进程正在改写该文件（wrapup.py 为离线只读取数脚本，不被代理调用）。

4. 影响范围¶

主机：单机（本机 token_proxy 工程），无其他节点。
组件：cost_audit/wrapup.py 一个文件、两行文本。
是否停服：否。该脚本不在代理请求路径上，改它不影响 ds / glm / mi 代理服务。
窗口期：无要求，随改随生效（下次调用即读到新文本）。
在跑作业：无影响。

5. 分步操作¶

步骤 1：备份原文件（高危前置）¶

改动虽只涉及文本，仍先做可回滚备份。备份落到本主题的 backup/，保持原路径层次。

cd /home/rain/Documents/services/token_proxy
mkdir -p wrapup-miss-threshold-20261007/backup/cost_audit
cp -p cost_audit/wrapup.py \
      wrapup-miss-threshold-20261007/backup/cost_audit/wrapup.py.bak.$(date +%Y%m%d-%H%M%S)

预期：backup/cost_audit/ 下出现 wrapup.py.bak.20261007-083601（17628 B）。失败判断：目录不可写或 cp 非 0 → 停止，勿继续改文件。

步骤 2：修正两处文本¶

仅替换文本，不动任何逻辑。等价 shell（本次实际用编辑器逐处替换）：

# ① docstring 用法示例
sed -i 's/--miss-threshold 5000  # 覆盖 miss 阈值（默认 5000）/--miss-threshold 20000  # 覆盖 miss 阈值（默认 20000）/' \
    cost_audit/wrapup.py
# ② argparse help
sed -i 's/miss 检测阈值（token），默认 5000/miss 检测阈值（token），默认 20000/' \
    cost_audit/wrapup.py

坑：文中第 26 行另有一处「由 5000 上调」，那是历史说明（描述阈值变更的来由），必须保留；本步只改「默认 5000」这一说法，勿误伤。

预期：两处替换各命中 1 次。失败判断：命中 0 次 → 文本已变动，先核对现状再改。

6. 验证¶

cd /home/rain/Documents/services/token_proxy
python3 cost_audit/wrapup.py --help          # 预期：「默认 20000」
grep -n "默认 5000" cost_audit/wrapup.py     # 预期：无输出
python3 cost_audit/wrapup.py                 # 预期：正常打印收尾自查表，退出码 0

实测结果（2026-10-07）：--help 显示「miss 检测阈值（token），默认 20000」；grep "默认 5000" 无命中；wrapup.py 正常输出表格。 回滚触发量化：若 --help 仍为 5000，或 wrapup.py 退出码非 0 → 按第 7 章回滚。

7. 回滚¶

备份位置：本主题 backup/cost_audit/wrapup.py.bak.20261007-083601（登记见 backup/README.md）。

cd /home/rain/Documents/services/token_proxy
cp -p wrapup-miss-threshold-20261007/backup/cost_audit/wrapup.py.bak.20261007-083601 \
      cost_audit/wrapup.py
python3 cost_audit/wrapup.py --help          # 回滚后预期：恢复为「默认 5000」

回滚后验证：--help 文本回到改动前状态即可确认回滚成功。

8. 风险说明¶

风险点	缓解措施
误改到行为相关行（常量或判定逻辑）	本次仅动 docstring 与 `help` 字符串，已核对 diff 只有两行文本
误伤第 26 行历史说明	替换模式限定「默认 5000」，与历史说明文本不同
备份散落	备份统一入本主题 `backup/`，并有台账登记

来源：/home/rain/Documents/services/token_proxy/wrapup-miss-threshold-20261007/SOP.md ｜最后更新：2026-10-07 08:36（由 build/sync.py 同步，请勿在站点侧修改）