- 简体中文 [zh-Hans] # 当前
- 繁體中文 (香港) [zh-Hant-HK]
- 繁體中文 (台灣) [zh-Hant-TW]
- English [en]
- Français [fr]
- Español [es]
- 日本語 [ja]
- 한국어 [ko]
- Русский [ru]
- العربية [ar]
- 支持 AutoJs6 脚本调试与运行的 VSCode 插件
- 克隆 (Clone) 自 hyb1996/Auto.js-VSCode-Extension
- VSCode 菜单
View / 查看-Extensions / 扩展[ Ctrl+Shift+X ] - 搜索 "AutoJs6" 或 "003"
- 选择 "AutoJs6 VSCode Extension" 插件并安装 (或更新)
- 在 VSCode 中连接设备并操作 AutoJs6 的脚本或项目 (运行 / 停止 / 保存 等)
- 在 VSCode 中实时显示 AutoJs6 的日志
- 扫描二维码建立连接, 局域网内自动发现开启服务端模式的设备 (AutoJs6 6.8.0+)
- 配对确认: 未知设备接入前询问, 扫码连接的设备自动信任, 可管理已信任设备
- 浏览, 编辑, 上传, 下载, 删除设备文件及运行设备脚本, 大文件分块传输并显示进度 (AutoJs6 6.8.0+)
- 从设备拉取项目变更 (设备端修改 -> 本地, 逐文件差异预览)
- 心跳检测与自动重连, 状态栏设备指示器
- 本地 HTTP 命令桥, 供外部工具触发插件命令
- 界面文案跟随 VSCode 显示语言 (简体中文 / English), 也可通过
autojs6.language显式指定
- 基本操作
< 命令面板 >- VSCode 菜单
View / 查看-Command Palette / 命令面板[ Ctrl+Shift+P ]
- VSCode 菜单
< 开发人员工具 >- VSCode 菜单
Help / 帮助-Toggle Developer Tools / 切换开发人员工具
- VSCode 菜单
< 菜单按钮 >- VSCode 标题区域按钮, 位于顶部区域, 用于快捷操作文件或项目
- 连接到计算机
- 打开
< 命令面板 >选择AutoJs6: 建立设备连接 (Connect)[ Ctrl+Alt+F6 ], 或点击相应的菜单按钮 - 使用下述方式之一建立设备连接 (任选其一)
服务端模式 (Server) | 局域网 (LAN)- AutoJs6 侧拉菜单中开启 "客户端模式"
- 输入 VSCode 弹窗显示的本机 IP 地址 (插件监听端口
6347, 需在防火墙放行, 可通过autojs6.server.port修改)
服务端模式 (Server) | 二维码 (QR Code)- VSCode 显示本机连接二维码 (可切换网络接口)
- AutoJs6 (6.8.0+) 侧拉菜单点击 "客户端模式", 点击地址输入框右侧的扫码按钮扫描二维码后自动连接
客户端模式 (Client) | 局域网 (LAN)- AutoJs6 侧拉菜单中开启 "服务端模式" (监听端口
7347) - VSCode 输入 AutoJs6 所在设备的 IP 地址或域名, 可附带端口 (如
192.168.1.5:7347,[fe80::1]:7347) - 意外断开后插件将自动重连 (指数退避, 默认持续 5 分钟, 可通过
autojs6.connection.autoReconnect关闭), VSCode 重启后自动恢复上次连接 (autojs6.connection.restoreOnStartup) - 任一方显式断开 (VSCode 命令或 AutoJs6 侧拉菜单 / 管理器) 后不再自动重连
- AutoJs6 侧拉菜单中开启 "服务端模式" (监听端口
客户端模式 (Client) | 安卓调试桥 (ADB)- AutoJs6 侧拉菜单中开启 "服务端模式"
- AutoJs6 所在设备通过 USB 连接到 VSCode 所在计算机
- AutoJs6 所在设备需启用 USB 调试模式并勾选信任上述计算机
- 不同设备操作方式可能不同 详见设备厂商手册或相关互联网资料
历史记录 (IP)- 连接成功后的设备 IP 地址会记录在列表中方便选择
- AutoJs6 需启用 "服务端模式"
- 设备 IP 地址可能发生改变
- 使用 "清理" 选项清除所有已保存的记录
- VSCode 弹窗显示
AutoJs6 设备接入: ${DEVICE} (${IP_ADDRESS})完成设备连接
- 执行命令
- 打开
< 命令面板 >查看并执行支持的命令 (快捷键详见下述 "命令" 板块) - 如
AutoJs6: 运行脚本 (Run)AutoJs6: 停止所有脚本 (Stop All)等 - 部分功能可通过点击相应的菜单按钮实现
- 查看日志
- 采用下述方式之一查看来自 AutoJs6 的日志 (任选其一)
- 在建立设备连接后弹出的
OUTPUT / 输出面板[ F12 ]查看 (每台设备一个面板) - 点击状态栏的
AutoJs6: N指示器选择设备后选择 "显示日志"
- 在建立设备连接后弹出的
- 设备断开后面板默认保留并标记断开, 可通过
autojs6.log.disposeChannelOnDisconnect设置为自动移除 - 插件自身的调试日志可通过
autojs6.log.debug开启, 位于AutoJs6 VSCode Extension Debug面板
- 管理设备文件 (AutoJs6 6.8.0+)
- 点击活动栏的
AutoJs6图标, 在 "设备文件 (Device Files)" 视图中浏览已连接设备的工作目录与外部存储 - 单击文件即可在编辑器中打开, 修改后使用 VSCode 的保存功能直接写回设备
- 右键或使用行内按钮可运行脚本, 新建文件夹/文件, 上传当前文件或本地文件, 下载, 重命名, 删除
- 右键设备目录选择 "上传文件夹到此目录 (Upload Folders)", 可多选本地文件夹, 在目标目录下保留所选文件夹名称, 子目录与空目录; 同名目录合并, 同名文件覆盖, 设备上其他文件保留. 上传显示当前路径并支持取消 (已上传内容保留); 符号链接及不支持的文件类型会跳过并提示
AutoJs6: 浏览设备文件 (Browse Device Files)可将设备目录作为工作区文件夹加入资源管理器
- 断开连接
- 采用下述方式之一断开所有 AutoJs6 与 VSCode 建立的连接 (任选其一)
- 打开
< 命令面板 >选择AutoJs6: 断开所有连接 (Disconnect All)[ Ctrl+Alt+Shift+F6 ] - 在 AutoJs6 侧拉菜单关闭对应开关 (客服端 / 服务端)
- 断开 AutoJs6 的 USB 连接 (仅适用于 ADB (USB) 连接方式)
- 退出 AutoJs6 应用 / 关闭 VSCode 软件
- 打开
- 查看在线文档 (View Online Document)
[ Alt+Shift+F6 ]- 查看 AutoJs6 在线开发文档
- 建立设备连接 (Connect)
[ Ctrl+Alt+F6 ]- 建立 AutoJs6 与 VSCode 的连接
- AutoJs6 相关开关可能需要手动开启
- 显示连接二维码 (Show QR Code)
[ CTRL+ALT+6 Q ]- 显示供 AutoJs6 客户端模式扫描的连接二维码
- 断开所有连接 (Disconnect All)
[ Ctrl+Alt+Shift+F6 ]- 断开所有已建立的连接
- AutoJs6 相关开关状态可能被重置
- 断开指定设备 (Disconnect Device)
- 选择需要断开的设备
- 重新连接上次的设备 (Reconnect)
- 立即重试正在重连的目标, 或恢复上次成功连接的设备 (局域网 / ADB)
- 停止自动重连 (Cancel Reconnect)
- 停止所有进行中的自动重连会话
- 从设备拉取项目变更 (Pull Project from Device)
- 比较设备上的项目副本与本地项目, 勾选设备端新增 / 修改的文件拉回本地, 可逐文件预览差异
- 管理已信任设备 (Manage Trusted Devices)
- 查看并移除已信任的 AutoJs6 设备 (移除后该设备下次接入时需重新确认)
- 选择设备 (Select Device)
- 列出已连接设备并选择操作 (显示日志 / 运行 / 保存 / 浏览文件 / 断开), 也可点击状态栏指示器
- 运行脚本 (Run)
[ F6 ]- 运行当前 VSCode 对应的脚本
- 对所有已连接的设备有效
- 重新运行脚本 (Rerun)
- 停止当前 VSCode 对应的脚本并重新运行
- 对所有已连接的设备有效
- 停止当前脚本 (Stop)
[ Ctrl+F6 ]- 停止当前 VSCode 对应的脚本
- 对所有已连接的设备有效
- 停止所有脚本 (Stop All)
[ Ctrl+Shift+F6 ]- 停止所有正在运行的脚本
- 对所有已连接的设备有效
- 保存到所有设备 (Save)
- 保存当前文件到已连接设备的 AutoJs6 工作目录
- 对所有已连接的设备有效
- 指定设备运行 (Run On Device)
- 弹出设备菜单并指定运行 VSCode 对应脚本的设备
- 保存到指定设备 (Save To Device)
- 弹出设备菜单并在指定保存 VSCode 对应脚本的设备
- 新建项目 (New Project)
[ CTRL+ALT+6 N ]- 选择 (或创建后选择) 一个空文件夹用于新建 AutoJs6 项目
- 新建项目后执行
npm run dts-link或npm run dts可完成声明文件部署
- 运行项目 (Run Project)
[ CTRL+ALT+6 R / Alt+F6 ]- 运行一个 AutoJs6 项目
- 保存项目到设备 (Save Project)
[ CTRL+ALT+6 S ]- 保存一个 AutoJs6 项目 (增量同步, 需 AutoJs6 6.8.0+ 才会同步删除设备上已删除的文件)
- 重新完整同步项目 (Resync Project)
- 向设备发送项目全部文件并覆盖同名文件
- 浏览设备文件 (Browse Device Files)
- 将设备目录作为工作区文件夹加入资源管理器 (AutoJs6 6.8.0+)
| 配置项 | 默认值 | 说明 |
|---|---|---|
autojs6.language |
auto |
插件界面文案的语言: auto (跟随 VSCode 显示语言), en 或 zh-cn; 命令标题与配置说明始终跟随 VSCode 显示语言, 修改后需重新加载窗口以全面生效 |
autojs6.server.port |
6347 |
插件监听端口 (AutoJs6 客户端模式连接目标) |
autojs6.server.confirmUnknownDevices |
true |
未知设备 (客户端模式) 接入前先询问; 扫码连接或已选择 "允许并记住" 的设备无需确认 |
autojs6.client.port |
7347 |
AutoJs6 服务端模式默认端口 |
autojs6.http.enabled / autojs6.http.host / autojs6.http.port |
true / 127.0.0.1 / 10347 |
本地 HTTP 命令桥, 如 http://127.0.0.1:10347/exec?cmd=run&path=... |
autojs6.adb.path |
空 | adb 可执行文件路径或目录, 留空时自动探测 |
autojs6.discovery.enabled |
true |
建立局域网连接时通过 mDNS (_autojs6._tcp) 搜索开启了服务端模式的 AutoJs6 6.8.0+ 设备 |
autojs6.connection.connectTimeout / handshakeTimeout |
8000 / 6000 |
连接与握手超时 (毫秒) |
autojs6.connection.heartbeatInterval / heartbeatTimeout |
15000 / 10000 |
心跳间隔与超时 (毫秒), 间隔为 0 时禁用 |
autojs6.connection.autoReconnect / maxReconnectAttempts |
true / 0 |
插件主动连接意外断开后自动重连, 次数为 0 时不限 |
autojs6.connection.reconnectTimeout / reconnectMaxDelay |
300 / 10000 |
单次重连会话的时间窗 (秒, 0 不限) 与最大退避间隔 (毫秒) |
autojs6.connection.restoreOnStartup |
true |
VSCode 启动时恢复上次成功连接的设备 (显式断开的除外) |
autojs6.log.showChannelOnConnect |
true |
设备接入时自动显示日志面板 |
autojs6.log.disposeChannelOnDisconnect |
false |
设备断开时移除日志面板 |
autojs6.log.debug |
false |
记录插件调试日志 |
autojs6.save.keepRelativePath |
true |
保存文件时保留相对工作区的目录结构 (AutoJs6 6.8.0+) |
通信协议详见 protocol.md.
- AutoJs6 { author: SuperMonster003 }
安卓平台 JavaScript 自动化工具 (二次开发项目)
- AutoJs6-TypeScript-Declarations { author: SuperMonster003 }
AutoJs6 声明文件 (代码智能补全)
- Auto.js-VSCode-Extension { author: hyb1996 }
Auto.js VSCode 开发插件
- Auto.js-VSCode-Extension { author: 710850609 }
Auto.js VSCode 开发插件 (二次开发项目)
- Auto.js-VSCode-Extension { author: kkevsekk1 }
Auto.js VSCode 开发插件 (二次开发项目)
新增活动栏 "AutoJs6" 视图: "设备 (Devices)" 列表与 "设备文件 (Device Files)" 树, 支持浏览/打开/编辑/上传/下载/重命名/删除设备文件及运行设备脚本 (需 AutoJs6 6.8.0+)新增设备文件视图支持上传本地文件夹 (可多选), 保留子目录与空目录, 合并同名目录并覆盖同名文件, 支持进度提示与取消新增远程文件系统autojs6fs://, 设备文件可直接在编辑器中打开并保存回设备; "浏览设备文件" 命令可将设备目录加入工作区新增二维码连接: "服务端模式 | 二维码" 显示本机连接二维码, AutoJs6 6.8.0+ 客户端模式扫码后自动连接issue #12新增通信协议 v2: 应用层心跳 (ping/pong) 检测半死连接, 插件主动连接 (局域网/ADB) 意外断开后自动重连issue #3issue #13新增自动重连会话: 意外断开后按指数退避持续重连 (默认 5 分钟, 可配置次数 / 时间窗 / 最大间隔), VSCode 重启后自动恢复上次连接 (autojs6.connection.restoreOnStartup); 新增 "重新连接上次的设备 (Reconnect)" 与 "停止自动重连 (Cancel Reconnect)" 命令, 状态栏显示重连进度新增断开通告bye: 任一方显式断开连接时告知对端, 对端不再自动重连也不再于启动时恢复; VSCode 关闭时发送bye(shutdown)以便 AutoJs6 (6.8.0+) 稍后自动重连新增配对确认: 未知设备以客户端模式接入时先询问 "允许并记住 / 仅本次允许 / 拒绝", 扫描二维码连接的设备凭一次性令牌自动信任; 新增 "管理已信任设备 (Manage Trusted Devices)" 命令与autojs6.server.confirmUnknownDevices配置 (AutoJs6 6.8.0+ 会显示 "等待 VSCode 端确认" 提示)新增局域网发现 (mDNS): "客户端模式 | 局域网" 连接列表自动列出局域网内开启了服务端模式及 "局域网发现" 的 AutoJs6 6.8.0+ 设备, 可通过autojs6.discovery.enabled关闭新增大文件分块传输: 设备文件读写超过 1 MiB 时按 1 MiB 分块传输并显示可取消的进度 (AutoJs6 6.8.0+)新增"从设备拉取项目变更 (Pull Project from Device)" 命令: 比较设备上的项目副本与本地项目, 列出设备端新增 / 修改的文件, 支持逐文件差异预览后勾选拉回本地 (AutoJs6 6.8.0+ 通过fs.list的md5比较, 旧版按内容比较)新增国际化: 界面文案跟随 VSCode 显示语言 (简体中文 / English), 命令与配置说明亦已本地化 (vscode.l10n)新增状态栏设备指示器 (点击可快速选择设备执行运行/保存/查看日志/断开等操作)新增配置项 (autojs6.*): 监听端口, HTTP 命令服务地址与端口, adb 路径, 连接/握手/心跳超时, 自动重连, 日志面板行为, 保存时保留相对路径等新增连接地址支持域名与自定义端口 (host:port,[ipv6]:port)issue #20新增"重新完整同步项目 (Resync Project)" 命令, 强制全量覆盖设备上的项目issue #29修复端口 6347/10347 被占用 (如同时打开多个 VSCode 窗口) 时插件激活失败, 导致所有命令 "not found" 的问题issue #14issue #15修复Linux / macOS 下adb devices结果按 Windows 换行符解析导致无法识别设备的问题; 增加 adb 路径自动探测 (ANDROID_HOME,ANDROID_SDK_ROOT, 常见安装目录) 与autojs6.adb.path配置issue #35修复项目增量同步override标志取反以及 Windows 下deletedFiles含反斜杠导致设备端文件无法删除的问题 (需配合 AutoJs6 6.8.0+)issue #29修复焦点位于输出面板时 "停止当前脚本" 与 "保存" 命令取到错误编辑器的问题修复握手超时或断开后访问已销毁连接抛出异常的问题修复设备断开后输出面板未处理的问题: 默认保留日志并标记断开, 可通过autojs6.log.disposeChannelOnDisconnect自动移除issue #30修复ADB 连接断开后未移除端口转发的问题修复意外断开后偶发 "无法重新连接 ..., 已停止重试" 误报的问题 (原固定 5 次约 31 s 后即放弃); 失败提示改为在重连窗口结束后仅出现一次并提供 "重试" / "不再自动恢复"优化保存/运行文件时携带相对工作区路径, AutoJs6 6.8.0+ 按目录结构保存到工作目录issue #37优化HTTP 命令服务默认仅监听127.0.0.1(原为0.0.0.0), 避免局域网内其他主机触发本机命令优化网络接口列表过滤 Hyper-V / VirtualBox / Docker / WSL 等虚拟网卡并优先展示默认网关接口issue #12优化连接二维码降低模块密度 (更短载荷, 低纠错等级) 并提供尺寸滑块, 便于 AutoJs6 扫码对焦优化项目同步遍历时直接跳过ignore目录 (如node_modules), 移除整包字节调试输出优化代码结构拆分为协议/设备/界面/远程文件/二维码等模块, 增加纯 Node.js 单元测试 (npm test)优化使用 esbuild 打包, vsix 体积由 9.6 MB 缩减至约 1 MB; 以tiny-pinyin与系统路由表探测替代pinyin/systeminformation依赖优化README 补充端口说明与协议文档protocol.mdissue #10
优化重构设备端 Socket 分帧协议: 使用固定 8 字节二进制帧头 (int32BE 长度 + 类型) 替代旧的文本式头部写入方式优化TCP 流解析逻辑使用基于累积缓冲区的循环拆帧模型, 提升对半包与粘包场景的处理可靠性优化增加帧合法性校验 (类型检查与最大帧长度限制), 用于尽早发现协议失步并防止异常内存膨胀优化发送 JSON 及二进制数据时移除不必要的字符串中转流程
修复服务端模式因版本判断失误导致无法连接的问题issue #27优化新建项目支持使用dts-link脚本任务自动创建 AutoJs6 声明文件 软链接issue #8
请编辑 .readme/ 与 .changelog/ 中的语言 JSON 和模板后重新生成文档, 不要直接修改生成的 Markdown. 根 README 使用简体中文. 下列命令需要 Python 3.10 或更新版本, 无需额外 Python 包; Windows 可用 py 替代 python. --check 只读校验语言集合, 字段, 历史版本与日期, 标点和生成结果, CI 同样执行此检查.
python .python/generate_markdown.py
python .python/generate_markdown.py --check
python -m unittest discover -s .python/tests