f60cebadb8
- 完善管家意图识别、模型计划构建与规划器调度 - 重构差旅报销提交编排器与管家计划流程前端交互 - 优化报销消息项样式与文档中心视图 - 新增小财管家与附件上传风险前置复核设计文档 - 补充管家规划器与文档中心测试覆盖
9.8 KiB
9.8 KiB
小财管家 TODO
阶段一：调研与契约
- 盘点首页输入框、工作台弹窗、会话路由和本体字段注册表。[CONCEPT: 背景与问题] 证据：已确认
PersonalWorkbench.vue、useAppShell.js、TravelReimbursementCreateView.vue、ontology_field_registry.py。 - 定义第一版只覆盖申请助手和报销助手，不引入 LangChain，但外层意图识别使用大模型 function calling。[CONCEPT: 目标与非目标] 证据：
CONCEPT.md已明确 MVP 边界和 function calling 主链路。 - 明确小财管家业务字段必须走 ontology canonical fields，编排字段不得进入业务本体。[CONCEPT: 本体字段约束] 证据：
CONCEPT.md已列出 canonical 字段与编排态字段。
阶段二：后端规划服务
- 新增
schemas/steward.py，定义计划请求、任务、附件归集、确认动作和响应模型。[CONCEPT: 后端] 证据：StewardPlanRequest、StewardTask、StewardAttachmentGroup、StewardConfirmationAction已新增。 - 扩展
services/runtime_chat.py，支持 OpenAI-compatible / Azure OpenAI 的tools与tool_choicefunction calling。[CONCEPT: 后端] 证据：新增complete_with_tool_call、RuntimeChatToolCall和工具调用解析。 - 新增
services/steward_intent_agent.py，定义submit_steward_intent_planfunction schema 并调用系统主/备模型。[CONCEPT: 任务识别与拆分] 证据：模型调用入口已从StewardPlannerService注入。 - 新增
services/steward_model_plan_builder.py，将模型工具参数转换为服务端可校验计划。[CONCEPT: 后端] 证据：模型返回后仍会校验任务类型、canonical 字段和附件名。 - 改造
services/steward_planner.py，实现大模型 function calling 优先、规则规划兜底。[CONCEPT: 任务识别与拆分] 证据：planning_source区分llm_function_call与rule_fallback。 - 新增
api/v1/endpoints/steward.py，提供POST /steward/plans。[CONCEPT: 后端] 证据：容器内接口 smoke 返回task_count=3。 - 新增
POST /steward/plans/stream，以 NDJSON 返回thinking和最终plan事件。[CONCEPT: 流式过程摘要] 证据：真实接口 smoke 返回事件序列thinking,thinking,thinking,thinking,plan。 - 调整
POST /steward/plans/stream，确保模型 function calling 完成前先返回首个thinking事件。[CONCEPT: 流式过程摘要] 证据：live smoke 首个事件为thinking/stream_start。 - 在
api/v1/router.py注册小财管家接口。[CONCEPT: 后端] 证据：运行中/api/v1/steward/plans返回 200。 - 保证所有输出到
ontology_fields的业务字段只使用 canonical ontology fields。[CONCEPT: 本体字段约束] 证据：测试断言occurred_date、transport_type、reason_value不进入输出字段。 - 强化模型提示词和规则兜底，确保“未来出差/去某地几天/部署支撑”即使未出现“申请”也识别为费用申请。[CONCEPT: 任务识别与拆分] 证据：live smoke 将“明天出差北京3天...”拆为
expense_application,reimbursement。
阶段三：前端入口和弹窗
- 将首页输入区主文案调整为“小财管家”，提示语体现可处理多任务。[CONCEPT: 前端] 证据：
PersonalWorkbench.vue标题和 placeholder 已更新。 - 增加
steward会话类型，首页复杂输入默认进入小财管家模式。[CONCEPT: 前端] 证据：SESSION_TYPE_STEWARD与首页sessionType已接入。 - 小财管家模式下隐藏“智能体切换”工具条。[CONCEPT: 前端] 证据：
shortcuts在isStewardSession下返回空数组。 - 小财管家模式下标题显示“小财管家”，副标题说明“统一财务任务编排入口”。[CONCEPT: 前端] 证据：
assistantHeaderTitle和assistantHeaderDescription已按 steward 分支处理。 - 小财管家模式下不展示欢迎界面。[CONCEPT: 前端] 证据：
useTravelReimbursementSessionState.js对 steward 空会话返回空消息，并过滤旧欢迎消息快照。 - 小财管家模式下使用专属底部输入框，不展示日期选择、差旅计算器和业务时间标签。[CONCEPT: 前端] 证据：
TravelReimbursementCreateView.vue按isStewardSession渲染steward-composer-row。 - 新增前端小财管家计划服务，调用
POST /steward/plans。[CONCEPT: 后端] 证据：web/src/services/steward.js已新增fetchStewardPlan。 - 新增小财管家视图模型，生成过程摘要、任务计划卡片和附件归集卡片。[CONCEPT: 流式过程摘要] 证据：
stewardPlanModel.js和TravelReimbursementMessageItem.vue已接入stewardPlan。 - 支持后端
thinking事件真流式呈现为折叠式意图识别气泡。[CONCEPT: 流式过程摘要] 证据：useStewardPlanFlow.js通过fetchStewardPlanStream接收 thinking 事件，并用typeStewardThinkingEvent将每条过程摘要逐字输出到折叠气泡。 - 支持小财管家最终正文逐字流式输出，正文完成前不展示确认按钮。[CONCEPT: 流式过程摘要] 证据：
useStewardPlanFlow.js新增typeStewardPlanText，计划完成后进入typing状态逐字追加正文，完成后再注入suggestedActions。 - 意图识别过程放在系统回复气泡上方，作为不同颜色的独立折叠气泡，完成后默认折叠。[CONCEPT: 流式过程摘要] 证据：
TravelReimbursementMessageItem.vue将steward-intent-bubble放在message-bubble上方，steward-plan-block只渲染任务和附件结果。 - 统一小财管家思考折叠气泡与正文气泡宽度，避免思考气泡长于正文框。[CONCEPT: 流式过程摘要] 证据：
has-steward-plan消息栈统一为 760px，思考气泡和正文气泡同宽。 - 优化小财管家最终正文和任务卡片层次，用户可见内容不直接展示本体字段名。[CONCEPT: 用户可见结果展示] 证据：
stewardPlanModel.js第一屏使用 Markdown 标题、段落和顺序列表说明“先做什么、后做什么、交给哪个助手做什么”，但不展示置信度和字段缺口；useStewardPlanFlow.js将第一屏标记为initialSummaryOnly，TravelReimbursementMessageItem.vue不再渲染第一屏任务详情卡片；后续步骤如需展示待补充项，再按独立列表行展示业务名称和填写说明。
阶段四：确认与分派
- 为每个创建/绑定/提交类动作生成确认按钮，不确认不执行。[CONCEPT: 用户确认] 证据：接口返回
confirmation_count=4，前端转为 suggested actions。 - 将小财管家确认区改为“只展示当前下一步主动作”，存在申请任务时优先进入申请助手。[CONCEPT: 用户确认] 证据：
buildStewardSuggestedActions只返回下一步动作，优先confirm_create_application。 - 支持用户输入“确定”触发小财管家的下一步动作，而不是重新生成计划。[CONCEPT: 用户确认] 证据：
useStewardPlanFlow会查找待确认的小财管家动作并执行。 - 支持小财管家隐藏委派申请/报销能力，执行后保留小财管家会话并继续引导剩余任务。[CONCEPT: 执行流] 证据：
sessionTypeOverride和stewardContinuation已接入前端提交流程。 - 支持小财管家确认后的隐式委派继续流式输出，正文完成后再展示申请核对表、报销核对卡片和确认按钮。[CONCEPT: 流式过程摘要] 证据：
useTravelReimbursementSubmitComposer.js新增typeStewardDelegatedMessage，申请预览与 orchestrator 结果均先流式思考、再逐字正文、最后挂载结构化 payload；npm.cmd --prefix web run build成功。 - 小财管家委派申请/报销能力期间不打开右侧单助手执行流程面板，用户可见身份保持“小财管家”。[CONCEPT: 流式过程摘要] 证据：
stewardDelegated分支跳过 flow step 与 review panel scope，并在最终消息设置assistantName: '小财管家'；stewardPlanModel.js助手标签兜底不再显示“财务助手”。 - 确认申请任务后，将任务摘要分派到现有申请助手会话。[CONCEPT: 执行流] 证据：确认动作携带
session_type=application和auto_submit=true。 - 确认报销任务后，将任务摘要和附件带入现有报销助手会话。[CONCEPT: 执行流] 证据：确认动作携带
session_type=expense、carry_files=true和auto_submit=true。 - 附件归集建议确认后，将选中附件作为报销助手上下文继续处理。[CONCEPT: 附件归集] 证据：附件归集确认动作携带归集附件名称和排除附件名称。
阶段五：测试与验证
- 新增
server/tests/test_steward_planner.py，覆盖多任务拆解、相对日期、附件归集、确认动作和流式事件。[CONCEPT: 测试方案] 证据：新增 4 个后端定向测试。 - 补充 function calling 定向测试，覆盖模型工具参数、canonical 字段清洗、附件归集和规则兜底。[CONCEPT: 后端单元测试] 证据：
test_steward_planner.py新增 fake function calling 路径，test_runtime_chat_service.py新增 tools payload 用例。 - 后端测试在 Docker
x-financial-main:/app内执行，超时控制在 60s 内。[CONCEPT: 容器验证] 证据：pytest -q server/tests/test_steward_planner.py server/tests/test_runtime_chat_service.py结果13 passed。 - 新增或更新前端定向测试，覆盖小财管家标题、隐藏智能体切换和计划展示。[CONCEPT: 前端测试]
- 运行前端构建或定向测试，确认 UI 编译通过。[CONCEPT: 测试方案] 证据：
npm.cmd run build成功。 - 通过接口或页面可见结果证明用户最终看到小财管家计划和确认点。[CONCEPT: 指标与验收] 证据：容器接口返回 3 个任务、3 份归集附件、1 份排除附件和 4 个确认动作。