| name | yida-publish-page |
| description | 宜搭自定义页面发布技能，将 JSX 源码经 Babel 编译、UglifyJS 压缩后构建 Schema，并通过 saveFormSchema 接口部署到宜搭平台。 |
| license | MIT |
| compatibility | ["opencode","claude-code"] |
| metadata | {"audience":"developers","workflow":"yida-deployment","version":"1.0.0","tags":["yida","low-code","deploy","babel"]} |
宜搭页面发布技能
概述
本技能提供宜搭自定义页面的完整发布流程：源码编译 → Schema 构建 → 读取登录态（按需触发登录）→ 接口发布。
何时使用
当以下场景发生时使用此技能：
- 用户需要将开发好的自定义页面发布到宜搭平台
- 用户修改了页面代码，需要重新部署
- 开发流程中的最后一步：发布页面
使用示例
示例 1：发布自定义页面
场景：将 JSX 源码编译并发布到宜搭
命令：
node .claude/skills/yida-publish-page/scripts/publish.js APP_XXX FORM-XXX pages/src/my-page.js
输出：
{"success":true,"formUuid":"FORM-XXX","version":0}
使用方式
cd .claude/skills/yida-publish/scripts
npm install
node publish.js <appType> <formUuid> <源文件路径>
参数说明：
| 参数 | 说明 | 示例 |
|---|
appType | 应用 ID | APP_E0MZ4VB75ZMB1BIGNVT4 |
formUuid | 自定义页面 ID | FORM-XXX |
源文件路径 | 源码文件路径（相对于项目根目录） | pages/src/xxx.js |
baseUrl 无需手动传入，脚本会自动从 .cache/cookies.json 读取登录态（若不存在或接口返回 302，则自动触发扫码登录），并从中读取 base_url。
示例：
node publish.js APP_XXX FORM-XXXXXX pages/src/xxx.js
工作流程
- 编译源码：通过
@ali/vu-babel-transform 将 JSX 转换为 ES5，再通过 UglifyJS 压缩
- 构建 Schema：通过代码动态构建完整的 Schema JSON，将编译后的
source 和 compiled 填入 actions.module
- 读取登录态：读取项目根目录的
.cache/cookies.json；若不存在则自动调用 login.py 触发扫码登录
- 发布 Schema：通过 HTTP POST 调用
saveFormSchema 接口保存 Schema；根据响应体 errorCode 自动处理异常（详见 yida-login 技能文档「错误处理机制」章节）
- 更新表单配置：调用
updateFormConfig 接口，设置 MINI_RESOURCE 配置为 8；同样根据响应体 errorCode 自动处理异常
注意：发布目标地址由 .cache/cookies.json 中保存的 base_url 决定（即登录后浏览器实际跳转到的域名），而非 config.json 中的 loginUrl。详见 yida-login 技能文档。
注意：当发布页面碰到组织 corpId 不匹配 或 "您当前未在「xxx」组织内" 时，可以询问是否创建新的应用发布。
前置依赖
- Node.js 16+
- Python 3.12+（用于调用 yida-login）
- playwright（Python 版，yida-login 依赖）
cd .claude/skills/yida-publish-page/scripts && npm install
文件结构
yida-publish/
├── SKILL.md # 本文档
└── scripts/
├── publish.js # 发布主脚本（Node.js，内含 Schema 动态构建逻辑）
├── package.json # Node.js 依赖声明
└── node_modules/ # 依赖包（npm install 后生成）
接口说明
saveFormSchema 和 updateFormConfig 接口的完整参数、返回值和错误处理机制，请参考 reference/yida-api.md 文档中的「表单设计类 API」章节。
注意：自定义页面发布时，updateFormConfig 的 value 参数固定为 8（区别于表单页面的 0）。
与其他技能配合
yida-login：登录态失效时自动调用（Cookie 持久化，首次或 302 时需扫码）yida-custom-page：编写源码前必须先加载此 skill，严格按照其开发规范编写代码（禁止使用 React Hooks）yida-app：完整应用开发流程的最后一步
⚠️ 重要警告：宜搭自定义页面使用类组件模式，禁止使用 React Hooks（useState/useEffect）。发布前必须确保代码已加载 yida-custom-page skill 并遵循其开发规范。
