PyCanMV IDE

基于 kendryte/canmv_ide 的 Python 版桌面 IDE（PySide6）。

当前支持两种连接模式：

• K230 串口（原有 OpenMV 协议链路）
• 核桃派 SSH（终端交互 + 远程文件浏览/上传/下载 + 远程运行 Python）

主要功能

• 串口扫描与连接（优先 1209:ABD1）
• 脚本运行/停止、终端输出轮询、REPL 输入
• 帧缓冲预览（JPEG/PNG）与性能面板（FPS/吞吐/丢帧）
• 代码编辑器增强：
• 语法高亮
• 自动缩进与 Tab=4 空格
• 自动补全 + Ctrl+Space 强制补全
• Jedi 语义补全、函数签名提示、定义跳转
• 语法/缩进/空白诊断
• 示例代码浏览器（可配置目录）
• SSH 模式：
• SSH 交互终端（输入即发送到远端 shell）
• 远程目录树浏览（懒加载）
• 远程文件预览、下载到本地、上传本地文件
• 本地编辑器脚本通过 SSH 上传到远端并执行

快速开始

cd pycanmv_ide
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
python -m pycanmv_ide

或安装后使用命令：

pip install -e .
pycanmv-ide

打包 EXE

在 D:\Github\PyCanMV\pycanmv_ide 下执行：

.\build_exe.ps1

默认产物：

dist\PyCanMV_IDE\PyCanMV_IDE.exe

单文件打包：

.\build_exe.ps1 -OneFile

自动发布 Release（推荐）

仓库已内置 GitHub Actions 工作流：.github/workflows/release-onefile.yml

• 触发方式：推送 v* 标签（例如 v0.1.0）
• 自动动作：Windows 打包单文件 EXE，并发布到 GitHub Releases

发布命令示例：

git tag v0.1.0
git push origin v0.1.0

发布后可在仓库右侧 Releases 中直接下载 PyCanMV_IDE.exe。

SSH 使用说明

1. 顶部“连接方式”切换到 核桃派 SSH
2. 填写 IP / 端口 / 用户名 / 密码
3. 点击“连接”
4. 左侧 SSH 远程文件 面板可浏览、上传、下载、预览
5. 点击“运行”将编辑器代码上传到 /tmp/pycanmv_run.py 并执行

备注

• 串口模式下“开机自启”保存到 main.py
• SSH 模式下“保存并设为开机启动(main.py)”会保存到 /root/main.py
• 示例目录路径、SSH 参数、连接方式会写入本地设置

开发文档

• 详见 开发文档.md（包含架构说明、AI 扩展建议、UI 框架迁移路线、回归清单）