iomgaa/PolyGateway
1
0
Fork 0
Code Issues 3 Pull Requests Actions Packages Projects Releases 9 Wiki Activity
Files
7622eb040278f1f46358bf54bf46299389fa71d7
PolyGateway/research-wiki/log.md
T
iomgaa 6d6b3cf59c docs: correct the stale throughput numbers and wiki state 
独立验证发现的 3 处文档欠账:

③ 两处代码内注释还挂着已作废的吞吐估算,`.env.example`/README/
   CHANGELOG/ARCHITECTURE 四处早已改成实测口径:
   - `config.py` 的 `# 4 条 ≈ 32 行/秒(实测…)` —— "32 行/秒"正是设计
     §10 修订 #1 判定"偏乐观一倍"并作废的估算值,却挂着"实测"二字;
   - `postgres.py` 的 `pool_max` docstring 写着 `稳态吞吐 ≈ pool_max /
     RTT`,正是设计要求下游**不要**用的那个公式。
   两处统一为实测值: RTT ≈ 123ms 上 `pool_max=4` 约 15.6 行/秒
   (50 行并发批 3.2s)。设计 §8 与计划 T7 里残留的同一公式一并标注作废。

④ 文档写 `acquire(timeout=剩余预算)`,实现传的是完整预算(行为无害,
   外层 `asyncio.timeout` 才是真正上界)。**改文档不改代码**: 设计
   §3.1、计划 T3、ARCH §7.8 三处对齐,并写明为什么内层不再算剩余量。

⑤ wiki 登记页与正文状态漂移: design 登记页仍写"待人类审"(正文已是
   "已实施")、plan 登记页写"正文 326 行"(实际 380)、log.md 末条停在
   T0 之前。三处校正,T1-T8 补登记,rebuild_index。

另补一条独立验证在真实 PG 上发现的语义细节: 本地池饱和造成的丢行走
**行级丢弃**,`degraded` 保持 False,只有 `dropped_rows` 增长——只按
`degraded` 配告警的下游会完全看不见这类丢行,而它恰是 `pool_max` 配小
了的唯一信号。README / .env.example / ARCHITECTURE / CHANGELOG 各补一句。
2026-08-24 11:55:22 -04:00

12 KiB
Raw Blame History

Wiki 变更日志

  • [2026-07-20 09:55 UTC] Wiki 初始化完成
  • [2026-07-20 09:55 UTC] 重建索引: 2 篇页面
  • [2026-07-20 10:18 UTC] 新增 plan: M1 核心里程碑实现计划 (plan:m1-core-plan)
  • [2026-07-20 10:18 UTC] 新增边: plan:m1-core-plan --implements--> design:m1-core-design
  • [2026-07-20 10:18 UTC] 重建索引: 4 篇页面
  • [2026-07-20 11:11 UTC] 新增 schema: 表结构: llm_calls(遥测 18 字段) (schema:llm-calls)
  • [2026-07-20 11:11 UTC] 新增 metric: 每次调用必录覆盖率(含缓存命中/失败/取消) (metric:call-telemetry-coverage)
  • [2026-07-20 11:11 UTC] 新增边: metric:call-telemetry-coverage --measures--> schema:llm-calls
  • [2026-07-20 11:11 UTC] 新增边: schema:llm-calls --implements--> design:m1-core-design
  • [2026-07-20 11:11 UTC] 重建索引: 6 篇页面
  • [2026-07-21 02:27 UTC] 新增 finding: M2 真实数据压测: 场景矩阵与数据清单 (finding:m2-soak-workload)
  • [2026-07-21 02:27 UTC] 重建索引: 8 篇页面
  • [2026-07-21 02:59 UTC] 新增 design: M2 分布式:Redis 治理后端+背压+Postgres 遥测+pricing+Embedding+压测 harness (design:m2-distributed)
  • [2026-07-21 02:59 UTC] 重建索引: 10 篇页面
  • [2026-07-21 03:46 UTC] 新增 plan: M2 分布式实现计划 (plan:m2-distributed)
  • [2026-07-21 03:46 UTC] 新增边: plan:m2-distributed --implements--> design:m2-distributed
  • [2026-07-21 03:46 UTC] 重建索引: 12 篇页面
  • [2026-07-21 06:00 UTC] 新增 finding: M2 verifier 三项 Important 补齐(不变量接线/网关保护/P3 验收) (finding:m2-verifier-fixes)
  • [2026-07-21 06:00 UTC] 重建索引: 13 篇页面
  • [2026-07-21 11:19 UTC] 新增 finding: P6 混合浸泡首跑基线与记分板三重伪击穿修复 (finding:p6-soak-baseline)
  • [2026-07-21 11:19 UTC] 重建索引: 15 篇页面
  • [2026-07-21 12:26 UTC] 新增 design: M2.5 治理韧性: 半死源隔离与健康感知调度 (design:m25-resilience)
  • [2026-07-21 12:26 UTC] 重建索引: 17 篇页面
  • [2026-07-21 12:30 UTC] 新增 plan: M2.5 治理韧性实现计划 (plan:m25-resilience)
  • [2026-07-21 12:30 UTC] 新增边: plan:m25-resilience --implements--> design:m25-resilience
  • [2026-07-21 12:30 UTC] 重建索引: 19 篇页面
  • [2026-07-21 21:34 UTC] 新增 finding: M2.5 验收: P6 同场景 58.1% → 98.96% (finding:m25-acceptance)
  • [2026-07-21 21:34 UTC] 重建索引: 21 篇页面
  • [2026-07-22 01:37 UTC] 新增 design: M3 OCR 端口族设计 (design:m3-ocr)
  • [2026-07-22 01:37 UTC] 重建索引: 23 篇页面
  • [2026-07-22 02:05 UTC] 新增 metric: OCR 治理调用成功率与错误分类分布 (metric:ocr-call-success)
  • [2026-07-22 02:05 UTC] 新增边: metric:ocr-call-success --measures--> schema:llm-calls
  • [2026-07-22 02:05 UTC] 新增边: schema:llm-calls --implements--> design:m3-ocr
  • [2026-07-22 02:05 UTC] 重建索引: 24 篇页面
  • [2026-07-22 02:09 UTC] 新增 plan: M3 OCR 实现计划 (plan:m3-ocr)
  • [2026-07-22 02:09 UTC] 新增边: plan:m3-ocr --implements--> design:m3-ocr
  • [2026-07-22 02:09 UTC] 重建索引: 26 篇页面
  • [2026-07-22 05:33 UTC] 新增 finding: P7 OCR soak 验收: 99.73% 与 13 不变量全 PASS (finding:p7-ocr-soak)
  • [2026-07-22 05:33 UTC] 重建索引: 28 篇页面
  • [2026-07-22 08:58 UTC] 新增 design: M4 迁移验证设计(GovDoc→CHS,发 v1.0) (design:m4-migration)
  • [2026-07-22 08:58 UTC] 重建索引: 30 篇页面
  • [2026-07-22 09:33 UTC] 新增 plan: M4 迁移实现计划(T0-T14) (plan:m4-migration)
  • [2026-07-22 09:33 UTC] 新增边: plan:m4-migration --implements--> design:m4-migration
  • [2026-07-22 09:33 UTC] 重建索引: 32 篇页面
  • [2026-07-22 14:36 UTC] 新增 finding: M4 迁移验收(GovDoc+CHS) (finding:m4-acceptance)
  • [2026-07-22 14:36 UTC] 重建索引: 34 篇页面
  • [2026-07-30 03:44 UTC] 新增 design: GatewaySettings 跨字段不变量守卫的生效范围 (design:settings-invariant-guards)
  • [2026-07-30 03:44 UTC] 重建索引: 36 篇页面
  • [2026-07-30 04:44 UTC] 新增 design: GatewaySettings 装配校验补齐(第二轮) (design:settings-invariants-round-2)
  • [2026-07-30 04:44 UTC] 重建索引: 38 篇页面
  • [2026-07-30 09:32 UTC] 新增 design: est_tokens 解耦: 拆分限流预扣与遥测用量兜底(issue #2) (design:est-tokens-decoupling)
  • [2026-07-30 09:33 UTC] 重建索引: 40 篇页面
  • [2026-07-30 09:33 UTC] 新增边: design:est-tokens-decoupling --refines--> design:m1-core-design
  • [2026-07-30 09:33 UTC] 重建索引: 40 篇页面
  • [2026-07-30 09:39 UTC] 新增 plan: est_tokens 解耦实施计划 (plan:est-tokens-decoupling)
  • [2026-07-30 09:39 UTC] 新增边: plan:est-tokens-decoupling --implements--> design:est-tokens-decoupling
  • [2026-07-30 09:39 UTC] 重建索引: 42 篇页面
  • [2026-07-31 08:35 UTC] 新增 design: 响应可观测字段扩展(Issue #3) (design:response-observability-fields)
  • [2026-07-31 08:37 UTC] 重建索引: 44 篇页面
  • [2026-07-31 11:10 UTC] 新增 plan: 响应可观测字段扩展实现计划 (plan:response-observability-fields)
  • [2026-07-31 11:10 UTC] 新增边: plan:response-observability-fields --implements--> design:response-observability-fields
  • [2026-07-31 11:10 UTC] 重建索引: 46 篇页面
  • [2026-07-31 11:11 UTC] 重建索引: 46 篇页面
  • [2026-07-31 12:25 UTC] 重建索引: 46 篇页面
  • [2026-07-31 15:57 UTC] 新增 design: 采样参数透传设计(issue #4) (design:sampling-params)
  • [2026-07-31 15:57 UTC] 重建索引: 48 篇页面
  • [2026-07-31 16:00 UTC] 重建索引: 48 篇页面
  • [2026-07-31 16:31 UTC] 重建索引: 48 篇页面
  • [2026-07-31 16:59 UTC] 新增 plan: 采样参数透传实现计划(issue #4) (plan:sampling-params-plan)
  • [2026-07-31 16:59 UTC] 新增边: plan:sampling-params-plan --implements--> design:sampling-params
  • [2026-07-31 16:59 UTC] 重建索引: 50 篇页面
  • [2026-07-31 17:01 UTC] 重建索引: 50 篇页面
  • [2026-08-01 01:58 UTC] 重建索引: 50 篇页面
  • [2026-08-02 09:38 UTC] 重建索引: 52 篇页面
  • [2026-08-02 09:38 UTC] 新增边: finding:2026-08-02-thinking-switch-and-reasoning-tokens --supports--> design:2026-08-02-thinking-capability-design
  • [2026-08-02 09:38 UTC] 新增 finding: 推理开关与 reasoning_tokens 供应商实测与业界做法 (finding:2026-08-02-thinking-switch-and-reasoning-tokens)
  • [2026-08-02 09:38 UTC] 新增 design: 推理开关能力建模与 reasoning_tokens 采集 issue #5+#6 (design:2026-08-02-thinking-capability-design)
  • [2026-08-02 09:39 UTC] 重建 Query Pack: 29 字符
  • [2026-08-02 09:49 UTC] 重建索引: 53 篇页面
  • [2026-08-02 09:49 UTC] 新增边: plan:2026-08-02-thinking-capability --implements--> design:2026-08-02-thinking-capability-design
  • [2026-08-02 09:49 UTC] 新增 plan: 推理开关能力建模与 reasoning_tokens 采集实施计划 (plan:2026-08-02-thinking-capability)
  • [2026-08-02 09:49 UTC] 重建索引: 53 篇页面
  • [2026-08-02 10:55 UTC] 重建索引: 53 篇页面
  • [2026-08-02 10:55 UTC] 更新 finding: 补 §2.5 输出长度不是有效判别量(e2e 各 15 轮实测)
  • [2026-08-06 06:37 UTC] 新增 design: 治理后端故障归位为 scope 级不可用(Issue #7) (design:governance-backend-error)
  • [2026-08-06 06:38 UTC] 重建索引: 55 篇页面
  • [2026-08-06 08:08 UTC] 新增 plan: 实现计划: 治理后端故障归位为 scope 级不可用(Issue #7) (plan:governance-backend-error)
  • [2026-08-06 08:08 UTC] 新增边: plan:governance-backend-error --implements--> design:governance-backend-error
  • [2026-08-06 08:08 UTC] 重建索引: 57 篇页面
  • [2026-08-06 08:11 UTC] 重建索引: 57 篇页面
  • [2026-08-06 14:57 UTC] 新增 design: stall 判定改为非生产性等待口径 (design:issue8-stall-budget)
  • [2026-08-06 14:58 UTC] 新增 plan: issue #8 实施计划: stall 非生产性等待口径 (plan:issue8-stall-budget-plan)
  • [2026-08-06 14:58 UTC] 新增边: plan:issue8-stall-budget-plan --implements--> design:issue8-stall-budget
  • [2026-08-06 14:58 UTC] 重建索引: 61 篇页面
  • [2026-08-07 15:20 UTC] 新增 design: 建表前先探测,判死只认「确定写不进去」 (design:issue9-telemetry-ddl-probe)
  • [2026-08-07 15:20 UTC] 重建索引: 62 篇页面
  • [2026-08-07 15:11 UTC] 重建索引: 62 篇页面
  • [2026-08-16 09:09 UTC] 新增 design: HTTP 错误响应体留存(Issue #10) (design:issue10-error-body-retention)
  • [2026-08-16 09:12 UTC] 重建索引: 64 篇页面
  • [2026-08-16 09:50 UTC] 新增 plan: 实现计划: HTTP 错误响应体留存(Issue #10) (plan:issue10-error-body-retention-plan)
  • [2026-08-16 09:50 UTC] 新增边: plan:issue10-error-body-retention-plan --implements--> design:issue10-error-body-retention
  • [2026-08-16 09:50 UTC] 重建索引: 66 篇页面
  • [2026-08-17 09:53 UTC] 重建索引: 68 篇页面
  • [2026-08-17 10:09 UTC] 新增 plan: 调用方自定义维度实现计划(issue #11) (plan:issue11-caller-dimensions)
  • [2026-08-17 10:09 UTC] 新增边: plan:issue11-caller-dimensions --implements--> design:issue11-caller-dimensions
  • [2026-08-17 10:09 UTC] 重建索引: 70 篇页面
  • [2026-08-19 12:44 UTC] 新增 design: issue #13: 遥测 schema 自动 ALTER 降级为按后端不对称的显式档位 (design:issue13-schema-mode)
  • [2026-08-19 12:44 UTC] 新增 design: issue #12: 遥测表的正文体量、保留期与访问控制 (design:issue12-telemetry-retention)
  • [2026-08-19 12:45 UTC] 重建索引: 74 篇页面
  • [2026-08-19 13:10 UTC] 新增 plan: 实现计划: issue13-schema-mode (plan:plan-issue13-schema-mode)
  • [2026-08-19 13:10 UTC] 新增边: plan:plan-issue13-schema-mode --implements--> design:issue13-schema-mode
  • [2026-08-19 13:10 UTC] 新增 plan: 实现计划: issue12-telemetry-retention (plan:plan-issue12-telemetry-retention)
  • [2026-08-19 13:10 UTC] 新增边: plan:plan-issue12-telemetry-retention --implements--> design:issue12-telemetry-retention
  • [2026-08-19 13:10 UTC] 重建索引: 78 篇页面
  • [2026-08-20 03:29 UTC] 新增 design: 熔断拒绝补齐等待档(issue #14) (design:issue14-admission-wait-policy)
  • [2026-08-20 03:30 UTC] 新增 plan: 实现计划: 熔断拒绝补齐等待档(issue #14) (plan:issue14-admission-wait-policy)
  • [2026-08-20 03:30 UTC] 新增边: plan:issue14-admission-wait-policy --implements--> design:issue14-admission-wait-policy
  • [2026-08-20 03:30 UTC] 重建索引: 82 篇页面
  • [2026-08-20 03:30 UTC] 重建索引: 80 篇页面
  • [2026-08-20 05:01 UTC] 新增边: review:issue14-branch-review --informs--> plan:plan-issue14-admission-wait-policy
  • [2026-08-20 05:01 UTC] 重建索引: 80 篇页面
  • [2026-08-20 05:01 UTC] 新增 review: 整分支审查: issue #14 熔断等待档 (review:issue14-branch-review)
  • [2026-08-20 05:01 UTC] 重建索引: 81 篇页面
  • [2026-08-24 05:49 UTC] 新增 design: issue #15: 遥测连接池的资源语义与生命周期 (design:issue15-telemetry-pool-lifecycle)
  • [2026-08-24 05:50 UTC] 重建索引: 83 篇页面
  • [2026-08-24 05:50 UTC] 新增边: design:issue15-telemetry-pool-lifecycle --refines--> design:issue9-telemetry-ddl-probe
  • [2026-08-24 05:50 UTC] 新增边: design:issue15-telemetry-pool-lifecycle --depends_on--> design:issue12-telemetry-retention
  • [2026-08-24 05:50 UTC] 重建索引: 83 篇页面
  • [2026-08-24 10:14 UTC] 重建索引: 83 篇页面
  • [2026-08-24 10:15 UTC] design:issue15-telemetry-pool-lifecycle 经 Codex 审查: 3 阻断+3 应改+1 可选,核实后 6 采纳 1 改判,正文补 §9 审查留痕
  • [2026-08-24 10:20 UTC] 最低 Python 提到 3.12(pyproject/ruff/README/CLAUDE.md 四处);design:issue15 §6 版本取舍消解,§7 补两项实施前置
  • [2026-08-24 10:32 UTC] Python 3.12 迁移执行完毕: 环境重建 3.12.13、补装 build/twine、UP047 三处改 PEP 695;make check 绿、973 passed 覆盖率 94%
  • [2026-08-24 12:05 UTC] 新增 plan: 实现计划: 遥测连接池的资源语义与生命周期(issue #15) (plan:plan-issue15-telemetry-pool-lifecycle)
  • [2026-08-24 12:05 UTC] 新增边: plan:plan-issue15-telemetry-pool-lifecycle --implements--> design:issue15-telemetry-pool-lifecycle
  • [2026-08-24 12:05 UTC] 重建索引: 85 篇页面
  • [2026-08-24 12:10 UTC] plan:issue15 经 Codex 审: 2 阻断已修(20 处构造点须同批改、application_name 改走 DSN 查询参数)、_failed 计数修正
  • [2026-08-24 15:48 UTC] issue15 T1-T7 实施完成: 池按需建连(min_size=0)+失败三分与 60s 冷却+TelemetryStatus 快照+所有权纪律统一,1038 passed
  • [2026-08-24 15:48 UTC] issue15 独立验证 5 问题处置: 日志级别决策收敛到 tracker(fatal=error)并补执法用例、is not None 所有权纪律补 falsy 用例、更正两处过时吞吐数字、acquire 预算措辞对齐代码、登记页状态与行数校正
  • [2026-08-24 15:49 UTC] 重建索引: 85 篇页面
  • [2026-08-24 15:51 UTC] 重建索引: 85 篇页面
Reference in New Issue View Git Blame Copy Permalink