核心用法
taobao-native 是一款调用淘宝桌面客户端（Chromium 内核）的 CLI 自动化工具，通过原生输入事件模拟用户操作。核心能力覆盖：商品搜索与以图搜图、SKU 智能选择与加购、订单管理（查单/催发货/开票）、旺旺即时通讯、商品评价自动化提交等。
调用格式统一为 taobao-native <工具名> --args '<JSON 参数>'，关键约束包括：必须传入 sourceApp 标识来源、大结果量工具需加 -o <文件> 避免截断、加购前必须先调 get_product_skus 获取规格、旺旺聊天强制使用 open_chat 而非手动导航。
显著优点
- 免登录免验证：直接复用用户已登录的桌面客户端会话，绕过淘宝反爬与验证码机制
- 原生事件可靠性：Chromium 原生输入事件比浏览器自动化更稳定，减少元素定位漂移
- 本地执行不干扰：在用户桌面应用内运行，不弹出额外浏览器窗口，体验更接近真人操作
- 流程闭环完整：搜索→加购→下单→客服→评价全链路覆盖，支持 SKU 自动选择与图文消息发送
潜在缺点与局限性
- 环境依赖重：必须先安装「淘宝桌面版」应用，Windows/macOS 均有独立安装包，首次配置门槛较高
- 平台受限：仅支持 Windows 与 macOS，无 Linux 版本；CLI 命令需正确配置环境变量，否则需重启 Agent
- 大结果截断风险：
search_products等工具返回数据量可达 50+ 条，必须显式加-o参数输出到文件，否则 stdout 截断导致数据丢失 - SKU 匹配严格：
sku参数必须与页面维度完全匹配，维度数量错误会直接失败，需前置调用get_product_skus获取准确结构 - 评价工具独占性：商品评价页面禁止混用通用交互工具，必须用专用
submit_product_rating，且多商品评价需保证文案差异化
适合人群
- 高频淘宝/Tmall 买家，需自动化比价、批量加购、定时抢购
- 电商运营人员，需自动化提交评价、批量客服沟通
- 代购或采购代理，需快速多 SKU 下单与发票管理
- 自动化测试/ RPA 开发者，需在电商场景构建稳定工作流
常规风险
- 账号安全风险：自动化操作仍受淘宝风控监测，高频或异常行为可能触发限流、登录态失效或短期封禁
- 数据写入风险：
-o参数若指向未授权路径会触发OUTSIDE_AUTHORIZED_ROOT，需确保使用任务 workspace 内的绝对路径 - 版本兼容风险：淘宝桌面版更新可能导致 DOM 结构变化，需关注 CLI 版本同步更新
- 敏感信息暴露：评价内容、聊天记录、订单信息在日志中可能明文记录，需在多用户环境注意隔离