44 lines
1.6 KiB
Markdown
44 lines
1.6 KiB
Markdown
# apps +get
|
||
|
||
按 app_id 查询单个应用详情。运行时命令事实以 `lark-cli apps +get --help` 为准。
|
||
|
||
## 何时用
|
||
|
||
需要查看一个应用的类型、名称、描述、发布状态等详情时使用。如果只是按应用名模糊搜索定位 app_id，用 `+list --keyword`。
|
||
|
||
## 命令骨架
|
||
|
||
- 必填：`--app-id`。
|
||
- 返回应用的完整信息：`app_id`、`app_type`、`name`、`description`、`icon_url`、`created_at`、`updated_at`、`is_published`。
|
||
|
||
## 示例
|
||
|
||
```bash
|
||
lark-cli apps +get --app-id app_xxx
|
||
lark-cli apps +get --app-id app_xxx --dry-run
|
||
lark-cli apps +get --app-id app_xxx -q '.data.app.app_type'
|
||
```
|
||
|
||
## 输出契约
|
||
|
||
- 成功读取 `data.app` 对象，包含以下字段：
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|------|------|------|
|
||
| `app_id` | string | 应用唯一标识 |
|
||
| `app_type` | string | 应用类型（如 HTML、FULL_STACK、MODERN_HTML） |
|
||
| `name` | string | 应用显示名称 |
|
||
| `description` | string | 应用功能说明 |
|
||
| `icon_url` | string | 应用图标 URL |
|
||
| `created_at` | string | 创建时间（ISO 8601 UTC） |
|
||
| `updated_at` | string | 最后更新时间（ISO 8601 UTC） |
|
||
| `is_published` | boolean | 是否已发布 |
|
||
|
||
- pretty 输出展示核心字段：`app_id`、`app_type`、`name`、`is_published`、`updated_at`。
|
||
- `is_published=true` 只代表应用历史上有发布版本，不代表最新代码已部署。
|
||
|
||
## Agent 规则
|
||
|
||
- 用户已有 `app_id` 想查看详情时用 `+get`；只有应用名时用 `+list --keyword`。
|
||
- 不要把 `cli_` 开头的飞书应用 ID 传给 `+get`，只接受 `app_` 开头的应用 ID。
|