用途:通过 Omni CLI 查找、浏览和整理 Omni Analytics 中的内容,包括仪表板、工作簿、文件夹和标签。
主要能力:使用 omni content search --q "关键词" --limit 25 进行全文搜索,匹配仪表板名称、描述、查询名、文件夹名、标签和创建者,结果含 identifier、name、folderPath、url 等;用 omni content list 列出内容,支持 --include '_count,labels'、--scope、--sort-field favorites/updatedAt 及 --cursor 分页;用 omni documents list 列出文档,可按 --creator-id 过滤,并支持 --include labels;用 omni folders list/create 管理文件夹;用 omni labels list、omni documents add-label/remove-label、omni folders bulk-update-labels 管理标签;用 omni documents add-favorite/remove-favorite 管理收藏;用 omni dashboards download 与 download-status 异步下载仪表板(pdf、png)。
使用方式:先确认 Omni CLI 已安装(command -v omni),用 omni config show 查看配置、omni config use <profile-name> 切换配置,用 omni whoami whoami 确认认证与权限。认证使用 API key 或 OAuth;若返回 401,请用户运行 ! omni config login <profile>。可用 -o json 强制结构化输出,-o human 输出可读表格。API 调用务必使用 identifier 字段而非 id。
适用场景:查找特定仪表板、按标签或范围浏览内容、整理文件夹与标签、收藏内容、下载仪表板、获取文档查询定义。
限制:omni content list 暂不支持 --labels 过滤;搜索仅覆盖仪表板,不包含仅工作簿文档;部分仪表板导出可能在创建任务前失败,此时不应调用 download-status 或声称导出完成;config login 不应在无浏览器环境自行运行。相关技能包括 omni-query、omni-content-builder、omni-embed、omni-admin。