2.0 KiB
2.0 KiB
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。