tzt/projectAIpopular
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
74 Commits 3 Branches 0 Tags
b2b7a64cb3a8f10f70eed946dcf2fe14c7141e62
Commit Graph
51 Commits
Author SHA1 Message Date
tzt b2b7a64cb3 feat(proxy): T-X12 采纳 enterprise-ai-gateway 双桶限流——TPM token 桶 + 语义缓存命中率透出 
- auth.RateLimiter.allow_tokens：TPM 令牌桶（容量=tpm_cap，连续回流 tpm/60 每秒，
  与 RPM 桶共用 per-key 锁、判定相互独立；tpm_cap<=0 不限）
- ProxyConfig.limits.tpm_per_key（默认 60000，0=不限）；chat_completions 在并发槽
  之后做 TPM 预扣判定（est=字符/3 与计费同口径），拒绝时释放并发槽并回 429
  （文案区分并发/RPM/TPM 三种原因）
- semcache.stats 增 misses 与 hit_rate；/admin/stats 新增 semcache 段透出
  （entries/hits_exact/hits_semantic/misses/hit_rate，与账本 h_g 互补）
- 新增 tests/test_tpm_limiter.py 6 项（容量/回流/禁用/双桶独立/key 隔离/命中率）
 2026-09-19 10:09:56 +08:00
tzt f04a6c4c43 feat(proxy): T-X11 采纳 cortiq shadow 旁路评审——live T1 本地应答异步云端评审喂晋升表 
- routes：live 分流 T1 响应后按 sample_rate 采样旁路——premium 条目以评审提示词
  给本地答案打 PASS/FAIL，经 PromotionTable.observe 写入 T-X5 晋升表
  （打通晋升质量信号的自动来源，夜间 labeler 之外的实时通路）
- 零客户端延迟：asyncio.create_task 旁路 + wait_for 超时 + Semaphore(2) 并发上限；
  上游故障/解析失败记 ERROR，不算 FAIL（评审器不可用不惩罚本地模型）；
  仅非流式响应采样（流式无同步答案文本），默认关闭（sense.shadow_review.enabled）
- 模块级计数字典 sampled/pass/fail/error + reset_shadow_review_stats() 测试钩子
- 新增 tests/test_shadow_review.py 5 项（默认关/条目选取/PASS-FAIL-ERROR 解析/
  晋升表喂入/关闭态零副作用），全假上游不依赖真实模型
 2026-09-19 10:03:38 +08:00
tzt e5470a3715 feat(proxy): T-X10 采纳 cortiq 语义缓存路由签名分桶——不同路由意图不互串答案 
- normalizer.canonical_hash 增加可选 route_sig 段：键 = bucket|doc_version|sig|sha256
  （旧三段格式向后兼容，旧条目随 TTL 自然淘汰）
- ProxyConfig 新增 semcache.route_sig_scope：capabilities（默认，vision/tools 需求
  签名）/ model（按模型隔离）/ none（旧行为）；非法值回落 capabilities
- semcache：签名升级为条目属性并分区 L2 语义扫描（仅键分桶不够——语义层仍会
  跨签名命中）；签名从缓存键第四段解析，重启重建零 schema 变更；
  晋升别名键携带签名段；route_sig=None 的旧调用零过滤完全兼容
- routes：lookup/put 共用同一 norm_hash（消除 put 侧重复哈希），签名贯穿两层
- 新增 tests/test_route_sig.py 6 项（键格式/键空间分割/scope 三态/两层隔离/
  重建存活/旧调用兼容）
 2026-09-19 09:59:15 +08:00
tzt 1aaa05cacc feat(sense): T-X5 云端评判晋升表×conformal 双闸门——本地档自动接管（采纳 cortiq promotion） 
- gateway/sense/promotion.py：PromotionTable 状态机（candidate/promoted/demoted）
  * 晋升门：n_total>=n_min 且 通过率>=promote_lb 且 soak 浸泡期满足
  * 退化：promoted 期间通过率<demote_lb 自动降级；降级后可凭数据恢复
  * 一票否决：tier=T3 观察不进通过率统计，已晋升者立即降级
  * 持久化 sense_promotion 表（CREATE IF NOT EXISTS 幂等）
- grader：live 模式对已晋升标签的 T2 决策（无 T3 信号/非 fallback）升级 T1，
  hard_gates.promotion_applied 如实标注；T1/T3/fallback 路径不受影响
- 回填链路：T1 审计抽样带 promo:<label> 标签 -> 人工 verdict approve=ok
  经 /review/{id} 提交时回填晋升表（失败不影响审核主流程）
- 双闸门语义：conformal 阈值保证单条决策风险率，晋升表保证标签级接管节奏；
  collect 数据不足（n_min 未满）不晋升，全部迁移可经 T-X4 留痕审计

pytest 474 passed（T-X4 后 466 + 8）
 2026-09-18 23:01:52 +08:00
tzt 7e01dc9b16 feat(sense): T-X4 可解释决策留痕三元结构 + 修复 sense live 分流潜伏 bug（采纳 ai-model-router 决策模型） 
- store：新增 sense_decisions 表（CREATE IF NOT EXISTS 幂等迁移），
  insert_decision / list_decisions（JSON 字段反序列化），q_hash 不落原文（D-G6）
- grader：全模式落库决策三元——reasons（§8 判定顺序最小完备集）、
  candidate_scores（线性头 probs）、rejected（落选档位+原因）；
  留痕失败静默不影响决策主链路
- 修复：chat_completions 的 sense 分流引用未导入的 settings_store，NameError
  被 except 吞掉导致 D-G7 live 分流从未生效；改为 build_proxy_router 显式注入
  settings_provider（api.py 传 settings_store），缺省 None 行为安全
- 新增 /proxy/admin/sense-decisions 管理面查询端点（sense 未启用返回空集）
- 回归测试：注入 settings_provider 后 x-campus-tier 头出现且 T1 决策经
  管理面可查（修复前该头永远缺失）

pytest 466 passed（T-X6 后 461 + 5）
 2026-09-18 22:55:49 +08:00
tzt 5078721df4 feat(proxy): T-X6 模型池能力位过滤——vision/tools/context 硬过滤（采纳 cortiq capabilities） 
- model_pool：条目新增 capabilities{vision,tools,context_window}，
  归一化缺省全兼容（老条目行为零变化；非法形态回落缺省）；
  filter_by_capabilities 硬过滤（context_window=0 视为不限）
- proxy routes：_request_needs 从请求体推断需求（多模态 image_url → vision、
  tools 非空 → tools、上下文需求 = 字符/3 + min(max_tokens,4096) 与预扣同口径）；
  条目不满足时在池内重定向到首个合格条目
- 与 T-X1/T-X2 组合语义：能力重定向 → 预算降档 → 降级链，逐级独立不互扰

pytest 461 passed（T-X3 后 455 + 6）
 2026-09-18 22:45:50 +08:00
tzt 27a092a3f8 feat(sense): T-X3 路由决策缓存——live 模式 embed+线性头去重（采纳 cortiq 决策哈希缓存） 
- gateway/sense/decision_cache.py：DecisionCache（sha256(scope+文本) 键、
  LRU + TTL 60s、4096 条上限、时钟可注入），对齐 auth._AuthCache 进程内模式
- Grader：仅 live 模式缓存纯决策负载（probs/head_version/vec）；
  命中跳过 embed + 线性头预测；tier 仍按当前 conformal 阈值即时重算；
  观察落盘（observer.log）不因缓存命中跳过——校准数据完整性不受影响
- collect/shadow 模式不走缓存（校准必须全量）；invalidate() 同步清空缓存
  （阈值/工件切换即时生效，TTL 仅兜底陈旧）

pytest 455 passed（T-X2 后 447 + 8）
 2026-09-18 22:41:15 +08:00
tzt a043493548 feat(proxy): T-X2 上游有序降级链 + failover 三元组如实上报（采纳 cortiq tier 链） 
- routes._fallback_chain：主条目之外的启用真实后端按（档位升序，单价和升序）
  构成有序候选链（≤3），排除 mock/停用/同模型，仅作 D-P4 首 token 前 failover
- _stream_response/_json_response 接入链式候选（原 [entry,entry] 同条目重试升级为真降级链）
- upstream.stream：failover 发生即记 sink[upstream_fallback] 与模块级统计；
  JSON 路径经 X-Upstream-Fallback/Original/Used/Reason 四头如实上报
  （流式路径头已发出不可追溯，由统计聚合暴露）
- /proxy/admin/stats 新增 upstream_failover 块（total + recent 20 条）

pytest 447 passed（T-X1 后 443 + 4）
 2026-09-18 22:35:53 +08:00
tzt aa7cb0704c feat(proxy): T-X1 预算四档渐进干预（采纳 ai-model-router budgets 设计） 
- billing.BillingMixin 新增 budget_mode(student, est, ts)：整数基点判定
  normal(<80%) / optimize(>=80%) / cheap(>=95%) / block(>100%)；
  cap<=0 不限额恒 normal；学生缺失 normal（扣费与拒绝权威仍在 try_hold）
- routes._run_chat：optimize/cheap 档自动降档池条目（_downgrade_entry，
  TIERS 排名制降档、杜绝反向升档、跳过停用与 mock），重算 model/est；
  非正常档位经 X-Budget-Mode 响应头如实上报（缓存命中路径同样携带）
- 黄金用例锁死边界：7999/8000/9499/9500/10000/10001bp 九组参数化断言，
  全整数运算无浮点漂移；跨日重置与不限额口径与 try_hold 一致

pytest 443 passed（基线 425 + 18）
 2026-09-18 22:28:50 +08:00
tzt ebb3cbb41d feat(proxy): 语义缓存 L2 查找 3.39x + Mimosa 扫描 15 高危清零 
算法（gateway/proxy/semcache.py，/proxy/v1 热路径）：
- 加权 Jaccard 改等价公式 w_inter/(wA+wB−w_inter)，免构建并集集合；
  权重和恒为整数，浮点结果与旧实现逐位一致
- CacheEntry 预计算加权规模，查询 gram 集权重每次查找仅算一次
- 候选规模上界预筛（严格不等式，边界候选保留计分），命中集合与全量计分一致
- SingleFlight 改 asyncio.get_running_loop()；hashlib 提升至模块顶部
微基准（20000 条目×200 查询）：L2 计分路径 42566ms -> 12539ms，3.39x

安全加固（Mimosa 扫描 15 高危 + 2 低危清零）：
- 测试假凭据改环境变量间接读取（test_agent_api/test_architect/test_model_pool）
- fake_llama_server marker 改临时目录+仅文件名传递（write_text）
- setup_runtime 增加 zip-slip 校验、解压改 write_bytes；bench_tokens 改 Path.open
- runtime 健康检查仅允许回环地址并改用 http.client（防 SSRF）
- e2e/run-api-check.js BASE_URL 回环白名单校验
- research/routerarena/local_runner.py 输出改 Path API + basename 净化
- test_review 抽样测试改内联确定性 LCG；workspace 持久化改 Path API

测试：新增 2 项（公式逐位一致性 property、规模悬殊预筛回归）
pytest 425 passed（基线 423 全绿 + 2）
基线检查点：ec19a07（操作前已提交，423 passed）
 2026-09-18 08:35:36 +08:00
tzt c54ad23c88 feat(proxy): T-P6 缓存分支接线（routes 主时序，M2 完整闭环） 
- _run_chat 开头缓存分支：cacheable（stop+单轮）-> canonical_hash ->
  L1/L2 查 -> 命中：try_hold->立即 settle(cost=0, charged=售价口径,
  status=cached, gateway_cached=1) -> SSE 合成回放或 JSON（X-Cache: HIT）
- 未命中流程收尾写缓存（_json_response 尾部，stop 且单轮）；
  缓存层任何故障降级直连上游（不影响可用性）
- 缓存命中计费 _cached_charge（成本 0，入按字符估收售价——全毛利杠杆 L0）
- _get_semcache 按 db_path 分实例（测试隔离）+ reset_semcache_instances
- 测试 +1（端到端：首问 miss 打上游/二问 HIT 上游仅 1 次/账目 cached），
  全量 423 passed
 2026-09-05 15:56:17 +08:00
tzt e41471c39c feat(proxy): T-P6 语义缓存（L1/L2 倒排+singleflight+SSE 回放，M2 核心） 
- semcache.py：SemanticCache——L1 精确（LRU max_entries=30万）+ L2 字符 2/3-gram
  倒排索引（启动自 sqlite q_norm 重建）+ 加权 Jaccard（3-gram 权 2）+
  共享 gram>=3 候选门限 + 阈值 0.92 + TTL 滑动过期 + L2 命中 5 次晋升 L1
  （别名键写回表）；SingleFlight（dict[hash->Future] 上限 256/60s 超时降级）；
  synth_sse_chunks 命中回放（分块 delta+finish+[DONE] 合法 SSE）
- ledger：semcache_rows/put_semcache/promote_semcache/purge_expired
- 测试 +10：gram/精确/语义上下阈值/TTL 假时钟/LRU/重建/晋升/singleflight/SSE 合法性，
  全量 422 passed
- 待接线：routes 缓存分支（T-P7 顺带接入，M2 完整闭环在压测前完成）
 2026-09-05 15:39:48 +08:00
tzt 6e5294353f feat(sense): T-G8 E-G1 shadow 报告（一致率/分布/覆盖率/晋升门） 
- scripts/sense_report.py：collect 数据 -> 夜间标签推导 -> 一致率/档位分布/
  T1 决策精度（conformal 覆盖）/T1 真值占比/混淆矩阵 -> CSV+Markdown
  报告入 research/v2_experiments/；晋升门四条自动判定
  （一致率>=85% + 覆盖>=1-α-2% + 标签>=min_labels + T1 占比 40-55%）
- 测试 +2（90% 一致率合成集走完整管道含混淆矩阵与晋升结论 /
  标签不足时正确拒绝 live），全量 412 passed
 2026-09-05 15:12:50 +08:00
tzt 204789aed6 feat(sense): T-G6 live 分流（pipeline tier_fn 三档钩子，D-G5 唯一受控改动） 
- pipeline.py：+tier_fn 可选构造参数（None = 现行为逐字节不变）；
  T1=fast path 入口 / T2=单次云端直答（跳过 brief/循环/review，失败落回
  完整管线 D-G1 阶梯）/ T3=强制完整管线（跳过快路径）；同时兼容
  直接可调用与带 .decide 的 grader 对象
- 测试 +5：None 零回归 / T1 fast path / T2 直答跳过 brief/loop / T3 完整管线 /
  T2 失败落回，全量 410 passed（pipeline 既有测试零回归）
 2026-09-05 14:25:46 +08:00
tzt 4575025056 feat(sense): T-G5 Grader 决策组合（特征门×概率×conformal + /v1/route + 三态 mode） 
- features.py：gate() 纯函数——轮数/字符估算/意图黑名单/仓库级信号/长度门
  -> t1_hard_ok（任一硬门不过即 False，D-G1）
- grader.py：Grader.decide §8 时序（embed 降级检查 -> 特征门 -> LinearHead 概率
  -> conformal 阈值：p1>=τ1 且 t1_hard_ok->T1，p3>=τ3 或 repo_signals->T3，
  其余 T2 默认；collect/shadow 只写观察 executed=现行为，live 决策即执行；
  全模式 observer.log）；工件/阈值缓存 + invalidate；D-G4 规则门退化
- routes：/v1/route 契约（D-G6 不落 query 原文）
- fix(observer)：embedding list -> BLOB 转换（修 sqlite 绑定）
- 测试 +6（门矩阵/shadow 不改流/live 决策/降级/保守阈值/写观察），全量 405 passed
 2026-09-05 14:17:44 +08:00
tzt 2a4cb529de feat(sense): T-G4 线性头（离线 softmax 回归 + 纯 Python 推理） 
- classifier.py：LinearHead.load（JSON 工件，缺失/损坏 -> ArtifactMissing）+
  predict（纯 Python 点积 + 稳定 softmax，D-G5 serving 零依赖）；LoraRemote 预留
- scripts/train_tier_head.py：numpy softmax 回归（类别权重均衡/L2），
  70/15/15 切分，head.json + metrics.json（accuracy/macro-F1/逐档 F1）+ 工件登记；
  --synthetic 合成自测链路；CLI 出口 UTF-8 reconfigure
- requirements-ml.txt 登记 numpy（离线训练用，D-P6/D-G5 说明理由）
- 测试 +5（黄金向量 softmax 一致/argmax/缺失/损坏/合成训练-推理链路），全量 400 passed
 2026-09-05 14:05:12 +08:00
tzt 324c419c35 feat(sense): T-G3 标签+校准（labeler 四规则推导 + split-conformal + last-good） 
- labeler.py：derive_true_tier 纯函数（规则0 人工优先 / plan_multi->T3 /
  失败->下一档(T3保持) / 成功->executed / 空结果跳过）+ derive_true_tiers
  批量回填 + 180d 留存清理
- calibrate.py：compute_thresholds（τ1/τ3 分组扫描——并列分数整组判定，
  精度 >= 1-α 的最大覆盖阈值；<min_labels -> ok=False 沿用 last-good）；
  save_thresholds 工件落盘+登记；load_active 回退链 active->同kind扫描->last-good->保守值
- store：all_observations/list_artifacts 支撑方法
- 测试 +9（四规则/批量清理/覆盖达标/标签不足/工件往返与回退），全量 395 passed
 2026-09-05 13:53:45 +08:00
tzt 51f1de2154 feat(sense): T-G1+T-G2 Embedder 与观察埋点 
- T-G1 embedder.py：embed() 调 llama-server /v1/embeddings -> 对称 per-vector
  int8 量化（scale=127/max|v|，1024 维余弦扰动 ~1e-4 << 1e-2 验收）；
  超时/连接/非200/空形状 -> EmbedderDown（D-G4 fail-closed）；
  /v1/embeddings OpenAI 兼容透传（双路由组：/sense 前缀 + /v1 无前缀，
  不可用 503）；build_sense_routers 返回列表
- T-G2 observer.py：Observation + 批量缓冲 100ms 刷盘（asyncio.Queue +
  to_thread，D-P10）；三消费方共用；升级阶梯回写 outcome/executed_tier；
  D-G6 无 query 原文列（int8 BLOB + 特征 JSON）
- 测试 +11（量化误差/范围/fail-closed×3/透传/单例/BLOB 持久化/批量刷盘/
  回写/无原文列），全量 381->386->381? 校正：386 passed
- 待真机项：llama-server embedder 端点冒烟（需配置 embedder.base_url）
 2026-09-05 13:37:59 +08:00
tzt f783878c02 feat(sense): T-G1 Embedder（int8 量化/降级 fail-closed + /v1/embeddings 透传） 
- embedder.py：embed() 调 llama-server /v1/embeddings -> 对称 per-vector
  int8 量化（scale=127/max|v|，1024 维余弦扰动 ~1e-4 << 1e-2 验收）；
  超时/连接/非200/空形状 -> EmbedderDown（D-G4 fail-closed）；
  quantize_int8/cosine_int8 辅助（int8 直接点积，scale 正标量不改方向）
- routes.py 拆双路由组：/sense 前缀组 + /v1 无前缀组（/v1/embeddings
  OpenAI 兼容透传，embedder 不可用 503）；build_sense_routers 返回列表，
  api.py 逐个 include；build_sense_router 保留向后兼容
- 测试 +6：量化余弦误差 200 组 <1e-2/范围/零向量/int8 余弦/
  正常量化/三种 fail-closed/透传端点（503+形状+400），全量 381 passed
- 待真机项：llama-server embedder 端点冒烟（需用户配置 embedder.base_url）
 2026-09-05 13:33:58 +08:00
tzt c3efa70da2 feat(sense): T-G0 语义分析器骨架（包结构/DDL/灰度门控挂载） 
- gateway/sense/：config（SenseConfig：mode 灰度三态/特征门/conformal/consumers
  档位映射，mode 非法回落 collect）、errors（EmbedderDown/ArtifactMissing，D-G4 降级）、
  store（tier_observations + sense_artifacts DDL，WAL；观察写入/标签回填/
  labeled 查询/180d 清理/工件登记与 active 切换）、routes（/sense/health 透出灰度状态）
- settings DEFAULTS 增 sense 段（enabled 默认 False，mode 默认 collect——D-G7）
- api.py include_router 门控（装配失败不拖垮主应用）
- 测试 +5：门控 404/DDL 幂等/配置缺省与 mode 回落/独立挂载 health/
  观察写入-回填-计数-清理链路，全量 375 passed
 2026-09-05 11:07:04 +08:00
tzt 3250e4e099 feat(proxy): T-P5 规范化+桶（canonical_hash 五规则/整形顺序/doc_version 失效） 
- normalizer.py：resolve_bucket（X-Campus-Bucket 头 > 映射 > default，D-P2）；
  normalize_messages（role\u0001content\u0002 串接，剔易变字段与时间戳行，
  多模态 content 取 text）；is_cacheable（system 外 >1 条 = 多轮不缓存，D-P5）；
  canonical_hash（bucket|doc_version|sha256(norm)——模板/资料不参与哈希，
  资料更新 = 版本+1 旧键失效）；shape（[canonical_system(无才注入)] ->
  [课程资料前缀(文件读取,不入git)] -> [原 messages]，易变顶层字段剔除）
- 测试 +8：同义同哈希/易变剔除/模板不入哈希/doc_version 失效/多轮判定/
  整形顺序+资料注入/桶解析回落/序列化形态，全量 370 passed
 2026-09-05 09:40:05 +08:00
tzt 5b04276fc8 feat(proxy): T-P4 路由端到端（M1：计费代理跑通） 
- routes.py 主时序：auth(热缓存) -> 限流/并发槽 -> 413 -> 池条目解析 ->
  try_hold 预扣（字符/3 + min(max_tokens,4096) 宁可高估）-> 上游流式 tee
  -> usage 归一 -> compute -> settle(actual 回补) -> 流水；异常路径：
  UpstreamError 全额 void / UpstreamAborted 按已收 usage 结算 status=aborted
- install_error_handlers：ProxyError 家族 -> §5.3 错误码
  （401/402/403/413/429/502，401 带 WWW-Authenticate）
- 管理面：students/topup/keys 签发/keys-revoke（X-Admin-Key 或 loopback）
- SSE 同构：chunk 补齐 object/created/id/model（OpenAI SDK 兼容形状），
  usage chunk 按客户端要求过滤
- 修复：补回 T-P4 重写时丢失的 /proxy/v1/models
- 测试 +8（非流式全程含 2550/1491 黄金账目/流式/402/401/413/502 void/
  httpx 手写 OpenAI SDK 合规断言含 chunk 形状+usage 过滤+[DONE]），全量 362 passed
 2026-09-05 09:35:12 +08:00
tzt a0afeec5cb feat(proxy): T-P3 计价（峰谷窗口/毫元整数/差异化售价/黄金用例） 
- pricing.py：is_offpeak（含跨午夜窗口、非法回落、±1min 边界语义）；
  compute 全整数毫元——上游成本叠加 offpeak_factor（空闲半价），
  学生售价按差异化折扣（in 0.5 / out 0.8，不叠加热闲系数，全天一口价），
  margin = charged - cost 恒等式
- 未配置价格模型三值零（调用方可拦截）；配置换算加载期唯一
- 测试 +9（窗口边界/跨午夜/回落/黄金手算 #1#2/恒等式 10 组扫/零用量/
  稳定性/未知模型/换算不漂移），全量 354 passed
 2026-09-05 09:18:51 +08:00
tzt f24f016e95 feat(proxy): T-P2 上游客户端（流式派发/usage 注入过滤/三家归一化/首 token 前 failover） 
- upstream.py：httpx.AsyncClient 模块级单例（keepalive，limits=100，
  超时 connect10/read120/write10/pool30）；stream() 始终注入
  stream_options.include_usage（计量不依赖客户端）+ filter_usage_chunk
  （客户端未要求 usage 时剥除该 chunk）；D-P4 首 token 前 failover 链、
  流中失败抛 UpstreamAborted（不可切换）；ttfb_ms 记录
- normalize_usage 三家归一：deepseek prompt_cache_hit_tokens /
  openai prompt_tokens_details.cached_tokens / anthropic cache_read_input_tokens
  （命中数>总数时钳制）
- model_pool：+provider（枚举校验 deepseek/openai/anthropic）+in_hit_price
  （缺省 = price_in×1/30，D-P3）
- 测试 +6：透传+sink/failover/流中 aborted/全挂 502/三家归一/过滤，全量 345 passed
 2026-09-05 09:14:31 +08:00
tzt a9f3405970 feat(proxy): T-P1 鉴权+账本（原子预扣/热路径缓存/令牌桶/管理鉴权原语） 
- ledger.py：students/keys CRUD + 日限额 check_and_count（跨日重置，注入时钟）+
  流水分页；计费两阶段拆分至 billing.py（BillingMixin，评审聚焦）：
  try_hold 锁内读现状->日上限判定->余额原子防线->holding 流水（request_id 幂等）、
  settle 按真实值回补（预扣-实际）差额、void 全额退款（上游失败）
- auth.py：issue_key（sk-campus- 前缀，明文只返回一次，库存 sha256+前缀）、
  authenticate 校验链（形态/注销/停用/日额/rpm，热路径 LRU TTL30s D-P10）、
  RateLimiter（令牌桶 rpm + per-key 并发信号量，D-P9 单进程）、
  verify_admin（hmac.compare_digest；未配置仅 loopback）
- 测试 +17：签发/错key/注销/停用/403/rpm 429/日额 429/并发槽/admin 策略 +
  预扣-结算-回补一致/双向差额/余额不足/日上限/幂等/跨日重置/void/并发10路不超扣
- 全量 339 passed
 2026-09-05 09:05:59 +08:00
tzt b109576707 feat(proxy): T-P0 代理层骨架（包结构/DDL/门控挂载/单进程校验） 
- gateway/proxy/ 十文件：config（ProxyConfig：元->毫元加载期换算 D-P1、差异化售价、
  桶/峰谷/限流/semcache 配置）/ errors（8 类 HTTP 语义异常）/ ledger（四表两索引 DDL，
  WAL，ReviewQueue 连接纪律）/ auth·pricing·normalizer·semcache·upstream（§6 签名占位）
  / routes（/proxy/v1/models OpenAI 形状）/ __init__（build_proxy_router 组装点）
- settings DEFAULTS 增 proxy 段（enabled 默认 False，D-P7）
- api.py 首次 include_router（enabled 门控 + 装配失败不拖垮主应用）
- serve.py workers>1 拒绝启动（D-P9：WEB_CONCURRENCY/UVICORN_WORKERS 校验）
- 测试 +4（门控 404/DDL 幂等/毫元换算/池模型列表），全量 322 passed
 2026-09-05 08:35:31 +08:00
tzt 3cc9851623 chore: T-P-1 补充 tests/e2e playwright 工程源文件（node_modules 已 ignore） 2026-09-05 08:29:20 +08:00
tzt ce0f6170d3 chore: T-P-1 工作区收敛——并行会话成果与历史未入库文件整理入库 
- 入库历史遗漏源码/测试：router_system 9 模块（agent/executors/inference/knowledge/
  memory/planner/skills/trace）、tests 11 个测试文件、config/knowledge 领域知识
- 入库根目录方案文档（v2/v3/可行性×2）、references 文献（arxiv 14-18/cnki_open/
  参考文献清单）、research 论文素材（routerarena/paper/中文文献 PDF）
- 前端构建产物刷新（新 hash）；webapp 误写文档删除
- gitignore 增补：deepseek-harness、research/_refs、.mimosa/.zcode、网关日志/pid、
  临时调试脚本、tests/e2e/node_modules、AI代理功能开发/prefix
- 基线确认：318 passed
 2026-09-05 08:28:25 +08:00
tzt 747d85c3ba feat(v3): T29 收尾 + T31 dsh 功能对齐 
T29 流式收尾：
- _stream_partial 每次流式调用前复位（防上次成功置位导致本次失败误抛不回退）

T31 dsh（deepseek-harness）功能对齐：
- OpenAICompatChat 重试退避：传输错误/408/429/5xx 指数退避（max_retries=2），4xx 不重试
- web_fetch 工具：公网 http/https 抓取，SSRF 防护（DNS 后拒绝私网/环回/链路本地/NAT64，
  512KB/15s/12k 上限，二进制嗅探拒绝），agent.allow_net 开关（默认开）
- 原子写入：write_file/edit_file 临时文件 + os.replace（Windows EPERM 退避）
- 慢工具线程卸载：run_command/web_fetch/search_files 独立线程 + asyncio.sleep 轮询
- search_files：os.walk 修剪依赖目录（替代 rglob 全量物化），不跟随符号链接
- run_command：危险命令黑名单独立拦截 + 显式 COMSPEC/sh 解释器执行
- 重复调用提醒：同工具同参数第 3 次起回喂系统提示 + repeat_warning 事件
- 会话重命名：PATCH /agent/sessions/{sid} + 前端 ✎
- 前端：SettingsView 适配密钥打码（留空保留），SPA 重新构建
- 新增 tests/test_agent_features.py（9 项）；全量 318 测试通过
 2026-09-02 00:02:24 +08:00
tzt ce3ba44de3 fix(v3): T30 安全加固（Mimosa 深度扫描驱动） 
- 路径参数 ID 白名单（runs/agent/sessions），杀灭 Windows 反斜杠穿越（..%5C 直读 .env）
- artifacts 端点关押 + pipeline 工件名消毒（模型输出名剥路径成分）
- /llama/download dest 关押 models/ 内 + URL 协议白名单（先于 HF 别名转换）
- GET /config architect.api_key 打码（api_key_set + 前 6 位），PUT 空串=保留
- TrustedHostMiddleware 信任围栏（GATEWAY_TRUSTED_HOSTS 可覆盖）+ __main__ 默认 127.0.0.1
- review 抽样改 CSPRNG
- 新增 tests/test_security_hardening.py（13 项，全部离线）
 2026-09-02 00:01:33 +08:00
tzt ddef8bec1c feat(v3): T29 token 级流式输出（SSE 流式解析 + delta 事件 + 打字机渲染，D10） 
- OpenAICompatChat 默认 stream=True：httpx 流式解析 OpenAI chunk，
  tool_calls 碎片按 index 组装（不在正文展示），include_usage 计量；
  失败自动回退非流式一次（已有部分增量输出则如实抛出）；
  补 raise_for_status（修复流式 4xx 误入回退的缺陷）
- ToolLoop 增 on_delta（签名探测兼容 2/3 参 chat_fn）；_loads_json_object 宽松解析
- DeltaThrottle >=48 字符节流落 delta 事件；单模型与两级模式（含规划者）接线
- 前端：streamText 打字机渲染 + 光标动画；工具/阶段事件到达时清空归档
- 配套修复：AgentView 闭包持有 push 前原始对象导致响应式丢失、过程事件不渲染
- 测试 +7（SSE 解析/碎片组装/回退/部分失败抛出/on_delta/节流/service delta 事件），
  全量 296 passed
 2026-09-01 23:41:45 +08:00
tzt ca8add02e2 feat(v3): T28 操作审批流（dsh 式 allow-once/deny，fail-closed） 
- ToolLoop 增 approval_hook：工具执行前挂起等待用户裁决，拒绝/异常折叠为
  失败结果回喂模型（可改道），fail-closed
- 策略 agent.approval_policy：off | dangerous（写/编辑/命令询问，只读放行，默认）| all；
  approval_timeout_s 超时自动拒绝（轮询实现，规避 portal 循环下 wait_for 定时器不可靠）
- POST /agent/{id}/approve 裁决端点；approval_request/decided 事件对进 SSE 与审计
- 前端：运行中审批卡（工具名+参数预览+拒绝/允许一次），composer 审批策略 chip
- 测试 +8（策略矩阵/拒绝回喂/允许执行/fail-closed/超时/端点分支），全量 289 passed
 2026-09-01 23:12:26 +08:00
tzt 7d11ae2644 feat(v3): T27 会话式智能体（多轮上下文/停止/对话式 UI，对齐 dsh 范式） 
- ToolLoop 增 history 参数（既往轮次折叠为对话上下文，近 6 轮）
- 会话制：AgentSession/SessionStore 持久化 agent_runs/sessions/{sid}.json，
  /agent/sessions CRUD + /agent 带 session_id（继承会话工作区与执行者配置，busy 并发控制）
- POST /agent/{id}/cancel：取消运行中任务
- AgentView 重构为对话式：会话列表 + 居中消息流（用户蓝气泡/助手白卡）+ 底部 composer
  （工作区/执行者/命令 chips，Enter 发送，运行中红色停止钮），工具过程折叠收纳
- 工具步数统计统一至事件写入层并透出 status.tool_calls
- fix(tests): 会话存储测试隔离，防测试数据泄漏进真实 sessions 目录
- 测试 +4，全量 281 passed
 2026-09-01 22:30:26 +08:00
tzt 43e2bceae7 feat(v3): T26 两级智能体（大模型规划/审查 + 本地小模型执行，D7） 
- run_dual 编排：规划者两阶段 JSON（plan/review，失败回喂重试一次再降级），
  redo 时裁决意见回喂执行者，交接上限 agent.max_handoffs（默认 2）
- 交接文档 agent_runs/{id}/handoff.json（智能体版交流文本：instructions/acceptance/exchanges）
- /agent 新增 executor_pool_id；规划者==执行者条目拒绝；整体 token_cap 覆盖两级调用
- ToolLoop 增 emit_final 开关（内层循环不发终态，防前端 SSE 提前收口）
- 前端：执行者选择器 + phase/message 事件渲染（阶段徽标 + 双色消息卡）
- 测试 +3（done/redo/执行者故障），全量 277 passed
- fix(tests): test_config_get_put_reset 增加设置备份/恢复隔离，防止清掉用户真实配置
 2026-09-01 11:45:33 +08:00
tzt 8358302002 feat(v3): T22-T23 harness 级工具扩展 + 工作区选择后端 
- T22 工具内核：edit_file（old_string 唯一命中才替换，防误改）、search_files
  （跨文件内容搜索，跳过 .git/node_modules 与二进制大文件）、run_command
  （allow_shell 默认关；超时+输出截断+Windows CREATE_NO_WINDOW）
- T23 工作区选择（参考 deepseek-harness 打开文件夹体验）：/agent/fs 磁盘目录浏览
  （空 path 列 Windows 盘符）、/agent/workspaces 最近列表持久化、
  POST /agent 接受 workspace（须存在目录），运行状态记录所用工作区
- 新增测试 12 项，全量 274 passed
 2026-09-01 10:16:58 +08:00
tzt 374dc765c2 feat(v3): T17-T18 模型池 + 工具智能体后端 
- T17 模型池：PoolStore（local/budget/premium 条目 + architect/worker/agent 角色指派），
  /pool CRUD+连通测试+模型探测端点；build_v2_pipeline 池指派优先（测试 override 最后）；
  V2Stats 新增 by_model 按 token/成本分账
- T18 智能体：OpenAI 兼容工具调用客户端（transport 可注入）+ AgentService
  （事件落盘 agent_runs/{id}/events.jsonl）+ /agent 提交/status/events/SSE stream
  + 工作区浏览/读取端点（越界 400）；轮数与 token 双护栏，模型经池 agent 角色或经典回退
- 新增测试 16 项，全量 262 passed（httpx 假注入，不依赖真实模型/key）
 2026-09-01 08:51:52 +08:00
tzt 6247e053c1 feat(v3): T16 工具内核（WorkspaceTools 路径关押 + ToolLoop 通用循环，纯标准库） 
- list_dir/read_file/write_file 三工具，OpenAI tools 声明与 tool_calls 解析
- 路径 join 后 resolve 必须仍位于工作区根内（防 ../ 与绝对路径逃逸）
- ToolLoop：轮数上限 + token 熔断双护栏、事件回调逐条产出、触顶强制总结
- 测试 11 项：关押/往返/截断/循环编排/熔断/错误折叠（假 chat_fn，零外部依赖）
 2026-09-01 08:51:52 +08:00
tzt 3bbdcb7cc7 feat(v3): Web 应用化基线（异步任务/SSE/llama-server 管理/Vue SPA 四页 + 设置页整页滚动修复） 2026-09-01 08:31:47 +08:00
tzt 8d36eeec59 feat(v2): 模型设置（用户可调小模型/大模型/管线，/config + UI） 2026-08-30 21:58:41 +08:00
tzt 5ba3cc778b feat(v2): Web 界面（对话/协作过程/人工检验/指标）+ worker 优雅降级 2026-08-30 21:26:16 +08:00
tzt b900082c6d feat(v2): T12+T13 实验脚本 bench_tokens 与 E1 token 经济学跑数 2026-08-30 21:20:00 +08:00
tzt 70b9907a89 feat(v2): T11 打包分发 setup_runtime（下载/续传/解压/硬件档位） 2026-08-30 21:17:22 +08:00
tzt ff7e1bc8de feat(v2): T10 rollup + prefix cache 前缀稳定性（--cache-reuse 对齐） 2026-08-30 21:16:02 +08:00
tzt c874382130 feat(v2): T7 网关扩展 + T9 token 计量与账单（/chat v2,/chat/legacy,/runs,/review,/metrics） 2026-08-30 21:15:19 +08:00
tzt ea150129b4 feat(v2): T8 人工检验队列 ReviewQueue（sqlite/抽样/审核） 2026-08-30 21:12:52 +08:00
tzt ad81e1afb7 feat(v2): T6 CollaborativePipeline 编排（快路径/协作循环/熔断/终审） 2026-08-30 21:12:03 +08:00
tzt 4fbbdb5290 feat(v2): T5 WorkerLoop + 接地验证（代码沙箱/facts对照/结构检查） 2026-08-30 21:08:45 +08:00
tzt b3143e2914 feat(v2): T3 ArchitectClient（DeepSeek API，JSON 约束输出） 2026-08-30 21:06:34 +08:00
tzt 3ed37a1d30 feat(v2): T4 Workspace 交流文本协议（schema/校验/渲染/rollup） 2026-08-30 21:03:52 +08:00
tzt 78a410b773 feat(v2): T2 运维层 hw_profile + llama_server 进程管理 2026-08-30 21:00:52 +08:00