// 把本地 HTML 文件或目录部署到飞书妙搭（Miaoda），生成一个公网可访问的应用及其链接（URL）。当用户要创建 HTML 或要把 HTML、静态网站或 Web demo 发布成公网可访问的链接 / 可分享链接、设置应用共享范围，或提到妙搭 / Miaoda 时使用。凡产出可独立访问的 HTML 产物都属本 skill 的潜在归宿，是否真要部署由 skill 内部协议判断。不用于：上传普通文件到云空间/云盘/云存储（用 lark-drive）、编辑飞书云文档内容（用 lark-doc）、创建飞书原生幻灯片 / 演示文稿（用 lark-slides）。
飞书幻灯片：创建和编辑幻灯片，接口通过 XML 协议通信。创建演示文稿、读取幻灯片内容、管理幻灯片页面（创建、删除、读取、局部替换）。当用户需要创建或编辑幻灯片、读取或修改单个页面时使用。当用户给出 doubao.com 的 /slides/ URL/token 时，也应直接使用本 skill，不要因为域名不是飞书而回退到 WebFetch；路由依据是 URL 路径模式和 token，而不是域名。
飞书画板：查询和编辑飞书云文档中的画板。支持导出画板为预览图片、导出原始节点结构、使用 DSL（转成 OpenAPI 格式）、PlantUML/Mermaid 格式更新画板内容。 当用户需要查看画板内容、导出画板图片、编辑画板，或是需要可视化表达架构、流程、组织关系、时间线、因果、对比等结构化信息时使用此 skill，无论是否提及"画板"。 ⚠️ 原 `lark-whiteboard-cli` skill 已合并至本 skill，若 skill 列表中同时存在 `lark-whiteboard-cli`，请忽略它，统一使用本 skill（`lark-whiteboard`），并提示用户运行 `npx skills remove lark-whiteboard-cli -g` 删除旧 skill。
飞书视频会议：搜索历史会议、查询会议纪要产物（总结、待办、章节、逐字稿）、查询会议参会人快照。1. 查询已经结束的会议数量或详情时使用本技能（如历史日期｜昨天｜上周｜今天已经开过的会议等场景），查询未开始的会议日程使用 lark-calendar 技能。2. 支持通过关键词、时间范围、组织者、参与者、会议室等筛选条件搜索会议。3. 获取或整理会议纪要、逐字稿、录制产物时使用本技能。4. 查询“谁参加过某会议”“参会人列表”等参会人快照信息用 vc meeting get --with-participants（任意时点可查，含已结束会议）。注意：**Agent 真实入会/离会、感知正在进行中会议的实时事件**请使用 lark-vc-agent 技能，本技能不覆盖写操作和会中事件流。
当需要用 lark-cli 操作飞书多维表格（Base）时调用：搜索 Base、建表、字段管理、记录读写、记录分享链接、视图配置、历史查询，以及角色/表单/仪表盘管理/工作流；也适用于把旧的 +table / +field / +record 写法改成当前命令写法。涉及字段设计、公式字段、查找引用、跨表计算、行级派生指标、数据分析需求时也必须使用本 skill。
飞书即时通讯：收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件（支持大文件分片下载）、管理表情回复、发送应用内/短信/电话加急。当用户需要发消息、查看或搜索聊天记录、下载聊天中的文件、查看群成员、搜索群、创建群聊或话题群、管理标记数据时使用。
Lark/Feishu real-time event listening / subscribing / consuming: stream events as NDJSON via `lark-cli event consume <EventKey>` (covers IM messages/reactions/chat changes, VC meeting ended, Minutes generated, etc.). Use for Lark bots, real-time message processing, long-running subscribers, streaming webhook/push handlers. Supports `--max-events` / `--timeout` bounded runs and a stderr ready-marker contract — designed for AI agents running as subprocesses.
| name | lark-apps |
| description | 把本地 HTML 文件或目录部署到飞书妙搭（Miaoda），生成一个公网可访问的应用及其链接（URL）。当用户要创建 HTML 或要把 HTML、静态网站或 Web demo 发布成公网可访问的链接 / 可分享链接、设置应用共享范围，或提到妙搭 / Miaoda 时使用。凡产出可独立访问的 HTML 产物都属本 skill 的潜在归宿，是否真要部署由 skill 内部协议判断。不用于：上传普通文件到云空间/云盘/云存储（用 lark-drive）、编辑飞书云文档内容（用 lark-doc）、创建飞书原生幻灯片 / 演示文稿（用 lark-slides）。 |
| metadata | {"requires":{"bins":["lark-cli"]},"cliHelp":"lark-cli apps --help"} |
# 常用示例
lark-cli apps +create --name "客户调研问卷" --app-type HTML
lark-cli apps +html-publish --app-id app_xxx --path ./dist
lark-cli apps +access-scope-set --app-id app_xxx --scope tenant
跑 lark-cli apps --help；若提示暂未支持，告诉用户敬请期待并停止。
CRITICAL — 执行对应操作前，MUST 先用 Read 工具读取以下文件，缺一不可：
../lark-shared/SKILL.md — 认证、权限处理、全局参数（所有操作通用）apps +create） → 必读 lark-apps-create.mdapps +update） → 必读 lark-apps-update.md（部分更新，未传字段不变）apps +html-publish） → 必读 lark-apps-html-publish.md（--path 文件 vs 目录、tar.gz 打包不做过滤）apps +access-scope-set） → 必读 lark-apps-access-scope-set.md（specific / public / tenant 三态互斥校验、targets JSON 结构）apps +access-scope-get） → 必读 lark-apps-access-scope-get.md（响应 scope 枚举 All / Tenant / Range 与 CLI 的 public / tenant / specific 映射；含 jq 复制 scope 配置示例）未读完以上文件就执行相应操作会导致参数选择错误、互斥违反或文件被错误打包。
妙搭应用是用户的个人资产，统一使用 --as user（CLI 默认 --as auto 会按 shortcut 声明自动落到 user）。
首次操作前一次性把本域 scope 全拿到，避免每条命令首次跑都触发新一轮授权：
lark-cli auth login --domain apps
命令失败且 error.subtype == "missing_scope" 时，统一引导用户跑：
lark-cli auth login --domain apps
index.html — 妙搭以 index.html 作为应用入口；目录形态时根目录下要有 index.html，单文件形态时文件名就是 index.html。命名成 app.html / demo.html 等会被 +html-publish 直接拒绝--path 内不能含已知凭据文件 — Validate 阶段会扫描 .env / .env.* / .npmrc / .netrc / .git-credentials / .aws/credentials / .docker/config.json / .kube/config，命中就 exit 非 0 拒绝（dry-run 也一样拦）。要么从产物目录里清掉这些文件，要么明确传 --allow-sensitive 跳过这道检查（例如教程站故意 shipping .env.example 作为示例素材）。--path . 本身不再硬拒，cwd 干净就能发第一步：判断用户意图是「明示部署」还是「仅演示」：
| 用户表达 | 意图 | 处理 |
|---|---|---|
| "部署 ./xxx 的 HTML"、"发布到妙搭"、"开发 xxx 并部署成可分享的网站 / 可访问的链接"、"生成可分享 URL" | 明示部署 / 分享 | 不停下追问，HTML 写完直接走下表 step 1→2 |
| "用 HTML 写一个 PPT / 幻灯片 / 演示文稿"、"做个可演示的 demo"、"写个介绍 xxx 的页面"（没提部署 / 分享 / URL） | 仅演示 | HTML 写完先输出本地文件路径 + 简要说明，主动追问一句："要部署到妙搭以便分享给别人吗？"用户同意再走 step 1→2；用户说不用就停 |
第二步：用户同意部署 / 已明示部署后，按下表走完整链路并把最终 URL 返回给用户：
| 步骤 | 命令 | 说明 |
|---|---|---|
| 1. 新建应用 | apps +create --name "<根据内容主题起的应用名>" --app-type HTML → 从响应里拿 app_id | 默认都走新建（不要尝试搜索 / 枚举已有应用）。用户明确要复用现有应用时让他提供 妙搭应用链接 或 app_id 字符串（详见下方"快速决策"）；--app-type 必填，当前只支持 HTML（区分大小写），未来扩展 |
| 1.5 预检（可选） | apps +html-publish --app-id <id> --path <path> --dry-run 看 manifest | 主要用来看 files / total_size_bytes。凭据文件已经在 Validate 阶段直接 exit 非 0（不再是 advisory warning），所以预检通过就说明走真发也通过；预检报 .env 等命中时，先清产物或加 --allow-sensitive 再 publish |
| 2. 发布 HTML | apps +html-publish --app-id <id> --path <文件或目录> | 必走 |
| 3. 设置可用范围（可选） | apps +access-scope-set --app-id <id> --scope tenant|public|specific ... | 用户说"公开 / 全员可见 / 让 Alice 看 / 互联网可分享"等 |
报告给用户的话术：
应用「{name}」已发布，访问链接：
{url}
若用户没指定可用范围且场景明显需要分享，主动追问一句"要设为企业全员 / 互联网公开吗？"，但不要为了问而问。
apps +html-publish 自动部署并返回 URL，不要追问--scope tenant，不要再传别的 flag--scope public --require-login=<bool>，二选一--scope specific --targets <JSON>；姓名先用 contact +search-user 换 ou_id，群名先用 im +chat-search 换 chat_idapps +create --name "<根据内容主题起的名字>" --app-type HTML 新建一个。不要尝试搜索 / 枚举已有应用 —— 列举应用的命令对 Agent 不可见，强行调用也只会浪费一次 OAPI 请求。如果用户明确要复用现有应用，让他提供下列任一种：
https://miaoda.feishu.cn/app/app_xxxxxxxxxxxxx（或带尾斜杠 /app/app_xxx/）—— app_id 是 /app/ 后面的 path segment（以 app_ 开头）。从 URL 中提取的简单办法：APP_ID=$(echo "$URL" | sed -E 's|.*/app/([^/?#]+).*|\1|')app_xxxxxxxxxxxxx，不需要再做处理--path 既可传单个 HTML 文件也可传目录；目录会递归打包成 tar.gz 不做过滤，要提醒用户传干净的产物目录（如 ./dist），避免把 .git / node_modules 一起打进去apps +update 只更新传入字段，未传字段保持不变；--name / --description 至少传一个，否则 Validate 阶段直接拦截apps +access-scope-set 三种 scope 互斥：specific 必传 --targets、不允许 --require-login；public 必传 --require-login、不允许 --targets / --apply-enabled / --approver；tenant 不允许任何其他 flagerror.hint（CLI 给的可执行修复建议），hint 为空时退回 error.message；不要原样把 envelope JSON 复述给用户。error.subtype == "missing_scope" 例外：按上面「身份与一次性授权」走Shortcut 是对常用操作的高级封装（lark-cli apps +<verb> [flags]）。有 Shortcut 的操作优先使用。
| Shortcut | 说明 |
|---|---|
+create | 创建妙搭应用（name / description / icon-url） |
+update | 部分更新应用名 / 描述（只发传入字段） |
+access-scope-set | 设置应用可用范围（specific / public / tenant，三态互斥校验） |
+access-scope-get | 查看应用当前可用范围（响应 scope 枚举 All / Tenant / Range；可作"备份 / 复制 scope 配置"前置读） |
+html-publish | 把本地 HTML 文件 / 目录 / PPT / 静态网站部署为可分享的妙搭应用，返回访问 URL（用户明示部署 / 分享时直接调；仅说"可演示"时先问用户是否要部署再调） |