# LQ_AI_Config

**Repository Path**: amovlab/lqaiconfig

## Basic Information

- **Project Name**: LQ_AI_Config
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LQ-10 AI 智能配置项目

用 **任意 AI 编程助手**（Cursor、GitHub Copilot、通义灵码、Codeium 等）打开本文件夹，按文档引导即可配置 AMOVLAB LQ-10 图数传。仓库内的规则与 Skill 面向 **Agent/AI**，不绑定某一 IDE。

**清空聊天记录后测试** → 先看 **[docs/TEST-START.md](docs/TEST-START.md)**

**直接说：**

- **「开始配置天空端」** — 接收端 STA（第一次）  
- **「开始配置地面端」** — 发送端 AP（第二次，须先换网线）  
- **「我不知道 IP」** — 自动发现，无需记地址  

---

## 你需要准备

- Windows（**无需安装 Python**，用 **`.\lq10.ps1`**）  
- 网线直连 LQ-10（**每次一台**）  
- 电脑网口 **192.168.1.x**  
- 支持 **Agent 对话** 的 AI 工具（推荐）；亦可手动运行下方 `.\lq10.ps1` 命令

## 换电脑 / Python 环境

**用户与 Agent 均不需要安装 Python。**

| 方式 | 说明 |
|------|------|
| **内置 Python（默认）** | 首次 `.\lq10.ps1` 自动下载 → `tools/python/`（约 25MB） |
| 系统 Python | 仅作回退，**文档与 Agent 不要推荐** |

**验证：**

```powershell
.\lq10.ps1 discover -v
# 应看到 [python] 内置 ...\tools\python\python.exe
```

说明：[tools/README.md](tools/README.md)

## AT 通道

```
本机 192.168.1.x:8080  ──UDP──►  设备 <IP>:52112
```

UART **不能**发 AT。发现设备：**ping 网段 → AT+FWVER?**（非全网 FACTORY 扫描）。

## 配置顺序

1. **天空端** STA（Web 无线页 / apply）→ `--role sky`  
2. **拔网线，改接地面端**（Agent 必须引导，见文档）  
3. **地面端** AP（Web 无线页 / apply）→ `--role ground`  

## USART0 遥控（自动化核心）

| 项 | 说明 |
|----|------|
| 仅 USART0 | USART1/2 不自动配 |
| 物理层 | `sbus` 115200 8N1 |
| 转发 | UDP 单播远端双向 → 对端 IP:7000 **一条** |
| 配置前 | 自动清空旧规则（防 Web 重复两条） |

详见 [docs/USART-SBUS-RULES.md](docs/USART-SBUS-RULES.md)。

## 快速命令

```powershell
.\lq10.ps1 discover -v
.\lq10.ps1 apply --profile full-stack --role sky --discover --dry-run
.\lq10.ps1 apply --profile full-stack --role sky --discover
.\lq10.ps1 apply --profile full-stack --role ground --discover
```

（首次运行 `.\scripts\setup-bundled-python.ps1` 安装内置 Python）

## 源码仓库（Gitee）

克隆与提交推送见 **[docs/GIT-SYNC.md](docs/GIT-SYNC.md)** · 远程：`https://gitee.com/amovlab1/lqaiconfig.git`

## 文档索引

| 文档 | 说明 |
|------|------|
| [GIT-SYNC.md](docs/GIT-SYNC.md) | Git 克隆 / pull / push |
| [TEST-START.md](docs/TEST-START.md) | **测试入口（删聊天后用）** |
| [GUIDED-WORKFLOW.md](docs/GUIDED-WORKFLOW.md) | Agent 主流程 |
| [USER-TEST-GUIDE.md](docs/USER-TEST-GUIDE.md) | 测试清单 |
| [USART-SBUS-RULES.md](docs/USART-SBUS-RULES.md) | 串口与转发规则 |
| [AGENTS.md](AGENTS.md) | Agent 工作说明 |

---

**阿木实验室 AMOVLAB · LQ-10 AI 配置助手**