aps-agent/docs/development/scheduling-entry-plan.md

33 lines
3.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 分析后排产入口修复
用户已授权继续 goal、多 agent 协作、禁止硬编码,并要求测试成功后交付。本轮只闭合分析后的排产入口及其实际执行链路。原工作区所有既有改动已快照到基线,原始资料和用户服务受保护。
## 分工与验收
- consume:自然语言指令路由,范围 server/agent_core/intent.py、server/pi* 中入口路由相关文件及对应新回归。立即排产、手动触发排产等明确命令须进入现有排产动作;询问、否定与发布必须保留原语义。
- intake:apps/web/src/chat 相关组件及独立前端回归。分析完成后提供明确的排产入口,四类解析数据可查看,刷新后仍能操作,继续使用现有聊天工作流及确认机制。
- master:独立只读审查与补充端到端验证方案,检查错误拒绝、空方案、历史消息和重复操作,不修改生产代码。
- root:server/aps_domain/workflow.py 及相关分析响应,明确结构化下一步动作;集成、自有端口运行、真实 Excel 浏览器验证、交付核对。
## 实施与验证
依赖顺序:基线核对 → 并行入口修复与 UI 实现 → 集成 → 真实资料导入、核对、立即排产与按钮两种触发 → 回归与构建 → 文件基线复核后交付原工作区。
每次修改已有符号前执行 GitNexus impact。工作分支提交前 detect_changes。Python 使用原仓库 .venv;前端复用原仓库 node_modules。资料源由测试环境显式配置,不在生产逻辑写入客户名称、文件路径、数量或日期。验证包含后端聚焦 pytest、前端渲染检查、TypeScript/Web build,以及隔离端口浏览器完整流程。发现真实资料不足时必须说明具体缺项,不能把空工单当排产成功。
原工作区 main 不提交、不推送、不进行分支合并;测试通过后仅复制本轮已验证文件,并保护同时发生的其他改动。测试服务只停止本轮创建的进程,保留既有验收临时目录。
PLAN AUDIT: PASS。范围明确、互不重叠,root 统一处理跨层动作契约,验证可用本地运行时和显式真实资料完成。
## 实测发现后的必要修复
真实浏览器发现新项目创建后过早关闭弹窗,会话切换吞掉刚选附件;确认完成后的即时刷新也可能恢复未处理卡。追加 ProjectPanel/AppDialog 的异步创建与失败重试、ChatPanel 的会话就绪与读取失败保护、projects/store 的按会话保存队列,覆盖延迟请求、重试不重复建档、历史失败不写空消息。
手机全流程还发现,单纯分析资料后的世界数据刷新会重新弹出旧方案,遮住资料卡与排产入口。App 的结果快照更新改为保留用户已关闭的面板状态,明确的查看和排产视口指令仍可打开方案。
这些修复均由独立审查与实测失败定位;验证补充严格限定测试环境,生产代码不增加人员、库存、订单或工时。
## 后续变更(2026-09-13)
传统意图识别入口已整体下线:`server/agent_core/intent.py`、`dialog.py`、`assistant.py` 均已删除,自然语言统一由 Pi Agent 的结构化工具调用路由(参数契约登记在 `server/agent_core/fallback_lane.py`)。本文第 7 行把 `intent.py` 写成路由范围的描述,是该轮方案的历史记录,现由 Pi 工具目录 + 确定性门禁替代。