# Yida Publish Page

> 宜搭自定义页面发布技能，将 JSX 源码经 Babel 编译、UglifyJS 压缩后构建 Schema，并通过 saveFormSchema 接口部署到宜搭平台。

- Skill: `openyida/yida-publish-page-2` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx get-skill add openyida/yida-publish-page-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/openyida/yida-publish-page-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: openyida (https://skillmd.com/u/openyida)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/openyida/yida-publish-page-2

---


# 宜搭页面发布技能

## 概述

本技能提供宜搭自定义页面的完整发布流程：源码编译 → Schema 构建 → 读取登录态（按需触发登录）→ 接口发布。

## 何时使用

当以下场景发生时使用此技能：
- 用户需要将开发好的自定义页面发布到宜搭平台
- 用户修改了页面代码，需要重新部署
- 开发流程中的最后一步：发布页面

## 使用示例

### 示例 1：发布自定义页面
**场景**：将 JSX 源码编译并发布到宜搭
**命令**：
```bash
node .claude/skills/yida-publish-page/scripts/publish.js APP_XXX FORM-XXX pages/src/my-page.js
```
**输出**：
```json
{"success":true,"formUuid":"FORM-XXX","version":0}
```

## 使用方式

```bash
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`。

**示例**：

```bash
node publish.js APP_XXX FORM-XXXXXX pages/src/xxx.js
```

## 工作流程

1. **编译源码**：通过 `@ali/vu-babel-transform` 将 JSX 转换为 ES5，再通过 UglifyJS 压缩
2. **构建 Schema**：通过代码动态构建完整的 Schema JSON，将编译后的 `source` 和 `compiled` 填入 `actions.module`
3. **读取登录态**：读取项目根目录的 `.cache/cookies.json`；若不存在则自动调用 `login.py` 触发扫码登录
4. **发布 Schema**：通过 HTTP POST 调用 `saveFormSchema` 接口保存 Schema；根据响应体 `errorCode` 自动处理异常（详见 `yida-login` 技能文档「错误处理机制」章节）
5. **更新表单配置**：调用 `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 依赖）

```bash
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 并遵循其开发规范。

