🌌 Kie AI CLI (kie-ai-cli)

Kie AI 极速命令行工具 — 专为终端发烧友与工程师打造的 AI 助手。支持 流式对话、管道输入、会话持久化、智能历史压缩、多阶段 Agent 代码编写 与 AI 图片异步生成。

✨ 核心特性

• ⚡ 流式输出 & 极速响应：原生支持流式（Streaming）对话，字字秒回，告别等待。
• 🗣️ 智能多轮 REPL：交互式对话模式，自带强大的斜杠指令系统，支持自动持久化与上下文历史恢复。
• 🗜️ 智能历史压缩：当会话过长时，系统会自动或手动触发 AI 摘要式压缩，保留最近轮次原文，大幅降低上下文 Token 开销。
• 📂 上下文智能感知：支持使用 /file 载入本地代码，/run 执行 Shell 命令并将输出直接喂给 AI，提供极佳的结对编程体验。
• 🖥️ 管道（Pipe）完美支持：轻松对接 cat、type 等命令输出，一行命令快速分析日志、总结文档或检查 Bug。
• 🤖 Agent 代码模式 (kie code)：内置高度智能的代码代理循环，自动感知工作区结构、自主编写/重构代码并运行测试。
• 🎨 图片异步生成 (kie image)：一键生成精美图片，后台全自动提交任务并轮询，完成后自动下载至本地目录。

📦 安装与要求

🔧 环境要求

• Node.js 18.0.0 或更高版本

🚀 全局安装（推荐）

npm install -g kie-ai-cli

提示：安装完成后，系统将自动注册全局命令 kie。你可以通过在终端输入 kie --help 验证是否安装成功。

💻 本地开发调试

git clone https://github.com/yibingzhi/kie-cli.git
cd kie-cli
npm install
npm run build

本地运行方式：

node dist/index.js <命令>
# 或使用 npm start
npm start -- <命令>

🚦 快速上手

1. 配置 API Key（必做）

kie config --set-api-key <您的_KIE_API_KEY>

2. （可选）修改 API 地址

系统默认请求 https://api.kie.ai。如果您有自建网关或测试环境，可以一键修改：

kie config --set-base-url https://api.kie.ai

3. 查看当前配置

kie config

4. 开启您的第一次对话 🚀

kie chat

🛠️ 命令总览

| 命令 | 作用说明 | | :--- | :--- | | kie config | 查看或快速设置 API Key、Base URL 以及默认模型 | | kie models | 管理与切换可用的 Claude 对话模型（支持交互式选择） | | kie chat | 核心对话入口（支持交互式 / 单次问答 / 管道输入） | | kie code | 智能代码助手与 Agent 模式（提供项目画像分析及测试闭环） | | kie image <提示词> | 异步文生图，自动排队轮询并下载到本地文件夹 | | kie --help | 查看命令帮助 | | kie --version | 查看当前版本 |

⚙️ kie config — 配置管理

所有的本地配置信息均加密保存至本机用户目录，绝对不会提交至代码仓库，也不会随 npm 包发布，请放心使用。

# 🔑 设置 API Key
kie config --set-api-key sk-xxxxxxxx

# 🌐 设置 API 根地址 (可选)
kie config --set-base-url https://api.kie.ai

# 🤖 设置默认对话模型
kie config --set-model claude-opus-4-7

# 🎨 设置默认图片生成模型
kie config --set-image-model gpt-image-2-text-to-image

# 🔍 查看当前全部配置
kie config

🧬 模型管理与路由

在切换不同模型时，CLI 会根据模型 ID 自动路由到相应的最佳接口端点：

| 模型系列 | 端点 (Endpoint) | 典型模型示例 | | :--- | :--- | :--- | | Claude | POST /claude/v1/messages | claude-opus-4-7、claude-sonnet-4-6 | | GPT | POST /{model}/v1/chat/completions | gpt-5-2 | | Responses | POST /codex/v1/responses | gpt-5-4、gpt-5-5 | | Responses | POST /api/v1/responses | gpt-5.1-codex |

📌 路由逻辑说明：

• 模型名称符合 gpt-5-2 → 路由至 Chat Completions
• 模型名称符合 gpt-5-* → 路由至 /codex/v1/responses
• 模型名称包含 codex → 路由至 /api/v1/responses
• 默认模型一律走向 Claude 高速通道。

🔍 查看与选择 Chat 模型

⚠️ 注意：此处模型仅作用于 kie chat 对话，与图片生成模型无关。

| 运行环境 | 选择方式 | | :--- | :--- | | 对话会话中 （kie chat 内部） | 输入 /model，随后输入对应数字序号（1, 2...）或模型 ID。这能完美避免 Windows 终端下的 readline 冲突问题。 | | 正常终端下 （命令行直接运行） | 直接输入 kie models，使用 ↑↓ 箭头按键进行交互式选择。 |

# 📂 交互式选择模型并立刻保存为全局默认
kie models --set

# 📋 仅打印当前支持的模型列表
kie models --list

🔥 内置精品推荐模型

| 模型 ID | 推荐指数 | 说明 | | :--- | :--- | :--- | | claude-opus-4-7 | ⭐⭐⭐⭐⭐ | 旗舰模型 (默认首选)，逻辑推理极强 | | claude-sonnet-4-6 | ⭐⭐⭐⭐ | 速度极快，兼顾准确度与时效性 | | claude-haiku-4-5 | ⭐⭐⭐ | 超轻量，响应速度最快，适合常规问答 | | gpt-5-2 | ⭐⭐⭐⭐ | GPT 5.2 强力驱动 | | gpt-5-5 | ⭐⭐⭐⭐ | 专注 Codex 高级工程能力 |

💬 kie chat — 终极终端对话体验

💡 三种运行姿势

① 🎮 交互模式 (REPL - 多轮对话)

不带任何参数启动，进入优雅的终端交互界面。AI 会实时记住你本轮会话中的完整上下文。

kie chat

• 自动持久化：启动时会自动加载您上一轮的活跃会话，退出（输入 exit 或 quit）时会自动保存。

② 🎯 单次直问 (快问快答)

向 AI 咨询单个问题，回答完毕后立即返回原终端，不占用过多会话。

kie chat 帮我解释一下什么是 TypeScript 中的 Omit 类型

③ 🔌 管道数据喂养 (Pipeline)

将其他命令的输出或者文件内容无缝“投喂”给 AI 进程进行深度加工：

# 🐧 Linux/macOS 分析日志
cat error.log | kie chat "详细分析这个报错并给出前三种修复策略"

# 🪟 Windows 提取代码逻辑
type app.ts | kie chat "找这段代码中可能导致内存泄漏的隐患"

🛠️ 对话辅助参数

| 参数 | 缩写 | 功能说明 | | :--- | :--- | :--- | | --new | - | 忽略历史，开辟一个全新干净的会话 | | --resume | - | 强制恢复上一次的活跃会话 | | --resume <ID> | - | 恢复指定命名/ID 的历史会话 | | --model <ID> | -m | 强行指定本次对话使用的模型 (不影响全局默认配置) |

# 例子：使用最新 Sonnet 模型临时恢复 my-debug 会话
kie chat --resume my-debug -m claude-sonnet-4-6

⌨️ 交互模式内置「斜杠指令」

在 kie chat REPL 的对话输入框中，输入 / 即可触发快捷交互：

| 快捷指令 | 效果说明 | | :--- | :--- | | /model [ID] | 快速切换或查看当前模型 | | /clear | 彻底清空当前会话的所有磁盘与内存上下文 | | /compress | 手动触发历史压缩，精炼旧消息为摘要 | | /file <本地路径>| 读取指定本地文件内容，直接塞入 AI 上下文 | | /run <命令> | 在本地静默运行命令，并将标准输出/错误喂给 AI | | exit / quit | 安全保存对话并退出 REPL |

🔥 妙用 /file 与 /run

无论是想要 AI 分析一个复杂模块的逻辑，还是运行了 npm test 失败想让 AI 找出报错根源，通过这两个指令，你可以一秒将当前开发环境的状态原汁原味地同步给 AI，省去繁琐的复制粘贴！

🤖 kie code — 智能代码代理 (MVP)

kie code 专为“写代码与工程构建”设计，默认以当前工作区目录为底座，开启**自动执行代理（Agent）**循环。它能感知代码树、生成并更新 .kie/workspace.json 画像。

# 🚀 描述需求，让 Agent 开始自主分析与修改（推荐搭配 -y 自动授权）
kie code "将 image 命令改为支持 --dry-run 参数，并在 README.md 中加上它" -y

# 🔧 初始化当前工作目录为 code 工作区
kie code --init

# 📂 精准携带多文件依赖进行代码设计
kie code "重构模型路由的算法" -f src/index.ts -f src/models.ts

# 💬 如果您仅需获取方案，不需要 Agent 自动帮您改写文件
kie code --chat "分析当前项目的架构并输出 Mermaid 关系图"

🎛️ kie code 专属参数表

| 参数名 | 默认值 | 作用说明 | | :--- | :--- | :--- | | -m, --model <id> | - | 指定 code 阶段调用的模型 | | --cwd <path> | process.cwd() | 设置工作区根路径 | | --init | - | 生成 .kie/code.json，构建初始项目树结构 | | --run <cmd> | - | 执行指定命令，并在执行完毕后将输出注入 Agent 上下文 | | --chat | - | 转换为纯对话状态（关闭 Agent 命令行自主执行功能） | | --route <mode> | auto | 路由策略选择：auto / quality / balanced / fast | | --max-steps <n> | 5 | 设置 Agent 最大自主执行轮数，防止进入死循环 | | -y, --yes | false | Agent 模式自动确认执行系统命令，无需手动二次批准 | | -f, --file <path> | - | 注入额外特定的文件作为 Agent 参考上下文 | | --no-tree | false | 禁用在提示词中附加项目文件树结构 |

🎨 kie image — AI 异步绘图

利用底层的高质量图像生成引擎，为您实现终端内的画图梦。支持提交后全自动异步轮询，制作完毕后会自动为您下载。

kie image "一只戴着宇航员头盔、在火星废墟上凝望地球的橘猫，写实风格，电影感光效"

• 运行流程：终端提交画图请求 ➡️ 接收异步 Task ID ➡️ CLI 开始自动背景轮询 ➡️ 渲染进度 ➡️ 图片自动保存到当前执行路径下的 kie-image/ 目录中。

📂 数据与会话存储

• 本地配置文件：
  • Windows: %APPDATA%\kie-cli\Config\config.json
  • macOS / Linux: ~/.config/kie-cli/config.json
• 历史会话存储：
  • 保存在与配置文件同级的 sessions/ 文件夹下。您可以使用 kie chat --resume <session_id> 轻松加载对应的 .json 历史。
• 智能自动压缩算法： 当会话内的字符长度超出 16,000 时，每次对话都会自动合并极早期对话为一条概括性 system 消息，同时保留最近约 6 轮的完整对话原文，保证 AI 既不会“失忆”，又能够以最低的价格和最高的性能响应你。

🛠️ 本地开发与构建

npm install      # 安装依赖
npm run build    # 编译 TypeScript 生成 dist 目录
npm start -- chat   # 免全局安装直接运行

💡 本包在配置的 prepublishOnly 脚本中已默认加入 npm run build，因此执行 npm publish 时会自动保证生成最新的 JavaScript 文件。

❓ 常见问题解答 (FAQ)

Q: 提示缺少 API Key 怎么办？

运行 kie config --set-api-key <您的KEY> 完成配置即可。

Q: 运行 /compress 会丢失我的聊天记录吗？

不会。它会由大模型将较早的消息提炼成非常精简的概要并储存在对话开头。您最近几轮的每一条对话仍然是绝对完整保留的。

Q: API Key 会有泄漏的风险吗？

完全没有。Key 存储在您本机的操作系统级用户私有目录下，npm publish 打包发布时排除了除 dist 外的所有开发配置文件，绝对安全。

📄 开源许可证

本项目基于 MIT License 开源。欢迎大家提交 Issue 和 PR！🎉