2026-09-03 23:29:43 +08:00
## 2026-09-03 — FB-02 智能兜底 P2（ ）
- **类型**：
- **做了什么**：
- Harness： （ （ ， ，
- `server/agent_core/fallback_lane.py` （ （ ） `plan_fingerprint` （ ， ） `validate_plan` 出卡前五段校验（ ） ； （ ，
- `server/integrations/pi_bridge.py` （ ） ： `fs_write` （限 work/outbox） `aps_invoke` （ ， ） ； `render_plan_task_brief` （
- `server/agent_core/fallback_verify.py` （ ， ） ： （ ） ）
- `workflow.py` `execute_confirmed` +1 分支（~50 行，证据校验后、既有全部 action 分支逐字节不变）：调 `execute_plan` → 分支写 `WORLD_WRITE agent.fallback.execute` 审计（成败都写；失败总账在 restore 之后补写）→ store.save() → 返回显式文案；分支体全异常归并显式失败（绝不抛出）。
- 确认卡零前端改动：复用 `confirm-card` 块 + `/api/actions/confirm` 唯一执行通道； （
- 新增环境变量：`APS_FALLBACK_EXEC_TIMEOUT_SEC`（ ） `APS_FALLBACK_EXEC_MAX_STEPS` （ ） `APS_FALLBACK_MAX_PLAN_STEPS` （ ）
- **验证**： ） `test_fallback_lane.py` （ ： `test_feature_flags.py` 共 **41 passed** ； （ ； **24 passed** ；全量黄金两批 **1090 passed / 3 failed / 14 errors** （ ， ） ； `All checks passed!` （
- **影响分析**：按 P2-DESIGN §9（ ） ； （ ， ） ； ；
- **文档同步**：
- **边界**： （ ） ； ； （ ） ； （ ）
- **发布动作**：无 commit/push/merge/publish。
---
2026-09-03 13:48:03 +08:00
## 2026-09-02 — FB-01 智能兜底 P1（ ）
- **类型**：
- **做了什么**：意图未识别（`assistant.reply`/`unknown` 分支）时不再只回固定话术，而是拉起 Pi headless 做**一次只读分析兜底**（方案 S1/S5 进产品路径，草稿语义，不写主干世界）。
- `server/agent_core/fallback_lane.py` （ ， ） ： （ ） （ ） `PI_CODING_AGENT_DIR` 配置圈禁 + taskkill 进程树回收、模型端点协商（ ， ） （
- `server/integrations/pi_bridge.py` （ ， ） ： （ ） （ ） ； （ ， ） ； （ ） ； （
- Harness： `agent.fallback.propose = P1` （ ， ，
- FF-01 开关：`FEATURE_CATALOG` 追加 `fallback` ；新增 `_DEFAULT_OFF_KEYS={"fallback"}` ——文件缺失/损坏/未配置/非 bool 时 fallback 默认 **False** （会拉起外部 LLM 子进程产生 token 成本，与其余键 fail-open 相反，有意取舍）；`/api/features` 响应追加 `defaultOff` 字段显式标注。
- 接线：`workflow.py` `assistant.reply/unknown` 分支 +8 行——开关开且意图未识别 → `propose_reply` ；返回 None（ ） ；
- **设计张力处置（简报层）**： ： ， ； ，
- **验证**： `test_feature_flags.py` **19 passed** （ ） ； （ （ ） **1084 passed / 1 failed** （ ， `git diff` 均为零， ， ） ； （ `All checks passed!` ，修改文件零新增告警）。**冒烟复证（ ， ） ， `node.exe` + 新增 `test_write_guard_extension_real_template_format` 防回归）后原样代码复跑 `poc/pi-fallback/smoke/smoke_e2e.py` 七条判据全 PASS（ ， ， ， ， ， `poc/pi-fallback/P1-SMOKE.md` §7，
- **影响分析**： ； `/api/features` （响应纯增量），三条 all-enabled 既有断言同轮修复 MED； （ ：
- **文档同步**： `/api/features` 条目 + 变更记录、新建 docs/architecture/fallback.md（
- **边界**： ， ） ； （ ）
- **发布动作**：无 commit/push/merge/publish。
---
2026-09-02 02:46:18 +08:00
## 2026-08-26 — FF-01 功能开关（ ）
- **类型**：
- **做了什么**：用一个 JSON 配置文件控制哪些功能上线可见、哪些隐藏不用。
- 后端 `server/agent_core/feature_flags.py` （ ） ： （ ， ） ； `server/data/features.json` 、`APS_FEATURES_PATH` 可覆盖；格式 `{"version": 1, "features": {"drawing": false, ...}}` 。
- 语义：可用性/可见性开关，**不是权限边界**（ `source/error` ，未知键列入 `unknown` ，非 bool 值该键回退默认开启并记录错误，绝不因配置问题锁死界面。
- 网关：`GET /api/features`（
- 前端 `apps/web/src/features/flags.ts` + 接线：右侧导轨 7 个工具按钮、左侧栏 6 个快捷入口（ ） （ ， ）
- **验证**： **6 passed** （默认全开/配置生效/损坏 fail-open+error/非 bool 回退/env 覆盖/端点契约） ； （ ） **1071 passed / 1 failed** （ （ ） ； （
- **影响分析**： ， ； （
- **文档同步**：
- **边界**：开关只隐藏入口，不拦截后端业务端点（如需端点级下线需另行设计，且不得替代 Harness 门禁）；桌面端与 Web 端共用同一配置；`server/data/features.json` 为现场数据不入库。
- **发布动作**：无 commit/push/merge/publish。
---
2026-08-20 10:09:04 +08:00
## 2026-08-20 — Round 67 审批迁移 Fail-Closed 与 Grant Digest 归一化（ ）
- **类型**：
- **做了什么**（
- **Grant digest 归一化（ `token_digest(raw_token)` ，不再把文件后端 raw token 主键直接写入 DB `token_hash` ；迁移后 active P3 grant 经 `DatabaseApprovalStore.consume_grant` 可消费一次、重放失败（修复前迁移产物完全不可消费）。
- **损坏 fail-closed（ ： ） `MigrationError` ，不再静默当空源报告成功。
- **单事务原子性**：全部 request/grant/事件写入在同一个 SQLAlchemy Session 内 flush/commit； （ ）
- **幂等语义重建**： （ ） ； （ ）
- **legacy 修复**： （ ；
- **终态 request 重建**： （
- **history canonical digest 去重**：完整事件 canonical JSON SHA-256 替代旧六字段去重；同秒同状态但 approver/note/payload 不同的事件全部保留，完全重复事件幂等去重。
- **停写门禁**：迁移要求 `APS_APPROVAL_MIGRATION_QUIESCED=1` ，持有与文件后端相同的 `{source}.lock` 进程锁直到提交； ，
- **影响分析**： `migrate_file_to_db` MEDIUM） ，
- **验证**： `test_approval_migration.py` **19 passed** （新增 14 项： ） ； （ ） **1065 passed / 1 failed** （ ， ） ；
- **数据保护**：全程使用临时审批文件与临时 SQLite； `.env` Git 状态干净，现场 `approvals.json` /`master.db` 未触碰。
- **文档同步**：本节、`docs/product/plan-completion-matrix.md`（矩阵 117 行证据与 §11 优先级）、`docs/round-67-approval-migration-state.md`。
- **遗留/边界**： （ ） ； ，
- **发布动作**：本地 commit（ ） ；
---
## 2026-08-06 — DXF-01 工程图纸自动识别（
- **类型**：
- **做了什么**：
- 新增 `server/aps_domain/dxf_drawing.py` （ ） ： （ ； （
- 主数据候选安全边界：物料编码/名称来自标题栏（类型/单位为推断值封顶 0.6） ； （ ； ，
- SVG 预览： ） ， （
- 多模态接线：`DxfDrawingExtractor`（ ） ；
- 网关：`POST /api/dxf/parse`（上传）· `/parse-path` （本地路径）· `GET /api/dxf/{drawingId}/svg` · `GET /api/dxf/discover` （工程目录发现）· `POST /api/dxf/stage` （候选 → master.material/bom/routing.upsert 的 P2 确认卡，唯一执行路径仍是 /api/actions/confirm） ： （ ） （ ，
- 依赖： （
- **样例验证**： （ ， （ （ ； ； （
- **前端**： （ ， ） `?layers=` 服务端过滤渲染）、标题栏字段表（置信度徽标+来源）、物料候选可编辑表单 → `postDxfStage` P2 卡 → `postConfirm` 批准/驳回、BOM 位置号 missing 标注、工艺路线待确认提示； `drawing` + 右侧导轨按钮 + Ctrl+K 命令面板条目。
- **验证**： （ `?layers=` 端点）；受影响回归 test_multimodal + test_multimodal_image + test_master_data 合计 50 passed（ ） ； （ ， ， ） ； （ ） ； （
- **文档同步**：
- **影响分析**： ， ； （ ） ； ，
- **遗留/边界**： （ ）
- **发布动作**：无 commit/push/merge/publish。
---
## 2026-08-03 — Round 66 Windows 求解器进程隔离与 Fail-Closed
- **类型**：
- **做了什么**：
- CP/HYBRID native 优化迁入独立 child， `aps.solver-process.v1` ；
- fatal/timeout/非法响应均 `UNAVAILABLE` 、0 PO/WO、不可发布； ，
- runtime probe 增加来源、版本、user-site、fatal+exit0 与内部 timeout 门禁；默认 PATH Anaconda 稳定拒绝，`.venv`/`.sidecar-venv` 各连续 5 次通过。
- 源码 Sidecar `--solver-child -I` 真实冒烟首次发现隔离 Python 移除源码 import root； ， `test_source_solver_child_entry_runs_under_isolated_python` 。修复后 CP `OPTIMAL` 、1 PO/10 WO/10 slots、协议 v1、`runtimeSafe=true`。
- **真实运行**：复制 `world.json` 的 CP/HYBRID 均 `OPTIMAL` 、1 PO/10 WO/10 operationSlots； `OPTIMAL` ，但受现有主数据阻断为 0 PO/WO、1 slot/1 conflict， ；
- **验证**： ； （ ） ； ；
- **复审补强**：大请求改用自动清理临时文件作为 child stdin，
- **首轮审计修复**： `OPTIMAL + 空 entries` 假绿；现强制重算 `responseDigest` ，校验条目完整排列/业务字段、pipeline/status 和可行槽位覆盖，新增 16 个负向用例。
- **服务/UI**： ；
- **数据保护**： `C6E7FF090719DB505AF5C3B0D8ADD376CBA7843D6E6982A68C1BA02C342052FA` 、MOM SHA-256 `6B64ADF6F29A43A518D89718610EE71FAD60E86D3F38CD5CFF26F1740CC53F7D` 前后不变；`server/data/**`、`.env` 无 Git 状态。`master.db` 可能更新 license `last_seen` 等运行元数据，不用文件 hash 冒充业务不变。
- **遗留/边界**：现有冻结 EXE 仅旧 `--probe-child` 通过，未重建，不能宣称新 `--solver-child` 已打包；仍需构建后冒烟、干净 Windows、签名/Defender/真实 CI。下一 P0 为全量 P2/P3 evidence 封套与审批迁移可靠性。
- **最终独立复审**： ；
- **文档同步**：
- **发布动作**：无 commit/push/merge/publish。
---
## 2026-08-03 — Round 65 端到端闭环 APS 排产内核
- **类型**：
- **做了什么**：统一商务订单/BOM/库存/供应/工艺/设备/班组/模具/层级负荷准入与 V2 校验；
- **证据门禁**：
- **前端/E2E**： ；
- **验证**： ； ； ；
- **现场保护**：旧版订单 GET 曾在 2026-08-03 10:10:24 写现场 world； `6b64adf6...53f7d` 在隔离验收前后保持一致，未擅自回退。
- **文档同步**：
- **遗留**： `AUDIT: PASS` ；未提交、未合并、未发布。
2026-07-21 11:05:57 +08:00
> **大管家的账本。** 每次改代码、加功能、改功能、修缺陷，同一轮必须追加一节。
> 写法见 [docs/README.md §2.2](./README.md)。旧名：`PROGRESS.md`（已迁入本文件）。
---
2026-08-20 10:09:04 +08:00
## 2026-08-02 — 锐扬 Excel 结构化诊断与真实行号收口（ ）
- **类型**：
- **解析纠偏**：设备编码别名采用“最后一个非空值优先”，后续空列不再覆盖已有编码；补 `固定资产编号` 别名。47 行原解析噪声恢复为有效设备行。
- **结构分类**： `ignorable_section` ；非排产整块归为 `NON_SCHEDULING_BLOCK/ignored` 。
- **诊断契约**： `diagnostics` 、`diagnosticCounts`、`diagnosticsVersion=1`，每条含 sheet、真实 Excel 行号、parserIndex、kind、code、severity、classification、message、rawSummary；
- **现场结果**：锐扬目录（主表 + `订单-样例.csv` ）为 **有效 1404 / blocking 1 / skippedRows 974** ； `07-设备模型` Excel 第 130 行“3.8吨锂电叉车”，三个业务编码均空；出厂编号不冒充设备编码。
- **用户可读输出**：文件问题列直接显示真实 Excel 行号；
- **回归**：结构化 XLSX 缩比测试、folder 聚合契约、日期稳定性与既有导入/指导测试通过；全量黄金基线随 round-64 一并验证为 910 passed。
## 2026-08-02 — MRP 多层 BOM 自制/采购纠偏 + 分阶段界面（ ）
- **类型**： （ ）
- **根因**：旧逻辑把“有默认工艺路线”错误等同于“自制”，并要求 `MAKE && hasRouting` 才继续展开；锐扬 MOM 导入又只为前 80 个自制候选生成模板路线，导致缺路线半成品被改写为采购并停止下钻。前端同时隐藏 `make` 、把 DRAFT 建议标成“采购订单”，分解后还自动跳采购页。
- **后端修复**：显式 `procurementType` 优先； ， `missingRouting` 阻断提示并继续多层展开；同订单同物料聚合后只扣一次库存/在途；持久化独立 `makeSuggestions` ，不写入/伪造 `productionOrders` ；路线进一步区分 READY / TEMPLATE / MISSING。
- **前端修复**：新增“自制建议”页签，分解后默认打开；“生产订单”改为“已排生产”，“采购订单/委外订单”改为“采购建议/委外建议”；模板工艺、缺工艺分别标识，明确建议与真实生产订单的阶段边界。
- **真实验证**： **106 项唯一自制建议 / 124 条采购建议 / 0 委外** ；其中 **67 项仅模板工艺待确认、39 项缺工艺路线** ； `RAW_MATERIAL` ，采购中半成品为 0； `C0030800-04179` 。
- **回归**： **10 passed** ； `npm run build` 通过； ；
- **边界**：当前 67 条路线来自导入模板， ， ；
## 2026-08-01 — trace_chain 接入 schedule.run
## 2026-08-01 — trace_chain 跨引擎可复算（
## 2026-08-01 — EXTERNAL 引擎接入 trace_chain + 前端追溯 UI（ ）
## 2026-08-01 — 对话状态与世界状态成对快照（ ）
## 2026-08-01 — 审计完整性告警通知渠道（ ）
## 2026-08-01 — 审计完整 Merkle 树（ ）
## 2026-08-01 — 审计 append-only 守护：跨进程锁 + 清理策略（ ）
## 2026-08-01 — 偏好学习升级：项目隔离/解释/重置/冷启动（ ）
## 2026-08-01 — Explore 与 Runtime 数据边界（ ）
## 2026-08-01 — L0-L3 Plan 重放能力（ ）
## 2026-08-01 — 统一工具运行时（ ， ）
## 2026-08-01 — 分支树：项目->会话->分支三级树（ ）
## 2026-08-01 — 分支切换自动恢复锚定检查点（ ）
## 2026-08-01 — 偏好解释 UI + stub 可复算修复（ ）
## 2026-08-01 — 主数据工艺树升级为树形表格 + 物料分类/来源修复（ ，
## 2026-08-01 — L0-L3 Plan 批准/驳回审计（ ）
## 2026-08-01 — Agent 自动编排： （ ）
## 2026-08-01 — 偏好时间衰减加权模型（ ）
## 2026-08-01 — Explore 通道扩展：敏感性/鲁棒性接入统一边界（ ）
## 2026-08-01 — 多智能体并行交付：会话引用/四层上下文/自动化G0-G4/分支树UI/时间线微观层（ ，
## 2026-08-02 — 多智能体并行交付·第二批： （ ，
- **类型**： （ ， ）
- **做了什么**（三个智能体并行，写范围互不重叠）：
- **方向 D（ ） ： （ ） （ ） （ ） （ ） ；
- **方向 E（ ） ： （
- **方向 F（ ） ： （ ；
- **为什么**：按 plan.md 蓝图继续拆分边界并行推进矩阵 Missing/Partial 项。
- **验证**：三方向黄金测试 32 项（ ） ； `npm run build` 通过；
- **边界**：
---
## 2026-08-02 — 多智能体并行交付·第三批： （ ，
- **类型**： （ ， ）
- **做了什么**（三个智能体并行，写范围互不重叠）：
- **方向 G（ ） ： ， `windowOuterMovedCount=0` ），扰动度量 movedOrderCount/shiftedHours/tardinessDelta/disturbanceRatio； `impact.lns` （ （ （ ） （ ） ；
- **方向 H（ ） ： （ ） （ `hard_blocking_conflicts` /`get_constraint_profile`，未改既有接口；`test_attribution.py` 7 项。
- **方向 I（ ） ） ； × ： ，
- **为什么**：按 plan.md 蓝图继续把 Missing/Partial 矩阵项分发给并行智能体，保持写范围互不重叠、智能体可互相沟通。
- **验证**：新增黄金测试 16 项（ ） `618 passed` （隔离 `APS_KNOWLEDGE_PATH` 规避知识库环境污染）；后端 8003 以新代码重启健康、前端 5173 构建通过。
- **边界**：真实 LP/CP 对偶影子价需线性化模型重解； ； `GET /api/checkpoints/{pairId}` （前端已降级展示）；分支合并世界 diff、@知识 引用、滚动摘要 LLM 压缩、策略特征规则归纳留待后续轮。
- **类型**： （ ， ）
- **做了什么**（三个智能体并行，写范围互不重叠）：
- **方向 A（ ） ： （
- **方向 B（ ） ： （
- **方向 C（ ） `BranchPanel.tsx` 分支树 UI（ `TimelineRail.tsx` 时间线微观层（ ）
- **为什么**：按 plan.md 蓝图拆分边界分发多智能体并行推进矩阵 Missing/Partial 项。
- **验证**：三方向黄金测试 20 项（ ） ； `npm run build` 通过；浏览器实测分支树 fork/merge/discard 与微观层正常。
- **边界**：接线（上下文到对话链路、自动化到网关定时/真实动作、引用自动触发）、`@知识` 引用、调度器持久化、两世界 diff 留待后续轮。
---
## 2026-08-02 — 多智能体并行交付·第四批：检查点投影/`@知识`引用/滚动摘要LLM/偏好特征规则（ ， ）
- **类型**： （ ， ）
- **做了什么**（三个并行智能体写范围互不重叠 + 主控实现矩阵 66） ：
- **方向 J（ ） ： （ `GET /api/checkpoints/{pairId}` （缺失 404 中文）与 `GET /api/checkpoints?pairIds=&branchIds=&sessionId=` （分支锚定批量投影）；前端 `fetchCheckpointWorld` + `WorldDiffView` 检查点 B 侧优先投影逐字段全量 diff，
- **方向 K（ ） ： `@知识` 引用（强制命中：命中→正文+出处+证据 ref， ） ； `knowledge_lookup` （既有 4 类零破坏） ； `handle_intent` 入口自动解析注入（`_refs` + SESSION 审计 evidenceRefs， ） ；
- **方向 L（ ） ： ， （ ） ； （ ， `test_context_policy.py` +3 项。
- **L66（ ） ： `induced_rules` （ ； `record()` 调用点接线 features；
- **为什么**：按 plan.md 蓝图继续把矩阵剩余 Partial 项收口，保持多智能体并行、写范围互不重叠。
- **验证**： `656 passed` （隔离 `APS_KNOWLEDGE_PATH` 规避知识库环境污染）；前端 `npm run build` 无类型错误；后端 8003 新代码重启健康。
- **边界**： ， ） ；
- **类型**：
- **做了什么**： `run_monte_carlo` 改为经 `explore_boundary.run_explore` 统一通道执行（ ， ） ； （ ）
- **为什么**：矩阵 55 行「Explore 与 Runtime 数据边界」剩余项「敏感性/鲁棒性等其他 Explore 工具逐一接入统一通道」。
- **验证**： （ ） ； ： ；
- **边界**：前端 Explore 与 Runtime 视觉分区留待后续轮。
---
## 2026-08-02 — 多智能体并行交付·第五批： （ ， ）
- **类型**： （ ， ）
- **做了什么**（三个并行智能体写范围互不重叠 + 主控实现矩阵 88） ：
- **方向 M（ ） ： ， ） ； （ ， `test_plan_branch_restore.py` 5 项。
- **方向 N（ ） ： （ ） ； （ ） ； ： （ ） ） （ ） （ ） （ `GET /api/wms/replay` + `GET /api/wms/inventory` ； `test_wms_replay.py` 3 项。
- **方向 O（ ） ： ； ， ； ） ； （
- **L88（ ） ： （ ） （ ， （ ）
- **为什么**：按 plan.md 蓝图继续把矩阵 Missing/Partial 项收口， （
- **验证**： `683 passed` （隔离 `APS_KNOWLEDGE_PATH` 规避知识库环境污染）；前端 `npm run build` 无类型错误；后端 8003 新代码重启健康（/api/wms/* 已注册）。
- **边界**： ） （ ） ； （ ） ； （ ） ；
- **类型**：
- **做了什么**： （ ） × （
- **为什么**：矩阵 66 行「偏好学习影响默认策略」剩余项「偏好模型升级为权重回归/规则归纳」的权重回归部分。
- **验证**： （
- **边界**：策略特征规则归纳（多特征回归：订单结构/客户等级/约束 → 策略）留待后续轮。
---
## 2026-08-02 — 多智能体并行交付·第六批： （ ， ）
- **类型**： （ ， ）
- **做了什么**（三个并行智能体写范围互不重叠 + 主控实现矩阵 86） ：
- **方向 P（ ） ： （ ） （ ） （ ； （ ） `mes.cancel_dispatch` /`cancel_work_order` 幂等补偿；`/api/saga/*` 列表/详情/retry/compensate/takeover； `test_saga_wms_closure.py` 6 项。
- **方向 Q（ ） ： （ ， ） `constraint_catalog()` ； （ ） （ （ `test_engine_constraint_semantics.py` 19 项。
- **方向 R（ ） ： （ ） （ `/api/gov/audit` traceAlerts + `GET /api/gov/trace/verify` + GovConsole ⚠断链徽标/顶部提示条；**EXTERNAL 真实 HTTP skill 端到端验收**（ `test_trace_external_http.py` 。
- **L86（ ） ： （ ） （ ） ； （
- **为什么**：按 plan.md 蓝图继续把矩阵 Missing/Partial 项收口， ）
- **验证**： `755 passed` （隔离 `APS_KNOWLEDGE_PATH` 规避知识库环境污染； `npm run build` 无类型错误；后端 8003 新代码重启健康（/api/saga/*、/api/gov/trace/verify 已注册）。
- **边界**： （
- **类型**：
- **做了什么**：新增 `server/agent_core/plan_orchestration.py` ： ， ， （ ， ） ； `_load` 的 regenCount 校验（状态流转版本 regenCount 不变，原校验要求连续递增会误判 corrupt）
- **为什么**：矩阵 110 行「L0-L3 Plan」剩余项「接入 Agent 自动编排（
- **验证**： ） ； ： （ ） ；
- **边界**：
---
## 2026-08-02 — 多智能体并行交付·第七批：自动化网关驱动/NSGA-II多目标/可重生流水线/桌面壳决策（ ， ）
- **类型**： （ ， ）
- **做了什么**（三个并行智能体写范围互不重叠 + 主控决策收口）：
- **方向 S（ ） ： （ （ ， ） ； `test_automation_gears.py` +2。
- **方向 T（ ） ： （ ） （ ） （ ） （ ） （ ） ； `test_registry.py` 6 项。
- **方向 U（ ） ： （ ） `solve_nsga2` 、`nsga2_solutions_to_cards` 衔接 rank_scenarios、大算例基线（ < 15s 不劣于单目标 GA ） ； 时间预算确定性修复 （ 小预算跑满固定代数与 GA 口径一致 ） ； algolib nsga2 条目翻转为可用 ； test_nsga2_engine . py ` 11 项 。
- **L98（ ） （ ） ， （
- **L110（ ） ： ）
- **为什么**：按 plan.md 蓝图继续把矩阵剩余项收口， ， ）
- **验证**： `791 passed` （隔离 `APS_KNOWLEDGE_PATH` 规避知识库环境污染；
- **边界**：自动化规则 CRUD UI、NSGA-II 冲突目标物化层对齐、rebuild 激活版本物理替换、真实 MES/WMS 适配器、信创/CI-CD/WORM 等外部环境依赖项留待后续。
- **类型**：
- **做了什么**： ： （ ） ， （ ） ， `status:<新状态>` 、note 写入 payload._note（ ） ； `PlanTransitionError` ； `/reject` 端点。
- **为什么**：矩阵 110 行「L0-L3 Plan」剩余项「批准/驳回审计」。
- **验证**： ） ；
- **边界**： （
---
## 2026-08-02 — 多智能体并行交付·第八批： （ ， ）
- **类型**： （ ， ）
- **做了什么**（三个并行智能体写范围互不重叠 + 主控实现矩阵 112） ：
- **方向 V（ ） ： （ ： ， ， ， ） ； （ （ < 30s ） ； test_cp_cumulative . py ` 8 项 。
- **方向 W（ ） ： （ ） （ ， ； ） ； `test_param_opt.py` +5。
- **方向 X（ ） （ @playwright/test ， ， ） ； （ （ ） ；
- **L112（ ） ： ）
- **为什么**：按 plan.md 蓝图继续把矩阵剩余项收口； （
- **验证**： `818 passed` （隔离 `APS_KNOWLEDGE_PATH` ）；前端 `npm run test:e2e` 3 passed + `npm run build` 通过； ；
- **边界**：签名/SBOM 上链/Defender 入 CI 与干净离线机安装冒烟（需外部证书/验证机） ； （ ） ； （ ） ；
- **类型**：
- **做了什么**：主数据「工艺路线」由 antd Tree 改为 **树形表格** （列：名称/编码/类型/来源/用量/图号，行展开折叠）；后端 `build_process_tree` 修复三缺陷——BOM 去重（ ） （ ） ； `typeLabel` /`sourcingLabel`（自制/委外/采购）/`operationName` 等字段（契约只增不删）。
- **为什么**：现场计划员反馈——要树形表格而非纯树；物料必须分原材料/半成品/成品；来源必须分生产(自制)/委外/采购，否则无法排产判断。
- **验证**： （ ； ；
- **边界**：无工艺路线的推导半成品来源按既有规则显示采购（若现场确认为厂内自制需在 infer_material_sourcing 增加按 typeLabel 覆盖）；默认展开策略可按现场反馈收紧。
---
## 2026-08-02 — 多智能体并行交付·第九批：多模态低置信确认/WORM归档模拟/前端StrictMode修复/roadmap对齐（ ，
- **类型**： （ ， ）
- **做了什么**（三个并行智能体写范围互不重叠 + 主控 roadmap 对齐）：
- **方向 Y（ ） ： （ ， **低置信确认门禁** （不完整显式拒绝、高置信直通、低置信 P2 确认卡，确认前绝不写世界状态）+ 审计（ ） ； ；
- **方向 Z（ ） ： ： ， `verify_archive()` （篡改/缺失/merkle 复算不一致检出 + summary） ； `POST /api/gov/archive/run` ；
- **方向 AA（ ） ： `alive` ref 永久置 false（ ） `captureSessionResult` 在 setWorld 更新器内（ ） ； ： ；
- **主控·文档收口**： （ （
- **为什么**：按 plan.md 蓝图继续推进矩阵剩余项；修复 E2E 发现的真实前端缺陷（
- **验证**： `846 passed` （隔离 `APS_KNOWLEDGE_PATH` ）；前端 `npm run build` 通过 + E2E preview/dev 双路径 3 passed；
- **边界**：真实 ASR/VLM 模型服务、物理 WORM 介质、加密/密钥管理、MySQL 实机、签名/Defender/离线机安装与真实 GitHub CI 跑通（均需外部环境）；低置信卡复用 import.commit 动作名（专用 multimodal.apply P2 卡需登记 _POWER_MAP 并同步 harness.md， ）
- **类型**：
- **做了什么**：设置中心「个人偏好」页新增偏好学习卡片：当前默认策略、置信度（高/中/冷启动）、原因文案、得分明细、重置按钮；后端新增 `GET /api/settings/preferences` （ ， ） `POST /api/settings/preferences/reset` ；修复 `algo_skill_stub._stub_input_fingerprint` 误纳含时间戳的 problemId 导致同输入两次运行 runId 不同、EXTERNAL trace 链不可复算（矩阵 114 行可复算性回归缺陷）。
- **为什么**：矩阵 66 行剩余项「UI 展示偏好解释」；全量回归偶发 `test_trace_external::test_external_flex_trace_recomputable_same_input` 失败，定位为 problemId 时间戳污染 runId。
- **验证**： ； ； ：
- **边界**：偏好模型升级为权重回归/规则归纳留待后续轮。
---
## 2026-08-02 — 多智能体并行交付·第十批：审计归档加密/Defender冒烟+离线包校验/桌面升级回滚/测试门禁修复（ ，
- **类型**： （ ， ）
- **做了什么**（三个并行智能体写范围互不重叠 + 主控测试门禁修复）：
- **方向 BB（ ） ： （ ， ） ， （ ）
- **方向 CC（ ） ： （ ， `scripts/offline-install-check.mjs` （ `docs/development/packaging-smoke.md` 。
- **方向 DD（ ） ： `build-upgrade-manifest.mjs` （清单生成/校验）+ `apps/desktop/updater.cjs` （校验→备份 copy/listing→NSIS 静默安装→健康检查→失败自动回滚+本地审计 JSONL， ） （ ） ； `updater-smoke.mjs` 4 项。
- **主控·测试门禁修复**： （ （
- **为什么**：按 plan.md 蓝图继续推进矩阵剩余项；根治每个全量轮次唯一的既有失败（知识库漂移）。
- **验证**： （ `858 passed` （隔离 `APS_KNOWLEDGE_PATH` ， ） ； ；
- **边界**：签名 Authenticode/SBOM 上链/provenance、WORM 物理介质、HSM/KMS 密钥管理、Defender for Endpoint CI 门禁与实时防护演练、干净离线机实机安装、真实 GitHub CI 跑通、NSIS 真装冒烟（均需外部环境/证书/验证机）。
- **类型**：
- **做了什么**： ： （ ） ， （ ） ；
- **为什么**：矩阵 52 行剩余项「分支切换时自动恢复锚定 checkpoint（ ） ；
- **验证**： （ ） ； ：
- **边界**： （
---
## 2026-08-02 — 多智能体并行交付·第十一批： （ ，
- **类型**： （ ， ）
- **做了什么**（三个并行智能体写范围互不重叠 + 主控收口）：
- **方向 EE（ ） ： `node-tests` job（ ） ； `cryptography>=42` ；根 `package.json` 新增 `test:node` （本地 npm run test:node 34/34）
- **方向 FF（ ） ： `version` （ ， （ ） `resolveAuditOptions` → updater Bearer+nonce 客户端链路闭环；
- **方向 GG（ ） ： ， ： `tests/node/nsis-smoke.test.mjs` 13 项 + `docs/development/nsis-smoke.md` 。
- **主控·收口**： （ ） ； ；
- **为什么**：按 plan.md 蓝图收口矩阵剩余本地可做项，把桌面升级/审计/打包链路与 CI 门禁衔接闭环。
- **验证**：全量回归 `861 passed` （隔离 APS_KNOWLEDGE_PATH） ； `npm run test:node` 34/34 + nsis-smoke 13/13 + updater 27 + sidecar 冒烟 5/5； ； ； （
- **边界**： （
## 2026-08-01 — 主数据工艺路线树产品升级（ ，
- **类型**：
- **做了什么**：主数据「工艺路线」页签树重做：根=选中工艺路线的成品（金色「成品」徽标+自制+用量× `build_process_tree` 只增不减补充展示辅助字段（ ） ； `processTreeNodeTitle` /`processTreeToNodes` 与 `.pt-badge--*` /`.pt-src--*` 样式。
- **为什么**：现场计划员需要一眼看清「成品 → 半成品 → 每层各自生成哪些工序」，此前树全部平铺无层级语义。
- **验证**： ； ；
- **边界**：空态 Alert 未在真实数据触发验证；更深层 BOM 子件默认折叠，可在产品迭代中调整默认展开深度。
---
## 2026-08-02 — 多智能体并行交付·第十二批：审计上报端点/HTTP MES适配器/图片元数据提取/信创依赖矩阵（ ， ）
- **类型**： （ ， ）
- **做了什么**（三个并行智能体写范围互不重叠 + 主控实现矩阵 102） ：
- **方向 HH（ ） ： （ （ ） ，
- **方向 II（ ） ： （ ） （ ） ； （ ） ； （ ， ） ； `test_mcp_bus.py` +1。
- **方向 JJ（ ） ：
- **L102（ ） ： （ `scripts/platform-deps-check.py` （ ）
- **为什么**：按 plan.md 蓝图收口矩阵剩余本地可做项（
- **验证**：全量回归 `888 passed` （隔离 APS_KNOWLEDGE_PATH） ； ； ； （
- **边界**：真实 MES 工厂对接（填配置+现场联调）、真实 ASR/VLM/OCR、麒麟/统信四组合实机安装、签名/SBOM 上链、Defender for Endpoint 门禁、干净离线机实机、真实 GitHub CI、main.cjs 新 nonce 传递接线（均需外部环境/证书/后续轮）。
- **类型**：
- **做了什么**：新增 `server/state/branches.py` （ ） ： （ ） ， （ ， ， （ ） ， ； `/api/sessions/{id}/branches` 系列端点（ ） （ ） ； `conversationSide` 纳入分支树。
- **为什么**：矩阵 51 行「项目 -> 会话 -> 分支三级树及分支生命周期」（ ）
- **验证**： （ ） ；
- **边界**：前端分支树 UI、分支合并世界差异 diff、分支切换自动恢复锚定 checkpoint 留待后续轮。
---
## 2026-08-02 — 多智能体并行交付·第十三批： （ ，
- **类型**： （ ， ）
- **做了什么**（三个并行智能体写范围互不重叠 + 主控基线同步）：
- **方向 KK（ ） ： （ （ ） ； （ ）
- **方向 LL（ ） ： （ ） ； ；
- **方向 MM（ ） ： （ ：
- **主控·基线同步**：矩阵「当前验证基线」更新为 round-45 取证（
- **为什么**：按 plan.md 蓝图收口矩阵最后本地可做项；
- **验证**：全量回归 `895 passed` （隔离 APS_KNOWLEDGE_PATH） ； （ ） ； ； `npm run build` 通过；
- **边界**：真实 MES 工厂对接/端点路径现场联调、applyUpdate 途中重启竞态根治（ （
- **类型**：
- **做了什么**：新增 `server/agent_core/tool_runtime.py` ： `_POWER_MAP` 、只读类白名单），未登记意图拒绝执行并写 TOOL 审计（`tool.denied`/P3） ， `handle_intent` （ `tool.run` 审计； `_run_intent` 改为经 `run_tool` 执行。
- **为什么**：矩阵 111 行「LLM 只有提议权」剩余验收「所有 LLM 工具调用都经统一工具运行时；不能通过未登记 API 或直接 store 写入绕过」。
- **验证**： ） ； `unknown` 拒绝、`schedule.run` 直通且双审计落盘。
- **边界**：其余 gateway 直连端点（
---
## 2026-08-02 — 升级链路竞态根治： （ ， ）
- **类型**： （
- **做了什么**： （ `{ok:false, deferredVerification:true, reason:'NONCE_MISMATCH'}` + 审计 `upgrade.health-pending` （ ） ， （ ） ； ） ，
- **为什么**：
- **验证**： `45/45` ；根 node 门禁（ ） ； `895 passed` （隔离 `APS_KNOWLEDGE_PATH` ） ；
- **边界**：跨进程持久化 nonce 续接（应用重启即丢 pending）
- **类型**：
- **做了什么**： `node_at` （时间线按版本取不可变节点，越界/不存在抛 PlanNotFoundError） `replay_verify` （ ） ； `GET /{plan_id}/versions/{version}` （时间线回放）与 `POST /{plan_id}/versions/{version}/replay-verify` （动作级重放校验）。
- **为什么**：矩阵 110 行「L0-L3 Plan」剩余项「时间线回放和 L2 单节点/L3 动作级重放」。
- **验证**： （ `test_plan_runtime.py` 8 项全绿。
- **边界**： （
---
## 2026-08-02 — 升级 pending 跨进程持久化（ ， ）
- **类型**： （
- **做了什么**： `statePath` 持久化——setPending/markInstalled/settle/clear 均原子写 `upgrade-state.json` （ ， ） ； （ ） `{APS_HOME}/upgrade-state.json` ；测试 3 项（持久化往返/过期丢弃/settle 清空） ，
- **为什么**： ）
- **验证**： ； ； ； ，
- **边界**：签名/SBOM 上链、真实 GitHub CI、真实 MES/信创/离线机、WORM 物理介质、HSM/KMS、MySQL 实机等外部项维持矩阵标注。
- **类型**：
- **做了什么**：新增 `server/aps_domain/explore_boundary.py` ： ） ， （ ， （
- **为什么**：矩阵 55 行「Explore 与 Runtime 数据边界」； ，
- **验证**： `test_scenario_compare_does_not_mutate_world` 等 18 项场景/边界测试全绿。
- **边界**：敏感性/鲁棒性等其他 Explore 工具逐一接入统一通道、前端 Explore 与 Runtime 视觉分区留待后续轮。
---
## 2026-08-02 — 外部验收执行手册（ ， ；
- **类型**： （ ；
- **做了什么**：新建 `docs/product/external-acceptance.md` ——按剩余行逐项给出前置条件/验收步骤/验收标准/代码锚点：真实 MES（ （ ） （ ） （ ） （ ） （ （ ） （ ） （ ）
- **为什么**： （ ） ； ， ，
- **验证**：文档门禁 4 passed；
- **边界**：矩阵 10 个 Partial 行状态不变（仍需外部环境）；无代码改动。
---
## 2026-08-02 — 最终验证 + 交付总览（ ， ；
- **类型**： （ ； ）
- **做了什么**：全量黄金测试最终复跑 **895 passed** （隔离 `APS_KNOWLEDGE_PATH` ，确认 round-15~49 十五批累积工作树全绿）；新建 `docs/product/delivery-summary.md` ——总览指标（ ） （ ） （ ）
- **为什么**： （
- **验证**：全量回归 895 passed； ；
- **边界**：矩阵状态不变（仍需外部环境/提交授权）；无代码改动。
- **类型**：
- **做了什么**： ： `project_id` 维度（样本落 projectId） ； `explain` （得分明细 + cold/medium/high 置信 + 依据条数 + 原因文案）与 `reset` （按项目清样本）；样本不足 3 条标记冷启动、并列最高分标记不确定； `schedule.run` 与 gateway `scenario.apply` 调用点传入 `world_key` 实现项目隔离。
- **为什么**：矩阵 66 行「偏好学习影响默认策略」；
- **验证**： `test_m3_knowledge.py` 6 项全绿；端到端 schedule.run 带 world_key 冒烟通过。
- **边界**：前端偏好解释 UI、权重回归/规则归纳模型留待后续轮。
---
## 2026-08-02 — 现场数据保护与文档基线收口（ ，
- **类型**： （ ）
- **做了什么**：按当前工作区重新固化发布前证据口径：① 隔离测试环境下全量 `pytest` **907 passed** ，现场 `master.db` 验证前后各表计数完全不变；② Playwright 默认目标 `127.0.0.1:8003` 时 fail-closed， `E2E_ALLOW_LIVE_BACKEND=1` 才允许连接现场后端；③ `folder.schedule` 富卡显示 **有效 1357 / 问题 53 / 跳过 974** ，跳过行明确不计入问题行；④ Web build 通过，
- **为什么**： ，
- **验证**：全量 `pytest` 907 passed； `master.db` 前后计数完全一致； ； ， `skippedRows` 不计入 `totalErrors` 。
- **边界**： `docs/CHANGELOG.md` 、`docs/product/plan-completion-matrix.md`、`docs/product/delivery-summary.md`、`docs/product/external-acceptance.md`；不修改代码/测试，不提交。矩阵仍为 **50 Done / 10 Partial / 0 Missing** 。
## 2026-08-02 — 目录分析区分「非排产块」：问题行噪声收敛 1027→53（ ， ）
- **类型**： （ ）
- **做了什么**： `_MOM_SKIP_BLOCKS` （生产模型/质检方案/仓储模型/人力资源/客户管理/供应商管理），`analyze_work_dir` 把命中非排产块的 sheet 问题行单独计入 `skipRows/skippedRows` ，不再混入 `errorCount/totalErrors` ； `skippedRows` 。
- **为什么**：锐扬 MOM 收集表的工厂/质检/仓储/人力/客户/供应商块本就不导入，此前 1027 问题行里 974 行来自这些块， ； （ ）
- **验证**：真实目录实测 `totalErrors 1027→53` 、`skippedRows 974`； `904 passed` 。
- **边界**：跳过逻辑按 sheet 名匹配（锐扬模板名），其他模板同名块同样受益；不影响 okRows/确认卡语义。
## 2026-08-02 — 全链路排产就绪验证： （ ， ）
- **类型**：验证（现场排产端到端闭环）
- **做了什么**：将 `订单-样例.csv` （订单号/客户/产品编码/数量/交期/优先级/加急，示例行 SO-RY-20260801） `D:\ItemSpace\14.工业智核\锐扬` 后，浏览器实测「给我模拟排产一下」：目录分析识别订单 1 有效行，**排产必备全齐（ ） ， ， ： ， ， ） `docs/product/ruiyang-data-runbook.md` 排产必备状态与验证记录。
- **为什么**：证明用户下一步（替换真实订单 → 带我排一版/根据这些数据排产 → P2 确认）端到端可用，现场数据接入全部打通。
- **验证**：浏览器实测如上；无代码改动；全量黄金 `904 passed` 基线不变。
- **边界**：样例行需替换为真实订单（产品编码须在 02/04 表内、交期非空）；问题行 1027 多为非排产块（工厂/质检/仓储/人力等） ； （
## 2026-08-02 — 外部验收手册增补资源清单收集表（ ， ）
- **类型**： （
- **做了什么**： （ ） ， ； （ ）
- **为什么**：外部资源是剩余矩阵项的唯一阻断；把「找谁要什么」固化成表，用户/现场可先行收集，资源到位即可按第 1-10 节执行。
- **验证**：文档渲染核对通过；无代码改动（不需要跑测试）。
- **边界**：资源到位后按单执行并回写矩阵状态；现场用户当前仍等订单表（订单-样例.csv）
## 2026-08-02 — 订单导入支持「加急」列 + 锐扬数据接入手册/订单样例（ ， ）
- **类型**： （ ）
- **做了什么**：① `importers.py` 表头别名新增 `加急→isRush` （订单表常用列，导入后订单带急单标记）；② 在工程目录放置 `订单-样例.csv` （列：订单号/客户/产品编码/数量/交期/优先级/加急，示例行改数即可用）；③ 新增 `docs/product/ruiyang-data-runbook.md` ： （
- **为什么**：现场排产唯一缺口是订单表；给计划员可直接填写的样例与手册，减少来回确认。
- **验证**：新增 `test_order_csv_rush_column_maps_to_is_rush` （ ） ； `903 passed` ；订单样例 CSV 已按 utf-8-sig 落盘（
- **边界**： （ ） ，
## 2026-08-02 — 锐扬 02-工艺模型「制造流程」列提取为工艺路线（ ， ）
- **类型**： （ ）
- **做了什么**： `_rows_from_xlsx` 检测「制造流程/工艺代码/工艺流程」列（锐扬 MOM 02-工艺模型第 17 列起，表头后次行为 01..12 序号），为每个数据行合成 `routing` 视图：`{productCode=ERP品号, seq=序号, operationCode/operationName=工艺代码}`（如 `ZP01组装` →ZP01/组装、`LM01POP拉铆`→LM01POP/拉铆），随 preview_file 按 routing 批校验入库。
- **为什么**：上一轮目录分析显示「工艺路线/工时 ×
- **验证**：真实文件 `totalOk 910→1356` （ `A0050101-00280 seq=1 op=ZP01/组装` ）；浏览器实测「给我模拟排产一下」→ 物料 ✓1356 / 工艺路线 ✓446 / 设备 ✓87 / **仅缺订单** ， `test_xlsx_mom_template_multiblock_headers_soft_preview` （ `903 passed` 。
- **边界**： （ ） ， （ ， `MOM--00280` 交期为空）。
## 2026-08-02 — JMS 无角色用户默认 planner， （ ， ）
- **类型**： （
- **做了什么**： （ `roles` （真实平台实测无该字段）时，默认注入 `planner` 角色（可用 `JMS_AUTH_DEFAULT_ROLE` 覆盖，留空关闭）；`.env` 增加 `JMS_AUTH_DEFAULT_ROLE=planner` 。
- **为什么**：审批角色默认集为 planner/approver/admin，
- **验证**： `roles:["planner"]` ；浏览器端「给我模拟排产一下」→ 目录分析（ **P2 确认卡正常生成** （导入工程目录并试排 · 批准执行/驳回）；`test_jms_auth_provider.py` 新增 3 项（无角色默认 planner / env 覆盖 / 有角色不被覆盖）；全量黄金回归 `903 passed` 。
- **边界**： ；
---
## 2026-08-02 — 锐扬 MOM 收集表模板导入：多行标题/分块表头自动识别（ ， ）
- **类型**： （
- **做了什么**： `_rows_from_xlsx` 改为**表头行自动探测**——按规范化后命中已知字段映射最多的行（序号/编码/名称/单位/数量…）作为表头，跳过「物料清单」等标题行与分块模板（物料组块 + 物料主数据块），平铺表第 1 行即表头时行为不变；② 新增别名：
- **为什么**：现场 `湖南锐扬MOM主数据收集表.xlsx` （ （ （ ）
- **验证**：真实文件实测 `totalOk 0→910` （ ， ） ， （ `test_xlsx_mom_template_multiblock_headers_soft_preview` + `test_xlsx_flat_header_row_0_behavior_unchanged` ；相关 14 项测试通过；全量黄金回归 `903 passed` ；浏览器端「给我模拟排产一下」→ 目录分析显示 910 有效行并出 P2 确认卡。
- **边界**： （
## 2026-08-02 — 「模拟排产」类口令落空修复： （ ， ）
- **类型**： （ ， ）
- **做了什么**： `_is_imperative_schedule` 尾缀正则只支持 `排/排产/排一下/排程` 结尾，`排产一下`、`排产一版`、`模拟排产(一下)` 等口语全部漏匹配，落到 LLM 降级 → `assistant.py` 的「我先按你的话理解一下…想开排说带我排一版」通用引导（现场实测复现）。修复：正则扩展为 `(模拟|试)?排(产|程)?(一下|一版)?` 并加入 `模拟排产` 、`试排一版/一下`、`排一下` 等独立词条；命中后走既有祈使排产路径（工程目录有表 → `folder.schedule` ，否则 `flex.schedule` ）。
- **为什么**：现场用户输入「给我模拟排产一下」得到的是四选一引导而非执行，是「竟然不理解」的直接根因；同批修复 `帮我排产一下` 等同类漏匹配。
- **验证**：快路实测 10 个新/旧祈使句全部 `flex.schedule` /`folder.schedule`；负向守护：`带我排一版`→wizard、`怎么排产`→wizard、`模拟报工`→mes.report、`帮我看看现在能不能排`→assistant.reply、`解析项目文件夹`→folder.analyze 均不被误吞；`test_assistant.py` 扩展祈使句清单 + 新增 `test_simulate_schedule_does_not_hijack_other_intents` ；浏览器实测「给我模拟排产一下」→ 真实解析工程目录 `锐扬` （ `898 passed` 。
- **边界**：若工程目录存在 Excel 但行校验不过，排产口令按产品规则走 `folder.schedule` 数据门禁（提示补齐数据）；真实数据补齐后即可开排。矩阵状态不变。
## 2026-08-02 — OpenAPI 生成回归门禁（ ， ）
- **类型**： （
- **做了什么**：新增 `tests/golden/test_openapi_schema.py` （
1. `test_openapi_schema_generates_without_forward_ref_error` ——`create_app().openapi()` 必须完整生成，且 12 个受影响路由（/api/import/commit、/api/templates/apply、/api/rag/query、/api/rebuild/*、/api/knowledge/import、/api/skills/*、/api/mcp/plugins/*、/api/jobs）
2. `test_affected_request_models_are_module_scope` ——12 个请求模型必须可从 `server.gateway.app` 模块级导入，且 `__qualname__` 不含 `create_app` （直接编码 round-52 修复前的状态，修复前必失败）。
- **为什么**： `/openapi.json` 500 的缺陷，但当时没有回归测试；本测试把该约束固化为黄金门禁，防止后续把模型类再写回函数局部。
- **验证**：新增 2 项通过（ `test_contract_sync` + `test_health_version` 17 项全绿； `GET /openapi.json` 200 不变。
- **边界**：矩阵状态不变（剩余 10 个 Partial 仍依赖外部资源）。
## 2026-08-02 — 修复 /openapi.json 500： （ ， ）
- **类型**： （
- **做了什么**：定位 `GET /openapi.json` 返回 500（ ： `create_app()` 函数体内定义了 12 个路由请求模型类（ ） ， ） ：
- **为什么**：
- **验证**： （ ， ） ； `GET /openapi.json` 200（ ） `/docs` 200； （ ， `APS_KNOWLEDGE_PATH` ） ； `895 passed` **（隔离 `APS_KNOWLEDGE_PATH` ，与 round-50 基线一致） ； （ ） ； （ ）
- **边界**：未改任何路由逻辑；矩阵状态不变（剩余 10 个 Partial 仍依赖外部资源：真实 MES/WMS、ASR/VLM、信创实机、干净离线机、代码签名证书、真实 GitHub CI、WORM 介质、HSM/KMS、MySQL 多主机）。
## 2026-08-02 — 侧栏乱码会话清理 + E2E 测试卫生预防（ ， ）
- **类型**：
- **做了什么**：
1. **修复** ：侧栏出现 `????` / `???????` 乱码任务——定位为早期 E2E 探针残留的空会话（ ， `?` ， `ProjectStore.delete_session` 正规删除， （
2. **预防** ： （
- **为什么**：本地 E2E 冒烟（ ）
- **验证**： （ ） ；
- **边界**： （ ，
- **类型**：
- **做了什么**：新增 `server/agent_core/audit_filelock.py` ： `locked_append` （进程内锁 + Windows msvcrt 区域锁，可配 `APS_AUDIT_LOCK_RETRY_SECONDS` ） ， `audit_mirror.append_event` 均切换接入，防多进程并发写行交错损坏证据；`audit_ledger.archive_old` 清理策略：超过保留窗口（`APS_AUDIT_LEDGER_KEEP_LAST`，默认 10000） `archive/<yyyy-mm>.jsonl` 目录，分级存储而非删除，证据不丢失。
- **为什么**：矩阵 116 行「审计 append-only」剩余项「清理策略、跨进程锁强化」。
- **验证**： （ × ） ；
- **边界**：
---
- **类型**：
- **做了什么**：新增 `server/agent_core/audit_merkle.py` ：完整二叉树 Merkle 树（叶子=事件 hash， `merkleRoot` （与本地复算一致）。
- **为什么**：矩阵 104 行「全审计」剩余项「完整 Merkle 树」； （ ） ，
- **验证**： ） ；
- **边界**： （ ） ；
---
- **类型**：
- **做了什么**：新增 `server/agent_core/audit_notify.py` ：按配置渠道（`APS_AUDIT_ALERT_CHANNELS`， < path > /webhook:< url > ， ） ； `APS_AUDIT_ALERT_DEDUP_SECONDS` （默认 300s） ；
- **为什么**：矩阵 104 行「全审计」剩余项「告警通知渠道」；此前 build_alerts 只聚合、无投递。
- **验证**： （ （ ）
- **边界**： ，
---
- **类型**：
- **做了什么**： `CheckpointStore.create()` 新增可选 `conversationSide` 完整对话侧快照参数（ ） ； `_create_checkpoint` 统一建档入口（自动收集对话侧）、`_restore_conversation_side`（回滚时成对恢复对话侧），全部 23 处 P2 写前建档与回滚分支接入；`test_m2_state.py` 增至 6 项（成对快照往返逐字段一致、不传对话侧向后兼容）。
- **为什么**：矩阵 52 行「对话状态与世界状态真正成对快照、成对切换和成对回滚」；此前仅存 world + conversationNote 摘要。
- **验证**： ； ： （ ）
- **边界**： （
---
- **类型**：
- **做了什么**： `_build_external_trace` /`_external_audit_evidence`/`_external_inputs_hash`， `flex.schedule.external` 审计携带 traceChainHash/traceCount/traceSummary（ ， `GovConsole.tsx` AuditView 新增「可追溯链」列展示 traceChainHash/traceCount/traceSummary（
- **为什么**：矩阵 114 行剩余「EXTERNAL 引擎接入、前端追溯 UI」； ，
- **验证**： （ ） ；
- **边界**：
---
- **类型**：
- **做了什么**： `solveTimeSec` （改为保留在 ALGO_RUN 审计 rationale 顶层字段），使 CP/HYBRID 真实求解（墙钟 > 0） ； `_run_audit_evidence` 把 `schedule-version:<id>` 引用并入审计 `evidence` （对齐 round-15 计划假设 2） ；
- **为什么**：
- **验证**： ；
- **边界**：
---
- **类型**：
- **做了什么**： `_run_schedule` 求解后经 `_build_run_trace` 构造 EvidenceItem 链（ ， `_run_inputs_hash` 输入包指纹） ， `schedule.run` 审计 rationale 新增 `traceChainHash` /`traceCount`/`traceSummary`；
- **为什么**：矩阵 114 行剩余「各引擎实际写入 trace_chain」首个落地（
- **验证**： ；
- **边界**：
---
## 2026-08-01 — 审计完整性告警
- **类型**：
- **做了什么**：新增 `server/agent_core/audit_alerts.py` （ ） ； `alerts` ；前端 `AuditAlert` 类型 + AuditView 按 severity 展示告警条（样式 `.gov-alert-*` ）。
- **为什么**：矩阵 104 行剩余「异常告警」；审计闭环最后一块。
- **验证**： ； ；
- **边界**： ）
---
## 2026-08-01 — 审计合规导出与保留脱敏
- **类型**：
- **做了什么**：新增 `server/agent_core/audit_export.py` ： （ `export_events` （ ， ） ； `GET /api/gov/audit/export?format=json|csv` 导出当前作用域审计事件（脱敏）+ 链/锚定摘要。
- **为什么**：矩阵 104 行剩余「保留脱敏、合规导出」；审计闭环的收尾能力。
- **验证**： （ ； `worldKey` 等含 "key" 子串字段。
- **边界**：
---
## 2026-08-01 — 审批转派（ ）
- **类型**：
- **做了什么**： ， `harness.transfer_confirmation()` + 网关 `POST /api/actions/transfer` ； ） ， `TRANSFERRED` 记录 from/to。
- **为什么**：矩阵 P3「外部副作用二次确认」剩余项（ ） ；
- **验证**： （ ；
- **边界**：批量转派、委托撤销、转派 UI 展示、MySQL 实机故障注入留待后续轮。
---
## 2026-08-01 — 统一 EvidenceItem 可追溯链
- **类型**：
- **做了什么**：新增 `server/agent_core/evidence.py` ： （ ： ） （ < kind > :< id > ` 语法，
- **为什么**：矩阵 114 行剩余「统一 EvidenceItem； ；
- **验证**： （ ；
- **边界**：各引擎实际写入 trace_chain、前端追溯 UI 留待后续轮。
---
## 2026-08-01 — 审批委托（ ）
- **类型**：
- **做了什么**： ； ） ，
- **为什么**：矩阵 P3「外部副作用二次确认」剩余项之一；
- **验证**： （ ；
- **边界**：
---
## 2026-08-01 — 契约生成自动化与差异检查门禁
- **类型**：
- **做了什么**：新增 `scripts/generate_contract_types.py` ：从 `shared/schemas/*.json` 生成 TS 类型声明（ ， `tests/golden/test_contract_generation.py` 5 项门禁（生成器对全部 7 个 schema 可执行、必填字段/枚举与 schema 一致、手写 types.ts 关键面 ⊆ schema、生成确定性）
- **为什么**：矩阵 117 行剩余「契约生成自动化（ ） ；
- **验证**： ；
- **边界**： （
---
## 2026-08-01 — 审计事件独立介质镜像（ ）
- **类型**：
- **做了什么**：新增 `server/agent_core/audit_mirror.py` （ ， ） ； `write_audit` 同步镜像每条审计事件（尽力而为，失败只记日志不阻断业务）；`/api/gov/audit` 有镜像时以镜像为事件源（响应含 `source: mirror|world` ），业务进程修改 world 无法抹掉独立介质证据。
- **为什么**：矩阵 116 行剩余「业务进程无法修改历史事件；独立介质」——此前审计事件只存世界内，改 world 即抹掉。
- **验证**： ； （
- **边界**：镜像默认关闭（`APS_AUDIT_MIRROR=1` 显式启用）；`_mirror_event` 全异常兜底（ ） ；
---
## 2026-08-01 — 文档技术选型漂移门禁
- **类型**：
- **做了什么**：修订 `docs/architecture/overview.md` 与 `docs/product/positioning.md` 的桌面技术选型描述——从「Tauri（ ） （ ， ； ） ， （ `tests/golden/test_doc_drift.py` 门禁：桌面描述必须含 Electron 或「待决策」标注、禁止孤立 Tauri 绝对描述、Hybrid 引擎描述与代码一致。
- **为什么**：矩阵 117 行点名「Hybrid、Tauri/Electron 文档描述漂移」；此前 overview/positioning 与 desktop.md 自相矛盾。
- **验证**： ；
- **边界**：
---
## 2026-08-01 — 审计独立介质锚定（ ）
- **类型**：
- **做了什么**：新增 `server/agent_core/audit_ledger.py` ： `AnchorLedger` （按租户/项目隔离的 append-only JSONL 账本，原子追加 + fsync） ； `anchor` 状态（已锚定/根/事件数/ok） ， `POST /api/gov/audit/anchor` 显式锚定；与既有 `verify_audit_chain` 链式校验互补（事件体篡改由链校验捕捉、哈希序列/账本行删改由锚定捕捉）。
- **为什么**：矩阵「全审计 / 审计 append-only 且可检测篡改」P0 剩余项——此前审计只存世界内，无独立介质与外部锚定证明。
- **验证**： `test_audit_anchor_api.py` 1 项（ ： ；
- **边界**： （ ） ，
---
## 2026-08-01 — 审批意见 UI 输入框（单条+批量）
- **类型**：
- **做了什么**： `note` 参数透传（接口能力此前已就绪，本次补齐前端入口）；审批历史「意见」列由此真正可用。
- **为什么**：页面巡检员 WARN——接口支持 note 但 UI 无输入框，意见列恒显示「—」。
- **验证**： ； ；
- **边界**：无。
---
## 2026-08-01 — 批量审批（ ）
- **类型**：
- **做了什么**：新增 `POST /api/actions/confirm-batch` 批量确认端点（ ， ： ） ； `postConfirmBatch` 与类型同步。
- **为什么**：矩阵 P3「外部副作用二次确认」剩余项之一；
- **验证**： ） ； ； ； （
- **边界**：委托/转派审批、文件→DB 存量迁移、WORM 归档、MySQL 实机故障注入留待后续轮。
---
## 2026-08-01 — 审批意见（ ）
- **类型**：
- **做了什么**： `ConfirmRequest` 支持可选审批意见 `note` ； `DatabaseApprovalStore.decide` 将意见写入 approvals 记录与审批历史事件（驳回路径同样落库）；管理台审批历史新增「意见」列展示；前端 `ApprovalActor.note` 类型同步。
- **为什么**：矩阵 P3「外部副作用二次确认」剩余验收项首个子项；
- **验证**：双后端聚焦 46 passed（ ； `tsc -b` 通过； （
- **边界**：委托/转派/批量审批、文件→DB 存量迁移、WORM 归档、MySQL 实机故障注入留待后续轮。
---
## 2026-08-01 — 契约漂移门禁补全：公共排产契约纳入三方校验链
- **类型**：
- **做了什么**：把 `scheduling_problem` / `scheduling_solution` / `plan_node` 三个公共排产契约纳入 `tests/golden/test_contract_sync.py` 三方校验链（ `orders/routings/resources` （ ） `operations` （ ） `evidenceRefs` 按 schema required 去掉空默认值（ ） ；
- **为什么**：矩阵 P0 批次点名「三层契约漂移门禁」；此前 4 个契约有校验，
- **验证**： （ ） ； ； ；
- **边界**：契约生成自动化与 Hybrid/Tauri 文档漂移门禁留待后续轮次。
---
## 2026-08-01 — 证据链 v1：
- **类型**：
- **做了什么**：把 `mes.dispatch` 的「确认令牌 + 版本证据 + 写前快照、缺项拒绝」统一为全 P2/P3 执行协议。`stage_confirmation` 出卡时冻结 `evidenceRefs` （显式或按 `versionId` 派生 `schedule-version:<id>` ）、`beforeSnapshot` 与 `beforeFingerprint` （输入快照指纹）；`execute_confirmed` 在最终批准后、写世界前执行 `verify_pending_evidence` （版本证据绑定 / 前置快照存在 / 版本可解析， ， ） ； `beforeSnapshot` +`evidenceRefs`。
- **为什么**：完成度矩阵 P0 批次点名「把强关联扩展到其余 P2/P3， ；
- **验证**：新增 `tests/golden/test_evidence_contract.py` 9 项（ `424 passed` （原 397 + 新增） ；
- **边界**：漂移检测采用对象域版本一致性（世界带版本表才解析），不做全局 world 指纹硬拒绝，避免审批期间 P0/P1 合法改世界的假阳性。
---
## 2026-07-31 — 跨主机共享审批存储首切片
- **类型**：
- **做了什么**：保留默认文件审批后端，新增显式 `APS_APPROVAL_BACKEND=database` ；共享模式复用 MySQL `APS_DATABASE_URL` ，以规范化 request/grant/event 表和 revision CAS 协调批准/驳回终态、P3 grant 签发及全局一次消费。最终批准、grant 和审批事件同事务提交，数据库只保存 token SHA-256； `APS_APPROVAL_PATH` 冲突、缺少 URL、方言不符或连接失败均失败关闭且不回退文件。Harness 外部 API、P2/P3、职责分离、TTL 和角色策略语义保持不变。
- **涉及路径**：
- **验证**：
- **文档同步**：
- **遗留**：执行副作用仍存在批准状态提交后、真实执行前的崩溃窗口；待补 outbox/幂等执行状态机、文件存量迁移器、MySQL 多主机故障注入和 WORM 审计归档。
## 2026-07-31 — 按动作与等级细分审批角色策略
- **类型**：
- **做了什么**：新增 `APS_APPROVAL_ROLE_POLICIES` 严格 JSON 配置，可分别按精确 action 和 P2/P3 设置发起、批准、历史查看角色；每种能力按 action > power > 既有全局环境变量确定性解析；未知字段/action/等级、重复键和非法角色结构使整份配置失败关闭；待办、确认解析、批准和历史四条路径统一按动作授权；治理策略 API 保留原字段并追加角色、来源和配置校验状态；
- **涉及路径**：
- **验证**：角色策略专项 `10 passed` ；审批/Harness/MES 聚焦回归 `45 passed` ；最终在全新 `APS_DB_PATH` 的全量黄金 `397 passed in 168.33s`
- **文档同步**：
- **遗留**：审批意见、委托/转派/批量审批、跨主机共享存储和 WORM 审计归档仍待后续切片。
## 2026-07-31 — 固定 CPython Desktop Sidecar 与安装态守护
- **类型**：
- **做了什么**：桌面安装态不再调用系统 Python； ， ； ， ， ， ， ， ； ， `brace-expansion` 5.0.9；根构建引擎同步要求 Node >=22.12.0。
- **涉及路径**：
- **验证**： `33 passed` ； `7 passed` ； ； ；
- **遗留**：当前安装包未签名、使用默认 Electron 图标；尚未在无 Python/无网络的干净 Win10/11 x64、中文和空格安装路径上完成 20 次冷启动、Defender、升级/回滚与真实 APS 大算例验收；`plan.md` 的 Tauri 目标与当前 Electron 实现仍需产品/架构决策。
## 2026-07-31 — CycloneDX SBOM 与本地制品完整性清单
- **类型**：
- **做了什么**：新增固定版本的 CycloneDX npm/Python 生成器，为 Web、Desktop 和冻结 Sidecar 依赖生成可重复、校验通过的 CycloneDX 1.6 SBOM； `signed=false` ，不把本地哈希清单冒充签名 provenance。
- **涉及路径**：
- **验证**： `dist/sbom/release-manifest.json` 。
- **遗留**：尚未接入 CI、签名服务、透明日志或 SLSA provenance； ，
## 2026-07-31 — 审批队列持久化、TTL 与 P3 双人职责分离
- **类型**：
- **做了什么**：新增原子 JSON 审批存储，持久化待审批动作、决策历史和一次性执行凭据；审批与凭据分别支持可配置 TTL， ； ； `worldKey` ，防止第二审批人的个人空间劫持执行目标；全部审计 actor 从认证身份派生，客户端原值仅作为 `requestedActor` 证据；冻结参数摘要和一次性消费语义跨进程重启保持不变；同机文件锁与落盘前刷新阻止多个 worker 重复签发；损坏或非法记录文件隔离为 `.corrupt-*` 并告警；治理台新增审批历史，待办/历史展示发起人、审批进度、等待/停留时长与到期时间。
- **涉及路径**：
- **验证**：审批存储定向含真实 `spawn` 多进程竞争；审批/MES/租户隔离/审计链定向 `41 passed` ， `npm run build:web` 成功。
- **遗留**：跨主机或不保证文件锁语义的网络文件系统仍需事务共享存储；按动作/等级细分角色策略、审批委托/转派/批量审批和 WORM 审计归档仍待后续切片。
## 2026-07-31 — 独立审计 P1/P2 整改
- **类型**：
- **做了什么**： `track/versionId/evidenceRefs` 会被拒绝且不消耗合法凭据； `schedulingVersionId` 反查工单；跨租户查询已知令牌不再泄漏第二确认状态。方案 UI 完全服从后端 `recommendationId` 并禁用 `HARD_REJECTED` ； `createdBy` ，来源固定为 `USER` 。ScheduleResult 的 `EXTERNAL` 、必填字段和求解元数据同步到 JSON Schema/TypeScript。
- **涉及路径**：
- **验证**：首轮审计整改跨模块定向 `43 passed` ；参数替换/81 条边界整改专项 `14 passed` ；最终全量黄金 `337 passed in 148.01s` ；
- **遗留**：审批队列/执行凭据仍为单进程内存态；
## 2026-07-31 — Windows 求解器发布探针
- **类型**：
- **做了什么**：新增隔离子进程探针，重复导入 NumPy/Pandas/OR-Tools 并运行最小 CP-SAT 求解；同时扫描标准输出和错误输出中的 `Windows fatal exception` 、`Fatal Python error`、`0xc0000139`，避免原生加载异常被退出码 0 掩盖。
- **涉及路径**：
- **验证**：仓库 `.venv` 直接五轮探针通过；探针黄金用例通过；包含该用例的最终全量黄金 `337 passed in 148.01s` 。PATH 首位 Anaconda Python 首轮以 `0xc0000139 / WinError 127` 被正确阻断，不属于可发布运行时。
- **遗留**：探针是发布阻断器，不替代对 Anaconda/Python 3.13 与二进制 wheel 组合的根因治理；正式打包环境应使用固定、可复现的 CPython sidecar。
## 2026-07-31 — SC-14 方案优选与蒙特卡洛鲁棒性首切片
- **类型**：
- **做了什么**：
- **涉及路径**：
- **验证**：定向回归 `15 passed` ； `325 passed` ；相关 Python 文件 Ruff 与 `git diff --check` 通过。算法 agent 的独立运行曾打印 OR-Tools→pandas/pyarrow 的 Windows `0xc0000139` 环境异常栈，但主代理最终全量回归未复现，仍保留为发布环境风险。
- **文档同步**：
- **遗留**：
## 2026-07-31 — L0-L3 PlanNode 可重生运行时首切片
- **类型**：
- **做了什么**：新增 L0-L3 共用的不可变 `PlanNode` 契约与项目隔离的追加式 JSON 版本仓；重生保持同一 `planId` 、递增 `version/regenCount` 并保留旧版；规范化 `inputsHash` 校验阻断输入漂移，默认重生 3 次后熔断；提供创建、最新版本、版本历史和重生四个最小 API。
- **涉及路径**：
- **验证**： `8 passed` ；加治理/认证/租户/会话回归集 → `40 passed`
- **文档同步**：
- **遗留**：尚未接入 Agent 自动分解、时间线 UI、审计事件写入与跨进程文件锁；
## 2026-07-31 — P3 外部副作用二次确认
- **类型**：
- **做了什么**： ； ， ； ； `confirmId` 、自动检查点 `beforeSnapshot` 和排产版本 `evidenceRefs` ， ；
- **涉及路径**：
- **验证**： `13 passed` ，覆盖 Gateway 0→1 外部副作用次数、重复令牌不刷新、缺少门禁/快照/证据时拒绝；`npm run build:web` 成功。
- **文档同步**：
- **遗留**：
## 2026-07-31 — 跨层契约版本与漂移门禁
- **类型**：
- **做了什么**： `interfaceVersion=1.0` ；把 `intent.schema.json` 的封闭枚举同步到当前运行时意图全集；增加黄金测试阻断 Pydantic、JSON Schema 与 TypeScript 的版本及 UIBlock/ViewportCommand 枚举漂移； `/api/health` 现在返回同一版本，前端 `InterfaceGate` 在认证和业务界面挂载前完成握手，不兼容或服务不可用时显式阻断。
- **涉及路径**：
- **验证**：契约+认证握手定向 `11 passed` ；
- **文档同步**：
- **遗留**：其余公共排产契约仍需逐步纳入统一生成链；多版本兼容窗口和灰度升级策略尚未建立。
## 2026-07-31 — SC-03 GA 真实求解首切片
- **类型**：
- **做了什么**：新增固定种子的 `GeneticAlgorithmEngine` ，联合搜索订单顺序与具备完整工位映射的候选产线；精英保留保证 RULE 顺序/首选线基线进入种群；代数预算由时限确定性推导，避免墙钟截断破坏固定种子复算；通过统一 `solverMeta` 留存种群、代数、目标值、耗时与种子；`get_engine("GA")` 不再由 RULE 代跑。
- **涉及路径**：
- **验证**： `24 passed`
- **文档同步**：
- **遗留**：方案层 Pareto 已落地；工序级 GA、NSGA-II 种群进化、LNS 和大算例性能基线仍待后续切片。
2026-07-21 11:05:57 +08:00
2026-07-28 02:12:46 +08:00
## 2026-07-24 — 桌面/Web 双形态与 ~/.aps（ ）
- **类型**：
- **背景**：
- **交付**：
- `server/aps_home.py` ： `~/.aps/{skills,sessions,data,…}` ； `server/data`
- Skill 改为目录布局 `skills/<id>/manifest.json` （
- Electron 壳 `apps/desktop/` ；根脚本 `npm run dev:web|dev:desktop` 、`build:web|build:desktop`
- `GET /api/system/paths` ；管理台展示 skills 目录
- 文档：`docs/architecture/desktop.md`
- **测试**：
## 2026-07-23 — 通用机加工排产平台（
- **类型**：
- **背景**：康尼数据硬编码在代码里、工时缺失被引擎默默按 1 分钟兜底、UI 无组件库、Skill 只读、RAG 无管理页且外部算法无法消费、低置信直接拒识不追问。目标：升级为面向整个机加工行业的通用排产平台。
- **交付**：
- **M-A 数据库地基**： （ `master.db` ，多项目隔离）+ world 双向投影（引擎零改动）；康尼口径全部搬进 `server/importers/profiles/kangni.json` （代码零硬编码）；演示数据 → `server/data/packs/demo.json` 数据包（日期按 baseDate 平移重放）
- **M-B 工时闭环**： `TIME_UNMAINTAINED` /`TIME_INFERRED` 冲突；`readiness.query` P0 / `flex.time.update` P2； （ ）
- **M-C UI 改版**： （ #F97316 ）；订单/主数据/柔性面板全面 Table/Drawer/Form/Tabs/Modal 组件化，
- **M-D Skill 管理台**： ） ； `version/capabilities/ragScopes` （旧配置自动升级）；契约 `schemaVersion` ；
- **M-E RAG 平台**： （ ） ； `meta.knowledgeRefs` ；索引状态/重建 API
- **M-F 对话智能**： `schedule.wizard` （缺路线推荐模板/缺工时追问/缺日历给默认，写入全走 P2）
- **M-G 收尾**： `test_e2e_acceptance` （入库→工时维护→向导排产→外部 skill 试排→知识问答）
- **测试**： `tsc --noEmit` 零错误 + vite build 通过
## 2026-07-23 — RAG 知识库 + 外部算法排产 Skill
- **类型**：
- **背景**：知识库仅 bigram 吐原文、无文档导入；排产引擎不可插拔外部算法。
- **交付**：
- RAG： （ ）
- Skill： `SchedulingProblem/Solution` DTO、`ExternalEngine`、`SkillRegistry`、`algo.stub`、口令与 harness 权力登记
- API：
- 文档：`docs/architecture/rag.md`、`skills.md`；
- **测试**：
2026-07-23 13:38:43 +08:00
## 2026-07-23 — 排产方案下载改为 Excel 工作计划表
- **类型**：
- **背景**：用户要求下载应是完整 Excel 工作计划表，而非 Markdown。
- **交付**：
- `build_plan_report` 产出 xlsx（
- 聊天报告块与柔性排产结果块：「下载 Excel 工作计划表」
- `GET /api/reports/files/{id}` + `GET /api/reports/plan?format=xlsx`
- **测试**：
## 2026-07-23 — 委外追问可答 + 排产方案报告可下载
- **类型**：
- **背景**：排产后问「这个订单有委外订单吗」低置信拒识；日报只覆盖固定轨，柔性排产方案无法下载。
- **交付**：
- `master.query` entity=`mrp`：委外/采购/分解建议问答，支持「这个订单」指代
- `report.generate` type=`plan`：柔性排产方案报告（概览+交期+工序明细表），聊天块「下载 .md」
- 口令：生成排产方案报告 / 下载排产 / 导出排产方案；快捷指令同步
- **测试**：
## 2026-07-23 — 「把这个订单排产」指代修复
- **类型**：
- **背景**：刚查到订单后说「给我把这个订单进行计划排产」走 LLM 低置信拒识，未走排产。
- **交付**：
- 快路识别「这个/该订单…排产」「计划排产」「给订单 xxx 排产」→ `flex.schedule` （有 flex 单时）
- `session_focus` ： `orderIds`
- 无焦点且多单时明确提示先查单，不瞎排全池
- **测试**：
## 2026-07-23 — 对话检索订单/主数据 + 机加工工艺知识库
- **类型**：
- **背景**：自然语言无法检索现场订单/主数据；知识库缺机械加工工艺路线生成模式。
- **交付**：
- `master.query` P0：
- `server/knowledge/machining_patterns.py` ：车铣钻磨钣金焊接装配热处理等工艺路线生成模式 + 城轨机构装配模板
- 「知识清单」列出全部资产；口令「机加工工艺怎么生成」「车削工艺模式」等
- **测试**：
## 2026-07-23 — 现场 Excel 同步写入主数据页/订单池（清演示）
- **类型**：
- **背景**：此前只写 `flex*` ，主数据页与订单池仍读固定轨演示表，界面像「垃圾数据」。
- **交付**：
- `load_site_into_world(clear_all=True)` 清空固定轨+柔性轨演示，写入工厂/产线/工位/工序/物料/BOM/路线/`salesOrders` + flex*
- 默认只导入 `订单102285668_完整生产路线.xlsx` 主单
- `ensure_flex_seed` 在现场清空后不再回填 HV/PDU 假数据
- 柔性工作台下拉改为读现场成品/设备，去掉 PDU/HV/PRESS 硬编码
- **验证**： ；
## 2026-07-23 — 康尼现场完整生产路线导入（替换演示 flex*）
- **类型**： （
- **背景**：引擎与文档口径对齐柔性能力池，但默认仍是 HV-HARNESS/PDU 演示假数据；用户要求用现场真实 Excel 把康尼排产流程跑通。
- **交付**：
- `server/aps_domain/kangni_intake.py` ：解析「完整生产路线」+ 同源订单/工艺/BOM；
- `scripts/load_kangni.py` ：清空演示 flex* → 写入现场 → PoolEngine 排产
- `flex.site.load` P2（ `POST /api/flex/site/load`
- 验证：订单 102285668 → 10 工序 VL/WO；
- **已知缺口**：源表标准工时/设备/模具均为「待维护」→ 部装45′ ′ `flexParams.siteInferences` ）
- **测试**：
- **文档**：
## 2026-07-23 — IND-02 SOP→约束规则包
- **类型**： （
- **背景**：知识库可存 SOP， ；
- **交付**：
- `sop.compile` P0 / `sop.apply` P2； `POST /api/sop/stage`
- 换线 SOP→启用 C10 + 跨族默认 60 分 + 16:00 宵禁；齐套 SOP→C6；
- 约束 `C13_sop` ；世界 `rulePacks` / `changeoverPolicy` ；宵禁冲突 `SOP_CHANGEOVER_CURFEW`
- 设置→约束配置「编译并应用」；
- **测试**：
- **顺带**： `mrp.release` 下达
## 2026-07-23 — SC-03 HYBRID 管线（ ）
- **类型**： （
- **背景**：
- **交付**：
- `HybridEngine` ：策略序收集 → RULE 选线 hint → CP-SAT `AddHint` 改良 → 班次占槽
- `solverMeta.pipeline=RULE→CP-SAT→shift-slot` 、`warmStart=RULE`
- 缺 ortools 时 `DEGRADED_RULE` 诚实降级（仍标 HYBRID）
- 口令「混合引擎试排」「HYBRID试排」；
- **测试**： `test_cp_engine.py` / `test_rule_engine.py`
- **验收**： ；
## 2026-07-23 — SC-03 CP-SAT 真求解首切片
- **类型**： （
- **背景**： ，
- **交付**：
- `CpSatEngine` （ ） ：
- `ScheduleResult.solveStatus|solveTimeSec|optimalityGap` ；版本 `solverMeta`
- 排产参数：默认引擎 / CP 时限；
- GA/HYBRID 仍 RULE 代跑并明确注释；缺 ortools → `ENGINE_UNAVAILABLE`
- **依赖**：
- **测试**：
- **验收**： ； ；
## 2026-07-23 — SC-06 主控参数敏感性分析
- **类型**： （
- **背景**：排产参数可改，但缺少 one-at-a-time 扰动与 Tornado 摆幅，难以判断「改哪项最敏感」。
- **交付**：
- `scenario.sensitivity` P1；
- 因子：展望期 / VIP 权重 / 交期缓冲比 / 冻结窗口 / 产线效率
- `EngineParams.deliveryBufferRatio` 、`freezeWindowHours`（显式传入才挂钩 RuleEngine）
- 设置→排产参数「敏感性分析」；
- **测试**：
- **验收**：主干不变；摆幅降序；更紧缓冲延期不降
## 2026-07-23 — SC-08 批次/战役合并
- **类型**： （
- **背景**：同产品近交期订单仍各自 PO， ；
- **做了什么**：
- 策略 `CAMPAIGN` ：交期窗 7 天同品合并；插单/预测单排；
- `campaign.preview` P0； `poSaved`
- 口令「战役合并预览」「战役合并试排」
- **验证**： `test_m2_state` 五卡；全量 golden；
---
## 2026-07-23 — SC-07 换型最小化策略
- **类型**： （
- **背景**： ，
- **做了什么**：
- 策略 `CHANGEOVER_MIN` （
- 方案对比增加换型卡与 `totalChangeoverMin` KPI
- 口令「换型最小化试排」；插单面板可选该策略
- **验证**： `test_m2_state` 四卡；全量 golden；
---
## 2026-07-23 — MD-06 换型矩阵主数据
- **类型**： （
- **背景**：引擎仅有标量 setupTime， × ，
- **做了什么**：
- `changeoverMatrix` + 物料 `productFamily` ； `master.changeover.upsert`
- RuleEngine 同线跨族叠加首道准备；约束中心 C10 可关
- 主数据「换型」页；口令「查看换型矩阵」「设置换型 …」
- **验证**： ；
---
## 2026-07-23 — PL-06 产供方向决策
- **类型**： （
- **背景**：削峰后仍超载时，缺加班/扩线/外协的结构化产供选项（此前仅靠叙事）。
- **做了什么**：
- `plan.supply` ：先削峰，残留缺口按加班→扩线→外协覆盖；`verdict` + options/gaps
- `GET /api/plan/supply` ；分桶视口「产供」；口令「产供决策」「加班建议」「外协建议」
- **验证**： ；
---
## 2026-07-23 — PL-05 产能平衡 / 削峰
- **类型**： （
- **背景**：排产层有 CAPACITY_BALANCE，
- **做了什么**：
- `plan.leveling` ：有限分桶上先提前后延后挪动；输出建议+前后负荷对照
- `GET /api/plan/leveling` ；分桶视口「削峰」；口令「削峰」「产能平衡」
- **验证**： ；
---
## 2026-07-23 — PL-04 库存投影
- **类型**： （
- **背景**：计划层缺随时间库存曲线，断料只能在齐套/MRP 事后发现。
- **做了什么**：
- `plan.inventory` ：期初+在途+成品交期/BOM 毛需求+采购到货；日/周投影；断料/安全库存告警
- `GET /api/plan/inventory` ；分桶视口「库存投影」；口令「库存投影」「库存投影 CTRL-A」
- **验证**： ；
---
## 2026-07-23 — PL-03 可行性分析
- **类型**： （
- **背景**：延期只能在详细排产后看见，缺计划层前置「能否按期 + 缺口在哪」。
- **做了什么**：
- `plan.feasibility` ：交期排序累计需求 vs 累计粗能力；
- `GET /api/plan/feasibility` ；分桶视口「可行性」页；口令「可行性分析」「能否按期」
- **验证**： ；
---
## 2026-07-23 — PL-02 有限/无限产能粗评估
- **类型**： （
- **背景**：分桶计划仅有限产能视角，缺西门子式无限产能粗评估与双模式对照。
- **做了什么**：
- `capacityMode=FINITE/INFINITE` ：无限不卡能力、给所需日产 + 有限参照；`plan.rccp` 对照摘要
- `GET /api/plan/rccp` ；分桶视口有限/无限切换；口令「有限产能粗评」「无限产能粗评」「粗能力对比」
- **验证**： ；
---
## 2026-07-23 — PL-01 时间分桶计划
- **类型**： （
- **背景**：计划层缺日/周/月时段建模，中长期需求与粗能力只能看排产后负荷。
- **做了什么**：
- `plan.buckets` P0： ；
- `GET /api/plan/buckets` ；视口「分桶计划」；口令「时间分桶」「分桶计划」「混合分桶」
- **验证**： ；
---
## 2026-07-23 — OR-05 预测 / 长周期订单
- **类型**： （
- **背景**：计划层缺独立预测需求台账；销售订单与预测混排会污染正式承诺。
- **做了什么**：
- `forecastOrders` + `forecast.upsert` /`delete`/`convert` P2、`forecast.query` P0；
- RuleEngine `includeForecast` ：
- 订单面板预测视图；口令「查看预测」「新建预测」「预测纳入试排」「预测转正」
- **验证**： ；
---
## 2026-07-23 — AG-08 项目 / 会话服务端化
- **类型**： （
- **背景**：项目/会话/消息只存浏览器 localStorage， ，
- **做了什么**：
- `server/data/projects.json` + `ProjectStore` ；
- `GET/PUT /api/workspace` 、项目/会话/消息 API； `message.*` / `workspace.replace` P1
- 前端启动拉取/本地迁移；防抖同步；消息优先服务端；删项目不碰世界
- **验证**： ；
---
## 2026-07-22 — OR-04 紧急插单专用流
- **类型**： （
- **背景**：急单仅能勾 `isRush` 或走柔性 `flex.rush` ，缺少固定轨「先快评再采用」专用流。
- **做了什么**：
- `rush.evaluate` P1 双沙盒对比（受影响订单/延迟/冲突差分）；主干零接触
- `rush.apply` P2：
- 订单面板插单向导；口令「插单快评」「紧急插单 200件控制器A」「采用插单」；
- **验证**： ；
---
## 2026-07-22 — OR-03 订单池 / 审核 / 变更
- **类型**： （
- **背景**：销售订单无审核态，新建即进排产，缺少业务台账泳道。
- **做了什么**：
- 状态机 DRAFT→SUBMITTED→APPROVED/REJECTED； ；
- `order.submit` P1、`order.approve`/`order.reject` P2； ；
- 订单面板泳道 + 提交/批准/驳回/批量批准；口令「订单池」「提交审核」「批量批准」
- **验证**： ；
---
## 2026-07-22 — SC-04 约束注册表 + 配置中心
- **类型**： （
- **背景**：冲突检测内嵌引擎，无法配置硬/软与启停；发布不区分硬约束。
- **做了什么**：
- `ConstraintDef` 目录 + `constraintProfile` ；版本快照约束配置
- RuleEngine/PoolEngine 读齐套软硬与维保/产能/班组/模具/滚动窗开关
- 发布前硬约束门禁；设置 → 约束配置；口令「关闭物料齐套」「齐套改为硬约束」
- **验证**： ；
---
## 2026-07-22 — OR-02 优先级与客户等级权重配置
- **类型**： （
- **背景**：策略排序只用 `priority` /`deliveryDate`，主管无法配置 VIP 相对权重；设置页无排产参数。
- **做了什么**：
- `scheduleParams.customerLevelWeights` ； ）
- `params.query` P0 / `params.update` P2；
- 设置 → 排产参数滑杆；
- **验证**： ；
---
## 2026-07-22 — AG-07 主动引导（空态 / 冲突 / 知识未命中）
- **类型**： （
- **背景**：欢迎页与空态仍是静态文案；冲突高/知识未命中缺少可点击下一步。
- **做了什么**：
- `build_guidance` + `guidance.next` P0 + `GET /api/guidance`
- 对话 `guidance` 块、欢迎页动态 starter、甘特空态；
- 口令「下一步建议」
- **验证**： ；
---
## 2026-07-22 — EX-06 资源利用率增强（设备热力 + 班组并发）
- **类型**： （ ） （
- **背景**：负荷热力只覆盖固定产线；柔性设备/班组利用率缺独立视口；
- **做了什么**：
- `build_utilization_report` + `GET /api/analytics/utilization` ：
- 视口「利用率」；口令「打开资源利用率」；柔性工作台展示班组清单
- 文档：
- **验证**：
---
## 2026-07-22 — OR-06 订单钉扎（柔性链）+ SC-12 文档对齐
- **类型**： （ ） （ ）
- **背景**：固定轨 `plan.trace` 已有；康尼需 FO→BOM/路线→虚拟产线→工单/设备钉扎；
- **做了什么**：
- `flex_plan_trace` + `plan_trace(track=flex|auto)` ；
- 柔性工作台「钉扎」页；口令「钉扎 FO-2601」「追溯柔性订单」
- implementation-spec：
- **验证**：
---
## 2026-07-22 — EX-07/08 方案对比表 + KPI 仪表盘
- **类型**： （ ）
- **背景**：视口仅有迷你 KPI 卡与方案卡，缺独立仪表盘与逐项 diff 表。
- **做了什么**：
- `build_kpi_dashboard` / `GET /api/analytics/kpi` ：固定+柔性+MES+冲突聚合；
- `build_compare_table` / `GET /api/analytics/compare` ：策略/三模式逐项最优高亮与 delta；
- `query.kpi` / `scenario.compare` / `flex.compare` 联动切换视口
- **验证**： ；
---
## 2026-07-22 — EX-05/09 MES 下发与报工回流（ ）
- **类型**： （
- **背景**： ；
- **做了什么**：
- `MockMesClient` + `mes.dispatch` （ `mes.report` （
- 柔性版本下发后标 `DISPATCHED` ；工序进度与订单整单完工联动
- API： ； ；
- **验证**： ；
---
## 2026-07-22 — MD-05 SAP 集成桩（入站拉单 / 出站回写）
- **类型**： （
- **背景**：康尼验收需 SAP↔APS 双向同步；本期用进程内 Mock，
- **做了什么**：
- `MockSapClient` （ ） `sap_sync` 入站写柔性订单/库存、出站幂等回写
- 意图：`sap.status` P0； ；
- API： ；
- **验证**： ；
---
## 2026-07-22 — EX-04 固定轨甘特拖拽调程
- **类型**： （
- **背景**：柔性甘特已可拖；固定轨仍只读。
- **做了什么**：
- `schedule.adjust.preview` / `commit` ：工位占槽、同 PO 工序先后、维保窗口校验；提交复制 PO/WO 为新草稿
- API：
- **验证**：
---
## 2026-07-22 — EX-04 柔性甘特拖拽调程
- **类型**： （
- **背景**： ；
- **做了什么**：
- `flex.adjust.preview` （ ） ：
- `flex.adjust.commit` （ ） ： ，
- API：
- **验证**： ；
---
## 2026-07-22 — EX-03 冲突解决工作流（建议 + 一键修复）
- **类型**： （
- **背景**：冲突此前只能在排产结果里「看见」，无法按建议修复。
- **做了什么**：
- `conflict.list` / 冲突中心：最新版本未解决冲突 + 按类型的可执行建议
- `flex.conflict.resolve` ：
- API：
- 柔性工作台「冲突」页；对话「查看冲突」「解决冲突」
- **验证**： ；
---
## 2026-07-22 — 故障优先 L1 + EX-10 预测预警 + 实时分钟窗
- **类型**： （
- **背景**：故障一律全量重排过粗；产能池缺短中长期预测；滚动层缺实时分钟精度。
- **做了什么**：
- **DY-01**： ， （ ） ； ；
- **EX-10**：产能分析补 4h/1d/1w 负荷利用率与 ≥85%/95% 预警列表；视口产能池展示预测芯片与告警条
- **SC-12**： （ ） ； ；
- **验证**：相关 golden + 全量；`tsc`
---
## 2026-07-22 — DY-01 真·L1 局部换机 + L2/L3/L4 升 P2 确认卡
- **类型**： （
- **背景**：窗内重排此前直通执行；局部换机此前靠故障缩池整单重排，非真 L1。
- **做了什么**：
- **L1**： `local_swap_equipment` — 池内空闲备机接手，只改目标工单，他单时段与设备不变，不新建版本；口令「局部换机 PRESS-01」； ；
- **L2/L3/L4**： **P2** ；对话与 `POST /api/flex/reschedule` 只出确认卡，批准后 `execute_confirmed` 执行并自动建档
- 柔性工作台分级重排走确认卡 UI
- **验证**： `test_reschedule_is_p2_and_preview` + golden；
---
## 2026-07-22 — 康尼 SC-12 滚动窗 + DY-01 L2/L3 + SC-11 班组约束
- **类型**： （ ）
- **背景**：验收剧本仍缺滚动分窗与窗内重排、班组人力未进引擎。
- **做了什么**：
- **SC-12**： （ ） ，
- **DY-01**： ；
- **SC-11**： `teamCode`
- 柔性工作台增加滚动排产与 L2/L3/L4 按钮；对话「短窗重排」「滚动排产」
- **验证**： ；
---
## 2026-07-22 — 康尼需求 P0 闭环：交期三区间 / 模具寿命 / 故障插单 / 柔性工作台
- **类型**： （ ）
- **背景**：用户要求先完善康尼相关能力；此前引擎有、产品面板与 DY/PL 缺口大。
- **做了什么**：
- **PL-08**：交期承诺补悲观区间 + `gaps` 资源缺口建议；对话块与柔性工作台询价
- **MD-07/SC-10**：排产消耗模具寿命，到限自动 LOCKED；
- **DY-01**：
- **SC-13**：
- **EX-10**：柔性工作台「资源 What-if」停机/调区即时重算产能
- 右侧「柔性工作台」：排产 / 交期 / 异常 / What-if 四页签
- **验证**： ； `tsc`
---
## 2026-07-22 — MD-04 导入管线 + 柔性主数据页 + EX-10 产能池仪表盘
- **类型**： （
- **背景**：
- **做了什么**：
- **MD-04**： `POST /api/import/preview|commit` （ `flex*`
- **MD-08/09**：主数据「柔性资源」页签（设备/模具/工序池/区域只读 + 导入联动）；`master.clear` 增 `flex` 范围
- **EX-10**：视口「产能池」模式 + `PoolCapacityView` （负载色标）；口令 `flex.capacity` 联动切池并刷新
- 订单/主数据面板挂载 `ImportBar` ；黄金测试 `test_importers.py`
- **验证**： `tsc`
---
## 2026-07-22 — 主数据一键清理改为真正清空
- **类型**：
- **背景**：资源页点「一键清理」后工厂/产线仍在——原实现是回种种子，不是清空。
- **做了什么**：
- **验证**：
---
## 2026-07-22 — 订单/主数据一键清理
- **类型**： （ ）
- **背景**：订单与主数据录入后缺少板块级清空，演示/试错不便。
- **做了什么**：
- 订单面板「一键清理」→ `order.clear` ：清空销售订单 + 采购/委外建议（ ）
- 主数据面板「一键清理」→ `master.clear` ：按当前页签（资源/工艺模型/日历维保）回种到种子基线（订单与历史排产不碰）
- 对话口令：「清空全部订单」「清理工艺模型主数据」
- **验证**： `tsc`
---
## 2026-07-22 — 订单删除 + 自然语言新增/批量导入（订单与主数据）
- **类型**： （ ）
- **背景**：订单面板只有取消没有删除；主数据/订单虽可表单维护，但缺少对话侧自然语言新增与批量导入。
- **做了什么**：
- `order.delete` ：物理删除销售订单，同步清该单草稿采购/委外；面板「删除订单」+ 口令「删除订单 SOxxxx」
- `data.import` ：口令「导入订单 / 导入物料」解析多行 CSV 或口语行，
- `master.material.upsert` 对话新建物料；订单 `order.upsert` 继续支持自然语言建单
- 快捷指令与欢迎语补充录数示例；`intake.py` 解析模块
- **验证**： `tsc`
---
## 2026-07-22 — 工艺模型 CRUD 起步（对齐聚制云主数据分层）
- **类型**： （ ）
- **背景**： ，
- **做了什么**：
- `masterdata.py` ：物料新建/全字段/停用； `operations` /`lineProducts`
- 发号器补 material/bom/operation/routing/lineProduct； `master.operation.upsert` / `master.lineProduct.upsert`
- 前端主数据「工艺模型」拆页签：物料 / BOM / 工序 / 工艺路线 / 产线绑定
- 黄金测试 M6：
- **验证**： `tsc`
---
## 2026-07-22 — 对齐聚制云：计划追溯链 + 主数据/排产依据可查
- **类型**： （
- **背景**：对照 `demand/聚制云…操作手册 V1.1` ，当前主数据维护无分层顺序、排产结果无法沿 SO→BOM/路线→采购委外→PO/WO→负荷/库存追溯，用户感知“混乱、找不到依据”。
- **做了什么**：
- 产品文档 `docs/product/master-data-and-plan-chain.md` ：手册主数据分层、计划链、与现状缺口、目标追溯模型
- 后端 `server/aps_domain/trace.py` + `GET /api/plan/trace` + 意图 `plan.trace` ：一单给出主数据依据、分解、排产工单、负荷分钟、库存缺口与缺失项
- 订单面板「追溯」页 + 聊天 `plan-trace` 块；快捷口令「追溯订单依据」
- 知识库补种：主数据录入顺序 / 工艺路线配置 / 订单排产与追溯 / 库存齐套口径 / 柔性轨说明（旧库幂等补齐）
- **验证**：进程内分解+试排后追溯可见 BOM 缺口、工单、产线负荷；`pytest`/tsc 见本轮末
---
## 2026-07-22 — 外围功能补齐（只留核心算法待调）：柔性可视化 / 对话建单 / MRP 下达 / 视口细节
- **类型**： （ ， ）
- **背景**：核心算法（固定产线 RuleEngine、柔性 PoolEngine） ； ， ， ， （
### 批次 A — 柔性排产可视化闭环
- **后端** `server/aps_domain/flex.py` + `server/gateway/app.py` ：新增 `flex_gantt_view` 与 `GET /api/flex/gantt` （行=设备按区域分组，条=柔性工单，含换型/移动/加工分解、瓶颈/超期/冲突标记）
- **前端**： `FlexGanttData` /`fetchFlexGantt`；新增 `viewport/FlexGanttView.tsx` ； ； `WorldData` 扩展 `flexGantt` ，
- **联动**： `viewport.mode=flex` +`world.refresh`，右侧自动切到柔性甘特并 capture 会话结果 —— 解决「柔性排产完了看不到工单」
### 批次 B — 对话/写入闭环
- **order.upsert 对话建单**：
- **text UIBlock**： `TextBlock` 渲染（标题+正文+要点），不再静默丢弃
### 批次 C — MRP 建议单确认下达（ ）
- `mrp.py` ： `apply_mrp_release` （ ，
- `harness` 注册 `mrp.release` =P2； `execute_confirmed` 执行（写前自动建档）；`intent` 加「下达」快路 + LLM 提示
- `POST /api/mrp/release` 出确认卡；`OrderPanel` 分解视图加「确认下达全部/只采购/只委外」按钮与 DRAFT/已下达状态徽标
### 批次 D — 视口细节
- 视口工具栏「时间粒度」徽标改为可点切换（天⇄小时）
- 负荷热力视图响应产线聚焦（`load_view` 行补 `lineCode` ，
- **验证**： `tsc --noEmit` 通过、`vite build` 成功；进程内实测 order.upsert（ ） （ ）
---
## 2026-07-22 — 柔性排产结果可下钻：每条产线给出工单级依据 + 冲突原因
- **类型**： （ ）
- **背景**：用户反馈「排产结果很混乱，要每条结果都有数据可依据」。原 flex-schedule 块只给完工时间与准时/超期标签，看不到时间是怎么算出来的。
- **做了什么**：
- **后端** `server/aps_domain/workflow.py` 的 `_run_flex` ：结果块新增两部分依据——
- 每条虚拟产线携带 `steps` （工单级明细：序/工序/设备+区/模具/换型min/移动min/加工min/起止时段/是否瓶颈）
- 顶层 `conflicts` （
- **前端** `apps/web/src/chat/ChatPanel.tsx` 的 `FlexScheduleBlock` ：行可点击展开，内嵌工单明细表 + 表尾说明「完工时间 = 各工序(换型+移动+加工)沿工艺顺序跨班次累加」；底部列出冲突依据清单
- **样式** `apps/web/src/styles.css` ：新增 `.flex-line-row/.flex-detail/.flex-step-table/.flex-conflicts` 等
- **验证结果**（ ） ： ） ；
- **回归**： （ ） ， （ ）
---
## 2026-07-22 — 柔性演示数据重做：对齐康尼芜湖 4 产品共线场景
- **类型**： （ ）
- **背景**：原柔性种子只有 2 产品（线束/PDU） ，
- **做了什么**（ `_seed_flex` ，忠实吸收 demand §3.2/§3.3/§6.1） ：
- **4 类产品**：高压线束总成 HV-HARNESS、PDU 配电单元 PDU-UNIT、充电枪总成 CHARGE-GUN、高压连接器 HV-CONN
- **10 道工序**，四类瓶颈与方案 §6.1 对齐：压接端子(线束)、激光焊接(PDU·全厂最紧)、控制盒装配ESD(充电枪)、插拔力测试(连接器)
- **22 台设备 / 4 区域**： × × × × × × × × × ×
- **5 副压接模具**家族（代表 50+ 套）、**12 项物料 + 8 条 BOM**（
- **10 张多品种小批量订单**（ ， ）
- 班组扩到 5 个覆盖新工序
- **验证结果**（进程内核对）：跑一版柔性排产 → 10 条虚拟产线 / 56 工单；瓶颈识别 = 压接(4台)·焊接(1台)·ESD(2台)·插拔力(1台)；瓶颈产能法：限制性瓶颈=激光焊接≈88件/天、ESD≈182、插拔力≈228、压接≈1795（
- **同步更新**： （ ；
- **涉及路径**： `tests/golden/test_pool_engine.py`
- **验证**：全量 `pytest` **51 passed** ；
- **注意**：旧 world.json 会被 `ensure_flex_seed` 幂等补种为旧结构——要看新数据需**重启后端并「重置数据」**（或删除持久化 world.json）
- **文档同步**：本文件
---
## 2026-07-22 — 修复：对话气泡样式塌陷 + 柔性回复图文表格化
- **类型**： （ ）
- **背景（缺陷）**：
1. 右侧用户气泡出现「短中文一字一行竖排」——根因是 `.bubble` 的 `word-break: break-all` 遇上 `.msg.user .msg-content` 的 `align-items:flex-end` ，令气泡塌陷到"单字符最小宽度"
2. 左侧柔性排产/瓶颈产能/交期承诺回复**全是纯文字**，可读性差
- **做了什么**：
- `apps/web/src/styles.css` ：修 `.bubble` → `width: fit-content; max-width: 100%; overflow-wrap: break-word; word-break: normal` （ ， ） ； （
- `server/contracts.py` + `apps/web/src/api/types.ts` ： `flex-schedule` / `flex-capacity` / `flex-due`
- `server/aps_domain/workflow.py` ：三个柔性处理分支改为「一句话结论文案 + 结构化 UIBlock」——排产结果给 KPI 指标格 + 虚拟产线表（产品/数量/工序数/完工/交期/准时标签）+ 瓶颈标签；瓶颈产能给各能力池日产能条形图（瓶颈池橙→黄高亮）；交期承诺给乐观/预计双卡
- `apps/web/src/chat/ChatPanel.tsx` ：新增 `FlexScheduleBlock` / `FlexCapacityBlock` / `FlexDueBlock` 三个渲染组件；快捷指令加「跑一版柔性排产 / 瓶颈产能 / PDU 500套什么时候能交」
- **涉及路径**： `apps/web/src/chat/ChatPanel.tsx` · `apps/web/src/api/types.ts` · `server/contracts.py` · `server/aps_domain/workflow.py`
- **验证**： `pytest` **51 passed** ；
- **注意**：需**重启后端** + 前端热更新（或刷新页面）生效
- **文档同步**：本文件
---
## 2026-07-22 — 修复：柔性排产接入对话意图管线（不再降级乱答）
- **类型**：
- **背景（缺陷）**：柔性排产此前只有 `/api/flex/*` REST 接口，**未进意图管线**。用户在对话里说「走一个全流程排产」时，既不命中固定产线 `schedule.run` （其要求"试排/重排/跑一版"动词），就降级到 LLM/知识库，
- **做了什么**：
- `server/contracts.py` ： `flex.schedule` / `flex.capacity` / `flex.simulate_due` （并补登此前遗漏的 `order.decompose` ，修掉其经对话触发时的契约校验隐患）
- `server/agent_core/intent.py` ：一级规则快路新增柔性触发词——柔性/能力池/虚拟产线/多品种小批量/全流程排产，以及方向词 正排(ASC)/倒排(DESC)/瓶颈锚(BOTTLENECK)（方向词在本系统仅 PoolEngine 实现，故归柔性）；交期问句（何时/多久能交 + 产品 + 数量）→ `flex.simulate_due` 并抽出 `productCode` /`quantity`；同步补 LLM 意图枚举
- `server/aps_domain/workflow.py` ：新增 `flex.schedule` （回执版本/虚拟产线/瓶颈/准时率/各单完工）、`flex.capacity`（瓶颈产能法各池日产能 + 限制性瓶颈）、`flex.simulate_due`（乐观/预计完工）三个处理分支与文案；`_HELP` 增列柔性口令
- `server/state/seed.py` ：新增幂等 `ensure_flex_seed()` ；柔性领域服务在读写前调用，**旧 world.json（
- `server/agent_core/harness.py` ：登记 `flex.capacity` /`flex.simulate_due` 为 P0（ ）
- **涉及路径**： `server/agent_core/intent.py` · `server/aps_domain/workflow.py` · `server/aps_domain/flex.py` · `server/state/seed.py` · `server/agent_core/harness.py` · `tests/golden/test_pool_engine.py`
- **验证**：新增意图路由护栏 F12（ `pytest` **51 passed** ；
- **注意**：需**重启后端**加载新代码；旧世界首次触发柔性口令会自动补种（无需 `重置数据` ）
- **文档同步**：本文件
---
## 2026-07-22 — 柔性排产全流程操作手册 + 自然语言流程描述
- **类型**：
- **做了什么**：
- 新增 [`docs/product/flex-simulation-guide.md` ](./product/flex-simulation-guide.md )：第一部分「自然语言全流程描述」（设备虚拟化→能力池→虚拟产线→瓶颈产能→交期承诺→动态重排，用大白话讲一遍）；第二部分走法 A 一键脚本；第三部分走法 B 逐接口（ `Invoke-RestMethod` 示例 + 端点速查）；第四部分走法 C 换真实数据；第五部分验收清单 + 常见问题
- 在 `docs/product/README.md` 与大管家 `docs/README.md` 导航登记本手册与数据采集模板
- **涉及路径**： `docs/product/README.md` · `docs/README.md` · 本文件
- **验证**：文档交叉引用自检；命令与端点签名对照 `server/gateway/app.py` / `scripts/flex_simulation.py` ；未改运行代码
- **文档同步**： `docs/README.md` · 本文件
---
## 2026-07-22 — 柔性排产全流程模拟 + 瓶颈产能法 + 三模式差异化
- **类型**：
- **做了什么**：
- 新增端到端模拟脚本 `scripts/flex_simulation.py` ：一次跑通「主数据/产能池 → 瓶颈锚排产+虚拟产线甘特 → 瓶颈产能评估 → 正/倒/瓶颈锚三模式对比 → 交期承诺(PDU 500套) → 动态重排(紧急插单 / 设备故障)」全链路，全中文可读输出
- 新增 `capacity_analysis` （瓶颈产能法 PL-07） `GET /api/flex/capacity` ：按能力池算日产能=池可用工时÷单件工时，标出限制性瓶颈（本演示=单机激光焊接池 88件/天，对照台账法压接池虚高 1920件/天）
- 修 `PoolEngine` 倒排（ ） ： ， （ ； ）
- `PoolEngine` 结果新增 `makespan` （最晚完工）与 `onTimeCount` （准时单数）
- 动态调度双案例：可移动压接机故障（池化韧性、日产能 1795→1344 仍有冗余） ，
- **涉及路径**： `server/engines/pool_engine.py` · `server/aps_domain/flex.py` · `server/gateway/app.py` · `tests/golden/test_pool_engine.py` · `docs/**`
- **验证**： **48 passed** （原 46 + 新 F10/F11） ；
- **文档同步**： （ ） `product/implementation-spec.md` · `architecture/harness.md` （
- **遗留**：前端虚拟产线甘特 + 产能池仪表盘（ ） ； （ ） （ ， ）
---
## 2026-07-22 — 柔性排产首切片：设备能力池 + 虚拟产线（ ）
- **类型**：
- **做了什么**：
- 新增柔性排产引擎 `server/engines/pool_engine.py` （ ， ） ： （ ； **ASC 正排 / DESC 倒排 / BOTTLENECK 瓶颈锚** 三模式（吸收 `排产逻辑.ppt` ）
- 种子追加 `flex*` 数据（`server/state/seed.py` 的 `_seed_flex` ） ： × `HV-HARNESS` /`PDU-UNIT` 及工艺/BOM/订单/参数；与固定产线层**并行独立键**，不进 RULE 引擎与既有计数
- 新增领域服务 `server/aps_domain/flex.py` ：能力池投影 `capability_pools` 、`flex_overview`、`run_flex_schedule`（ `harness.guard` +审计）、`simulate_due`（交期承诺模拟雏形，深拷贝沙盒）
- 端点：`GET /api/flex/world` · `POST /api/flex/schedule` · `POST /api/flex/simulate-due` ； `flex.schedule` P1
- 产出数据采集模板 `docs/product/demand-data-intake.md` （ ）
- 黄金测试 `tests/golden/test_pool_engine.py` （ – ：
- **涉及路径**： `server/engines/__init__.py` · `server/aps_domain/flex.py` · `server/state/seed.py` · `server/state/store.py` · `server/agent_core/harness.py` · `server/gateway/app.py` · `tests/golden/test_pool_engine.py` · `docs/**`
- **验证**： **46 passed** （原 37 + 新 9， ）
- **文档同步**： （ ） `product/implementation-spec.md` · `product/demand-data-intake.md` · `architecture/harness.md` · `architecture/modules.md` · 本文件
- **遗留**：前端虚拟产线甘特 + 产能池仪表盘（ ） ； （ ） ； （ ） ； ； （
---
## 2026-07-22 — 吸收 demand/ 真实需求进产品文档
- **类型**：
- **做了什么**：
- 解析 `demand/` ： （ ） （
- 新增 `docs/product/demand-kangni-wuhu.md` ：抽象为行业无关能力，并与现有编号映射；明确非绑定客户工厂
- `features.md` 登记 MD-08/09、SC-12~14、PL-07/08、EX-10、DY-01、IND-03；
- 同步 `implementation-spec` 编号总表、`positioning` 需求输入声明、product/大管家索引；`.gitignore` 忽略本地提取目录
- **涉及路径**： `docs/product/features.md` · `docs/product/implementation-spec.md` · `docs/product/positioning.md` · `docs/product/README.md` · `docs/README.md` · `docs/product/aps-benchmark-siemens.md` · `.gitignore`
- **验证**：文档交叉引用自检；未改运行代码
- **文档同步**：
- **遗留**：新编号落地规格卡随 M4/M5 开工补齐；柔性场景种子数据与引擎实现另开切片
---
2026-07-21 11:05:57 +08:00
## 2026-07-16 — 订单分解 MRP 首切片 + BOM/工艺路线可维护（对标西门子）
- **类型**：
- **做了什么**：
- 新增 MRP 领域服务 `server/aps_domain/mrp.py` ：订单按 BOM/工艺路线分解为 自制（进排产）/ **采购建议** （净需求=毛需求−库存−在途，建议下单日按采购前置期倒排）/ **委外建议** （ `purchaseOrders` /`outsourceOrders` DRAFT 建议表，重复分解幂等替换
- `order.decompose` 登记 P1； `POST /api/mrp/decompose` ；对话口令「分解订单 SOxxx / 生成采购建议 / MRP」走同一动作
- MD-02 深化：新增 `master.bom.upsert` （明细用量/关键料）与 `master.routing.upsert` （准备/单件时间/外协标记）两个 P2 动作；主数据面板选中成品后可直接编辑 BOM 与工艺步骤
- 订单面板新增「分解建议」视图与「分解此单」按钮，展示采购/委外建议（含来源订单、建议下单日、前置期）
- 黄金测试 `tests/golden/test_mrp.py` ：缺料出采购建议+前置期倒排、充足物料零建议、外协往返、指定订单幂等、BOM 用量联动
- **涉及路径**： `server/aps_domain/masterdata.py` · `server/aps_domain/workflow.py` · `server/agent_core/harness.py` · `server/agent_core/intent.py` · `server/gateway/app.py` · `server/state/seed.py` · `server/state/store.py` · `apps/web/src/orders/OrderPanel.tsx` · `apps/web/src/master/MasterPanel.tsx` · `apps/web/src/api/*` · `tests/golden/test_mrp.py` · `docs/**`
- **验证**： **37 passed** ；
- **文档同步**： （ ） `product/journeys.md` （旅程 A4） `product/implementation-spec.md` · `product/aps-benchmark-siemens.md` · `architecture/harness.md` · `architecture/modules.md` · 本文件
- **遗留**：建议单确认下达（转正式采购/委外， ）
---
## 2026-07-16 — MD-01/02/03 主数据维护模块首切片
- **类型**：
- **做了什么**：
- 新增主数据领域服务 `server/aps_domain/masterdata.py` ：资源树/物料BOM/日历维保只读投影 + `master.line.upsert` （产线编辑停启用）/ `master.material.upsert` （库存在途安全库存）/ `master.maintenance.upsert` （维保新增取消）三个 P2 写动作
- 新增 `GET /api/master` 与 `POST /api/master/stage` ；页面只暂存确认卡，批准统一走 `/api/actions/confirm` ，写前自动 Checkpoint + 审计链
- 引擎联动修复：`find_product_lines` / `find_workstation_for_operation` 补 ACTIVE 过滤（停用资源不进新排产）；维保冲突检测忽略 CANCELLED 窗口
- 前端新增主数据面板 `MasterPanel` （资源/物料与BOM/日历与维保三页签），侧栏与右侧工具栏、命令面板均可进入
- `WorldStore` 发号器支持 maintenance 表
- 黄金测试 `tests/golden/test_master_data.py` ：停用产线排除、库存调零缺料增加、维保窗口冲突往返、确认卡校验、审计链完整
- **涉及路径**： `server/gateway/app.py` · `server/aps_domain/workflow.py` · `server/agent_core/harness.py` · `server/engines/queries.py` · `server/engines/rule_engine.py` · `server/state/store.py` · `apps/web/src/master/MasterPanel.tsx` · `apps/web/src/App.tsx` · `apps/web/src/projects/ProjectPanel.tsx` · `apps/web/src/api/*` · `tests/golden/test_master_data.py` · `docs/**`
- **验证**： **33 passed** ；
- **文档同步**： `product/journeys.md` （旅程 A3） `product/implementation-spec.md` · `architecture/harness.md` · `architecture/modules.md` · 本文件
- **遗留**：工位/设备编辑、BOM/工艺路线版本发布、周日历模板、Excel 导入（ ） ； （ ）
---
## 2026-07-16 — 对标西门子 Opcenter APS 完善产品功能清单
- **类型**：
- **做了什么**：
- 新增 `docs/product/aps-benchmark-siemens.md` ：以西门子 Opcenter APS（ ）
- `features.md` 扩充：新增「计划层 Advanced Planning」章节（ ） （ ） ， ×
- `implementation-spec.md` 编号总表同步新增 25 个功能编号
- 更新 product 索引与大管家导航
- **涉及路径**： `docs/product/features.md` · `docs/product/implementation-spec.md` · `docs/product/README.md` · `docs/README.md`
- **验证**：文档编号一致性自检；未改运行代码
- **文档同步**： `docs/README.md` · 本文件
- **遗留**： （ ） ；
---
## 2026-07-16 — Codex 式工作台布局与会话节点导航
- **类型**：
- **做了什么**：
- 将左侧从图标轨/项目面板改为 Codex 桌面端式工作区侧栏：快捷入口、项目列表、当前项目任务、底部设置
- 去掉顶栏重复项目/任务标题，中央区域回归沉浸式对话；无结果数据时对话区铺满主工作区
- 订单管理、检查点/版本、会话结果收敛到右侧工具入口，结果视图按当前会话快照展示
- 新增会话节点导航：对话区最右侧生成消息节点，悬停显示节点摘要，点击滚动到对应消息
- 修复上一版左侧新结构缺少样式导致原生控件裸露的问题
- 修复右侧工具展开后的大面积空白：右侧工作区改为吃满剩余空间，竖向工具栏固定贴最右侧
- **涉及路径**： `apps/web/src/projects/ProjectPanel.tsx` · `apps/web/src/chat/ChatPanel.tsx` · `apps/web/src/styles.css`
- **验证**： **28 passed**
- **文档同步**：本文件
- **遗留**：左侧快捷入口后续可继续绑定真实“知识库管理”页面；当前先复用设置/集成入口
---
## 2026-07-16 — 首屏引导与操作口径专业化
- **类型**：
- **做了什么**：
- 将对话首屏从口号式说明改为“排产工作流 / 方案评估 / 版本治理 / 视图分析”的业务化引导
- 快捷指令与命令面板改为计划员工作台口径，
- 甘特空态、时间线空态、后端帮助和无版本提示统一为专业表达
- 增加旧欢迎语本地缓存迁移，命中“左边说，右边动”时自动替换新版欢迎语，不清空其他消息
- **涉及路径**： `apps/web/src/App.tsx` · `apps/web/src/viewport/GanttView.tsx` · `apps/web/src/timeline/TimelineRail.tsx` · `server/aps_domain/workflow.py` · `server/aps_domain/reports.py`
- **验证**： **28 passed**
- **文档同步**：本文件
- **遗留**：项目/任务默认名称后续可随真实项目模板继续行业化
---
## 2026-07-16 — OR-01 订单管理首切片 + 审计契约修复
- **类型**：
- **做了什么**：
- 新增订单领域服务：订单只读投影、成品校验、`order.upsert/cancel/complete` P2 写入逻辑
- 新增 `GET /api/orders` 与 `POST /api/orders/stage` ，订单页面只暂存确认卡，批准仍统一走 `/api/actions/confirm`
- 前端新增订单管理面板：列表、编辑表单、新建/编辑/取消/完成、内嵌确认卡与批准/驳回
- 修复审计事件时间契约：新增 `at` ，保留 `ts` ，治理页与旧数据兼容
- 黄金测试新增 OR-01 覆盖：新增订单进入排产、取消订单排除、确认卡摘要、审计双字段
- 同步门禁矩阵、模块登记、产品状态、业务旅程与落地规格
- **涉及路径**： `server/aps_domain/workflow.py` · `server/gateway/app.py` · `server/agent_core/audit.py` · `apps/web/src/orders/OrderPanel.tsx` · `apps/web/src/App.tsx` · `apps/web/src/api/*` · `tests/golden/test_order_management.py` · `docs/**`
- **验证**： **28 passed** ；
- **文档同步**： `product/journeys.md` · `product/implementation-spec.md` · `architecture/harness.md` · `architecture/modules.md` · 本文件
- **遗留**： ；
---
## 2026-07-16 — 产品功能落地规格补全
- **类型**：
- **做了什么**：
- 新增 `docs/product/implementation-spec.md` ，按主数据、订单、排产、执行、对话治理拆出功能落地卡
- 为每个功能点补充用户目标、最小切片、权力等级、数据对象、API/动作、UI、验收与测试要求
- 在 `features.md` 增加落地规格编号，覆盖当前可演示能力、主数据、订单、排产引擎、结果执行、对话治理
- 更新 product 索引和大管家导航，产品评审可从功能清单跳到落地规格
- **涉及路径**： `docs/product/features.md` · `docs/product/README.md` · `docs/README.md`
- **验证**：文档链接与编号自检；未改运行代码，未跑业务测试
- **文档同步**： `docs/README.md` · 本文件
- **遗留**：后续实现任一功能时仍需同步 `journeys.md` 、`harness.md` 或 `algorithm/*` 的对应落地细节
---
## 2026-07-16 — 文档体系重组（大管家 + 分类落地）
- **类型**：
- **做了什么**：
- 建立 `docs/README.md` 大管家入口与活文档铁律
- 按角色拆分：`product/` · `architecture/` · `algorithm/`
- `PROGRESS.md` → `CHANGELOG.md` ；
- 种子工厂名改为「演示工厂」（去地域硬编码，与产品通用定位一致）
- **涉及路径**： `plan.md` §12.9 · `README.md` · `server/state/seed.py`
- **验证**：文档结构自检；种子仅改展示名，不影响黄金测试键结构
- **文档同步**：本文件 · product/* · architecture/* · algorithm/* · 大管家
- **遗留**： `docs/algorithm/` 与 `product/features.md` 的状态列为准
---
## 2026-07-16 — 产品化整改：缺陷修复 + 设置收敛 + 通用化
- **类型**：
- **做了什么**：
- 修复右侧无数据：`/api/gov/tests?run=true` 改为 `asyncio.to_thread` ；前端 `refreshWorld` 逐端点兜底 + 3s 重试
- 导航收敛：轨道仅 项目/对话/时间线/设置；门禁与重生并入设置
- 前端种子项目改「演示项目（示例数据）」；顶栏「智能排产 · 通用行业版」
- 产出功能清单（后迁入 `product/features.md` ）
- **涉及路径**： `apps/web/src/**` · `docs/`
- **验证**：后端多端点 200；
- **遗留**：订单/主数据管理页等见 `product/features.md` 差距清单
---
## 2026-07-16 — plan.md 深水区五问补全
- **类型**：
- **做了什么**：
- **涉及路径**：
- **验证**：章节编号连贯
- **遗留**：落地以 `algorithm/scheduling-v1.md` 为准；蓝图能力标 🔜
---
## 2026-07-16 — UI 对标 Codex 操作
- **类型**：
- **做了什么**：
- **涉及路径**： `apps/web/src/chat/**` · `apps/web/src/shell/**`
- **验证**：
- **遗留**：任务状态仍前端固定「运行中」
---
## 2026-07-16 — M3 知识与偏好
- **类型**：
- **做了什么**：知识资产库 + bigram 检索带出处；日报/版本对比报告；偏好加权缺省策略；意图与前端 evidence/report 块
- **涉及路径**： `server/aps_domain/reports.py` · `apps/web/**` · `tests/golden/test_m3_knowledge.py`
- **验证**： **24 passed** ； ；
- **遗留**：真向量 RAG、会话树服务端化、上下文四层管理
---
## 2026-07-16 — M2.5 Codex 级产品表面 + 文档体系初建
- **类型**：
- **做了什么**：
- **验证**：黄金测试全绿；`npm run build`
- **遗留**：权力矩阵在线编辑 🔜 M4
---
## 2026-07-16 — M2 前端补完（项目制 + 折叠 + 分隔条）
- **类型**：
- **做了什么**：项目/任务/文件、折叠轨、分隔条、时间线回滚口令
- **验证**：当时黄金测试 15/15；
- **遗留**：项目数据仍在浏览器 localStorage
---
## 2026-07-15~16 — M2 后端（成对状态 + 沙盒 + 时间线）
- **类型**：
- **做了什么**：
- **验证**：
---
## 2026-07-15 — M0 + M1（
- **类型**：
- **做了什么**：
- **验证**：当时 11/11；
---
## 更早 — M-POC
- **类型**：
- **做了什么**：
