Codex/p3 增加转换器可用性增强设计

[abella02333]

变更摘要

• 为 P3 需规转软设 Dify 转换器增加 readiness 状态。
• 在 /api/software-design-v2/converters 返回默认转换器可用性。
• 新建 P3 软设会话时写入 conversion.converter.readiness。
• 缺少 Dify API Key 时，后端在 conversion 执行前阻断，并记录 conversion_failed。
• P3 Design Lab 展示转换器就绪状态，缺配置时禁用“执行基础转换”。
• 补充后端、前端测试及 3 份正式交付文档。

验证

• uv run pytest apps/api/tests/test_platform_exchange_p2_p3_api.py apps/api/tests/test_design_converter_plugins.py apps/api/tests/test_stage_artifacts_api.py apps/api/tests/test_workspace_layouts_api.py apps/api/tests/test_software_design_v2_api.py -q

  • 44 passed, 5 warnings

• pnpm --dir apps/web exec vitest run src/test/P3DesignLabPage.test.tsx src/test/DesignMorphCanvasPlatform.test.tsx src/test/P3DesignLabWorkbenchAdapter.test.ts src/test/P3DesignMorphModel.test.ts

  • 4 passed test files
  • 54 passed tests

• git diff --check

  • 通过

文档

• DOC/CODEX_DOC/02_设计说明/P3_软件设计系统/P3-软件设计系统设计-260629-转换器可用性增强补充案.md
• DOC/CODEX_DOC/06_测试文档/03_机测记录/2026-06测试/260629-P3-转换器可用性增强验证记录.md
• DOC/CODEX_DOC/07_过程文档/01_会话交接/2026-06-29-P3转换器可用性增强交付说明.md

说明

• 本次提交不包含本地学习过程文档。
• 当前修改更适合开发者、测试人员、本地部署和内部交付场景，可提前暴露转换器运行条件、减少无效转换请求；如果后续面向外部普通用户开放，建议进一步收敛前端提示文案，不直接暴露后端环境变量名，并考虑将缺少服务端配置的错误语义调整为服务不可用类错误。
• 当前缺配置路径仍沿用原项目 ValueError -> HTTP 400 机制，后续产品化阶段可考虑调整为 503 Service Unavailable。