z.zhang
3543208458
- 新增 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 打包未做 |
||
|---|---|---|
| .. | ||
| algorithm | ||
| architecture | ||
| development | ||
| integrations | ||
| product | ||
| CHANGELOG.md | ||
| README.md | ||
| round-1-evidence-chain-plan.md | ||
| round-2-contract-gate-plan.md | ||
| round-3-approval-note-plan.md | ||
| round-4-confirm-batch-plan.md | ||
| round-6-audit-ledger-plan.md | ||
| round-7-doc-drift-plan.md | ||
| round-8-audit-mirror-plan.md | ||
| round-9-contract-gen-plan.md | ||
| round-10-approval-delegate-plan.md | ||
| round-11-evidence-item-plan.md | ||
| round-12-approval-transfer-plan.md | ||
| round-13-audit-export-plan.md | ||
| round-14-audit-alerts-plan.md | ||
| round-15-trace-run-plan.md | ||
| round-65-aps-end-to-end-baseline.json | ||
| round-65-aps-end-to-end-parallel-implementation-plan.md | ||
| round-65-aps-end-to-end-plan-audit.md | ||
| round-65-aps-end-to-end-runtime-baseline.json | ||
| round-65-aps-end-to-end-runtime-final.json | ||
| round-65-aps-end-to-end-state.md | ||
| round-65-aps-end-to-end-work-plan.md | ||
| round-66-solver-isolation-parallel-implementation-plan.md | ||
| round-66-solver-isolation-runtime.json | ||
| round-66-solver-isolation-state.md | ||
| round-66-solver-isolation-work-plan.md | ||
| round-67-approval-migration-parallel-implementation-plan.md | ||
| round-67-approval-migration-state.md | ||
| round-67-approval-migration-work-plan.md | ||
README.md
APS Agent 文档大管家
本文件是文档体系的唯一入口。
改代码、加功能、改功能、改门禁、改模块登记——同一轮必须在本体系留痕，否则视为交付未完成。
1. 目录地图（按角色分类）
| 目录 | 读者 | 内容 |
|---|---|---|
CHANGELOG.md |
全员 | 变更登记簿：每次代码/功能变动一条记录（大管家的账本） |
product/ |
产品经理 / 业务方 | 定位、功能清单、业务旅程、验收口径 |
architecture/ |
架构 / 后端 / 前端 | 分层、门禁、可重生模块、契约与数据流 |
algorithm/ |
算法 / OR / 数据 | 已落地求解逻辑、冲突语义、目标算法路线 |
根目录 plan.md |
全员（蓝图） | 完整架构蓝图；细节以本 docs/ 落地文档为准 |
旧扁平文件（PROGRESS.md / FEATURES.md / HARNESS.md / REGEN.md）已迁入上述分类，请勿再往根下堆新文档。
2. 写文档的硬规则（活文档铁律）
2.1 什么时候必须改文档
| 你改了什么 | 必须更新 |
|---|---|
| 任意功能增删改、修 bug、改交互 | CHANGELOG.md 追加一节 |
| 产品能力边界 / 功能状态 | product/features.md |
| 核心用户路径或业务语义 | product/journeys.md |
_POWER_MAP、API 端点权限 |
architecture/harness.md |
moduleId 增删改名 |
architecture/modules.md |
| 排产规则、冲突类型、策略模板 | algorithm/scheduling-v1.md |
| 架构分层、技术选型重大变更 | architecture/overview.md + 必要时同步 plan.md |
2.2 CHANGELOG 写法（强制模板）
## YYYY-MM-DD — 一句话标题
- **类型**：feature | fix | refactor | docs | chore
- **做了什么**：3～8 条，写结果不写流水账
- **涉及路径**：关键文件/目录
- **验证**：命令 + 结果（如 `24 passed` / 构建成功）
- **文档同步**：勾选本次已改的文档
- **遗留**：未做完的点（可空）
2.3 真相优先级（防「文档骗人」）
- 可运行代码与黄金测试 > 本文档 >
plan.md蓝图 - 文档里写「已落地」必须能在代码里指到路径；写「规划中」必须标明未实现
- 禁止把演示数据写成产品定位（本产品无行业/工厂硬编码）
3. 快速导航
产品经理
架构 / 研发
算法
本地跑起来
见仓库根 README.md。
4. 文档维护责任
| 角色 | 责任 |
|---|---|
| 每次改代码的 Agent / 开发者 | 同一轮更新 CHANGELOG + 对应分类文档 |
| 产品评审 | 以 product/ 为准验收，不以聊天记录为准 |
| 架构评审 | 以 architecture/ + plan.md 为准；冲突时先改文档再改代码或反过来同轮对齐 |
大管家索引 · 与代码同生命周期维护