# 技能与工具说明 ## 核心工具: taobao-native CLI 通过 `taobao-native` 命令调用淘宝桌面客户端的所有功能。 ### 调用格式 ```bash taobao-native <工具名> --args '' ``` **重要**: 所有调用必须传入 `sourceApp` 参数标识调用来源,如 `"LemonAI"`。 ### 工具分类 #### 1. 启动工具 | 工具 | 用途 | 示例 | |------|------|------| | launch | 启动淘宝桌面版 | `taobao-native launch` | #### 2. 导航工具 | 工具 | 用途 | 关键参数 | |------|------|----------| | list_available_pages | 获取所有可用页面 | - | | navigate | 导航到预设页面 | page | | navigate_to_url | 打开淘宝 URL | url | | close_page | 关闭当前页面 | - | #### 3. 页面读取工具 | 工具 | 用途 | 关键参数 | |------|------|----------| | get_current_tab | 获取当前标签页 | - | | read_page_content | 读取页面文本 | scope?, maxLength?, offset? | | scroll_page | 滚动页面 | direction, selector?, amount? | | inspect_page | 诊断页面状态 | - | #### 4. 页面交互工具 | 工具 | 用途 | 关键参数 | |------|------|----------| | scan_page_elements | 扫描可交互元素 | filter?, scope? | | click_element | 点击元素 | index 或 text | | input_text | 输入文本 | text, submit? | | trigger_keyboard_event | 触发键盘事件 | key, eventType? | | trigger_key_sequence | 触发按键序列 | text 或 sequence | #### 5. 搜索与商品工具 | 工具 | 用途 | 关键参数 | |------|------|----------| | search_products | 搜索商品 | keyword, type? | | image_search | 以图搜图 | imagePath | | get_product_skus | 获取商品 SKU | itemId? | | add_to_cart | 加入购物车 | itemId?, sku? | | get_browse_history | 获取浏览历史 | type | | submit_product_rating | 提交商品评价 | 多种参数 | #### 6. 旺旺聊天工具 | 工具 | 用途 | 关键参数 | |------|------|----------| | open_chat | 打开旺旺聊天 | source, message, imagePath? | | send_chat_message | 发送消息 | message, imagePath?, shopName? | ## 必读规范 ### 输出文件使用 大结果(搜索结果、页面内容)必须使用 `-o` 参数输出到文件: ```bash taobao-native search_products --args '{"keyword":"iPhone","sourceApp":"LemonAI"}' -o result.json ``` ### 错误处理规则 当 `taobao-native` 命令不可用时: - **Windows**: 检查 APPDATA 中的安装路径,使用完整路径调用 - **macOS**: 使用 `open -a /Applications/淘宝桌面版.app` 尝试打开 - 最终方案: 提示用户需要重启 Agent ### SKU 选择流程(加购前必读) 1. 调用 `get_product_skus` 获取商品 SKU 信息 2. 根据用户选择的规格匹配 3. 调用 `add_to_cart` 传入完整 sku 数组 ### 旺旺聊天规范 - 必须使用 `open_chat` 工具 - 触发关键词: "问问商家"、"旺旺"、"聊天"、"咨询"、"发消息" - 图片发送需先发送图片再发送文字