用途:在 Glean 中管理推广搜索结果(pins),即把特定文档固定到某些查询结果的前列。
主要能力:提供五个子命令——create(创建 pin)、get(获取指定 pin)、list(列出全部 pin)、update(更新 pin)、remove(删除 pin)。
使用方式:命令形式为 glean pins <subcommand> [flags]。常用标志包括 --dry-run(布尔,默认 false)、--json(传入 JSON 请求体)、--output(可选 json、ndjson、text,默认 json)。示例:glean pins list | jq '.[].id'。可用 glean schema pins 查看该命令的机器可读 schema,或用 glean schema | jq '.commands' 列出全部命令。
前置条件:使用前需阅读 ../glean-shared/SKILL.md,了解认证、全局标志与安全规则。
适用场景:需要将重要文档置顶到特定搜索查询结果时。
限制:资料未提供具体认证方式、权限要求、速率限制及错误处理细节。