# ext2-py-pet-api

**Repository Path**: mind-plus/ext2-py-pet-api

## Basic Information

- **Project Name**: ext2-py-pet-api
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-26
- **Last Updated**: 2026-10-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI课程工具箱 - 桌面精灵（aicoursetoolsdesktoppet）

`aicoursetoolsdesktoppet` 是一个适用于 Mind+ V2 Python 积木模式的扩展，由爱方思（AiFangSi）同名 Mind+ V1.8 用户库 `ai_course_tools_desktop_pet`（桌面精灵）转换而来，配合 AIToolkit2 与 AI 课程使用。

该扩展提供 AI 桌面助手（Assistant）窗口体系：文本输入 / 输出窗口、录音窗口、聊天对话窗口、视频 / 图片播放窗口、模拟器窗口与文件对话框，以及文本 / 音频 / 视频结束 / 图片播放结束 / 聊天提问五类事件回调（帽子积木），可独立进程启动桌面精灵。

本扩展无硬件 SKU，运行依赖本机 AIToolkit2 Python 环境中的 `aitoolkit.qt` 模块（扩展不声明 pip 依赖，与 V1 行为一致）。

## 积木

扩展共 25 个积木，其中 5 个为事件回调帽子积木：

- 初始化：初始化辅助桌面（自动注册已定义的回调）、独立（进程）启动辅助桌面、等待 ESC 键退出
- 文本：打开文本输入 / 输出窗口、文本输出窗口添加文本、当收到文本输入时（帽子）
- 音频：打开录音窗口、播放音频文件 / 音频数据、当收到音频数据时（帽子）
- 视频：打开视频播放窗口、播放视频文件、当视频播放结束时（帽子）
- 图片：打开图片播放窗口、播放图片（路径 / 播放时间 / 循环 / 图片列表）、当图片播放结束时（帽子）
- 聊天：打开聊天窗口、向输入框添加文本、回答提问、当聊天窗口提问时（帽子）
- 其他：打开模拟器窗口、连接模拟器与 PCA9685 控制库、打开文件对话框（打开文件 / 打开多个文件 / 保存文件 / 打开路径）

## 示例程序

V1 源库未包含示例工程文件，本仓库暂未提供可运行示例；典型用法：先「指定Python解释器」指向 AIToolkit2 的 primary 目录，初始化辅助桌面后按需打开窗口并注册回调。

## 支持列表

本扩展为 Python 积木模式（`mode: "python-block"`），不绑定主板，在 Mind+ Python 模式下于 Windows 平台配合 AIToolkit2 使用（V1 config 声明 `platform: ["win"]`）。

## 更新日志

### V2.0.6

- 由 Mind+ V1 用户库 `ai_course_tools_desktop_pet` 2.0.6 完整转换为 Mind+ V2 扩展；积木名称、参数、菜单值与生成代码行为保持一致（`compatibilityId: 爱方思-ai_course_tools_desktop_pet-thirdex`）

## 开发指南

- 源码位于 `extension/`（index.js 积木定义、func.js 生成代码、public/ 配置与本地库、icon/ 图标、locales/ 翻译）。
- 本地 Python 库 `public/libraries/env.py`、`a.py` 负责按 `#env_path` 注释切换到 AIToolkit2 解释器运行生成的脚本。
- 初始化与编译：`npm install` 后 `npm run build`，产物在 `build/`。
- 更详细的 Mind+ V2 扩展开发说明请参考：[Mind+官方扩展开发文档](https://mindplus.dfrobot.com.cn/mp2/Extensions/)