 iomgaa
|
1149e7fbbf
|
docs: 全量下线文档站,留说明性占位页
八轮审查累计确认 93 处与源码不一致,近半落在参考区(手工镜像源码里已有
的事实,必然漂移),且修正本身在引入次生偏差,逐轮修补不收敛。
过期文档比没有文档更危险——它看起来权威。留空并指向源码 docstring、
.env.example、CHANGELOG、ARCHITECTURE.md 这些真实事实源。
历史内容未丢失,全在 git 历史里: git checkout e78bfb9 -- .
|
2026-08-02 04:26:36 -04:00 |
|
|
iomgaa
|
e78bfb90d3
|
docs: 修正第八轮 5 处不一致,其中 3 处是我第七轮引入的
我引入的三条:
- per_source_reasons 写入规则我写成 rate_limited 一律 setdefault,实际它有
两个写入点——上游 429 走 _failure_reason 直接覆盖,本地限流闸拒绝才是
setdefault。照我上轮的写法反推会得出相反结论
- Home 导语我写成"成本换算仅 chat 有",实际反了: EmbeddingClient 传 pricing、
而 chat 的 LLMResponse.cost 被硬编码 None
- STALL_WINDOW_S 我只补了"可省/缺省值",没纠正它被窄化成"配额满等待"
原始缺陷两条:
- LLMResponse.cost 在 chat 路径恒为 None(retry.py:437 硬编码),wiki 一直写
"按价格表折算"。sum(r.cost ...) 会 TypeError,写了 or 0 的静默算出 0 元
- SourceDeadError 同样不穿出,except SourceDeadError 是死分支,坏 key 告警
会静默失效
|
2026-08-02 02:32:44 -04:00 |
|
|
iomgaa
|
592d7e87bd
|
docs: 修正第七轮 6 处不一致,总表补响应缓存行与作用域边界段
本轮 7 条里 5 条是缺失、仅 1 条是我的次生偏差(Embedding 页的封闭计数
"两处不同"漏了 AIMD),已改为开放式并链回总表。
G1 两个 client 无 cache= 形参且不构造响应缓存(配了 PGW_CACHE_BACKEND
会以为 embed 走缓存,实际每次真打上游且不报错)
G2 GatewaySettings 20 字段全必填,四个子配置类型不在顶层导出
G3 坏结果不写缓存仅默认档成立,salvage 下半截答案按 TTL 回放
G5 per_source_reasons 写入规则不统一,坏 key 的 source_dead 会被
circuit_open/cooldown 覆盖掉
G6 健康分/AIMD/冷却备忘三样永远进程本地无 redis 实现;备忘时长取自
PROBE_TTL_S 而非 COOLDOWN_S,熔断闭合也不撤销
按报告建议一次做完模式 A: Home 与 Embedding 页的路径差异复述改为链回
解释-治理行为 的总表。
|
2026-08-02 01:40:56 -04:00 |
|
|
iomgaa
|
db4a41e472
|
docs: 修正第二轮审查发现的 22 处 wiki 与代码不一致
含两条上一轮我照搬建议引入的错误: 缓存页的"未装 strategy 静默降级"
(实为 chat() 入口硬抛 ImportError)、采样页的"provider 支持时自动选用
原生 schema"(内置四个 profile 的 supports_native_schema 全为 False)。
其余: LLMResponse 字段表把 source_name 排进前 11 位(迁移项目按位置构造
fake 会静默错位)、aclose 不释放限流/熔断后端、register_provider 是纯函数、
retry_after_s 取值随 reason 而异、TransientError 有三种出口、429 记的是
rate_limited、OCR 的 cache 键仍必填、六个可选键缺默认值、RPM/TPM 是分钟
固定窗口、退避 jitter 上界 1.5 倍、memory 缓存无上限、依赖实为五项必装。
|
2026-08-01 23:25:55 -04:00 |
|
|
iomgaa
|
bc05de157d
|
docs: 修正审查发现的 6 处事实错误,并发布 v1.0.5
reason 词表混淆了 scope 级与 source 级两张表;教程说改错 key 得到
AllSourcesExhausted,实测是 CircuitOpenError(照写会捕不到);TPM 的
EST_TOKENS 必填在 v1.0.3 已废除;limiter/breaker 后端标错必填而真正
必填的 RETRY/BREAKER 键没标;llm_calls 是 22 列(21 是端口参数数,差
created_at);结构化覆盖 response_format 只在原生 schema 策略下成立。
|
2026-07-31 23:54:33 -04:00 |
|
|
iomgaa
|
9bd2061f26
|
docs: correct the version to 1.0.4 and the backfill wording
|
2026-07-31 11:13:53 -04:00 |
|
|
iomgaa
|
d40f89378c
|
docs: document the response observability fields for v1.1.0
|
2026-07-31 08:22:11 -04:00 |
|
|
iomgaa
|
4c8dc0954c
|
docs: usage_source 三态与 EST_TOKENS 降为可选(v1.0.3)
- 指南-遥测与成本: 新增三态表与 cost NULL 口径,缺口查询必须带 cache_hit 限定
- 解释-治理行为: 有效预扣量的派生规则;点明限流保守与计费诚实是两回事
- 参考-配置键: EST_TOKENS 由必填降为可选调优覆盖
- 参考-公共API: usage_source 三态、SourceConfig.effective_est_tokens()
- 指南-Embedding: 缺 usage 时记 unavailable 而非估算值
- Home: 版本号 v1.0.3(安装命令用 1.0.* 无需改)
|
2026-07-30 12:14:48 -04:00 |
|
|
iomgaa
|
5cfb131d6f
|
docs: bump current version to v1.0.2
|
2026-07-30 02:33:53 -04:00 |
|
|
iomgaa
|
e9af8f11eb
|
docs: bump current version to v1.0.1
|
2026-07-30 00:39:14 -04:00 |
|
 iomgaa
|
9745aa771c
|
docs: full documentation set (Diataxis: tutorial, how-to, reference, explanation)
|
2026-07-23 03:52:59 -04:00 |
|
|
iomgaa
|
7b3777a094
|
Add "Home"
|
2026-07-23 15:46:38 +08:00 |
|