iomgaa
6691e52195
Changelog, README (install pin, capability table, usage, deployment recipe, operations notes, known limits), env example, architecture, roadmap, the M3 design erratum and the CHSAnalyzer3 consumption notes.
16 KiB
16 KiB
Research Wiki 索引
自动生成，更新时间：2026-10-22 04:23 UTC
design (49)
- 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 - OCR 整份文档解析设计(#34)
design:2026-10-21-issue34-ocr-document-design - 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 - 统一完成判定设计(#30/#31)
design:2026-10-14-issue30-31-completion-verdict-design - 调用方自定义维度设计(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 (44)
- 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 - OCR 整份文档解析实现计划(#34)
plan:2026-10-21-issue34-ocr-document - 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 - 统一完成判定实现计划(#30/#31)
plan:2026-10-14-issue30-31-completion-verdict - 调用方自定义维度实现计划(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