小鱼精灵开发工具

面向小鱼精灵 Lua 脚本开发的 VS Code 扩展。安装后即可在 VS Code 中编写、补全、运行和打包脚本，并直接使用抓图取色工具。

官方网站与开发文档

功能

• Lua API 补全：输入 find、m.find 等内容即可提示当前公开 API；候选项会显示函数签名、参数、返回值和说明。
• 运行与控制：运行当前 Lua 文件，以及暂停、继续、停止脚本、读取日志。
• 项目打包：根据工作区中的 alpkg.json 生成 .alpkg 脚本包。
• 抓图取色：一键打开内置抓图取色器，支持与 Android 引擎同时连接。

快速开始

1. 在 Android 设备上启动小鱼精灵。
2. 在扩展设置中填写设备地址，例如 192.168.1.100:18380；模拟器也可以使用 127.0.0.1:18380。
3. 打开 Lua 文件，通过命令面板或底部状态栏运行、调试和打包。

使用 ADB 转发时，在高级连接设置中启用“通过 ADB 转发连接”，并按需填写 ADB 路径和设备序列号。

常用命令

• 小鱼精灵：连接设置
• 小鱼精灵：检查连接
• 小鱼精灵：运行当前 Lua 文件
• 小鱼精灵：暂停脚本
• 小鱼精灵：继续脚本
• 小鱼精灵：停止脚本
• 小鱼精灵：读取日志
• 小鱼精灵：打包当前项目
• 小鱼精灵：打开抓图取色器

项目打包

在脚本项目根目录新建 alpkg.json：

{
  "entry": "main.lua",
  "exclude": ["dist/", "*.bak"]
}

执行“打包当前项目”即可生成脚本包。没有该文件时，插件会按上述默认内容创建后继续打包。

文档与反馈

• 官方网站
• 脚本开发文档