星瀚助手 (xinghan-upload)
在 Cursor / VSCode 中通过左侧树视图管理星瀚控制器（ESP32 MicroPython）：上传与运行代码、查看设备文件、串口 REPL 等。
功能概览
所有操作均在左侧「星瀚助手」侧栏和底部状态栏完成，无需使用命令面板（Ctrl+Shift+P）。
左侧侧栏（星瀚助手）
点击左侧活动栏的 星瀚助手 图标，展开两个面板：
星瀚助手（上栏）
- 运行：在控制器上运行当前打开的文件，输出在「输出」面板
- 停止：停止设备上正在运行的程序
- 上传：将当前文件上传到选定容器（container1～container5）
- 联网：向设备发送 WiFi 连接命令（预设或手动输入）
- 串口通信：仅列出星瀚控制器端口（
/dev/cu.usbmodem*），选择后在内置终端进入 REPL
星瀚控制器（下栏）
- 展开 container1～container5 查看设备上的 .py 文件
- 点击 .py 文件：在编辑器中打开，可修改后 Ctrl+S 保存回设备
- 右键 .py 文件 → 删除：从设备上删除该文件
状态栏
底部状态栏提供快捷按钮：星瀚运行、星瀚停止、星瀚上传，与侧栏操作一致。
安装
从 VSIX 安装（推荐）
- 下载
xinghan-upload-0.7.1.vsix（或从 Releases 获取）
- 在 Cursor/VSCode 中：
Cmd+Shift+P（Mac）或 Ctrl+Shift+P（Win/Linux）→ 输入 Extensions: Install from VSIX... → 选择 .vsix 文件
- 重新加载窗口后即可使用
开发调试
- 克隆或下载本仓库，在 Cursor/VSCode 中打开
- 运行
npm install
- 按 F5 启动扩展开发主机，在新窗口中测试
环境要求
- Python 3
- pyserial、mpremote（首次使用时插件会检测并提示安装）
手动安装：pip install pyserial mpremote
星瀚控制器通过 USB 连接后，Mac 上一般为 /dev/cu.usbmodem*；插件仅识别此类端口，其他串口不会在「串口通信」中显示。
配置（可选）
在设置中搜索「星瀚助手」可配置：
| 配置项 |
说明 |
默认 |
xinghan.pythonPath |
Python 解释器 |
python3 |
xinghan.serialPort |
指定串口，留空则自动检测 |
空 |
xinghan.wifiPresets |
预设 WiFi 列表（name、password、authMode） |
见设置说明 |
输出与日志在「输出」面板的 星瀚助手 通道查看。
打包
npm install
npm run esbuild # 编译
npm run package # 生成 .vsix
会在当前目录生成 xinghan-upload-0.7.1.vsix，可分发给他人安装。
更新日志
v0.7.1
- 停止：点击停止后除结束本机进程外，会向设备发送软复位（
machine.soft_reset()），设备上正在运行的程序会真正停止并重启
v0.7.0
- 插件更名为 星瀚助手，活动栏与设置标题统一为「星瀚助手」
- 交互改为仅通过左侧树视图与状态栏，不再依赖命令面板
- 侧栏拆分为两栏：星瀚助手（运行/停止/上传/联网/串口通信）、星瀚控制器（设备上的 .py 文件）
- 串口通信：仅显示星瀚控制器端口（usbmodem），选择后在内置终端进入 REPL；无设备时提示「未找到星瀚控制器」
- 星瀚控制器栏：仅展示 .py 文件；点击在编辑器中打开，保存即写回设备；右键可删除设备上的文件
- 删除设备文件时，右键菜单显示「删除」（仅此命令保留在 contributes 以便菜单文案正确）
v0.6.0
- 首次使用时自动检测 Python 依赖（pyserial、mpremote），可一键安装
- 发布到 Open VSX，Cursor 用户可直接搜索安装
v0.5.0
- 状态栏新增「星瀚停止」，顺序：运行 | 停止 | 上传
v0.4.0
v0.3.0
v0.2.0
- WiFi 连接、删除控制器文件、esbuild 打包
v0.1.0
License
MIT
| |
