aps-agent/docs/architecture
z.zhang 967ae3703a feat(fallback): FB-02 智能兜底 P2——写操作过确认卡门禁(计划锁 + checkpoint + diff 验证)
- _POWER_MAP 新增 agent.fallback.execute=P2 / execute.highrisk=P3(默认拒绝)
- 计划锁:结构化计划草稿 + 指纹冻结进确认卡;execute 逐步比对,偏离即熔断 blocked + 自动回滚
- checkpoint 成对快照强制前置;失败/熔断自动回滚并在 restore 后补写审计
- 新建 fallback_verify.py(core-fallback-verify):world diff 对账,数字只许来自冻结快照
- pi_bridge 写面:fs_write/aps_invoke 经 ActionMailbox;桥侧事件流为唯一凭证源,Pi 自述一律不作执行依据
- workflow execute_confirmed +1 分支(唯一写入口);FROZEN/ASSISTED 双模式规避 90s 同步超时
- 验证:P2 目标 44 passed;全量黄金 1090 passed / 3 failed / 14 errors(均既有问题,stash 基线逐例一致);S3 真实冒烟 16/16(真实 Kimi K2.6:陌生格式文件 → 计划 → 确认卡 → 导入 → +15 逐值对账);注入攻击 21/21(计划外工具熔断回滚/自述确认物理无效/数据藏注入拦截)
- 文档:fallback.md P2 章节、harness.md 权力矩阵、CHANGELOG
- 边界:S4/S6/S7 与 highrisk 白名单属 P3;桌面打包未做
2026-09-03 23:29:43 +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-02 智能兜底 P2——写操作过确认卡门禁(计划锁 + checkpoint + diff 验证) 2026-09-03 23:29:43 +08:00
harness.md feat(fallback): FB-02 智能兜底 P2——写操作过确认卡门禁(计划锁 + checkpoint + diff 验证) 2026-09-03 23:29:43 +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/ 为准)