AScript — Cursor / VS Code 扩展

AScript 的 Cursor/VS Code 版插件：新建工程、连接设备、本地/远程运行脚本（与 IDEA 插件能力对应）。

功能

• 新建 AScript 工程：选择目录后生成 build.as、main.py 及 res/ 结构。
• 在 Windows 本地运行：使用配置的 Python 解释器运行当前工程的 main.py。
• 侧边栏：AScript 视图下的「设备」与「工具箱」（设备列表后续接入你们的 API）。

安装与调试

npm install
npm run compile

在 Cursor/VS Code 中按 F5 或“运行 > 启动调试”即可在扩展开发主机中调试。

打包与上架

• 打包 vsix：npx @vscode/vsce package（需先 npm install -g @vscode/vsce）。
• 发布到 Open VSX（Cursor 使用）：在 open-vsx.org 登录并签署协议后，使用 npx ovsx publish 发布。
• 详见 FEASIBILITY.md 中的上架说明。

配置

• ascript.pythonPath：用于“在 Windows 本地运行”的 Python 解释器路径，默认为 python。

设备扫描与 ADB

• 局域网扫描：自动探测本机网段内开放 9096 端口的设备（Android/iOS AScript 应用），并识别平台。
• ADB 扫描：优先使用扩展自带的 ADB。请将 Android SDK platform-tools 中的以下文件复制到扩展目录下，以便未配置 ANDROID_HOME 时也能扫描到设备：
  • Windows：复制 adb.exe、AdbWinApi.dll、AdbWinUsbApi.dll 到扩展安装目录下的 bin/win/（详见 bin/win/README.txt）。
  • macOS：复制 adb 到 bin/mac/ 并 chmod +x adb（详见 bin/mac/README.txt）。
• 若未在 bin 下放置 ADB，扩展会回退到 ANDROID_HOME/platform-tools/adb 或系统 PATH 中的 adb。

与 IDEA 插件对应关系

本扩展对应 IDEA 插件（D:\workspace\idea\ascript）中的：

• 新建工程 → AScriptProjectGenerator2 / 模板
• 本地运行 → MyScriptRunState.startWindowsLocalProcess
• 设备/工具箱 → DeviceManagerService、ToolGroupAction（设备与 API 接入后续在扩展内实现）

可行性分析见 FEASIBILITY.md。