docs: 归档翻译上下文/字幕审校方案的评审结论与实测数据

- 待办:会话式长上下文方案标记为已技术评审且不实施;补记问题 A 的阶段性结论(暂缓)
- 新增 docs/实验数据-字幕审校定位与修复实验.md:LLM 定位触发率/召回、合成正样本、逐条修复前后对照、成本与复现方式
- 新增 docs/实验数据-字幕重生成成本与耗时.md:单价口径、功率画像、全量推算
- decisions:补充两条决策(会话式长上下文否决、审校定位+定向修复暂缓)
- scripts:归档一次性探测脚本 probe_subtitle_review_stage0.py(含 rebuild 子步骤)
- AGENTS/README:补充实验与改动许可规则、文档索引
This commit is contained in:
2026-09-19 18:33:28 +08:00
parent 2c8bbb6469
commit 5b263171f2
7 changed files with 1187 additions and 0 deletions
+14
View File
@@ -14,6 +14,9 @@
| 测试资产清单、真实模型集成测试 | [docs/testing.md](./docs/testing.md) |
| 设计决策与踩坑记录(含实验结论) | [docs/decisions.md](./docs/decisions.md) |
| 代码缺陷跟踪与修复验收标准 | [docs/代码审查问题跟踪.md](./docs/代码审查问题跟踪.md) |
| 待办:翻译上下文复用与 ASR 语义纠错 | [docs/待办-翻译上下文复用与语义纠错.md](./docs/待办-翻译上下文复用与语义纠错.md) |
| 字幕重生成的成本/耗时/功率实测 | [docs/实验数据-字幕重生成成本与耗时.md](./docs/实验数据-字幕重生成成本与耗时.md) |
| 字幕审校(定位+定向修复)实验与暂缓结论 | [docs/实验数据-字幕审校定位与修复实验.md](./docs/实验数据-字幕审校定位与修复实验.md) |
**开工前先做两件事**:读 [README.md](./README.md) 建立项目认知,
再读 [docs/architecture.md](./docs/architecture.md#关键设计约束北极星不变式)
@@ -41,6 +44,17 @@
- 测试与构建也遵循此规则:已知 `uv run pytest` 全量约 70 秒,用后台+轮询,
不要写 `timeout 1800`
## 实验与改动许可(强制,2026-09)
- **未经用户明确许可,禁止编写或修改任何代码**(含 `scripts/``nodes/``src/`
`tests/` 以及 `/tmp` 等目录下的临时脚本)——**单次性实验脚本同样属于此列**。
- **未经用户明确许可,禁止编写/运行实验**:包括跑数据集、调用模型或 LLM API 做
效果验证、调节参数试探、批量重跑等。先说明「要验证什么、打算怎么做、预计代价」,
等用户同意后再执行。
- 只读排查不受限:读文件、`rg`/`ls`/`stat``git status|log|diff`、查看服务与日志、
查询数据库。需要写文件、改代码、跑实验时,一律先请求许可。
- **一次许可只对当次明确范围生效**,不自动延伸到后续实验、相邻改动或“顺手修一下”。
## 开发流程:TDD(红-绿-重构)
- 任何新功能/修复必须先写失败测试(红),再实现最小代码让其通过(绿),