核心用法
BrickLink Skill 是一款面向乐高（LEGO）BrickLink 平台的命令行工具，完整封装了 BrickLink Store API（OAuth 1.0 签名）。用户需先在 workspace/bricklink/config.json 配置 OAuth 凭证，或通过环境变量传入，即可调用各类命令。
读取类操作：涵盖订单查询（收/发双向）、订单详情、订单物品、消息、评价；库存列表与单条查询；目录数据（分类、颜色、物品详情、超集/子集、价格指南）；未读通知等。
写入类操作：更新订单字段与状态、支付状态、发送 Drive Thru 邮件；发布/回复评价；库存的创建、批量创建、更新、删除。所有修改操作需显式添加 --yes 确认。
实用工具：order-detail-html 可将订单渲染为紧凑 HTML，便于查看或归档。
显著优点
- 功能全面：覆盖 BrickLink Store API 绝大部分端点，从只读到读写一应俱全，适合自动化店铺运营。
- CLI 友好：纯 Python 脚本，无复杂依赖，适合集成到 CI/CD 或定时任务。
- 安全确认机制：所有 mutating 操作强制
--yes，降低误操作风险。 - 灵活认证：支持配置文件与环境变量双模式，便于多环境部署。
潜在缺点与局限性
- OAuth 1.0 legacy：BrickLink 仍采用 OAuth 1.0，密钥管理较繁琐，无现代 OAuth 2.0 的 token 刷新机制。
- 无内置重试/限流处理：脚本层未体现自动重试或速率限制管理，高频调用可能触发 API 限流。
- HTML 工具依赖外部：
order-detail-html需自行处理图像内联或输出路径，无内置邮件发送功能。 - Python 环境依赖：需预装
python3，Windows 用户可能需额外配置。
适合人群
- BrickLink 店铺卖家，需批量管理库存、自动化订单处理
- 乐高爱好者/数据分析师，需抓取价格指南、目录数据
- 开发者构建周边工具（如定价监控、库存同步）
常规风险
- API 密钥泄露：
config.json含完整 OAuth 凭证，需严格限制文件权限（建议 600），避免提交至版本控制。 - 误操作风险：尽管有
--yes确认，批量库存删除/更新仍可能因参数错误导致数据丢失，建议先get-inventories备份。 - 数据一致性：API 与 BrickLink 网页端状态可能存在延迟，关键操作后建议二次确认。