用途:在 Confluence 中查找内容,属于只读技能,不能创建、修改或删除内容。适用于按文本、标题、标签、空间、日期、创建者检索页面,构建复杂 CQL 查询,导出搜索结果,以及查看本地查询历史。
主要能力:执行 CQL 查询;校验 CQL 语法;获取字段、值、运算符和函数建议;交互式查询构建;将结果导出为 CSV/JSON;对大数据集进行带检查点的流式导出;管理本地查询历史。
常用命令:confluence search cql "space = 'DOCS' AND type = page";confluence search validate "space = 'DOCS' AND type = page";confluence search suggest --fields;confluence search interactive --space DOCS;confluence search export "space = 'DOCS'" --format csv --output results.csv;confluence search stream-export "space = 'DOCS'" --output docs.csv --resume;confluence search history list;confluence search content "meeting notes" --space DOCS。
CQL 字段包括 space、title、text、type、label、creator、contributor、created、lastModified、parent、ancestor、id 等。文本搜索用 ~ 且不区分大小写,= 为精确匹配;日期用 YYYY-MM-DD 或 startOfWeek()、now("-7d") 等函数;含空格的值需加引号。
限制:仅只读;导出仅生成本地文件;历史记录仅存本地。常见错误包括 CQL 语法错误、引号问题、日期格式错误、结果集过大导致超时,可先用 validate 校验、用 stream-export 分批导出。403 表示无空间搜索权限,408 表示查询过于复杂或结果过大。