宜搭应用创建技能
概述
本技能描述如何通过 HTTP 请求调用宜搭 registerApp 接口创建应用,返回应用 ID(appType)。创建应用是搭建宜搭应用的第一步,后续可在应用下创建表单页面和自定义页面。
何时使用
当以下场景发生时使用此技能:
- 用户需要创建新的宜搭应用
- 用户想要通过 AI 一句话生成宜搭应用
- 开始一个新的宜搭项目开发流程
使用示例
示例 1:基础用法
场景:创建一个简单的宜搭应用 命令:
node .claude/skills/yida-create-app/scripts/create-app.js "考勤管理"
输出:
{"success":true,"appType":"APP_XXX","appName":"考勤管理","url":"{base_url}/APP_XXX/admin"}
示例 2:完整参数
场景:创建带描述和图标的应用 命令:
node .claude/skills/yida-create-app/scripts/create-app.js "考勤管理" "员工考勤打卡系统" "xian-daka" "#00B853"
使用方式
node .claude/skills/yida-create-app/scripts/create-app.js <appName> [description] [icon] [iconColor]
参数说明:
| 参数 | 必填 | 默认值 | 说明 |
|---|---|---|---|
appName |
是 | — | 应用名称 |
description |
否 | 同 appName | 应用描述 |
icon |
否 | xian-yingyong |
图标标识 |
iconColor |
否 | #0089FF |
图标颜色 |
示例:
# 最简用法
node .claude/skills/yida-create-app/scripts/create-app.js "考勤管理"
# 完整参数
node .claude/skills/yida-create-app/scripts/create-app.js "考勤管理" "员工考勤打卡系统" "xian-daka" "#00B853"
输出:日志输出到 stderr,JSON 结果输出到 stdout:
{"success":true,"appType":"APP_XXX","appName":"考勤管理","url":"{base_url}/APP_XXX/admin"}
前置依赖
- Node.js
- 项目根目录存在
.cache/cookies.json(首次运行会自动触发扫码登录)
调用流程
- 读取项目根目录的
.cache/cookies.json获取登录态;若不存在则自动调用login.py触发扫码登录 - 构建
registerApp请求参数 - 发送 POST 请求到
/query/app/registerApp.json;根据响应体errorCode自动处理异常(详见yida-login技能文档「错误处理机制」章节) - 从返回值中获取应用 ID(appType)
- 将
appType记录到prd/<项目名>.md备用
文件结构
yida-create-app/
├── SKILL.md # 本文档
└── scripts/
└── create-app.js # 应用创建脚本
接口说明
registerApp
- 地址:
POST /query/app/registerApp.json - Content-Type:
application/x-www-form-urlencoded - 核心参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
_csrf_token |
String | 是 | CSRF Token(由 yida-login 获取) |
appName |
String (JSON) | 是 | 应用名称,i18n 格式:{"zh_CN":"名称","en_US":"名称","type":"i18n"} |
description |
String (JSON) | 否 | 应用描述,i18n 格式同上 |
icon |
String | 否 | 图标标识,格式:{iconName}%%{颜色},如 xian-daka%%#00B853 |
iconUrl |
String | 否 | 自定义图标 URL(与 icon 二选一) |
colour |
String | 否 | 主题颜色,固定 blue |
其他固定参数:
defaultLanguage=zh_CN、openExclusive=n、openPhysicColumn=n、openIsolationDatabase=n、openExclusiveUnit=n、group=全部应用
- 返回值:
{
"content": "APP_XXX",
"success": true
}
content 即为新创建的应用 ID(appType)。
与其他技能配合
- 创建应用 → 获取
appType(本技能) - 创建表单页面 → 使用
yida-create-form-page技能在应用下创建表单 - 创建自定义页面 → 使用
yida-create-page技能在应用下创建展示页面 - 部署页面代码 → 使用
yida-publish技能将 JSX 代码部署到自定义页面
图标列表
| 名称 | 标识 | 名称 | 标识 | |
|---|---|---|---|---|
| 新闻 | xian-xinwen |
地球 | xian-diqiu |
|
| 政府 | xian-zhengfu |
汽车 | xian-qiche |
|
| 应用 | xian-yingyong |
飞机 | xian-feiji |
|
| 学术帽 | xian-xueshimao |
电脑 | xian-diannao |
|
| 企业 | xian-qiye |
工作证 | xian-gongzuozheng |
|
| 单据 | xian-danju |
购物车 | xian-gouwuche |
|
| 市场 | xian-shichang |
信用卡 | xian-xinyongka |
|
| 经理 | xian-jingli |
活动 | xian-huodong |
|
| 法律 | xian-falv |
奖杯 | xian-jiangbei |
|
| 报告 | xian-baogao |
流程 | xian-liucheng |
|
| 火车 | huoche |
查询 | xian-chaxun |
|
| 申报 | xian-shenbao |
打卡 | xian-daka |
图标背景色
#0089FF #00B853 #FFA200 #FF7357 #5C72FF #85C700 #FFC505 #FF6B7A #8F66FF #14A9FF