openyida 0.1.2 → 1.0.0-beta.0

package/yida-skills/skills/yida-publish-page/SKILL.md

@@ -0,0 +1,113 @@
+---
+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 源码编译并发布到宜搭
+**命令**：
+```bash
+node <skill_root>/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 <skill_root>/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 <skill_root>/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 并遵循其开发规范。

package/.eslintrc.json

@@ -1,25 +0,0 @@
-{
-  "env": {
-    "browser": true,
-    "es2021": true,
-    "node": true
-  },
-  "extends": "eslint:recommended",
-  "parserOptions": {
-    "ecmaVersion": "latest",
-    "sourceType": "module"
-  },
-  "rules": {
-    "indent": ["error", 2],
-    "linebreak-style": ["error", "unix"],
-    "quotes": ["error", "single"],
-    "semi": ["error", "always"],
-    "no-unused-vars": "warn",
-    "no-console": "off"
-  },
-  "ignorePatterns": [
-    "*.compile.js",
-    "node_modules/",
-    "build/"
-  ]
-}

package/.github/workflows/ci.yml

@@ -1,123 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-jobs:
-  # ── 安装脚本集成测试（三平台）────────────────────────────────────────
-  install-test:
-    name: Install Script (${{ matrix.os }})
-    runs-on: ${{ matrix.os }}
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [ubuntu-latest, macos-latest, windows-latest]
-
-    steps:
-    - name: Checkout code
-      uses: actions/checkout@v4
-
-    # ── Mac / Linux ──────────────────────────────────────────────────
-    - name: Install Skills (Mac/Linux)
-      if: runner.os != 'Windows'
-      run: bash install-skills.sh --global
-
-    - name: Verify Skills installed (Mac/Linux)
-      if: runner.os != 'Windows'
-      run: |
-        if [ ! -d ".claude/skills/skills" ]; then
-          echo "❌ Skills 目录不存在：.claude/skills/skills"
-          exit 1
-        fi
-        skill_count=$(ls -d .claude/skills/skills/*/ 2>/dev/null | wc -l | tr -d ' ')
-        if [ "$skill_count" -eq 0 ]; then
-          echo "❌ 未找到任何已安装的 Skill"
-          exit 1
-        fi
-        echo "✅ Skills 安装验证通过，共 ${skill_count} 个"
-
-    - name: Verify shell script syntax (Mac/Linux)
-      if: runner.os != 'Windows'
-      run: sh -n install-skills.sh && echo "✅ install-skills.sh 语法检查通过"
-
-    # ── Windows ──────────────────────────────────────────────────────
-    - name: Install Skills (Windows)
-      if: runner.os == 'Windows'
-      shell: pwsh
-      run: |
-        Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force
-        .\install-skills.ps1 --global
-
-    - name: Verify Skills installed (Windows)
-      if: runner.os == 'Windows'
-      shell: pwsh
-      run: |
-        $skillsPath = ".claude\skills\skills"
-        if (-not (Test-Path $skillsPath)) {
-          Write-Host "❌ Skills 目录不存在：$skillsPath"
-          exit 1
-        }
-        $skillCount = (Get-ChildItem -Path $skillsPath -Directory).Count
-        if ($skillCount -eq 0) {
-          Write-Host "❌ 未找到任何已安装的 Skill"
-          exit 1
-        }
-        Write-Host "✅ Skills 安装验证通过，共 $skillCount 个"
-
-    - name: Verify PowerShell script syntax (Windows)
-      if: runner.os == 'Windows'
-      shell: pwsh
-      run: |
-        $errors = $null
-        $null = [System.Management.Automation.Language.Parser]::ParseFile(
-          (Resolve-Path "install-skills.ps1").Path, [ref]$null, [ref]$errors
-        )
-        if ($errors.Count -gt 0) {
-          $errors | ForEach-Object { Write-Host "❌ $_" }
-          exit 1
-        }
-        Write-Host "✅ install-skills.ps1 语法检查通过"
-
-  # ── 单元测试与代码质量（ubuntu）──────────────────────────────────────
-  test:
-    name: Unit Tests
-    runs-on: ubuntu-latest
-    needs: install-test
-
-    steps:
-    - name: Checkout code
-      uses: actions/checkout@v4
-
-    - name: Install Skills
-      run: bash install-skills.sh --global
-
-    - name: Setup Node.js
-      uses: actions/setup-node@v4
-      with:
-        node-version: '20'
-
-    - name: Validate JavaScript syntax
-      run: |
-        for file in .claude/skills/skills/*/scripts/*.js; do
-          [ -f "$file" ] || continue
-          node --check "$file" || exit 1
-        done
-
-    - name: Validate JSON files
-      run: |
-        find . -name "*.json" -path "./.claude/skills/skills/*" | while read -r file; do
-          node -e "JSON.parse(require('fs').readFileSync(process.argv[1]))" -- "$file" || exit 1
-          echo "  ✅ $file"
-        done
-
-    - name: Install dependencies
-      run: npm install
-
-    - name: Run tests
-      run: npm test
-
-    - name: Run tests with coverage
-      run: npm run test:coverage

package/.github/workflows/publish.yml

@@ -1,105 +0,0 @@
-name: Publish to npm
-
-on:
-  push:
-    tags:
-      - 'v*'
-
-jobs:
-  # ── 发布前：三平台安装脚本验证 ────────────────────────────────────────
-  pre-publish-check:
-    name: Pre-publish Check (${{ matrix.os }})
-    runs-on: ${{ matrix.os }}
-    strategy:
-      fail-fast: true
-      matrix:
-        os: [ubuntu-latest, macos-latest, windows-latest]
-
-    steps:
-    - name: Checkout code
-      uses: actions/checkout@v4
-
-    - name: Install Skills (Mac/Linux)
-      if: runner.os != 'Windows'
-      run: bash install-skills.sh --global
-
-    - name: Verify Skills installed (Mac/Linux)
-      if: runner.os != 'Windows'
-      run: |
-        skill_count=$(ls -d .claude/skills/skills/*/ 2>/dev/null | wc -l | tr -d ' ')
-        [ "$skill_count" -gt 0 ] && echo "✅ Skills 安装验证通过，共 ${skill_count} 个" || (echo "❌ 未找到任何已安装的 Skill" && exit 1)
-
-    - name: Install Skills (Windows)
-      if: runner.os == 'Windows'
-      shell: pwsh
-      run: |
-        Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force
-        .\install-skills.ps1 --global
-
-    - name: Verify Skills installed (Windows)
-      if: runner.os == 'Windows'
-      shell: pwsh
-      run: |
-        $skillCount = (Get-ChildItem -Path ".claude\skills\skills" -Directory -ErrorAction SilentlyContinue).Count
-        if ($skillCount -gt 0) { Write-Host "✅ Skills 安装验证通过，共 $skillCount 个" } else { Write-Host "❌ 未找到任何已安装的 Skill"; exit 1 }
-
-  # ── 发布到 npm ────────────────────────────────────────────────────────
-  publish:
-    name: Publish to npm
-    runs-on: ubuntu-latest
-    needs: pre-publish-check
-    permissions:
-      contents: write  # 用于创建 GitHub Release
-
-    steps:
-    - name: Checkout code
-      uses: actions/checkout@v4
-
-    - name: Setup Node.js
-      uses: actions/setup-node@v4
-      with:
-        node-version: '20'
-        registry-url: 'https://registry.npmjs.org'
-
-    - name: Install Skills
-      run: bash install-skills.sh --global
-
-    - name: Install dependencies
-      run: npm install
-
-    - name: Run tests
-      run: npm test
-
-    - name: Verify package version matches tag
-      run: |
-        PKG_VERSION="v$(node -p "require('./package.json').version")"
-        TAG_VERSION="${GITHUB_REF_NAME}"
-        echo "package.json 版本：$PKG_VERSION"
-        echo "Tag 版本：$TAG_VERSION"
-        if [ "$PKG_VERSION" != "$TAG_VERSION" ]; then
-          echo "❌ package.json 版本（$PKG_VERSION）与 tag（$TAG_VERSION）不一致，请先更新 package.json"
-          exit 1
-        fi
-        echo "✅ 版本一致，准备发布"
-
-    - name: Publish to npm
-      run: npm publish --access public
-      env:
-        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-
-    - name: Create GitHub Release
-      uses: softprops/action-gh-release@v2
-      with:
-        tag_name: ${{ github.ref_name }}
-        name: ${{ github.ref_name }}
-        body: |
-          ## 安装
-
-          ```bash
-          npm install -g openyida
-          ```
-
-          ## 更新日志
-
-          请查看 [CHANGELOG](https://github.com/openyida/openyida/commits/main) 了解本版本变更详情。
-        generate_release_notes: true

package/.github/workflows/update-contributors.yml

@@ -1,151 +0,0 @@
-name: Update Contributors
-
-on:
-  pull_request:
-    types: [closed]
-    branches: [main]
-  workflow_dispatch:
-
-jobs:
-  update-contributors:
-    if: github.event_name == 'workflow_dispatch' || github.event.pull_request.merged == true
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-        with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-          fetch-depth: 0
-
-      - name: Update README contributors
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          REPO: ${{ github.repository }}
-        run: |
-          python3 - <<'PYEOF'
-          import subprocess
-          import json
-          import re
-          import sys
-          import os
-
-          repo = os.environ["REPO"]
-          print("📋 获取仓库所有贡献者...")
-
-          # 从 GitHub API 获取所有贡献者（gh cli 支持自动分页）
-          result = subprocess.run(
-              ["gh", "api", f"repos/{repo}/contributors?per_page=100&anon=false", "--paginate"],
-              capture_output=True, text=True
-          )
-          if result.returncode != 0:
-              print(f"⚠️  获取贡献者失败: {result.stderr}")
-              sys.exit(0)
-
-          # gh --paginate 返回多个 JSON 数组拼接，需要合并
-          raw = result.stdout.strip()
-          all_contributors = []
-          for chunk in re.findall(r'\[.*?\]', raw, re.DOTALL):
-              try:
-                  all_contributors.extend(json.loads(chunk))
-              except json.JSONDecodeError:
-                  pass
-
-          if not all_contributors:
-              print("⚠️  未获取到贡献者数据，跳过更新")
-              sys.exit(0)
-
-          print(f"✅ 共获取到 {len(all_contributors)} 位贡献者")
-
-          # 读取当前 README
-          with open("README.md", "r", encoding="utf-8") as f:
-              readme_content = f.read()
-
-          # 提取 README 中已有的贡献者用户名（小写，去重）
-          existing_users = set(
-              u.lower() for u in re.findall(r'href="https://github\.com/([^"]+)"', readme_content)
-          )
-          print(f"=== 当前 README 中已有贡献者 ===")
-          for u in sorted(existing_users):
-              print(f"  - {u}")
-
-          # 机器人账号关键词（跳过）
-          bot_patterns = re.compile(r'\[bot\]|dependabot|github-actions|renovate|actions-user', re.IGNORECASE)
-
-          # 找出新贡献者，按贡献数量排序（API 返回已按贡献数降序）
-          new_html_parts = []
-          for contributor in all_contributors:
-              login = contributor.get("login", "")
-              avatar_url = contributor.get("avatar_url", "")
-              html_url = contributor.get("html_url", f"https://github.com/{login}")
-
-              if not login:
-                  continue
-
-              # 跳过机器人
-              if bot_patterns.search(login):
-                  print(f"  🤖 跳过机器人: {login}")
-                  continue
-
-              # 跳过已在 README 中的贡献者
-              if login.lower() in existing_users:
-                  print(f"  ⏭️  已存在: {login}")
-                  continue
-
-              print(f"  ✨ 新贡献者: {login}")
-              # 构建头像 HTML（与现有格式完全一致）
-              # 强制将版本参数替换为 v=4，修复旧账号可能返回 v=3 的问题（issue #31）
-              avatar_url_v4 = re.sub(r'\?v=\d+', '?v=4', avatar_url)
-              avatar_48 = f"{avatar_url_v4}&s=48"
-              new_html_parts.append(
-                  f'<a href="{html_url}"><img src="{avatar_48}" width="48" height="48" alt="{login}" title="{login}"/></a>'
-              )
-
-          if not new_html_parts:
-              print("\n✅ 没有新贡献者需要添加，README 无需更新")
-              sys.exit(0)
-
-          print(f"\n📝 添加 {len(new_html_parts)} 位新贡献者到 README...")
-
-          # 在 contributors 区域的 </p> 前插入新贡献者头像
-          # README 中 contributors 区域格式：
-          #   ### 贡献者
-          #   <p align="left">
-          #     <a href="..."><img .../></a> ...
-          #   </p>
-          new_html_str = " " + " ".join(new_html_parts)
-
-          pattern = r'(### 贡献者.*?<p align="left">)(.*?)(</p>)'
-
-          def replacer(m):
-              existing_block = m.group(2).rstrip()
-              return m.group(1) + existing_block + new_html_str + "\n" + m.group(3)
-
-          updated_content = re.sub(pattern, replacer, readme_content, flags=re.DOTALL)
-
-          if updated_content == readme_content:
-              print("⚠️  未找到 contributors 区域（### 贡献者 + <p align=\"left\">），跳过更新")
-              sys.exit(0)
-
-          with open("README.md", "w", encoding="utf-8") as f:
-              f.write(updated_content)
-
-          print("✅ README.md 已更新")
-          PYEOF
-
-      - name: Commit and push if changed
-        run: |
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
-
-          if git diff --quiet README.md; then
-            echo "✅ README.md 无变化，无需提交"
-            exit 0
-          fi
-
-          git add README.md
-          git commit -m "chore: 自动更新 README contributors [skip ci]"
-          git push origin main
-          echo "🚀 已推送更新到 main 分支"

package/.openclaw/skills/yida-issue/SKILL.md

@@ -1,27 +0,0 @@
----
-name: yida-issue
-description: 一句话给 OpenYida 提需求，自动判断路由到 openyida/openyida 还是 openyida/yida-skills，并创建格式规范的 GitHub Issue。触发词：给 OpenYida 提需求、提个 issue、报个 bug、希望支持 xxx、建议 xxx。
----
-
-# 一句话提需求
-
-用自然语言描述需求，自动路由到正确仓库并创建 GitHub Issue。
-
-## 路由规则
-
-| 关键词/场景 | 目标仓库 |
-|---|---|
-| CLI、命令行、安装、CI/CD、贡献者、npm | `openyida/openyida` |
-| 登录、创建应用/页面/表单、发布、Schema、宜搭 API | `openyida/yida-skills` |
-| 无法判断 | 提示用户手动指定 `--repo` |
-
-## 使用方式
-
-```bash
-node scripts/create-issue.js "<需求描述>" [--repo openyida|yida-skills] [--type feature|bug] [--dry-run]
-```
-
-## 前置依赖
-
-- Node.js ≥ 16
-- GitHub CLI（`gh`）已安装并已登录（`gh auth login`）