Tauri 桌面工具使用说明

AccBot 提供了一个基于 Tauri 的桌面工具，用于管理项目、安装插件、升级 SDK 版本和打包 APK。本文说明工具的各项功能和使用方法。

下载与安装

下载 AccBot Tool 安装包（Windows）

1. 下载后双击运行安装程序
2. 按提示完成安装
3. 启动后默认进入连接页面，输入设备地址和端口连接 Android 设备

项目管理

创建新项目

1. 切换到项目页面
2. 点击新建项目按钮
3. 选择项目存放路径并输入项目名称
4. 工具自动基于模板创建项目，包含以下默认结构：
   • package.json：已配置好 @accbot/accbot_sdk 依赖
   • public/：静态资源目录（插件 zip 会放在这里）
   • src/：示例代码目录，包含可运行的 Demo
5. 创建完成后可以直接运行和编辑

导入已有项目

1. 点击导入项目按钮
2. 选择已有项目的目录路径
3. 工具自动识别项目信息并加入列表

版本显示

每个项目卡片显示以下信息：

• 项目名称和路径
• SDK 当前版本
• 项目状态

插件管理

每个项目行的操作列有插件按钮，点击后弹出该项目的插件管理对话框。

查看已安装插件

插件对话框展示一个表格，包含：

安装插件

1. 点击插件对话框底部的安装插件按钮
2. 从候选列表中选择插件（如 opencv、paddleocr）
3. 工具自动执行 npm install，安装完成后刷新列表

安装完成后，插件包的 postinstall 会自动将 plugin.zip 复制到项目的 public/ 目录。

更新插件

当插件有新版本可用时，该行会显示更新按钮：

1. 点击更新按钮
2. 工具执行 npm install @accbot/accbot-plugin-{name}@latest
3. 更新完成后自动刷新版本信息

卸载插件

1. 点击该插件行的卸载按钮
2. 确认后工具执行 npm uninstall
3. 卸载完成后刷新列表

SDK 版本管理

查看当前版本

项目卡片上显示当前安装的 SDK 版本。

升级 SDK

1. 点击项目卡片上的升级按钮
2. 工具查询远端最新版本并提示
3. 确认后自动执行升级

打开项目

每个项目行的操作列有打开按钮，用于在 IDE 中打开项目：

• 工具自动调用系统默认 IDE（可在设置中配置）
• 也可以直接用文件管理器打开项目目录

常见问题

插件安装后 public/ 下没有 plugin.zip

插件包的 postinstall 脚本负责将 plugin.zip 复制到 public/。如果缺失，尝试重新安装插件：

npm uninstall @accbot/accbot-plugin-{name}
npm install @accbot/accbot-plugin-{name}@latest --registry=https://npm.cnb.cool/accbot/ts/-/packages/

设备连接失败

1. 确认设备与电脑在同一网络
2. 确认设备上已启动 AccBot 服务
3. 检查设备 IP 和端口是否正确