# apustai

**Repository Path**: clawclaw/apustai

## Basic Information

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

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ApusTAI

ApusTAI 是武汉鑫通态科技有限公司推出的 AI 驱动串口屏组态软件，用于 HMI 串口屏工程设计、控件组态、脚本编写、模拟运行与程序下载。

## 下载安装

请在本仓库发行版中下载 Windows MSI 安装包：

- ApusTAI-1.0.0-x64.msi

发行版地址：

https://gitee.com/clawclaw/apustai/releases/tag/1.0.0

## AI 助手使用方法

ApusTAI 内置 AI 助手，可以把自然语言转换为组态操作命令，辅助完成页面创建、控件放置、属性修改、工程设置、Lua 脚本编写、编译、模拟运行和下载等工作。

### 1. 配置 AI 接口

启动 ApusTAI 后，打开 AI 设置：

- 在工具栏或菜单中选择“AI 设置”
- 选择供应商，例如 DeepSeek、豆包、百度千帆、通义千问、OpenAI 或自定义 OpenAI 兼容接口
- 填写 Base URL、模型名称和 API Key
- 点击“确定”保存

API Key 也可以通过环境变量提供。优先级如下：

```text
APUSTAI_AI_API_KEY
APUSTFT_AI_API_KEY
DEEPSEEK_API_KEY
OPENAI_API_KEY
```

建议新版本优先使用 `APUSTAI_AI_API_KEY`。旧的 `APUSTFT_AI_API_KEY` 会继续兼容。

### 2. 打开工程和页面

AI 助手会结合当前打开的工程、当前页面、选中控件和工程图库来生成操作步骤。使用前建议先：

- 新建或打开一个工程
- 打开要编辑的页面
- 如果要修改现有控件，先选中目标控件
- 如果要使用图片，先把图片导入工程图库或本地图库

### 3. 用自然语言描述需求

可以直接输入类似下面的指令：

```text
在当前页面中间放一个数值输入控件，读取地址为 LW100，整数 5 位，小数 2 位，文字颜色蓝色。
```

```text
把第 6 页重命名为“数值输入控件示例”，背景设为白色。
```

```text
给当前选中的按钮设置文字“启动电机”，写地址为 LW200，操作模式为写常量，常量值为 1。
```

```text
帮我写一个 Lua 脚本，每 1 秒读取 LW100，并把它加 1 后写到 LW102。
```

### 4. 确认并执行 AI 生成的步骤

AI 助手会把自然语言转换为 ApusTAI CLI 命令步骤。执行前请检查：

- 页面 ID 是否正确
- 控件类型是否正确
- 地址、颜色、数值范围是否符合工程要求
- 下载命令是否指向正确串口和设备

普通页面编辑、控件编辑、脚本生成、编译和模拟运行可直接执行。下载到串口屏前，请确认串口连接和目标设备正确。

### 5. Lua 脚本生成建议

AI 助手编写 Lua 脚本时，会优先使用 `script patch` 方式维护 AI 代码块，避免覆盖用户已有脚本。每次生成或修改脚本后，建议执行脚本检查。

常见脚本需求包括：

- 初始化变量
- 定时器刷新
- 寄存器读写联动
- 串口自由协议收发
- 页面切换回调
- 控件事件处理

### 6. 参考文档

安装包中已包含 AI 和 CLI 相关文档：

```text
docs/CLI.md
docs/SKILL.md
```

其中 `CLI.md` 是完整命令和属性说明，`SKILL.md` 是 AI 使用 ApusTAI CLI 时的简要规则。

## 在外部 AI 软件中使用 ApusTAI

除了组态软件内置 AI 助手，也可以在 Claude、Codex、ChatGPT、通义、豆包等外部 AI 软件中使用 ApusTAI。推荐方式是让外部 AI 通过 ApusTAI CLI 操作工程，而不是直接手工修改工程数据库。

### 1. 准备工作

- 安装 ApusTAI，并确认 `ApusTAI.exe` 可以正常启动。
- 找到工程目录，例如 `D:/project/demo`。
- 找到 ApusTAI 可执行文件路径，例如 `C:/Program Files/Simtutai/ApusTAI/ApusTAI.exe`。
- 把安装包内的 `docs/CLI.md` 和 `docs/SKILL.md` 提供给外部 AI 作为上下文。

`CLI.md` 是完整命令说明，`SKILL.md` 是给 AI 的简明操作规则。外部 AI 应优先阅读这两个文件，再生成命令。

### 2. 推荐提示词

可以把下面这段发给外部 AI：

```text
你正在协助开发 ApusTAI 串口屏 HMI 工程。请先阅读 docs/CLI.md 和 docs/SKILL.md。所有工程修改都优先通过 ApusTAI.exe --cli 完成，不要直接修改 .tftprj/.vmf SQLite 文件，除非我明确要求。生成命令前请确认工程目录、页面 ID、控件 ID、控件类型和属性名。属性名必须以 ApusTAI.exe --cli schema 或 docs/CLI.md 为准。涉及 Lua 脚本时优先使用 script patch，并在修改后执行 script check。涉及下载到串口屏时，必须先提醒我确认串口和目标设备。
```

### 3. 常用命令示例

```bash
ApusTAI.exe --cli schema
ApusTAI.exe --cli page list D:/project/demo
ApusTAI.exe --cli widget list D:/project/demo 0
ApusTAI.exe --cli widget add D:/project/demo 0 numericinput x=200 y=80 w=120 h=48 readAddr=LW100 intDigits=5 decDigits=2
ApusTAI.exe --cli script patch D:/project/demo main.lua timer_demo "function on_init() start_timer(1, 1000, 0, 0) end"
ApusTAI.exe --cli script check D:/project/demo main.lua
ApusTAI.exe --cli build D:/project/demo
ApusTAI.exe --cli run D:/project/demo
```

### 4. 外部 AI 操作建议

- 让 AI 先执行 `schema`，确认当前版本支持的控件类型和属性。
- 修改现有控件前，先执行 `widget list` 或 `widget get` 找到真实控件 ID。
- 用户说“当前页面”“选中控件”时，外部 AI 通常不知道上下文，应要求用户提供页面 ID 或控件 ID。
- 批量修改、删除页面、下载到设备前，应让用户二次确认。
- 图片相关需求应先确认图片是否已在工程图库 `res/pic` 或本地图库 `imagelib` 中。
- Lua 脚本不要整文件覆盖，优先使用 `script patch` 维护 AI 代码块。

### 5. 与内置 AI 助手的区别

内置 AI 助手可以自动获得当前工程、当前页面、选中控件和工程图库信息，使用起来更直接。外部 AI 软件通常拿不到这些 GUI 上下文，所以需要用户明确提供工程路径、页面 ID、控件 ID 和目标需求。

## 注意事项

- AI 生成内容执行前建议先确认，尤其是批量修改、删除页面、下载到设备等操作。
- 发布包不会包含本机 AI API Key。
- MSI 安装包提供标准安装、卸载和开始菜单快捷方式。

## 公司信息

武汉鑫通态科技有限公司

官网：https://www.simtutai.cn