WP08:内容助手参数贯通
状态:完成(2026-10-17)。阶段:M0。主责:Backend / AI 工具。 上层工作项:B05(AI);详见模块计划。本包是该工作项的实施拆分,不是另一份配置契约。
前置与输入
前置完成:WP03、WP04、WP07。 字段与行为以统一契约为准;所有依赖编号见执行清单。
修改范围与交付
- 修改范围:检查并调整现有项目/路由写工具的白名单、参数、序列化、指南及返回摘要;从 tool_specs.py 派生披露。
- 交付物:现有内容助手能通过受控业务接口保存放映参数的工具说明和实现。
- 提交边界:不新增远程浏览器控制工具,不在工具实现绕过 DTO 直接写数据库。
完成标准
- [x] 实现及评审覆盖上述修改范围,未超出提交边界。
- [x] 行为验收:工具与 HTTP 对同输入同结果;继承/null 不丢失;未实现的模式不披露;参数失败不会部分落库。
- [x] 验证范围:工具规格/披露防漂移、业务服务复用和权限测试。
- [x] 关联验收:A03、A05;见联调与验收计划。
- [x] 记录代码版本、实际测试命令/结果、未运行项及原因,产物保存到任务专属临时目录。
- [x] 回填本卡状态与证据;阶段能力是否开放由对应阶段出口包决定,单包完成不等于整阶段交付。
建议提交标题:WP08:内容助手参数贯通。通常按一个可评审 PR 实施;若实际改动仍过大,先按输入/输出再拆子包,保留父编号和依赖。
测试环境与命令选择遵循 dev-start-test,不因执行本卡重复启动服务或重置开发数据。
实施记录
- 交付代码:
ProjectCreatePayload.slideshow(可选完整对象);新增ProjectSlideshowPayload与project.update.slideshowaction,复用ProjectUpdateRequest/ProjectCreateRequest校验与落库;update_entityaction 枚举同步扩展。 - 工具规格:
tool_specs.py新增放映操作手册(范围、完整对象、media_end未开放、只影响默认值),项目创建手册补充省略默认值说明;路由树手册说明逐页覆盖省略/null 语义。规格由tool_specs.py单点派生,未另建清单。 - 不披露:guide Schema 中
advance.mode只有 manual/timer,media_end不出现;非法模式在工具参数校验阶段转AI_OPERATION_ARGUMENTS_INVALID,不会部分落库。 - 验证:
pytest tests/integration/ai/test_ai_generic_business_tools.py→ 11 passed(含工具写入、非法 media_end 不落库、创建透传);pytest tests/unit/test_generic_business_tools.py tests/unit/test_unified_tool_specs.py→ 24 passed(动作集合与 Schema 防漂移)。 - 未运行:真实模型会话端到端(工具层与 HTTP 服务复用已覆盖)。