auto.js教程笔记（五）环境搭建：TaoToken 统一 Key 打通 autojs 插件与手机端电脑端互连

1. 环境搭建前先理清 autojs 插件与双端互连到底卡在哪如果你正在搜 auto.js 教程、autojs 环境搭建、autox.js 怎么和 VSCode 连起来大概率已经踩过两个坑一是 VSCode 里搜不到 hyb1996 那个老插件二是手机或模拟器死活连不上电脑的 9317 端口。这篇笔记就围绕这两个卡点展开把 autojs 插件安装、Auto.js-Autox.js-VSCodeExt 配置、手机端与电脑端互连调试一次讲透顺带把脚本里要调用的模型接口用 TaoToken 统一 Key 管起来避免每个脚本里散落一堆 API Key。先说清楚这套环境适合谁你有一台 Windows 电脑、一个安卓手机或模拟器、想在 VSCode 里写 autojs/autox.js 脚本并一键跑到设备上。核心链路是 VSCode 装插件 → 插件开服务监听 9317 → 手机 autox.js 主动连电脑 → 脚本 run/save on device。听起来简单但防火墙、插件版本、模拟器网段这三处最容易翻车。我试过把雷电和逍遥都跑了一遍雷电模拟器默认网段是 172.16.x.x和 PC 的 192.168.x.x 不在同一局域网虽然模拟器能 ping 通 PC但 PC 反向 ping 不通模拟器。这不影响 autox.js 连接因为服务端在 PC 的 VSCode 上模拟器作为客户端主动连过来就行。真正卡人的是 Windows 防火墙对 9317 端口的入站拦截以及 VSCode 没被勾选进“允许应用通过防火墙”的列表。另外要提前说明auto.js 普通版和 pro 版的连接方向是反的。普通版以及 autox.js是手机主动连电脑的 VSCode 服务pro 版是手机开服务VSCode 用 pro 插件去连手机。这篇按普通版/autox.js 的流程走pro 用户注意别混用插件两个插件同时开启会冲突建议只留一个。脚本里如果涉及调用大模型接口做 OCR 后处理、文本理解或自动化决策建议统一走 TaoToken 的 API 通道一个 Key 管所有模型调用省得在 autojs 脚本里硬编码多个平台的 Key。下面从插件安装开始一步步把环境跑通。2. TaoToken 前置准备统一 Key 与 API 通道在写 autojs 脚本之前先把模型接口这层理顺。很多自动化脚本后期会加“识别屏幕文字后让模型判断下一步”这类逻辑如果每个脚本都塞一个不同平台的 Key维护起来很痛苦。TaoToken 的作用就是提供一个统一的 API 入口你用同一个 Key 就能调用不同模型脚本里只改 model 字段即可。先注册并拿到 Key。打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 完成账号注册后进入控制台。控制台地址是 https://taotoken.net/console 在 API Keys 页面创建一个新 Key复制保存好后面脚本里会用到。API Keys 直达链接https://taotoken.net/api-keys 。TaoToken 的 API Base URL 是 https://taotoken.net/api 注意这个地址不带 UTM 参数脚本里配置时直接用这个。模型对话调试页面在 https://taotoken.net/chat 你可以先在网页上试一下模型能不能正常返回确认 Key 有效再写进脚本。如果你后面要做长期编码或 Agent 类自动化可以了解下 Coding Planhttps://taotoken.net/coding-plan 。为什么要在 autojs 环境里提前配这个因为 autojs 脚本跑在手机上网络请求用的是手机的网络栈和电脑端调试环境不一样。你需要在脚本里用http.post或fetch发请求Header 里带Authorization: Bearer 你的KeyBody 里指定 model 和 messages。统一用 TaoToken 后换模型只改一个字符串不用动请求结构。这里给一个 autojs 脚本里调用模型接口的最小示例你可以直接复制到 demo.js 里测试// autojs 调用 TaoToken 统一接口示例 var url https://taotoken.net/api/v1/chat/completions; var apiKey sk-你的TaoTokenKey; var headers { Content-Type: application/json, Authorization: Bearer apiKey }; var body { model: gpt-4o-mini, messages: [ { role: user, content: 用一句话说明 autojs 能做什么 } ] }; var res http.postJson(url, body, { headers: headers }); if (res.statusCode 200) { var data res.body.json(); toast(data.choices[0].message.content); } else { toast(请求失败: res.statusCode); }这段代码在手机 autox.js 里直接能跑前提是手机能访问外网。如果你在模拟器里跑确认模拟器网络模式是 NAT 或桥接且能出网。跑通这一步说明你的 Key 和 API 通道没问题后面双端互连调试时就不会把网络问题和接口问题混在一起排查。注意不要把 Key 硬编码在会分享的脚本里。调试阶段可以写在脚本顶部正式使用时建议放到本地配置文件或通过 VSCode 插件下发时替换。TaoToken 控制台可以随时吊销和重建 Key泄露了也不慌。3. VSCode 插件安装与可复制配置片段VSCode 里搜 hyb1996 搜不到是正常的那个插件已经下架或改名。现在用 Auto.js-Autox.js-VSCodeExt 这个插件下载量高兼容 autox.js。安装步骤打开 VSCode点左侧扩展图标搜索Auto.js-Autox.js-VSCodeExt认准作者和下载量点安装。安装完成后按Ctrl Shift P打开命令面板输入auto能看到插件提供的一堆命令包括“开启服务并监听 ADB 设备”“运行脚本”“保存到设备”“停止当前脚本”等。先点“开启服务并监听 ADB 设备”右下角会显示本机的各个 IP 地址包括虚拟网卡的。记下你无线网卡的那个 IP比如 192.168.2.31。插件本身不需要复杂的 settings.json 配置但为了双端连接稳定建议在 VSCode 的 settings.json 里加两行固定服务端口和 ADB 路径如果你用 ADB 连接模拟器{ autojs.port: 9317, autojs.adbPath: C:\\platform-tools\\adb.exe }如果你不用 ADB只走 WiFi 连接autojs.adbPath可以不加。autojs.port默认就是 9317写出来是为了后面排查端口问题时心里有数。保存 settings.json 后重启 VSCode再执行“开启服务并监听 ADB 设备”。这里有个关键点插件开启服务后VSCode 进程会监听 9317 TCP 端口。你可以在 PowerShell 里用netstat -ano | findstr 9317确认监听状态正常会看到TCP 0.0.0.0:9317 LISTENING。如果没看到说明服务没起来检查插件是否安装成功、VSCode 是否以管理员权限运行某些情况下需要。另外如果你同时装了 auto.js 普通版插件和 pro 版插件务必禁用其中一个。两个插件都尝试监听端口或接管命令面板时会出现命令冲突、连接失败等玄学问题。在扩展面板里把不用的那个禁用掉只留 Auto.js-Autox.js-VSCodeExt。配置片段里还可以加一个autojs.deviceIp字段记录你常用设备的 IP但这不是插件原生支持的只是方便你自己查。真正连接时还是要在手机端输入电脑 IP。把上面这段 JSON 复制进 settings.json路径和原文一致不要改键名。4. 手机端与电脑端互连验证与成功结果插件服务起来后打开手机上的 autox.js app。注意不是 auto.js 普通版是 autox.js两者包名和界面略有差异。在 autox.js 里找到“连接电脑”或“连接 VSCode”的入口输入电脑的无线网 IP比如 192.168.2.31端口默认 9317。点连接。如果提示连接失败先别急着改代码。按这个顺序排查第一在电脑上netstat -ano | findstr 9317确认端口在监听第二在手机上用网络工具 ping 电脑 IP确认能通第三在手机上探测 9317 端口如果 ping 通但端口探测不到基本就是防火墙问题。防火墙这块有个大坑光加“入站规则”允许 9317 TCP 还不够。Windows 防火墙的“阻止规则”优先级高于“允许规则”而且 VSCode 如果没被勾选进“允许应用或功能通过 Windows Defender 防火墙”列表它的监听端口对外就是不可见的。操作路径控制面板 → Windows Defender 防火墙 → 允许应用或功能通过 Windows Defender 防火墙 → 找到 VSCode可能显示为 Code.exe→ 在“专用”和“公用”两列都打勾 → 确定。这一步做完手机上再探测 9317 端口通常就能通了。连接成功后VSCode 右下角会显示已连接的设备。在 demo.js 里写一行toast(This is a test)按 F5 或命令面板选“运行脚本”手机上会弹出 toast。这就是双端互连成功的标志。接着试“保存到设备”命令面板选“save on device”选择设备手机上提示“保存成功请刷新目录”下拉刷新就能看到脚本文件。模拟器场景补充雷电模拟器网段是 172.16.x.x和 PC 的 192.168.x.x 不同但模拟器能主动连 PC 的 9317所以照样能用。逍遥模拟器如果网络模式设成桥接可能和 PC 同网段更省事。不管哪种只要模拟器能访问 PC 的 IP 和端口连接就能建立。PC 无法 ping 通模拟器不影响因为服务端在 PC模拟器是客户端。验证成功的完整链路VSCode 插件开服务 → 手机/模拟器 autox.js 连电脑 IP:9317 → 命令面板 run 脚本 → 设备执行 → save on device 回传文件。这四步都通了环境搭建就算完成。5. 本篇常见报错排查401、local proxy failed、reading choices、OAuth报错一401 Unauthorized。这是调用 TaoToken 接口时 Key 不对或没带。检查 Header 里Authorization: Bearer sk-xxx格式是否正确Key 是否被吊销Base URL 是否是https://taotoken.net/api。注意不要写成带 UTM 的官网地址API 地址不带参数。报错二local proxy failed或连接被拒绝。这通常出现在手机连电脑 9317 时。先确认 VSCode 服务已开启netstat能看到监听。然后确认手机和电脑在同一局域网手机能 ping 通电脑。最后检查防火墙VSCode 是否在允许列表里打勾9317 入站规则是否添加。如果全部开启防火墙能连、开启规则不能连就是阻止规则优先级问题去“允许应用”列表勾选 VSCode。报错三reading choices或Cannot read property choices of undefined。这是 autojs 脚本解析模型返回时返回体结构不是预期的 OpenAI 格式。可能原因请求 URL 写错、Key 无效导致返回错误对象、model 字段填了不存在的模型。先在 TaoToken 的模型对话页面 https://taotoken.net/chat 用同样的 model 和消息试一次确认能返回标准结构再对比脚本里的请求体。报错四OAuth相关错误。如果你在脚本里用了某些需要 OAuth 的第三方服务或者插件配置里混入了 OAuth 流程会出现这个。autojs 环境里建议直接用 API Key 方式不要走 OAuth。TaoToken 的接入文档在 https://taotoken.net/doc 里面有标准的 Key 认证说明照着配就不会触发 OAuth 问题。还有一个隐蔽问题auto.js 普通版和 pro 版插件冲突。表现是命令面板里出现重复命令、连接时提示端口被占用、run 脚本没反应。解决办法是禁用其中一个插件只留 Auto.js-Autox.js-VSCodeExt。如果你用的是 pro 版连接方向是反的手机开服务、VSCode 去连手机别按本文的普通版流程走。排查时建议按“先接口后连接”的顺序先用 TaoToken 的 chat 页面确认 Key 和模型可用再确认 VSCode 插件服务起来最后确认手机能连上 9317。这样出问题时能快速定位是哪一层。6. 把 Key 和连接参数管起来后续脚本直接复用环境跑通后建议把 TaoToken 的 Key、Base URL、常用 model 写成一个独立的 config.jsautojs 脚本用require引入。这样换 Key 或换模型只改一个文件不用翻遍所有脚本。VSCode 插件那边把设备 IP 和端口记在 settings.json 的注释里JSON 不支持注释就记在旁边的 README下次连接直接填。如果你后面要做长期编码类自动化比如让脚本根据屏幕内容生成操作序列可以看下 Coding Planhttps://taotoken.net/coding-plan 它更适合高频调用场景。日常调试和验证模型返回用模型对话页面 https://taotoken.net/chat 就够了。API Key 管理在 https://taotoken.net/api-keys 接入文档在 https://taotoken.net/doc 这两个地址建议收藏。最后提醒一句autojs 脚本里发网络请求是异步的http.postJson在部分版本里是同步阻塞在另一些版本里需要回调。如果你发现 toast 没弹出但接口返回正常检查是不是请求还没完成脚本就结束了。加个sleep(2000)或者在回调里处理结果能避免大部分“请求发了但没反应”的假象。环境搭建这一步把连接和接口都跑通后面写业务脚本就是纯逻辑的事了。