给AI调用的 Aardio 命令行(CLI)软件开发笔记

---

一、核心原理（必须看懂）

1. 什么是「给AI用的命令行exe」？

就是：AI 不点击界面、不手动输入，直接通过命令行传递数据 → exe 自动处理 → 返回结果。

2. AI 与 exe 通信的 2 种核心方式（aardio 通用）

方式1：命令行参数（最稳定、推荐）

• AI 启动 exe 时直接把数字/文本等参数写在命令里
• 格式：程序.exe 参数1 参数2
• exe 启动瞬间就能拿到数据，无需等待、无输入框

方式2：标准输入管道（不改代码）

• AI 把数据“流”进 exe
• 格式：echo 2 | 程序.exe
• 适合原有 console.getNumber() 代码不修改

3. Aardio 官方获取参数规则

https://www.aardio.com/zh-cn/doc/

搜CMDLINE相关说明。

• _CMDLINE = 系统传入的原始命令行字符串（全局变量，直接用）
• string.cmdline(_CMDLINE) = 官方解析函数，自动把命令行切割成干净的参数数组
• 参数顺序：
  • args[0] = exe自己的路径
  • args[1] = AI传入的第一个参数（你要的数字/文本）
  • args[2] = 第二个参数，以此类推

---

二、开发步骤

步骤1：创建控制台程序

import console; // 必须导入控制台库

步骤2：获取AI传来的参数（官方标准写法）

// 1. 获取原始命令行
// 2. 用官方函数解析成参数数组
var args = string.cmdline(_CMDLINE);

步骤3：业务逻辑处理

• 拿到参数后做计算/处理
• 用 console.log() 输出结果（AI可以读取输出）

步骤4：打包发布

• 发布 → 控制台程序 → 生成exe
• AI直接调用exe即可

---

三、完整可直接使用模板（AI专用）

/*
  Aardio 命令行工具 - 专为AI调用开发
  原理：AI通过命令行传参 → 程序读取参数 → 自动处理 → 输出结果
*/
import console;

console.log("=== Aardio AI命令行工具 ===");

// ======================================
// 【核心原理】获取并解析AI传入的命令行参数
// _CMDLINE         : 系统传递的原始命令行
// string.cmdline() : aardio官方解析函数，切割参数为数组
// args[0] = 程序路径
// args[1] = AI传入的第1个参数（我们要的数字）
// ======================================
var args = string.cmdline(_CMDLINE);
var num;

// 判断：有参数 = AI调用 | 无参数 = 手动输入
if (args[1]) {
    // AI 自动模式
    num = tonumber(args[1]);
    console.log("AI传入参数：", num);
} else {
    // 人工手动模式（兼容）
    num = console.getNumber("请输入数值：");
    console.log("手动输入：", num);
}

// ======================================
// 你的业务逻辑（这里可以写任何功能）
// ======================================
var result = num * 2; // 示例：数字×2
console.log("\n处理结果：", result);

// 暂停方便查看（打包后可去掉）
console.pause();

---

四、AI 如何调用这个 exe？

1. 命令行传参（推荐，最稳定）

你的程序.exe 参数1

程序直接拿到：参数1

2. 管道输入（不修改代码）

echo 2 | 你的程序.exe

自动输入并回车

3. Python/AI自动化代码

import subprocess

# AI调用exe并传入数字2
result = subprocess.check_output("程序.exe 2", encoding="gbk")
print("AI获取结果：\n", result)

---

五、关键知识点总结

1. 通信原理

• 命令行参数 = 进程启动时由系统直接传递
• 无需窗口、无需输入、无需点击
• 这是AI自动化调用程序的标准方案

2. Aardio 专用API

代码	作用
_CMDLINE	全局变量，获取完整命令行字符串
string.cmdline(_CMDLINE)	官方解析，返回干净参数数组
args[1]	AI传入的第一个数据
console.log()	输出结果给AI读取

3. 为什么这样开发最适合AI？

• 启动即拿到数据，无等待
• 无界面干扰，纯后台运行
• 跨语言通用，Python/Node/Java/AI都能调用
• 稳定不崩溃，比模拟键盘输入可靠100倍

---

六、一句话记住核心

AI 调用 exe = 命令行传参 → aardio 用 string.cmdline(_CMDLINE) 解析 → args[1] 拿到数据

这就是最标准、最稳定、官方推荐、工业级可用的 AI 命令行工具开发方案。