创建自定义页面

> 资源边界：本技能只处理普通 OpenYida 页面创建；目标不明时先只读确认或询问用户。

Resource-First 使用门槛

本技能只负责创建缺失的 display page，不负责优化、修改或重新发布已有页面。执行前必须已经解析 resource context：

• 如果本轮用户给了页面 URL、formUuid、bound page，或 workspace cache/config 中已有目标 display page，禁止调用 openyida create-page；改由 yida-canvas-custom-page 编写页面源码，再由 yida-publish-page 发布。已确认是历史平台 JSX 组件页面维护时，不由本技能创建或派发，改走根路由的“JSX 自定义页面开发”入口。
• 如果用户给的是普通表单 formUuid 且诉求是改字段结构，改用 yida-create-form-page；不要把表单 ID 当作自定义页面创建目标。
• 只有目标 app 已明确、目标 display page 缺失，并且用户意图允许新增页面（例如“在 APP_xxx 里增加回访页面”）时，才加载并执行本技能。
• 多个已有页面候选按根技能来源优先级选择；同级冲突或无法判断主页面时才问用户。

严格禁止 (NEVER DO)

• 不要编造 formUuid，必须从命令返回的 JSON 中提取
• 不要用此命令创建表单页面（带字段的数据收集页），应使用 yida-create-form-page
• 已有页面 URL / formUuid / bound page 时，不要创建新页面；除非用户明确要求新增另一个页面并确认。

严格要求 (MUST DO)

• 创建前必须确认：单点创建页面时，执行创建命令前必须向用户确认页面名称和目标应用。由 yida-app 完整应用统一编排且用户已说“默认方案 / 不要追问 / 直接创建”时，合理命名并直接创建，不再二次追问。
• 创建成功后，将 formUuid 记录到 .cache/<项目名>-schema.json
• 由 yida-app 完整应用统一编排的首页/工作台/智能助手/门户门面页，可以先于业务表单创建；先占位记录 formUuid，待表单 ID 明确后再写源码并发布。
• 创建成功后，将真实 formUuid 交给 yida-canvas-custom-page 编写页面源码，再交给 yida-publish-page 发布；本技能不使用 yida-custom-page 处理新建页面。
• 本技能不读写 memory：formUuid 等信息输出到 stdout，通过 .cache/<项目名>-schema.json 持久化，不依赖跨会话的 memory 状态

适用场景

用户需要创建"自定义展示页面"、"可视化大屏"、"自定义 UI 页面"，且 resource context 未解析到目标页面时使用。

关键区分：
- 自定义展示页面（无字段，纯 JSX/React 开发）→ 本技能
- 表单页面（有字段，数据收集）→ yida-create-form-page

触发条件

正向触发：
- "创建自定义展示页面"、"新建可视化大屏"
- "创建自定义 UI 页面"、"新建一个页面"
- 完整应用开发流程中主页面缺失且允许创建的页面创建步骤（由 yida-app 编排调用）

命令

openyida create-page <appType> "<pageName>" [--mode dashboard] [--hide-nav] [--locale zh_CN|en_US|ja_JP] [--open|--no-open]

优先使用上表参数。兼容别名：--hide-navigation / --no-nav 等同于 --hide-nav；--render-nav false（也接受 --is-render-nav / --isRenderNav）要求隐藏，true 保持默认；多个导航参数以最后一个为准。--content-locale / --lang 等同于 --locale。本命令自动输出结果 JSON，不提供专用 --json 参数。

使用 --hide-nav 时，页面级配置与回读已包含在创建命令中，不需要常规追加 update-form-config。已确认的自定义应用导航隐藏在应用设置更新时同步保存，与这里的页面级配置分开执行。

默认生成页面导航可见；仅说“看板 / 驾驶舱 / 首页 / 门户 / 工作台”不等于隐藏导航。

输出

{"success":true,"pageCreated":true,"pageId":"FORM-XXX","pageName":"驾驶舱","appType":"APP_XXX","mode":"dashboard","hideNavRequested":false,"hideNav":false,"chromeless":false,"navigationVerification":null,"url":"{base_url}/APP_XXX/workbench/FORM-XXX","workbenchUrl":"{base_url}/APP_XXX/workbench/FORM-XXX","dashboardConfigWarning":null}

隐藏导航时，navigationVerification 记录 requestedRenderNav:false、实际 renderNav、verified 和配置次数 attempts。回读优先使用平台的 renderNav，缺少该字段时才读 isRenderNav；布尔值及字符串 "true" / "false" 均可识别，缺失值不会当成隐藏成功。

补写后仍未确认时，命令以非零退出码返回 success:false、pageCreated:true、真实 pageId 和 CREATE_PAGE_NAVIGATION_NOT_VERIFIED。此时 hideNav 表示回读结果，未知为 null，chromeless:false；按 recovery 提供的参数对原页面执行 update-form-config，再用 get-form-config --json 确认。不要重跑创建命令，也不要用 URL 中的 isRenderNav=false 代替配置回读。

> 如需创建表单页面（带字段的数据收集页），请使用 yida-create-form-page。

异常处理