docs: add frontend app-type to lark-apps command references

SKILL.md's routing table already covered frontend, but the per-command
reference docs still enumerated only html/full_stack. Update create/list/get
enum values, add a frontend local-dev section, and note frontend in the
release-create entry so agents document the third app type consistently.
This commit is contained in:
zhmushan
2026-07-28 19:55:16 +08:00
parent dd8255d59d
commit a7262ef2fc
5 changed files with 33 additions and 6 deletions

View File

@@ -9,7 +9,7 @@
## 命令骨架
- 必填:`--name``--app-type`
- app type 语义取值为 `html` / `full_stack`CLI 会把输入归一成小写后校验。
- app type 语义取值为 `html` / `frontend` / `full_stack`CLI 会把输入归一成小写后校验。
- 可选:`--description``--icon-url`
## 示例
@@ -17,6 +17,9 @@
```bash
lark-cli apps +create --name "客户调研问卷" --app-type html
lark-cli apps +create --name "JSON 格式化工具" --app-type frontend \
--description "纯前端交互工具,无需数据库"
lark-cli apps +create --name "审批系统" --app-type full_stack \
--description "部门审批系统,支持登录、提交申请、多级审批"
@@ -35,5 +38,5 @@ lark-cli apps +create --name "Demo" --app-type html --dry-run
创建后按用户路径继续:
- 本地应用开发(含 html full_stack读 [`lark-apps-local-dev.md`](lark-apps-local-dev.md)。
- 本地应用开发(含 html / frontend / full_stack读 [`lark-apps-local-dev.md`](lark-apps-local-dev.md)。
- 云端 Agent 生成/迭代:读 [`lark-apps-cloud-dev.md`](lark-apps-cloud-dev.md)。

View File

@@ -26,7 +26,7 @@ lark-cli apps +get --app-id app_xxx -q '.data.app.app_type'
| 字段 | 类型 | 说明 |
|------|------|------|
| `app_id` | string | 应用唯一标识 |
| `app_type` | string | 应用类型(如 HTML、FULL_STACK、MODERN_HTML |
| `app_type` | string | 应用类型(如 HTML、FRONTEND、FULL_STACK、MODERN_HTML |
| `name` | string | 应用显示名称 |
| `description` | string | 应用功能说明 |
| `icon_url` | string | 应用图标 URL |

View File

@@ -10,7 +10,7 @@
- 支持 `--keyword` 按应用名模糊搜索。
- `--ownership` 枚举:`all` / `mine` / `shared`(默认 `all` = 我创建的 + 共享给我的;`mine` = 仅我创建;`shared` = 仅共享给我)。
- `--app-type` 枚举:`html` / `full_stack`
- `--app-type` 枚举:`html` / `frontend` / `full_stack`
- 分页:`--page-size` 默认 20`--page-token` 传上一页 cursor。
## 示例

View File

@@ -1,6 +1,6 @@
# lark-apps 本地开发
适用用户要把妙搭应用full_stack 或 html源码拉到本地用本地 code agent/IDE 开发、调试数据库,再发布。
适用用户要把妙搭应用full_stack、frontend 或 html源码拉到本地用本地 code agent/IDE 开发、调试数据库,再发布。
## 新建 vs 已有应用
@@ -36,6 +36,30 @@ git push origin sprint/default
lark-cli apps +release-create --as user --app-id app_xxx --branch sprint/default
```
### frontend
纯前端应用vite-react无数据库。流程与 full_stack 基本一致——`+init` 装依赖、`npm run dev`、commit/push/release——差别是无 `+db-*` 调库步骤。后续需要数据库/后端能力时不在本地升级,按 SKILL.md「类型升级」引导到云端会话。
```bash
# 新建 frontend 应用
lark-cli apps +create --as user --name "JSON 格式化工具" --app-type frontend \
--description "纯前端交互工具,无需数据库"
# 初始化本地仓库(--dir 取值见下方「领域规则」,勿照抄此处示例值)
lark-cli apps +init --as user --app-id app_xxx --dir ./json-tool
# 进入仓库后按项目脚手架启动vite-react
cd ./json-tool
npm install
npm run dev
# 开发完成后:提交本次改动 -> git push origin sprint/default -> +release-create
git add <本次开发的文件>
git commit -m "feat: ..."
git push origin sprint/default
lark-cli apps +release-create --as user --app-id app_xxx --branch sprint/default
```
### html
#### 首次开发(无 app无代码

View File

@@ -4,7 +4,7 @@
## 何时用
用于把应用的代码分支推进到发布流程html full_stack 统一走此入口)。
用于把应用的代码分支推进到发布流程html / frontend / full_stack 统一走此入口)。
## 命令骨架