用途
妙搭（Spark/Miaoda）应用开发与托管技能，来自 larksuite/cli。用于创建、开发、发布、运维妙搭应用。妙搭应用属于用户资产，默认使用 --as user 身份操作。
应用类型与开发路径
应用类型（app_type）分三类：
- full_stack：含数据库或后端持久化需求，如登录、增删改查、报名投票存记录、多人协作等。
- html（创意模式）：纯静态展示物料，无 JS 交互，如 PPT/deck、demo、落地页、海报、UI mockup、线框图、静态仪表盘、视觉探索。
- frontend：有 JS 交互但无数据库的前端应用，如可交互原型、SPA、表单校验、动态计算、调用外部 API。用户未明确提出数据库需求时默认引导 frontend。
开发路径分两条：
- 本地开发：拉源码到本地编写，读 lark-apps-local-dev.md。
- 云端会话：妙搭 AI 生成，读 lark-apps-cloud-dev.md。
用户未表达"谁来写代码"偏好时须先询问。修改已有应用且当前目录是 .spark/meta.json 项目时直接继续本地流程。类型升级需引导用户到云端会话（https://miaoda.feishu.cn/app/{app_id}）用自然语言描述后端需求。
主要能力
- 应用资产管理：
+create创建、+list --keyword <name>按名字过滤、+get --app-id查详情、+update改名或描述。 - 本地开发：
+init初始化仓库（或手动+git-credential-init+ 原生 git）、+export导出源码快照、+env-pull重新拉取启动期环境变量。 - 环境变量：
+env-list、+env-set、+env-delete查看/设置/删除。 - 可观测性：
+log-list、+log-get、+trace-list、+trace-get、+metric-list、+analytics-list，查线上日志、Trace、请求数、错误率、延迟、CPU、memory、PV/UV。请求量/错误量用--metric requests，延迟用--metric latency，PV/UV 用+analytics-list。 - 数据库：
+db-table-list、+db-table-get、+db-env-create、+db-data-export/+db-data-import、+db-changelog-list、行级审计命令、+db-env-diff/+db-env-migrate、+db-recovery-diff/+db-recovery-apply、+db-quota-get；+db-execute逐条执行 SQL。 - 文件存储：
+file-upload/+file-download/+file-list/+file-get/+file-sign/+file-delete/+file-quota-get。 - 缓存调试：
+cache-get/+cache-delete/+cache-clear。 - 发布：
+release-create、+release-get、+release-list；本地开发链路需先 git commit + git push。 - 访问范围：
+access-scope-set、+access-scope-get（运行时可见范围，非角色权限）。 - 协作者管理：
+member-list、+member-add、+member-update、+member-remove、+member-settings-get、+member-settings-set。 - 应用内角色：
+role-*系列命令。 - 云端会话：
+session-create->+chat->+session-get，+session-messages-list查看某轮回复。 - 开放 API Key：
+openapi-key-*系列。 - 自动化触发器：
+automation-*系列，支持定时、记录变更、Webhook、飞书审批四类。 - 外部能力集成：
+plugin-install/+plugin-list/+plugin-uninstall。 - ID 转换：
+user-id-convert在妙搭 user_id 与飞书 open_id/union_id/user_id 之间互转。
使用方式与约束
- 认证：需要未登录或缺少 scope 时执行
lark-cli auth login --domain apps。 - 路径参数（
--path、--file、--output）只接受当前工作目录下的相对路径。 - app_id 必须是
app_开头的妙搭应用 ID；cli_开头的是飞书应用 ID，不能传给 apps 命令。/page/<meta_token>链接为创意模式应用，形似飞书文档链接。 - 高风险写命令先用
--dry-run核对，确认后加--yes。删除/清空等不可逆操作（如数据库操作、+role-delete、批量移除成员、+cache-clear）有额外确认底线。 - 资源型文件（图片、字体、音视频）应上传到应用文件存储后引用远端 URL，不应提交到 git 或 base64 内联。上传链接按 app 隔离。
- 应用运行时代码必须使用工程内领域 skill 规定的 SDK，禁止通过 exec 或子进程调用 lark-cli。
适用场景
需要创建或维护妙搭应用、进行本地或云端全栈开发、管理应用数据库与文件、发布上线、查看监控与日志、配置协作者与访问范围、集成外部能力的开发者与团队使用。
限制
- 本地 CLI 不提供 frontend 到 full_stack 的类型升级，需到云端会话处理。
- 收到 feature_not_available（OpenAPI code 3340005）时需停止 CLI 自动化，引导用户在妙搭后台操作。
- external_invite、copy_download_by 只能在
+member-settings-get响应中读取，不能独立设置。CCM 当前不支持为妙搭对象写入复制、打印和下载权限。 - 本文所依据的资料未提供具体收费、价格与更多平台支持信息。
分类
妙搭应用创建、全栈开发与托管工具，归入智能体与模型（agents）。