iomgaa
9185eab8c9
Add faithful single-choice chat results, tool stream activity, error-frame retries, and isolated protocol caching. Reject empty cached completions with the same value predicate as transport, add regression coverage, and adopt Apache-2.0.
15 KiB
15 KiB
Research Wiki 索引
自动生成，更新时间：2026-10-01 18:27 UTC
design (47)
- 1.3.4 推理意图与测试证据设计
design:2026-09-09-134-thinking-contracts-design - 2026-07-20-m1-core-design
design:2026-07-20-m1-core-design - 2026-07-20-m2-distributed-design
design:2026-07-20-m2-distributed-design - 2026-07-21-m25-resilience-design
design:2026-07-21-m25-resilience-design - 2026-07-21-m3-ocr-design
design:2026-07-21-m3-ocr-design - 2026-07-22-m4-migration-design
design:2026-07-22-m4-migration-design - 2026-07-29-settings-invariant-guards-design
design:2026-07-29-settings-invariant-guards-design - 2026-07-30-est-tokens-decoupling-design
design:2026-07-30-est-tokens-decoupling-design - 2026-07-30-settings-invariants-round-2-design
design:2026-07-30-settings-invariants-round-2-design - 2026-07-31-response-observability-fields-design
design:2026-07-31-response-observability-fields-design - 2026-07-31-sampling-params-design
design:2026-07-31-sampling-params-design - 2026-08-06-governance-backend-error-design
design:2026-08-06-governance-backend-error-design - 2026-08-06-issue8-stall-budget-design
design:2026-08-06-issue8-stall-budget-design - 2026-08-16-issue10-error-body-retention-design
design:2026-08-16-issue10-error-body-retention-design - 2026-08-17-issue11-caller-dimensions-design
design:2026-08-17-issue11-caller-dimensions-design - 2026-08-19-issue12-telemetry-retention-design
design:2026-08-19-issue12-telemetry-retention-design - 2026-08-19-issue13-schema-mode-design
design:2026-08-19-issue13-schema-mode-design - 2026-08-19-issue14-admission-wait-policy-design
design:2026-08-19-issue14-admission-wait-policy-design - 2026-08-24-issue15-telemetry-pool-lifecycle-design
design:2026-08-24-issue15-telemetry-pool-lifecycle-design - 2026-09-04-reasoning-effort-design
design:2026-09-04-reasoning-effort-design - 2026-09-09-135-call-observability-design
design:2026-09-09-135-call-observability-design - 2026-09-09-136-call-budgets-design
design:2026-09-09-136-call-budgets-design - 2026-09-10-24-hedged-requests-design
design:2026-09-10-24-hedged-requests-design - 2026-09-11-streaming-stall-design
design:2026-09-11-streaming-stall-design - est_tokens 解耦: 拆分限流预扣与遥测用量兜底(issue #2)
design:est-tokens-decoupling - GatewaySettings 装配校验补齐(第二轮)
design:settings-invariants-round-2 - GatewaySettings 跨字段不变量守卫的生效范围
design:settings-invariant-guards - HTTP 错误响应体留存(Issue #10)
design:issue10-error-body-retention - issue #12: 遥测表的正文体量、保留期与访问控制
design:issue12-telemetry-retention - issue #13: 遥测 schema 自动 ALTER 降级为按后端不对称的显式档位
design:issue13-schema-mode - issue #15: 遥测连接池的资源语义与生命周期
design:issue15-telemetry-pool-lifecycle - issue #18: 隔离靠权限强制,目标靠显式声明
design:2026-08-26-issue18-pg-test-isolation - M1 核心里程碑设计:公共签名冻结与治理栈落地
design:m1-core-design - M2 分布式:Redis 治理后端+背压+Postgres 遥测+pricing+Embedding+压测 harness
design:m2-distributed - M2.5 治理韧性: 半死源隔离与健康感知调度
design:m25-resilience - M3 OCR 端口族设计
design:m3-ocr - M4 迁移验证设计(GovDoc→CHS,发 v1.0)
design:m4-migration - OpenAI消息保真设计
design:2026-10-01-issue29-openai-fidelity-design - stall 判定改为非生产性等待口径
design:issue8-stall-budget - 响应可观测字段扩展(Issue #3)
design:response-observability-fields - 建表前先探测,判死只认「确定写不进去」
design:issue9-telemetry-ddl-probe - 推理可观测性一等化(issue #16 + #17)
design:2026-08-25-thinking-observability-design - 推理开关能力建模与 reasoning_tokens 采集(issue #5 + #6)
design:2026-08-02-thinking-capability-design - 推理档位一等化设计(issue #20 及其一般形式)
design:reasoning-effort - 治理后端故障归位为 scope 级不可用(Issue #7)
design:governance-backend-error - 调用方自定义维度设计(issue #11)
design:issue11-caller-dimensions - 采样参数透传设计(issue #4)
design:sampling-params
finding (22)
- 1.3.4 推理契约验证与发布准备
finding:2026-09-09-134-thinking-contracts-validation - 1.3.5 T2/T3/T4 验收证据：36 列遥测、失败终态、PG 存储兼容与变异矩阵
finding:2026-09-09-135-call-observability-validation - 1.3.5 发布完成与外部验收：合并后门、registry 产物与页面亲查
finding:2026-09-09-135-release-completion - 1.3.6 可选调用期限与取消结算验证记录
finding:2026-09-10-136-call-deadline-validation - 1.3.8 流式中段沉默:净口径与中段对冲验证报告
finding:2026-09-11-streaming-stall-validation - 2026-07-20-m2-soak-workload
finding:2026-07-20-m2-soak-workload - 2026-07-21-m25-acceptance
finding:2026-07-21-m25-acceptance - 2026-07-21-p6-soak-baseline
finding:2026-07-21-p6-soak-baseline - 2026-07-22-m4-acceptance
finding:2026-07-22-m4-acceptance - 2026-07-22-p7-ocr-soak
finding:2026-07-22-p7-ocr-soak - 2026-09-11-streaming-stall-hedging-research
finding:2026-09-11-streaming-stall-hedging-research - 2026-10-01-issue29-license-audit
finding:2026-10-01-issue29-license-audit - issue #16/#17 实测: M3 推理正常,失效的是推理的可观测信号
finding:2026-08-25-thinking-observability-regression - issue #18 实测: 偶发红的是安全网本身,不是被测脚本
finding:2026-08-26-issue18-shared-pg-test-isolation - issue #24 长尾对冲请求与裸生成时间验证报告
finding:2026-09-10-24-hedged-requests-validation - M2 verifier 三项 Important 补齐(不变量接线/网关保护/P3 验收)
finding:m2-verifier-fixes - M2 真实数据压测: 场景矩阵与数据清单
finding:m2-soak-workload - M2.5 验收: P6 同场景 58.1% → 98.96%
finding:m25-acceptance - M4 迁移验收(GovDoc+CHS)
finding:m4-acceptance - P6 混合浸泡首跑基线与记分板三重伪击穿修复
finding:p6-soak-baseline - P7 OCR soak 验收: 99.73% 与 13 不变量全 PASS
finding:p7-ocr-soak - 推理开关与 reasoning_tokens: 供应商实测与业界做法
finding:2026-08-02-thinking-switch-and-reasoning-tokens
plan (42)
- 1.3.4 推理契约实施计划
plan:2026-09-09-134-thinking-contracts - 1.3.5 逻辑调用统计与结构化失败诊断实施计划
plan:2026-09-09-135-call-observability - 1.3.6 可选调用期限与取消结算修复实施计划
plan:2026-09-10-136-call-deadline - 1.3.8 流式中段沉默:计量口径与对冲实施计划
plan:2026-09-11-streaming-stall - 2026-07-20-m1-core-plan
plan:2026-07-20-m1-core-plan - 2026-07-20-m2-distributed-plan
plan:2026-07-20-m2-distributed-plan - 2026-07-21-m25-resilience-plan
plan:2026-07-21-m25-resilience-plan - 2026-07-21-m3-ocr-plan
plan:2026-07-21-m3-ocr-plan - 2026-07-22-m4-migration-plan
plan:2026-07-22-m4-migration-plan - 2026-07-30-est-tokens-decoupling-plan
plan:2026-07-30-est-tokens-decoupling-plan - 2026-07-31-response-observability-fields
plan:2026-07-31-response-observability-fields - 2026-07-31-sampling-params
plan:2026-07-31-sampling-params - 2026-08-06-governance-backend-error-plan
plan:2026-08-06-governance-backend-error-plan - 2026-08-06-issue8-stall-budget
plan:2026-08-06-issue8-stall-budget - 2026-08-16-issue10-error-body-retention
plan:2026-08-16-issue10-error-body-retention - 2026-08-17-issue11-caller-dimensions
plan:2026-08-17-issue11-caller-dimensions - 2026-08-19-issue12-telemetry-retention
plan:2026-08-19-issue12-telemetry-retention - 2026-08-19-issue13-schema-mode
plan:2026-08-19-issue13-schema-mode - 2026-08-24-issue15-telemetry-pool-lifecycle
plan:2026-08-24-issue15-telemetry-pool-lifecycle - 2026-09-04-reasoning-effort
plan:2026-09-04-reasoning-effort - est_tokens 解耦实施计划
plan:est-tokens-decoupling - issue #18 实现计划: 权限边界替代行数快照 + --table 锁死目标
plan:2026-08-26-issue18-pg-test-isolation - issue #24 长尾对冲请求与裸生成时间实施计划
plan:2026-09-10-24-hedged-requests - issue #8 实施计划: stall 非生产性等待口径
plan:issue8-stall-budget-plan - M1 核心里程碑实现计划
plan:m1-core-plan - M2 分布式实现计划
plan:m2-distributed - M2.5 治理韧性实现计划
plan:m25-resilience - M3 OCR 实现计划
plan:m3-ocr - M4 迁移实现计划(T0-T14)
plan:m4-migration - OpenAI消息保真实现计划
plan:2026-10-01-issue29-openai-fidelity - plan-issue14-admission-wait-policy
plan:plan-issue14-admission-wait-policy - 响应可观测字段扩展实现计划
plan:response-observability-fields - 实现计划: HTTP 错误响应体留存(Issue #10)
plan:issue10-error-body-retention-plan - 实现计划: issue12-telemetry-retention
plan:plan-issue12-telemetry-retention - 实现计划: issue13-schema-mode
plan:plan-issue13-schema-mode - 实现计划: 推理档位一等化
plan:reasoning-effort - 实现计划: 治理后端故障归位为 scope 级不可用(Issue #7)
plan:governance-backend-error - 实现计划: 遥测连接池的资源语义与生命周期(issue #15)
plan:plan-issue15-telemetry-pool-lifecycle - 推理可观测性一等化实现计划(issue #16 + #17,发 1.3.1)
plan:2026-08-25-thinking-observability-plan - 推理开关能力建模与 reasoning_tokens 采集实施计划(issue #5 + #6)
plan:2026-08-02-thinking-capability - 调用方自定义维度实现计划(issue #11)
plan:issue11-caller-dimensions - 采样参数透传实现计划(issue #4)
plan:sampling-params-plan
review (6)
- 2026-09-11-138-branch-review
review:2026-09-11-138-branch-review - 2026-09-11-138-verifier
review:2026-09-11-138-verifier - 2026-09-11-streaming-stall-design-review
review:2026-09-11-streaming-stall-design-review - 2026-09-11-streaming-stall-plan-review
review:2026-09-11-streaming-stall-plan-review - 保真缓存审查修复与1.4.0准备
review:2026-10-01-issue29-cache-review - 整分支审查: issue #14 熔断等待档
review:issue14-branch-review
schema (1)
- 表结构: llm_calls(遥测 36 字段)
schema:llm-calls
metric (2)
- OCR 治理调用成功率与错误分类分布
metric:ocr-call-success - 每次调用必录覆盖率(含缓存命中/失败/取消)
metric:call-telemetry-coverage