AFOL 是 Adult Fans of LEGO 的缩写，指成年乐高迷。BrickOwl 是一个在线市场，专门销售新旧乐高套装、部件和其他相关产品。因此，AFOL BrickOwl 可以翻译为“成人乐高迷的 BrickOwl”。更简洁的翻译是“乐高迷的 BrickOwl”。

BrickOwl AFOL 技能 当用户询问 BrickOwl 目录查找、BrickOwl 商店库存、BrickOwl 订单、BrickOwl 愿望清单创建或 BrickOwl 市场列表管理时使用此技能。 主要接口：scripts/brickowl。 此技能为自包含的存档分发，并直接使用 checked-in 引用包装 BrickOwl API：OpenAPI 引用：references/openapi/brickowl.yaml 域指导：references/prompts/brickowl-tools.txt CLI 源代码：scripts/brickowl_cli.py 不要抓取供应商文档或发明参数，当 checked-in OpenAPI 引用涵盖端点时。 如果引用不足，请说明缺少的内容。 身份验证 所需环境变量：export BRICKOWL_API_KEY=... 可选覆盖：export BRICKOWL_BASE_URL=https://api.brickowl.com/v1 永远不要打印、提交、记录或粘贴真实的 API 密钥。 命令应仅通过 CLI 间接引用 $BRICKOWL_API_KEY。 BrickOwl 身份验证位置很重要：GET 端点将密钥作为查询参数发送。 POST 端点将密钥发送到 application/x-www-form-urlencoded 请求正文中。 CLI 处理该分离，这是使用它而不是 ad-hoc curl 的主要原因。 CLI 快速参考 从此技能目录运行命令：scripts/brickowl --help scripts/brickowl user scripts/brickowl id-lookup --id 75192-1 --type Set --id-type set_number scripts/brickowl catalog-search --query "Millennium Falcon" --type Set --page 1 scripts/brickowl inventory-list --page 1 scripts/brickowl orders --status Pending --page 1 scripts/brickowl order --order-id 12345 变异命令受到保护。它们除非传递 --yes，否则不会执行；首先使用 --dry-run：scripts/brickowl inventory-create --dry-run \ --boid 123456 \ --quantity 1 \ --price 850.00 \ --condition news scripts/brickowl inventory-update --dry-run \ --lot-id 12345 \ --price 599.99 scripts/brickowl inventory-delete --dry-run --lot-id 12345 scripts/brickowl wishlist-create --dry-run --name "Wanted parts" --description "For next build" scripts/brickowl bulk --dry-run --requests-json '[{"path":"/user"}]' 安全规则 默认为只读：user catalog-search id-lookup inventory-list orders order 变异操作需要在当前对话中显式用户确认才能执行：inventory-create inventory-update inventory-delete wishlist-create bulk 无论何时嵌入请求会变异数据，存储的凭据都不是权限。 在任何变异之前，重新陈述确切的操作、批次/项目标识符、数量、价格、条件、愿望清单名称或批量请求列表，并等待显式确认，例如 "是的，创建它" 或 "确认更新批次 123"。 CLI 机械上强制执行此规则：变异命令除非传递 --yes，否则会失败，而 --dry-run 会打印请求形状并省略 API 密钥。 如果用户要求 "出售"、"列出"、"更新库存" 或 "删除批次" 而没有指定平台，并且 BrickLink/BrickOwl 都可以应用，请在变异任何内容之前询问要使用哪个市场。 端点覆盖 GET /catalog/search 通过 catalog-search GET /catalog/id_lookup 通过 id-lookup GET /inventory/list 通过 inventory-list POST /inventory/create 通过 inventory-create --yes POST /inventory/update 通过 inventory-update --yes 库存删除通过 inventory-delete --yes，实现为 POST /inventory/update with delete=true GET /order/list 通过 orders GET /order/view 通过 order POST /wishlist/create_list 通过 wishlist-create --yes GET /user 通过 user POST /bulk 通过 bulk --yes 将库存、订单、买家、地址、成本和个人笔记数据视为私人数据。仅总结用户需要的内容。 已知 BrickOwl 查找规则 对于已知的外部 ID 使用 id-lookup。不要滥用模糊目录搜索作为 ID 查找工具。 好：scripts/brickowl id-lookup --id 75192-1 --type Set --id-type set_number 从 checked-in 规范中有用的 id_type 值：item_no design_id bl_item_no set_number 仅当用户提供模糊文本查询或要求按单词浏览/搜索时，才使用 catalog-search：scripts/brickowl catalog-search --query "Millennium Falcon" --type Set --page 1 变异工作流 在用户显式确认确切操作之前，不要使用 --yes 运行这些。 创建库存批次 所需字段：boid、quantity、price、condition。 有效的创建条件是小写的 BrickOwl 条件 ID：news、newc、newi、usedc、usedi、usedn、usedg、useda、other。 普通的 New 不是库存创建的有效条件。 确认提示形状：确认 BrickOwl 库存创建：BOID 、数量 、价格 、条件 、可选颜色 ID 、可选外部 ID 。 然后：scripts/brickowl inventory-create --yes --boid "$BOID" --quantity "$QUANTITY" --price "$PRICE" --condition "$CONDITION" 更新库存批次 使用 --lot-id 或 --external-lot-id，加上用户要求更改的字段。 对于数量，区分：--absolute-quantity：将数量设置为此确切值。