z.zhang
fee1a4c13d
- 智能体核心：Harness 门禁/_POWER_MAP、P2/P3 确认卡、证据链、Plan 运行时 L0-L3、统一工具运行时、自动化 G0-G4 - 领域层：Rule/CP-SAT/GA/NSGA-II/LNS 引擎、13 类约束目录、IIS 冲突归因、敏感性/蒙特卡洛、插单重排、MRP 分解 - 状态层：世界/对话成对快照、分支树、检查点、Saga 补偿、审批文件/DB 双后端 - 集成层：MCP 插件总线、MES/WMS 适配器（stub+HTTP）、异步任务 - 前端：左说右动工作台（聊天+甘特/负荷/交期）、主数据、订单、治理台、分支树、时间线、审计统计 - 桌面端：Electron 壳 + Python Sidecar + NSIS 打包 + 许可证 - 文档：plan.md 蓝图、完成矩阵（50 Done/10 Partial/0 Missing）、CHANGELOG 全量账本、各轮次计划/状态 - 验证基线：黄金测试 1000+ 项、Node 60 项、Web build 通过（详见 docs/CHANGELOG.md） |
||
|---|---|---|
| .. | ||
| 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 为准；冲突时先改文档再改代码或反过来同轮对齐 |
大管家索引 · 与代码同生命周期维护