# AI Generator CLI 安装接入指南

这份指南用于让具备命令执行和本机文件访问能力的 Agent 安装并配置 AI Generator CLI。

## 目标

- 安装 npm 包 @ai-generator/cli。
- 使用固定的生产服务器 https://aiaigenerator.ai。
- 将 CLI Key 保存在本机文本文件中，避免出现在 Agent 聊天、命令参数、日志或输出里。
- 完成一次图片生成测试，确认接入可用。

## 安全要求

- 不要要求用户在聊天中发送、粘贴、重复或确认 Key。
- 不要读取、打印、回显、记录或展示 Key 的实际内容。
- 只让用户在自己的设备上，把 Key 粘贴到本机文件中。
- 不要把 Key 文件加入 Git、共享文件夹、截图或任务输出。
- 生产服务器地址固定为 https://aiaigenerator.ai，不要向用户询问服务器 URL。

## 安装 CLI

确认 Node.js 18 或更新版本，然后执行：

    npm install --global @ai-generator/cli

如果用户使用 pnpm，也可以执行：

    pnpm add --global @ai-generator/cli

## 在本机保存 Key

如果你已登录网站的 CLI 页面并创建了 Key，优先点击 Key 旁的“下载 TXT”按钮。支持保存文件对话框的浏览器可以直接选择目标目录；其他浏览器会先下载到默认下载目录，请将文件移动到下方对应路径。文件名保持为 cli-key.txt。不要在聊天中接收或粘贴 Key 内容。

如果浏览器不支持文件保存对话框，也可以根据操作系统手动创建或打开 Key 文件：

### macOS / Linux

    mkdir -p "$HOME/.ai-generator"
    nano "$HOME/.ai-generator/cli-key.txt"

请用户只在打开的本机文件中粘贴 Key，保存后关闭编辑器，并回复“已储存”或 “saved locally”。

### Windows PowerShell

    New-Item -ItemType Directory -Force "$env:USERPROFILE\.ai-generator" | Out-Null
    notepad "$env:USERPROFILE\.ai-generator\cli-key.txt"

请用户只在记事本中粘贴 Key，保存后关闭记事本，并回复“已储存”或 “saved locally”。

### Windows CMD

    if not exist "%USERPROFILE%\.ai-generator" mkdir "%USERPROFILE%\.ai-generator"
    notepad "%USERPROFILE%\.ai-generator\cli-key.txt"

请用户只在记事本中粘贴 Key，保存后关闭记事本，并回复“已储存”或 “saved locally”。

## 配置 CLI

等用户确认 Key 已保存在本机文件后，按当前终端执行对应命令。命令会从本机文件读取 Key，不会把 Key 放进命令参数中。

### macOS / Linux

    ai-generator auth set --key-file "$HOME/.ai-generator/cli-key.txt" --base-url "https://aiaigenerator.ai"

### Windows PowerShell

    ai-generator auth set --key-file "$env:USERPROFILE\.ai-generator\cli-key.txt" --base-url "https://aiaigenerator.ai"

### Windows CMD

    ai-generator auth set --key-file "%USERPROFILE%\.ai-generator\cli-key.txt" --base-url "https://aiaigenerator.ai"

验证配置时只能输出脱敏信息：

    ai-generator auth show --json

如果出现认证失败，说明如何修复本机文件或 CLI 配置，但不要要求用户把 Key 发到聊天中。

## 验证接入

执行一次不包含 Key 的测试任务：

    ai-generator generate-image --prompt "A cinematic product photo" --wait --json

只有当命令返回成功状态和结果 URL 时，才能说明接入验证通过。不要把 Key 文件内容或包含 Key 的日志发回聊天。

## 后续使用

    ai-generator generate-image --prompt "<image prompt>" --wait --json
    ai-generator generate-video --prompt "<video prompt>" --wait --json
    ai-generator task-status --task-id <task-id> --type image --json
    ai-generator task-download --task-id <task-id> --type image --output-dir ./outputs --json

需要完整命令说明时，执行：

    ai-generator --help