lark-apps
妙搭(Spark/Miaoda)应用开发与托管:应用创建、本地全栈开发、云端生成迭代、创意设计(UI mockup / 可交互原型 / 线框图 / 落地页 / 仪表盘 / 幻灯片 deck / 视觉探索)、AI相关能力和飞书平台能力或者其他外部能力集成、日志/Trace/监控指标/PV/UV 查询、环境变量管理、应用协作者与协作权限设置、应用角色与成员管理、自动化触发器(定时/记录变更/Webhook/飞书审批)。当用户要开发/新建一个系统·工具·平台·应用,或要本地开发 / 云端开发 / 修改 / 部署 / 发布 / 上线 / 拿可分享链接,或用 HTML 做页面·网站·部署到妙搭,或要设计 / design / mockup / prototype / wireframe / 做 PPT / deck / 视觉探索,或提到妙搭/Spark/Miaoda(应用运行时域名形如 *.aiforce.cloud)、应用数据库、应用文件存储、开放 API Key、可见范围、应用协作者/开发权限、应用角色/角色成员、线上日志、接口请求量、错误量、延迟、访问量、环境变量、给妙搭应用配自动化任务/定时触发/审批通过后自动触发时使用。不负责普通云盘文件上传(lark-drive)、飞书文档编辑(lark-doc)、原生幻灯片创建(lark-slides)。
larksuite · AI review on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add larksuite/cli --skill lark-appsAbout this skill
name: lark-apps version: 1.0.0 description: "妙搭(Spark/Miaoda)应用开发与托管:应用创建、本地全栈开发、云端生成迭代、创意设计(UI mockup / 可交互原型 / 线框图 / 落地页 / 仪表盘 / 幻灯片 deck / 视觉探索)、AI相关能力和飞书平台能力或者其他外部能力集成、日志/Trace/监控指标/PV/UV 查询、环境变量管理、应用协作者与协作权限设置、应用角色与成员管理、自动化触发器(定时/记录变更/Webhook/飞书审批)。当用户要开发/新建一个系统·工具·平台·应用,或要本地开发 / 云端开发 / 修改 / 部署 / 发布 / 上线 / 拿可分享链接,或用 HTML 做页面·网站·部署到妙搭,或要设计 / design / mockup / prototype / wireframe / 做 PPT / deck / 视觉探索,或提到妙搭/Spark/Miaoda(应用运行时域名形如 *.aiforce.cloud)、应用数据库、应用文件存储、开放 API Key、可见范围、应用协作者/开发权限、应用角色/角色成员、线上日志、接口请求量、错误量、延迟、访问量、环境变量、给妙搭应用配自动化任务/定时触发/审批通过后自动触发时使用。不负责普通云盘文件上传(lark-drive)、飞书文档编辑(lark-doc)、原生幻灯片创建(lark-slides)。" metadata: requires: bins: ["lark-cli"] cliHelp: "lark-cli apps --help; lark-cli apps + --help"
apps (v1)
妙搭应用属于用户资产。默认用 --as user;认证、scope、exit-10、高风险确认、_notice 等通用处理只读 ../lark-shared/SKILL.md,不要在本 skill 里复制。妙搭应用有两条开发路径:本地开发(拉源码本地写)/ 云端会话(妙搭 AI 生成)。
身份与授权
妙搭应用是用户的个人资产,统一 --as user(见开头)。已有用户身份可用时直接执行业务命令,不要为了预防权限问题主动重新登录,否则可能中断原任务并触发不必要的设备授权。仅当 CLI 明确返回未登录或缺少本域 scope 时,一次性执行:
lark-cli auth login --domain apps
因缺权限失败(error.subtype == "missing_scope")时的通用处理见 ../lark-shared/SKILL.md,同样按 --domain apps 授权;授权成功后只恢复原业务操作,不扩展任务范围。
意图路由
按具体操作查命令(开发路径先用下方「选择开发路径」判定表定好再进来取命令):
| 用户意图 | 先用 | 按需读取 |
|---|---|---|
| 创建新应用资产、拿 app_id | +create | lark-apps-create.md |
| 找已有 app_id、按名字过滤应用 | +list --keyword <name> | lark-apps-list.md |
| 查单个应用详情(类型、名称、发布状态等) | +get --app-id <app_id> | lark-apps-get.md |
| 改应用名或描述 | +update | lark-apps-update.md |
| HTML 应用 / 创意模式 — 写 HTML 页面/网站、静态页、PPT/deck、落地页、仪表盘、UI mockup、原型、线框图、视觉探索 | 加载 creative-design/creative-design.md(含完整开发与发布流程) | creative-design/creative-design.md |
| 旧版存量 HTML 应用(无 Git 管理)继续上传已有静态产物 | +html-publish(仅兼容旧链路;新建 html / 创意模式 / creative-design 产物不得使用) | lark-apps-html-publish.md |
开发已有应用 / 初始化本地仓库(开发方式已定为本地后;先解析 app_id,勿 +create 新建) | +init(或手动 +git-credential-init + 原生 git)。执行前必读 lark-apps-local-dev.md,含端到端流程和领域规则 | lark-apps-init.md, lark-apps-git-credential.md |
本地开发时 .env.local 损坏/丢失,重新拉取启动期环境变量 | +env-pull | lark-apps-env-pull.md |
| 管理应用环境变量(查看/设置/删除) | +env-list, +env-set, +env-delete | lark-apps-env.md |
| 查线上日志、Trace、请求数、错误率、延迟、CPU、memory、PV/UV/访问量 | +log-list, +log-get, +trace-list, +trace-get, +metric-list, +analytics-list | lark-apps-observability.md |
| 看表 / 看结构 / 初始化多环境 / 导入导出数据 / 变更追溯 / 行级审计 / dev→online 发布 / 时间点恢复 / 查 DB 用量 | +db-table-list、+db-table-get、+db-env-create、+db-data-export/+db-data-import、+db-changelog-list、+db-audit-status/+db-audit-enable/+db-audit-disable/+db-audit-list、+db-env-diff/+db-env-migrate、+db-recovery-diff/+db-recovery-apply、+db-quota-get | lark-apps-db.md |
| 逐条执行 SQL(SELECT / DML / DDL);建表 / 改表 / 写 SQL 的平台规范 | +db-execute | lark-apps-db-execute.md(含「平台 SQL 规范」:审计列 / RLS / user_profile / 禁用 SQL / PG 陷阱) |
| 管理应用文件存储:上传/下载本地文件、列出/查看/删除已存文件、生成临时分享链接、查存储用量 | +file-upload/+file-download/+file-list/+file-get/+file-sign/+file-delete/+file-quota-get | lark-apps-file.md |
| 调试应用运行时缓存:查看/删除单个业务 key、清空指定环境缓存 | +cache-get/+cache-delete/+cache-clear | lark-apps-cache.md |
| 部署/上线应用("部署""上线""推上去并部署""发布到云端");查发布状态/历史 | 本地开发链路先按 lark-apps-local-dev.md 确认本次改动已 git commit + git push,再用 +release-create / +release-get;查历史用 +release-list | lark-apps-local-dev.md, lark-apps-release-create.md, lark-apps-release-get.md, lark-apps-release-list.md |
| 设置或查看运行时可见范围 | +access-scope-set, +access-scope-get | 对应 access-scope reference |
| 管理应用协作者(列出/添加/改权限/移除)或协作权限设置 | +member-list, +member-add, +member-update, +member-remove, +member-settings-get, +member-settings-set | 本文「应用协作者与协作权限设置」 |
| 创意模式(html)应用的评论相关操作 | 创意模式应用评论走 lark-drive 文档评论体系,读取 ../lark-drive/SKILL.md 了解评论能力 | ../lark-drive/SKILL.md |
管理 app_... 应用内角色、角色成员,或查询用户匹配角色 | +role-list/get/create/update/delete, +role-member-list/add/remove, +role-match-list | lark-apps-role.md |
| 云端 Agent 生成/迭代应用(开发方式已定为云端后) | +session-create -> +chat -> +session-get | lark-apps-cloud-dev.md |
| 管理妙搭应用开放 API Key(创建/查看/启停/重置/删除凭证;密钥仅 create/reset 一次性返回) | +openapi-key-list/get/create/update/enable/disable/delete/reset | lark-apps-openapi-key.md |
| 管理妙搭应用自动化触发器(定时/记录变更/Webhook/飞书审批四类触发器的查询/创建/更新/启停;Webhook URL·Token 一次性回显、不落盘) | +automation-list/get/create/update/enable/disable | lark-apps-automation.md |
| 查看某次会话某一轮(turn)的回复消息(含仍在生成中的本轮)/ 导出上一轮模型回复("这一轮回复了什么""上一轮的回复""导出某轮消息") | 先 +session-get(取 latest_turn.turn_id)-> +session-messages-list --turn-id <id>(仅 user 身份;分页用 --page-token) | lark-apps-session-messages-list.md |
| 外部能力(AI模型能力和飞书平台能力)集成/插件/Plugin/Capability | +plugin-install, +plugin-list, +plugin-uninstall | lark-apps-plugin-install.md, [`lark-apps-plugin-uninstall |