Starlight_Lancher/.agents/skills/lark-apps/references/lark-apps-list.md

apps +list

列出当前用户可见的妙搭应用，用于从应用名定位 app_id。运行时命令事实以 lark-cli apps +list --help 为准。

何时用

在下游操作需要 app_id、而用户只给了应用名/描述时,用 --keyword 定位。无明确目的的全量枚举会浪费上下文,优先按关键词缩小范围。

命令骨架

• 支持 --keyword 按应用名模糊搜索。
• --ownership 枚举：all / mine / shared（默认 all = 我创建的 + 共享给我的；mine = 仅我创建；shared = 仅共享给我）。
• --app-type 枚举：html / full_stack。
• 分页：--page-size 默认 20，--page-token 传上一页 cursor。

示例

lark-cli apps +list --keyword "审批"
lark-cli apps +list --ownership mine --app-type full_stack
lark-cli apps +list --page-token "<cursor>"

输出契约

• 成功读取 data.items[]；保留字段为 description、app_id、name、is_published、online_url、updated_at，用于候选展示的核心字段是 name、app_id、updated_at。
• is_published=true 只代表应用历史上有发布版本，不代表最新云端会话、最新代码提交或最新 HTML 产物已经部署。
• online_url 是当前已有发布态入口；若你没有在本轮确认发布完成，不要把它描述成“最新版本链接”。
• 默认输出已裁掉 icon_url（图片 URL，agent 无法渲染）和 created_at（与 updated_at 冗余）；需要时可用 --jq 过滤上述保留字段。
• data.items 可能为空；不要把空列表当失败。
• 若有 has_more=true，用返回的 page_token / next_page_token 继续翻页。

Agent 规则

多候选时展示名称、app_id、updated_at 让用户确认。用户描述里已经有 app_xxx 或妙搭链接时，直接提取，不再 +list。

把 +list 当定位工具和发布态快照工具，不要把 is_published 当部署完成证明。需要证明“最新内容已上线”时，使用对应发布命令的完成状态：看 +release-get 的 finished。