核心功能
BrickLink Skill 是专为 BrickLink 平台设计的命令行工具，面向 LEGO 零件交易卖家与资深收藏者。该工具通过 Python 脚本封装 BrickLink Store API，完整覆盖订单生命周期管理、商店库存读写操作、目录查询及价格数据分析等核心场景。
订单管理：支持查询进出订单详情、批量获取订单物品清单、消息记录与反馈信息，卖家可更新订单状态、支付状态、物流信息，并发送 "Drive Thru" 自动化邮件。注意 API 限制——仅店铺订单（direction=out）支持状态修改，买家端订单（direction=in）需通过网页操作。
库存运营：提供完整的 CRUD 能力，包括单品上架、批量 JSON 导入、库存数量/价格/状态更新及删除。支持按类别、颜色、状态等多维度筛选查询，适配中小型卖家的日常补货与调价需求。
目录与定价：集成 BrickLink 官方目录数据，可查询零件/套装/人仔的详细属性、超集/子集关系、已知颜色列表，并获取实时价格指南（stock/sold 两种模式），辅助定价决策。
实用工具：内置订单详情 HTML 渲染器，支持内联图片生成，便于离线存档或打印发货单。
显著优点
- 全功能覆盖：相比零散脚本，提供 30+ 个细粒度命令，覆盖 90% 以上的 API 能力
- OAuth 1.0 标准实现：采用业界成熟的签名方案，密钥不硬编码，支持环境变量注入
- 批量操作友好：JSON 批处理模式适合大规模库存迁移，避免逐条 API 调用开销
- 零依赖轻量：纯 Python 标准库实现（假设），无需额外二进制依赖
潜在局限
- 卖家导向设计：核心变异操作（改状态、发邮件）仅限店铺卖家，纯买家体验受限
- API 限制继承：BrickLink API 本身的速率限制、数据延迟（价格指南非实时）与功能边界（如无法归档买入订单）均存在
- 配置门槛：需手动申请 OAuth 密钥对，对非技术用户有一定学习成本
- 生态封闭：仅服务 BrickLink 单平台，无多市场（如 eBay、BrickOwl）联动能力
适合人群
- BrickLink 活跃卖家，日均处理 10+ 订单的中大型店铺运营者
- 价格套利交易者，依赖价格指南数据进行零件投资分析
- 库存管理强迫症用户，需要将 BrickLink 库存与本地 ERP/数据库同步
- 技术型 LEGO 爱好者，偏好 CLI 工作流而非网页后台
常规风险
- 密钥泄露风险：环境变量方式虽优于硬编码，但在共享服务器/CI 日志中仍需注意屏蔽
- 误操作不可逆：
delete-inventory与update-order-status为即时生效，无二次确认机制 - 数据一致性：API 与网页后台存在缓存延迟，高频调价可能导致平台判定异常
- OAuth Token 过期：长期无人值守脚本需处理 401 刷新逻辑（文档未明确说明实现）