Yida Create App

创建应用

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

Resource-First 使用门槛

本技能不是完整搭建的默认第一步，只能在以下条件同时满足时加载/执行：

1. 根技能或 yida-app 已完成 resolve_resource_context；
2. 没有从本轮 prompt、应用 URL、已绑定资源上下文、workspace 配置/缓存或会话历史解析到目标 appType；
3. 用户明确要求从零创建应用，或完整搭建缺少 app 且 allowCreate=true。

若已解析到 appType、应用 URL、已绑定 app 或 workspace 中可确认的 app，必须复用该 app 并继续后续表单/页面/发布步骤，不得调用 openyida create-app。若用户说“新建另一个应用”，先确认目标组织和新应用名，再执行本技能。

若该 app 是外部工具预创建的 app（上下文标记 source=agent_bound 或 precreated=true），也仍然视为“已有目标 app”：不得调用 openyida create-app，也不得在本技能中修改应用名称。本技能只负责在确实没有目标 app 且允许创建时新建应用。

严格禁止 (NEVER DO)

• 不要编造 appType，必须从命令返回的 JSON 中提取
• 不要在未确认 corpId 的情况下创建应用（先运行 openyida env 确认登录态）
• 不要在同一轮已成功创建应用后重复创建。若接口明确返回名称冲突，单点任务先询问用户；yida-app 完整应用统一编排可追加短后缀重试一次，不要为了查重额外探测。
• 已有 appType、应用 URL、已绑定 app 或 workspace app 时，不要创建新应用；除非用户明确要求新建另一个应用并确认。

严格要求 (MUST DO)

• 创建成功后，将 appType 记录到 .cache/<项目名>-schema.json
• 若完整搭建已确认 PRD 和视觉设计，创建成功后不得回写 .cache/openyida/<项目名>/requirement-brief.json，也不得仅因拿到真实 appType 重新生成或校验 PRD 和视觉设计；真实 appType 只写入 schema 或当前任务资源上下文。
• 创建前确认当前登录的组织（corpId）与目标组织一致
• 本技能不读写 memory：appType 等信息输出到 stdout，通过 .cache/<项目名>-schema.json 持久化，不依赖跨会话的 memory 状态

适用场景

用户说"只创建应用壳"、"新建应用并返回 appType"，且 resource context 没有目标 app 时使用此技能。 创建应用后，若任务只是创建应用壳则返回真实 appType 即可；若继续完整搭建，把真实 appType 写入 .cache/<项目名>-schema.json 或当前任务资源上下文，然后直接按已经确认的 PRD 与视觉设计执行：创建/更新表单（yida-create-form-page）→ 创建或复用页面（yida-create-page / existing page）→ 发布页面（yida-publish-page）。 后续如果需要自定义页面，源码写到 project/pages/src/<页面名>.canvas.jsx 并发布。

命令

openyida create-app --name <appName> [--desc <description>]
# 提取返回的 appType 后，单独更新应用基础设置
openyida update-app <appType> --theme-file <app-theme.css> --nav-theme light --logo-source appIcon --layout <side|top|l_shape>

openyida create-app 不支持 --json 参数；不要添加 --json。创建成功时命令本身会输出一行 JSON，从该输出中提取 appType。

以下参数只用于 update-app <appType>，不能传给 create-app：

主题确认后立即生成 CSS，可与表单创建和页面开发并行；真实 appType 与 CSS 就绪后立即更新，不等待页面完成。OpenYida 统一在 CSS 生成后通过一次 update-app 同步 colour、themeColor、customThemeStyle、navTheme、logoSource、layoutDirection 和导航显隐。创建命令不接受或提交这些设置字段。

创建应用壳层兜底

如果用户只说“创建一个律所/茶叶官网/数据大屏应用”，先由 yida-design 根据行业、品牌、业务情绪和视觉目标设计任意合适的品牌色，禁止把行业词直接映射成固定颜色。把完整色盘写入应用主题 CSS；获得真实 appType 后，必须执行 update-app --theme-file 上传该文件并保存到应用基础设置，同时保存导航主题、Logo 来源和导航布局。

创建命令只提交名称、描述、图标和必要的创建标记，不推断或提交应用主题与导航配置。创建完整应用、使用 PRD/design.md 或用户要求配置主题时，主题更新命令默认传入主题文件；只有用户明确只创建空壳或暂不配置主题时才跳过主题更新。搭建流程必须采用先 create-app、再 update-app --theme-file 的两个步骤。create-app 不接受 --theme-file 和 --logo-source，也不接受 --colour、--theme、--nav-theme、--layout 或旧位置参数里的主题与布局，不隐式执行应用设置更新。

CLI 始终按“显式 --icon → 行业推断 → 随机系统图标”的顺序选择图标，只有未显式指定且未命中行业时才随机，与后续是否更新主题文件无关。主题文件生成后按 PRD 在 update-app --layout 中显式设置布局；普通应用未指定时由设计流程选择 l_shape。在 update-app --theme-file 步骤中校验 CSS 并将图标颜色统一为 --color-brand1-6 转换后的 HEX；导航配置沿用 PRD，普通浅色方案显式传 --nav-theme light --logo-source appIcon。

应用主题（colour）口径：

默认不要把黑色、深灰或灰黑中性色作为普通应用主题色。创建业务系统、工作台、门户、数据管理类应用时，先根据行业、品牌、业务情绪和视觉目标做创意色彩判断；podBlue、podGreen、podOrange 只是常用浅底候选，不是固定默认，也不是行业刻板答案。black 仅在用户明确要求暗色模式、高对比、奢侈品牌或极简黑色视觉时使用，greyBlue 也只在工业制造、技术工程等稳重场景下作为 fallback。

主题颜色不受平台预置 key 限制。先执行以下命令复制内置主题模板，再定点修改品牌相关 token：

openyida sample yida-design app-theme --output .cache/openyida/<项目名>/app-theme.css --design-file prd/<项目名>/design.md

将任意设计主色写入 --color-brand1-6 后执行：

openyida create-app --name "<应用名>" --desc "<描述>"
# 从创建结果提取 appType 后执行
openyida update-app <appType> --theme-file <app-theme.css> --nav-theme light --logo-source appIcon --layout l_shape

CLI 会先校验主题文件完整声明平台实际生成的 --color-brand1-1/2/3/5/6/9/10，并允许不存在 --color-brand1-4/7/8。update-app --theme-file 上传 CSS，再调用应用基础设置的 updateApp 接口联合保存从 --color-brand1-6 提取的 themeColor、customThemeStyle、navTheme、logoSource 和 layoutDirection。更新主题时，系统应用图标会同步保存为 iconName%%主题色HEX；外链或上传图片图标保持原值。

colour 只保存平台 key，实际色值保存在 themeColor。导入主题文件时自动使用 colour=custom，无需手动填写；显式 --colour custom 需要主题文件或有效主题色，已有有效主题色可沿用。平台预置 key 不能与自定义 CSS 或 --theme-color 同传；切换预置主题会清空旧自定义 CSS。

更新结果必须包含 themeVerification.verified=true 和非空的 customThemeStyle.cssUrl，证明主题资源已绑定到应用设置；仅有本地 CSS 或创建成功不代表主题已应用。回读失败时保留已有 appType，修复后重试 update-app --theme-file，不要重复创建应用。修改 CSS 后也必须重新上传保存。

完整应用主题 key、颜色倾向和 token 变量统一维护在 yida-design/references/theme/theme-token-presets.md，本技能不重复维护完整清单。

输出

{"success":true,"appType":"APP_XXX","appName":"考勤管理","url":"{base_url}/APP_XXX/workbench"}

图标列表

图标背景色：update-app --theme-file 时固定跟随 CSS 的 --color-brand1-6；下面这些颜色仅用于应用创建时的初始图标：#0089FF #00B853 #FFA200 #FF7357 #5C72FF #85C700 #FFC505 #FF6B7A #8F66FF #14A9FF

创建后交付约定

• 将 appType、页面 formUuid、表单 fieldId 写入 .cache/<项目名>-schema.json，PRD 只保留业务语义。
• 自定义页面源码默认使用 .canvas.jsx，完成编写后发布。
• 造测试数据或修旧数据时，可以用 Python 或 JS 编写 .cache/ 下的一次性脚本；优先选择更快更清晰的方式，但字段 ID 和记录 ID 必须来自真实查询。

异常处理