proxy-pool/progress.md

项目进度

2026-07-29

• 已实现共享 httpapi、httpsecurity 与 httpserver，统一严格 JSON、Problem、 Request ID、认证、可信代理、Client ID、准入、多监听器生命周期和优雅停机。
• Distribution/Admin Handler 已装配到独立监听器；Gateway 配置认证统一复用 httpsecurity，API 401 与代理 407 语义保持分离。
• 部署配置已使用 ${VAR} 真实环境变量解析，ConfigMap 与本地配置通过 LoadResolved 回归测试。
• 已新增公用 activitypool 契约和并发安全内存参考实现；Provider 按各供应商 TTL 与安全余量写入，独占提取、短期幂等和 Worker 所有权在同一原子边界内。
• Proxy 明细不写 PostgreSQL；PostgreSQL 仅保存配置版本、管理状态、Admin 审计、管理 outbox 和可选聚合指标。
• usableUntil 已进入 Worker Snapshot 契约，Gateway 在供应商硬过期前按安全 余量停止新分配。
• 生产 Redis Adapter、PostgreSQL 管理面 Adapter、生产命令入口与代表性 100,000 QPS 集群压测仍待实现。

2026-07-28

• 用户删除了先前基于不完整网页内容生成的设计文件。
• 已重新读取当前 对话内容.md 全部 9,404 行。
• 已按主题定位配置定稿、实施方案、Distribution API、认证、安全、并发、 故障语义和最终 Exclusive Extraction 修订。
• 已建立新的任务计划与事实记录，旧网页摘要不再作为需求证据。
• 已建立需求追踪矩阵、统一领域语言、产品设计、总体架构、项目结构、ADR、 开发、配置、API、安全、测试与运维文档。
• 已提供 20 个严格校验的配置示例、Distribution/Admin OpenAPI、Controller/ Worker/Checker Protobuf 契约和 35 张 Mermaid 图。
• 已实现并测试 Proxy 状态/TTL/唯一键、打包原子容量、首条路由、Sequential 并发切换、Fetch 分类、一次性独占提取、严格配置、Snapshot 与本地 Dispatch。
• go test ./...、go vet ./...、go build ./... 通过。
• Protobuf 描述符编译、Compose 静态展开、Kustomize 渲染、Grafana JSON 与 配置示例校验通过。
• Windows 当前 CGO_ENABLED=0 且无 C 编译器，race 测试由 Linux CI 承担。
• 100,000 QPS 仍是未验证设计目标；运行进程、存储适配器、完整网络转发与 代表性集群压测尚未实施，已在完成审计中明确列出。
• 已生成 proxy-pool-docs-v1.0.zip，包含 50 个条目，SHA-256 为 A6882B71196210CE3594A10992C2A0A73EA3A1CF31D8A570709CA999133CE104。
• 已实现 random、roundRobin、weighted、leastConnections，并将 Sequential 拆成共享 Upstream 空结果状态与每 Routing 版本化游标。
• 已实现 Provider 合并通知、完整 attempt 超时、永久错误契约、指数退避、 Retry-After、原子 FetchBudget 以及 Pool Reconciler。
• 已强制 Worker 所有权与 Exclusive Extraction 注入同一权威 Repository， 覆盖 100 轮并发竞争、续期、Drain ACK 和 Worker 过期回收。
• 已实现提取服务层策略映射、Redis 短期幂等语义、来源身份准入和公共 FixedWindow 全局/Client 限流器；不保存逐代理提取审计记录。
• 已为 100k Proxy 快照建立 scheme/upstream/tag 索引；本机持续基准中 Acquire 为 640 ns/op、256 B/op、2 allocs/op。该数据仅证明本地选择热路径， 不代表 100k QPS 集群端到端容量。
• 本轮 go test -count=1 ./...、go vet ./...、go build ./... 和 git diff --check 通过；Windows CGO_ENABLED=0，race 仍由 Linux CI 验证。