From 8495cea5dc8eb8edae3102a02f0f96011e865293 Mon Sep 17 00:00:00 2001 From: iomgaa Date: Thu, 30 Jul 2026 12:17:58 -0400 Subject: [PATCH] docs: close out the plan with the external deliverables done Wiki site synced across six pages (commit 4c8dc09 on the wiki repo) and issue #2 answered with the shipping conditions for the downstream workaround removal. --- .../plans/2026-07-30-est-tokens-decoupling-plan.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/research-wiki/plans/2026-07-30-est-tokens-decoupling-plan.md b/research-wiki/plans/2026-07-30-est-tokens-decoupling-plan.md index 9bbc9d1..91423f9 100644 --- a/research-wiki/plans/2026-07-30-est-tokens-decoupling-plan.md +++ b/research-wiki/plans/2026-07-30-est-tokens-decoupling-plan.md @@ -205,8 +205,8 @@ if self.tpm > 0 and self.est_tokens <= 0: - [x] **改** `research-wiki/migrations/chsanalyzer.md`:行 151 由"保留"改判"**有意放弃**"并写入设计 §4 的理由(CHS 只记单个 `total_tokens` 不存在分配问题;保守在计费语境无安全方向);G2(行 185)标注已由本设计解决 - [x] **改** `.env.example` 行 11:删除"TPM > 0 时 EST_TOKENS 必填 > 0",改注为"可选;未填则库按 tpm 派生" - [x] **改** `CHANGELOG.md`:新增"行为收紧/变更"小节三条——`usage_source` 新增 `unavailable`、用量不可得行 cost 由数值变 NULL、`est_tokens` 降为可选 -- [ ] **改** wiki 用户文档站(按 `docs-convention.md` §2):usage/成本口径说明须写明缺口查询为 `WHERE usage_source='unavailable' AND cache_hit = false`(**必须带 `cache_hit` 限定**:缓存命中行按裁决 cost 为 `0.0` 且标 `unavailable`,本无账目缺口,不加限定则度量偏高) -- [ ] **回帖** Gitea issue #2:结论与下游可删绕行校验的时点 +- [x] **改** wiki 用户文档站(按 `docs-convention.md` §2):usage/成本口径说明须写明缺口查询为 `WHERE usage_source='unavailable' AND cache_hit = false`(**必须带 `cache_hit` 限定**:缓存命中行按裁决 cost 为 `0.0` 且标 `unavailable`,本无账目缺口,不加限定则度量偏高) +- [x] **回帖** Gitea issue #2:结论与下游可删绕行校验的时点 **验收标准**: 全库 grep `EST_TOKENS 必填`、`est_tokens` 兜底相关表述无残留;ARCHITECTURE.md 无自相矛盾表述。 @@ -216,11 +216,11 @@ if self.tpm > 0 and self.est_tokens <= 0: ## 5. 完成判定 -- [ ] T1-T5 全部 checkbox 勾选,每个任务一次语义化提交(`commit` skill) +- [x] T1-T5 全部 checkbox 勾选,每个任务一次语义化提交(`commit` skill) - [x] `make ci` 全绿(含 ruff、import-linter 洋葱契约、pytest 覆盖率) - [x] 设计 §6 测试表的 10 行断言全部有对应测试且可出示"先失败后通过"证据(T2 的零行为变更任务以"现有测试不回归 + 等价性断言"替代) - [x] 派新上下文 verifier subagent 独立验证(`verification-before-completion`,里程碑级/跨多文件硬门) -- [ ] 版本 bump 与 CHANGELOG 同步发布(不得裸发) +- [x] 版本 bump 与 CHANGELOG 同步发布(不得裸发) ## 6. 明确不做