docs(architecture): clarify storage pass-through mode

2026-10-07 21:26:40 +08:00
parent 13c29badfb
commit c465d39d58
3 changed files with 15 additions and 1 deletions
@@ -136,6 +136,12 @@ write 也必须服从当前实现与测试。修改前先确认代码中的常
 Worker 发生故障时可以进入已有退避和恢复流程；这不应被伪装成负载上限。正常排队的
 解析、存储和 Host 工作不能因为一个未经测量的队列数字直接返回 busy。

+`ReadonlyQueryReader` 同时服务只读 Worker 和桌面 storage client。只有调用方显式传入
+`maxPending` 时，`waiting` 队列才承担有界等待语义；生产 storage client 不传该选项，
+请求直接交给 storage host。这个共享类不是第二个 storage owner，不能因为看到等待队列
+就给生产路径恢复默认 admission 上限。若未来实测证明某个边界需要容量策略，应先说明
+资源、故障和测量依据，再拆出最小的显式 wrapper 或增加调用方配置。
+
 ## 测试与真实验证

 单元测试用于确定字节边界、事务回滚、顺序、归属、取消竞态、失败清理和重试。行为改动