# unihiker-m10-python

**Repository Path**: chenqi1233/unihiker-m10-python

## Basic Information

- **Project Name**: unihiker-m10-python
- **Description**: 用自然语言描述想法，生成适用于 UNIHIKER M10（行空板 M10）的 Python 程序，并通过项目自带的 PowerShell 脚本经 SSH 部署运行。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-05
- **Last Updated**: 2026-08-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# UNIHIKER M10 Python

[English](README.md) | 简体中文

用自然语言描述想法，生成适用于 UNIHIKER M10（行空板 M10）的 Python 程序，并通过项目自带的 PowerShell 脚本经 SSH 部署运行。

本仓库同时也是一个 Agent Skill。Agent 的执行流程和安全规则见 [SKILL.md](SKILL.md)。`SKILL.md` 及发布到 ClawHub 的技能内容保持英文。

## 支持的功能

- 通过 `unihiker` 控制 240×320 触摸屏和图形界面。
- 通过 PinPong 使用板载光线、运动、按键和蜂鸣器等硬件。
- GPIO、PWM、ADC、音频和屏幕亮度控制。
- 通过 USB 或 Wi-Fi 使用 SSH 部署程序。
- 检测并选择 pyenv、uv 或系统 Python。
- Windows 电脑无需安装本地 Python。

## 使用要求

- UNIHIKER M10（行空板 M10）。
- 支持数据传输的 USB Type-C 线，或让 M10 与电脑连接到同一 Wi-Fi。
- Windows 10/11、PowerShell 和 OpenSSH 客户端（`ssh`、`scp`）。

出厂默认连接信息：

| 项目 | 默认值 |
|---|---|
| USB 地址 | `10.1.2.3` |
| SSH 用户 | `root` |
| SSH 密码 | `dfrobot` |

如果设备所有者修改过登录信息，请使用当前凭据。不要把私人密码写入仓库文件。

## 快速开始

在仓库根目录打开 PowerShell：

```powershell
# 1. 检查行空板连接。
.\scripts\check_connection.ps1

# 2. 检测板载 pyenv、uv 和系统 Python。
.\scripts\detect_python_env.ps1

# 3. 保存推荐的运行环境。
.\scripts\detect_python_env.ps1 -SaveEnvFile .\.m10-env.json

# 4. 上传并在后台运行常驻屏幕示例。
.\scripts\run_on_m10.ps1 .\examples\hello_unihiker.py -EnvFile .\.m10-env.json -Background
```

使用 Wi-Fi 时，通过 `-M10Host` 传入行空板的局域网 IP。

## Agent 工作流程

使用本技能的 Agent 应按以下顺序执行：

1. 确认行空板通过 USB 还是 Wi-Fi 连接。
2. 执行连接检查；检查失败时停止后续操作。
3. 检测可用的 Python 环境并让用户选择。
4. 使用 `Board("UNIHIKER").begin()` 生成简洁的 Python 程序。
5. 通过 `run_on_m10.ps1` 上传并运行。
6. 查看标准输出和错误输出，仅进行必要的最小修改。

自然语言需求示例：

```text
在 M10 屏幕显示“你好”。
让 P24 接口的 LED 闪烁五次。
在屏幕显示光线传感器数值，每秒刷新两次。
按下 A 键时让蜂鸣器响一声。
```

## 安装为文件夹技能

将整个仓库克隆或复制到 Agent 使用的 skills 目录。常见路径见 [references/skill-install-paths.md](references/skill-install-paths.md)。

```powershell
git clone https://gitee.com/chenqi1233/unihiker-m10-python.git "$env:USERPROFILE\.codex\skills\unihiker-m10-python"
```

## 发布到 ClawHub

本仓库已针对 ClawHub 做好发布准备：

- `SKILL.md` 使用英文描述技能能力，并声明 OpenClaw 运行要求。
- `.clawhubignore` 会排除仓库说明、许可证和维护专用探测脚本。
- 发布后的技能适用 ClawHub 的 MIT-0 许可条款。

登录符合要求的 GitHub 账号后，使用 ClawHub CLI 发布：

```powershell
npm install -g clawhub
clawhub login
clawhub skill publish . --slug unihiker-m10-python --name "UNIHIKER M10 Python" --categories development,operations --topics "unihiker,m10,python,ssh,hardware"
```

新技能未显式指定版本时，ClawHub 默认从 `1.0.0` 开始。

## 仓库结构

```text
unihiker-m10-python/
|-- SKILL.md
|-- README.md
|-- README_CN.md
|-- scripts/
|   |-- check_connection.ps1
|   |-- detect_python_env.ps1
|   `-- run_on_m10.ps1
|-- examples/
`-- references/
```

## 重要编程规则

- 使用 `Board("UNIHIKER")`，不要使用 `Board("M10")`。
- 屏幕程序必须通过等待或事件循环保持运行。
- 常驻屏幕程序使用 `-Background` 部署。
- 运行程序和安装依赖必须使用用户选择的同一个 Python 环境。

更多信息见 [连接指南](references/connection-guide.md)、[Python 环境说明](references/m10-python-env.md)和 [UNIHIKER 与 PinPong API](references/unihiker-pinpong-api.md)。这些参考资料目前为英文。