生成前信息采集清单
本页用于客户提出需求之后、动手生成代码之前的信息采集与确认：无论人工开发，还是把需求交给 AI 助手（Agent），都建议先按本清单逐项确认，避免默认假设（写错语言、取错环境的库、有真机却连不上）。
怎么用
- ★ 必问项：售前 / 对接人逐条问客户并填入「填写」栏；
- AI 助手（Agent）：先问再生成，缺项不要猜；
- 配套阅读：Agent 开发指引（§2「动手前先问清楚」）· 编译与验证指南（无真机时的三级验证）。
1. 语言与编译环境
| 项目 | 关键说明 | 填写 |
|---|---|---|
| ★ 开发语言：C++ / C# / Python | 三语言各有「快速开始」与对应库 | |
| ★ 编译环境（C++ 时）：MinGW(Qt) / MSVC(VS) / Linux GCC | 库按环境区分、不可混用；Linux 注意 gcc-4 / gcc-9 库与编译器配套（见 Linux 环境） | |
| 上位机运行平台：Windows x64 / Linux x64 | 决定取哪套库、动态库加载方式 |
2. 版本匹配（防「连不上 / 跑不起来」）
| 项目 | 关键说明 | 填写 |
|---|---|---|
| ★ 控制器固件版本：RTL-xx.xx | SDK 版本必须与固件对应（见版本与兼容性与下载页） | |
| SDK 包来源 / 版本：如 v2.0.4-24.03 | 与固件一致；确认下载来源 |
3. 现场连接信息
| 项目 | 关键说明 | 填写 |
|---|---|---|
| ★ 是否已有真实控制器：有 / 无 | 有 → 真机联调；无 → 编译级三级验证 | |
| ★ （有真机时）控制器 IP + SDK 端口 | 端口默认 6001；IP 写入程序配置或命令行参数 | IP：____ 端口：____ |
| 网络连通性 | 上位机与控制器同网段 / 已互通（可视情况先 ping 验证） |
4. 机器人本体（影响接口选择）
| 项目 | 关键说明 | 填写 |
|---|---|---|
| 机器人数量（请客户选择）：单机器人 / 双臂机器人 / 其他数目 | 双臂（多机器人）使用 _robot 多机接口，写法与单机不同；选择“其他数目”时请注明具体数量 | |
| 轴数 | 默认按 6 轴，无需询问；仅当客户明确说明轴数（4 / 7 …）时，按其说明 | 默认 6 轴 |
| 外部轴 | 默认没有，无需询问；仅当客户明确说明带外部轴时才按外部轴处理 | 默认无 |
| 是否有仿真环境 | 无真机时可用于验证（可选；没有则按编译级验证） |
5. 功能需求（勾选 / 补充）
| 模块 | 常见内容 | 选择 |
|---|---|---|
| 连接与状态 | 连接 / 状态查询 / 版本 / 读位置 | |
| 运动 | 点位 MoveJ / 直线 MoveL / 点动 | |
| IO | 数字输出 / 数字输入 / 模拟量 | |
| 进阶 | 作业文件 / 队列运动 / 轨迹记录回放 | |
| 工艺 | 焊接 / 码垛 / 视觉 / 激光切割 / 传送带跟踪 | |
| 其它 | 自定义需求：________________ |
6. 交付形式与验证
| 项目 | 选项 | 选择 |
|---|---|---|
| 交付形式 | 源码 / 可编译工程（VS、Qt、Makefile）/ 可运行的示例程序 | |
| 程序形态 | 控制台示例 / 带界面（Qt、WinForms） | |
| 验证方式 | 真机联调 / 无硬件三级验证（L1 语法 → L2 编译链接 → L3 运行自检） |
7. 安全确认（涉及真实运动时，运行前必查）
- [ ] 工作空间内无人员与障碍物；急停按钮可用且在可触及范围内
- [ ] 首次运行使用低速；已核对轴号 / 方向 / 目标点位 / IO 端口
- [ ] 生成的代码保留安全警告（Agent 默认遵守）
填写样例（点动 + IO 输出）
| 项 | 内容 |
|---|---|
| 开发语言 / 环境 | C++；Linux（WSL g++-9）+ Windows（VS2022 MSVC） |
| 版本 | 控制器 RTL-24.03 ↔ SDK v2.0.4-24.03 |
| 机器人本体 | 单机器人；轴数默认 6 轴；无外部轴 |
| 真实控制器 | 暂无（演练）→ 走三级验证；IP 留可配置项 |
| 功能 | 点动（robot_start_jogging / robot_stop_jogging）+ 数字输出（set_digital_output） |
| 交付 | 源码 + 构建脚本 + 可执行程序（windows_x64 / linux_x64） |
生成后默认约定（Agent 默认遵守，不必问客户）
- IP / 端口做成可配置项（文件顶部配置或命令行参数）；
- 附「编译与运行说明」；运动类代码必须保留安全提示；
- 函数名以官网接口页 / SDK 头文件为准，不臆造；
- 无真机时，附 L1 / L2 / L3 三级验证步骤。