宜搭页面发布技能
概述
本技能提供宜搭自定义页面的完整发布流程:源码编译 → 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-pageskill 并遵循其开发规范。