aps-agent/docs/architecture
z.zhang 3543208458 feat(fallback): FB-01 智能兜底 P1(只读)——Pi Agent 兜底车道进产品路径
- 新增 server/agent_core/fallback_lane.py(core-fallback-lane):兜底编排器,run 目录/环境清洗/模型协商/三重熔断/stopReason 成败判定/propose_reply 绝不抛出
- 新增 server/integrations/pi_bridge.py(integ-pi-bridge):只读三工具 + callId 凭证 + 路径越界拦截 + 快照导出
- harness._POWER_MAP 纯追加 agent.fallback.propose=P1(计划草稿,沙盒语义不写主干)
- feature_flags 新增 _DEFAULT_OFF_KEYS:fallback 默认关(与全局 fail-open 相反),/api/features 显式 defaultOff 标注
- workflow assistant.reply/unknown 分支接线:开关关时原路径逐字节不变;90s 硬熔断;失败回退原话术
- node 解析 Windows 优先 node.exe(避开 node.CMD 垫片),APS_FALLBACK_NODE 最高优先
- 验证:全量黄金 1084 passed / 1 failed(test_preference_features 既有日期炸弹,与本轮无关);真实 Kimi K2.6 端到端冒烟 7 判据全 PASS(含越狱测试与审计链核验)
- 文档:docs/architecture/fallback.md 新建、harness.md 权力矩阵、CHANGELOG
- 边界:P1 仅只读;写操作/确认卡执行/桌面打包属 P2+;Pi runtime 打包未做
2026-09-03 13:48:03 +08:00
..
README.md feat(fallback): FB-01 智能兜底 P1(只读)——Pi Agent 兜底车道进产品路径 2026-09-03 13:48:03 +08:00
auth-tenancy.md feat: APS 智能排产智能体全量实现(M-POC~M6 + 跨阶段治理 + round-1~66) 2026-08-20 11:39:21 +08:00
database.md feat: APS 智能排产智能体全量实现(M-POC~M6 + 跨阶段治理 + round-1~66) 2026-08-20 11:39:21 +08:00
desktop.md feat: APS 智能排产智能体全量实现(M-POC~M6 + 跨阶段治理 + round-1~66) 2026-08-20 11:39:21 +08:00
dialog.md feat: 完善 APS 工作台、租户认证与桌面授权 2026-07-28 02:14:13 +08:00
fallback.md feat(fallback): FB-01 智能兜底 P1(只读)——Pi Agent 兜底车道进产品路径 2026-09-03 13:48:03 +08:00
harness.md feat(fallback): FB-01 智能兜底 P1(只读)——Pi Agent 兜底车道进产品路径 2026-09-03 13:48:03 +08:00
modules.md feat: APS 智能排产智能体全量实现(M-POC~M6 + 跨阶段治理 + round-1~66) 2026-08-20 11:39:21 +08:00
overview.md feat: APS 智能排产智能体全量实现(M-POC~M6 + 跨阶段治理 + round-1~66) 2026-08-20 11:39:21 +08:00
plan-runtime.md feat: APS 智能排产智能体全量实现(M-POC~M6 + 跨阶段治理 + round-1~66) 2026-08-20 11:39:21 +08:00
platform-matrix.md feat: APS 智能排产智能体全量实现(M-POC~M6 + 跨阶段治理 + round-1~66) 2026-08-20 11:39:21 +08:00
rag.md feat: 完善 APS 工作台、租户认证与桌面授权 2026-07-28 02:14:13 +08:00
skills.md feat: 完善 APS 工作台、租户认证与桌面授权 2026-07-28 02:14:13 +08:00

README.md

架构文档(architecture/)

面向架构与研发。

文档 用途
overview.md 分层、数据流、仓库地图
harness.md 门禁权力矩阵(与代码一一对应)
modules.md 可重生 moduleId 登记
rag.md RAG:导入 / 嵌入 / 混合检索 / 生成式问答 / Skill 消费 / 工艺模板库
skills.md 外部算法排产 Skill 与中性 DTO / Skill 管理台
desktop.md 桌面/Web 双形态、~/.aps 目录、开发与打包命令
database.md SQLite 主数据库:schema / world 投影 / 数据包 / 导入 profile
dialog.md 多轮澄清槽位机 + 引导式排产向导
fallback.md 智能兜底(Pi Agent):意图未识别的只读分析兜底、围墙、开关、审计
auth-tenancy.md 登录闸门、租户隔离、项目成员权限与用户系统适配

蓝图全文:../../plan.md(目标态多,落地以本目录 + algorithm/ 为准)