用途:把一份 HTML(单文件或整目录)发布成可分享的飞书应用,拿到访问 URL,并管理应用名称、描述与访问范围。
前置条件:所有 apps 命令需要 User Access Token;scope 为 spark:app:write(create / update / html-publish / access-scope-set)和 spark:app:read(access-scope-get / list)。注意 auth login --scope 是替换而非合并,需把 spark scope 并入完整 scope 串登录:feishu-cli auth login --scope "<现有全部 scope> spark:app:read spark:app:write",可先用 feishu-cli auth check --scope "spark:app:write" 预检。
典型三步:feishu-cli apps create --name "我的页面" --app-type HTML 创建应用(取 .app.app_id);feishu-cli apps html-publish --app-id app_xxx --path ./dist 发布并取 .url;feishu-cli apps access-scope-set --app-id app_xxx --scope tenant 设访问范围。--app-type 当前只支持 HTML,发布目录根目录必须有 index.html,单文件形态文件名也须为 index.html。
其它命令:apps update 修改 --name/--description(至少一个);apps access-scope-get / set 管理范围,--scope 三选一:specific 需配 --targets(统一格式,自动拆成 users/departments/chats),public 必须显式给 --require-login,tenant 不接受其它 flag。app_id 也可从妙搭链接 https://miaoda.feishu.cn/app/app_xxx 提取。
限制:整包上传为单个 in-memory tar.gz 单次 multipart,未压缩 ≤200MB、tar.gz ≤20MB、单个 .html ≤10MB,超限客户端拦截。默认拦截 .env、.npmrc、.netrc、.git-credentials、.aws/credentials、.docker/config.json、.kube/config 等凭证文件,需放行时加 --allow-sensitive。所有命令支持 --format 与 --jq,写命令支持 --dry-run 并尊重格式化选项。输出已剥掉飞书响应的 data 外层。错误码 90002 表示应用不存在或无权访问,90001 表示上传成功但服务端构建失败。安装方式与具体收费、平台支持范围暂未提供。