kie-ai-cli 1.0.0

package/README.en.md

@@ -0,0 +1,36 @@
+# kie-cli
+
+#### Description
+{**When you're done, you can delete the content in this README and update the file with details for others getting started with your repository**}
+
+#### Software Architecture
+Software architecture description
+
+#### Installation
+
+1.  xxxx
+2.  xxxx
+3.  xxxx
+
+#### Instructions
+
+1.  xxxx
+2.  xxxx
+3.  xxxx
+
+#### Contribution
+
+1.  Fork the repository
+2.  Create Feat_xxx branch
+3.  Commit your code
+4.  Create Pull Request
+
+
+#### Gitee Feature
+
+1.  You can use Readme\_XXX.md to support different languages, such as Readme\_en.md, Readme\_zh.md
+2.  Gitee blog [blog.gitee.com](https://blog.gitee.com)
+3.  Explore open source project [https://gitee.com/explore](https://gitee.com/explore)
+4.  The most valuable open source project [GVP](https://gitee.com/gvp)
+5.  The manual of Gitee [https://gitee.com/help](https://gitee.com/help)
+6.  The most popular members  [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)

package/README.md

@@ -0,0 +1,503 @@
+# kie-cli
+
+在终端里调用 Kie AI 的命令行工具，支持流式对话、管道输入、会话保存、历史压缩和图片生成。
+
+## 环境要求
+
+- Node.js **18** 或更高版本
+
+## 安装
+
+### 本地开发
+
+```bash
+git clone <你的仓库地址>
+cd kie-cli
+npm install
+npm run build
+```
+
+之后用下面两种方式之一运行：
+
+```bash
+node dist/index.js <命令>
+# 或
+npm start -- <命令>
+```
+
+### 全局安装（推荐）
+
+```bash
+npm install -g kie-cli
+# 或作用域包：npm install -g @你的用户名/kie-cli
+```
+
+安装后可直接使用 `kie` 命令。
+
+---
+
+## 第一次使用
+
+### 1. 配置 API Key（必做）
+
+```bash
+kie config --set-api-key <你的API_KEY>
+```
+
+### 2. （可选）修改 API 地址
+
+默认地址为 `https://api.kie.ai`，一般不用改。若使用自建或测试环境：
+
+```bash
+kie config --set-base-url https://api.kie.ai
+```
+
+### 3. 查看当前配置
+
+```bash
+kie config
+```
+
+### 4. 开始对话
+
+```bash
+kie chat
+```
+
+---
+
+## 命令总览
+
+| 命令 | 作用 |
+|------|------|
+| `kie config` | 查看或设置 API Key、Base URL、默认模型 |
+| `kie models` | 列出可用的 Claude 对话模型 |
+| `kie chat` | 与 AI 对话（交互 / 单次 / 管道） |
+| `kie code` | 代码模式（输出 MVP 实现方案、改动清单、验证步骤） |
+| `kie image <提示词>` | 根据文字生成图片 |
+| `kie --help` | 查看帮助 |
+| `kie --version` | 查看版本 |
+
+---
+
+## `kie config` — 配置管理
+
+保存到本机用户目录，**不会**写进代码仓库，也不会随 npm 包发布。
+
+```bash
+# 设置 API Key
+kie config --set-api-key sk-xxxxxxxx
+
+# 设置 API 根地址（可选）
+kie config --set-base-url https://api.kie.ai
+
+# 设置默认对话模型（Claude @ Kie）
+kie config --set-model claude-opus-4-7
+
+# 设置默认图片模型
+kie config --set-image-model gpt-image-2-text-to-image
+
+# 查看当前配置
+kie config
+```
+
+---
+
+## 模型切换
+
+切换模型时会**自动选择接口**：
+
+| 系列 | 端点 | 示例模型 |
+|------|------|----------|
+| **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` |
+
+自定义模型 ID：`gpt-5-2` → Chat Completions；`gpt-5-*` → `/codex/v1/responses`；名称含 `codex` → `/api/v1/responses`；默认 Claude。
+
+### 查看 / 选择对话模型 (Chat)
+
+这些模型只用于 **`kie chat` 对话**，和图片模型 `kie image` 无关。
+
+| 场景 | 选择方式 |
+|------|----------|
+| **对话里** `kie chat` 后输入 `/model` | **输入序号**（1、2、3…）或模型 ID，避免 Windows 终端与 readline 冲突 |
+| **对话外** 单独运行 `kie models` | **↑↓ + Enter** 交互选择 |
+
+```bash
+kie models           # 独立运行：↑↓ 选择 Chat 模型
+kie models --set     # 选择并保存为默认对话模型
+kie models --list    # 仅打印列表
+```
+
+内置推荐：
+
+| 模型 ID | 说明 |
+|---------|------|
+| `claude-opus-4-7` | 旗舰，默认 |
+| `claude-opus-4-6` | 上一代旗舰 |
+| `claude-sonnet-4-6` | 速度与质量均衡 |
+| `claude-sonnet-4-5` | Sonnet 4.5 |
+| `claude-haiku-4-5` | 更快、更省 |
+| `gpt-5-2` | GPT 5.2（Chat Completions） |
+| `gpt-5-4` | GPT 5.4（Codex Responses） |
+| `gpt-5-5` | GPT 5.5（/codex/v1/responses） |
+| `gpt-5.1-codex` | GPT 5.1 Codex（/api/v1/responses） |
+
+也可设置 Kie 支持的**任意** model id：
+
+```bash
+kie config --set-model <任意模型ID>
+```
+
+### 三种切换方式
+
+```bash
+# 1. 全局默认（写入配置，以后 chat 都用它）
+kie config --set-model claude-sonnet-4-6
+
+# 2. 仅本次 chat 使用（不改全局配置）
+kie chat --model claude-haiku-4-5
+kie chat -m claude-opus-4-7 "你好"
+
+# 3. 对话模式中切换 Chat 模型（会同时更新全局默认）
+kie chat
+(You) > /model              # 显示序号列表，输入 1、2、3… 选择
+(You) > /model claude-sonnet-4-6   # 也可直接输入模型 ID
+
+# 若想要 ↑↓ 选择，请先退出对话，运行：
+kie models --set
+kie chat
+```
+
+优先级：**`kie chat --model`** > **交互里 `/model` 设置的会话模型** > **`kie config --set-model` 全局默认** > `claude-opus-4-7`。
+
+> **说明：** 本 CLI 专注终端对话、会话持久化与历史压缩。多模态图片、`tools`、`reasoning` 等高级参数请在业务侧直接调 API。
+
+```bash
+kie config --set-model gpt-5-2   # Chat Completions
+kie config --set-model gpt-5.1-codex   # /api/v1/responses
+kie config --set-model gpt-5-5       # /codex/v1/responses
+kie chat "你好"
+```
+
+---
+
+## `kie chat` — AI 对话
+
+### 三种使用方式
+
+#### ① 交互模式（多轮连续对话）
+
+不传任何参数，进入 REPL，可一直聊，AI 会记住本轮会话里的上下文：
+
+```bash
+kie chat
+```
+
+启动后会显示当前**会话 ID**，并自动恢复上次对话（若有）。
+
+输入 `exit` 或 `quit` 退出，退出时会自动保存会话。
+
+#### ② 单次提问
+
+问一句，答一句，结束后退出，**不进入**交互模式：
+
+```bash
+kie chat 帮我解释一下什么是 REST API
+```
+
+#### ③ 管道输入
+
+把文件或命令输出「喂」给 AI：
+
+```bash
+# 总结文件内容
+type README.md | kie chat 请用三句话总结
+
+# Linux / macOS
+cat error.log | kie chat 分析这个报错
+
+# 管道内容 + 额外说明
+type app.ts | kie chat 找出可能的 bug
+```
+
+---
+
+### `kie chat` 启动参数
+
+| 参数 | 说明 |
+|------|------|
+| `--new` | 开启**全新会话**，不加载历史 |
+| `--resume` | 恢复**上一次**使用的会话 |
+| `--resume <id>` | 恢复**指定 ID** 的会话 |
+| `-m, --model <id>` | 指定本次对话使用的模型 |
+
+示例：
+
+```bash
+# 默认：恢复上次会话（会话 ID 一般为 default 或 session-时间戳）
+kie chat
+
+# 新开会话，适合聊新话题
+kie chat --new
+
+# 恢复名为 my-project 的会话
+kie chat --resume my-project
+```
+
+---
+
+### 交互模式内的斜杠指令
+
+仅在 `kie chat` 交互模式下可用（以 `/` 开头）：
+
+| 指令 | 作用 |
+|------|------|
+| `/model` | 显示序号选模型；`/model <id>` 直接切换 |
+| `/clear` | **清空**当前会话的所有上下文（内存 + 磁盘） |
+| `/compress` | **手动压缩**对话历史，把较早内容收成摘要 |
+| `/file <路径>` | 读取本地文件内容，加入对话上下文 |
+| `/run <命令>` | 在本机执行 shell 命令，把输出加入上下文 |
+| `exit` / `quit` | 退出并保存会话 |
+
+#### `/clear` — 清空会话
+
+忘记之前聊了什么、想重新开话题时使用：
+
+```
+(You) > /clear
+✅ 当前会话上下文已清空。
+```
+
+#### `/compress` — 手动压缩
+
+对话太长、想减少占用或避免超出模型上下文时使用。会把**较早的对话**交给 AI 写成摘要，**保留最近几轮完整原文**。
+
+- 不足 2 轮对话时会提示「无需压缩」
+- 压缩会额外调用一次 API
+
+```
+(You) > /compress
+✔ 压缩完成：18 → 7 条消息，24500 → 4200 字符
+```
+
+#### `/file` — 读入文件
+
+让 AI 能「看到」某个文件的内容（例如代码、日志）：
+
+```
+(You) > /file ./src/index.ts
+✅ 已读取文件 ./src/index.ts 并加入记忆上下文。你可以针对它进行提问了。
+
+(You) > 这段代码里有没有明显的性能问题？
+```
+
+Windows 下拖拽文件到终端时可能带引号，工具会自动去掉。
+
+#### `/run` — 执行命令
+
+在本地跑一条命令，把标准输出交给 AI 分析：
+
+```
+(You) > /run git status
+✅ 命令执行成功，输出结果已加入记忆上下文。
+
+(You) > 根据这个 git 状态，我接下来该做什么？
+```
+
+命令失败时，错误信息也会写入上下文，你可以问 AI 为什么报错。
+
+---
+
+### 会话保存与自动压缩
+
+#### 会话保存在哪？
+
+与配置文件同目录下的 `sessions/` 文件夹，例如：
+
+- Windows：`%APPDATA%\kie-cli\Config\sessions\default.json`
+- macOS / Linux：`~/.config/kie-cli/sessions/default.json`
+
+每个会话一个 JSON 文件，包含完整消息列表。
+
+#### 自动恢复
+
+再次运行 `kie chat` 时，默认加载**上次活跃的会话**。
+
+#### 自动压缩
+
+当会话总字符数超过约 **16000** 时，每轮对话结束后会**自动压缩**：
+
+1. 保留最近约 **6 轮**完整对话
+2. 把更早的内容发给 AI 生成摘要
+3. 摘要作为一条 `system` 消息，与最近几轮一起继续对话
+
+也可随时用 `/compress` 手动触发。
+
+---
+
+## `kie code` — 代码模式（MVP）
+
+`kie code` 专注于“写代码”场景，默认使用**当前命令执行目录**作为代码工作目录（可用 `--cwd` 覆盖），并且**默认就是 agent 自动执行模式**。
+
+- 传入任务：单次返回代码实现方案
+- 不传任务：进入交互对话框（类似 `kie chat`）
+- 可初始化工作区：生成 `.kie/code.json`，并刷新 `.kie/workspace.json`（项目画像）
+
+```bash
+# 直接描述任务（默认 cwd = 当前目录）
+kie code "给 image 命令增加 --dry-run 参数，并更新 README"
+
+# 初始化 code 工作区配置 + 工作区画像
+kie code --init
+
+# 附带关键文件上下文（可重复 -f）
+kie code "重构模型路由逻辑" -f src/index.ts -f src/models.ts
+
+# 管道输入任务描述
+type task.txt | kie code
+
+# 默认就是 agent 自动执行（建议先配合 -y）
+kie code -y "修复 lint 报错并跑测试"
+
+# 如需明确写法，也可保留 --agent（兼容）
+kie code --agent -y "修复 lint 报错并跑测试"
+
+# 如果你只想对话，不自动执行命令
+kie code --chat "先只给方案，不执行命令"
+
+# 进入交互 code 对话框
+kie code
+```
+
+### `kie code` 参数
+
+| 参数 | 说明 |
+|------|------|
+| `-m, --model <id>` | 指定本次 code 使用的模型 |
+| `--cwd <dir>` | 指定 code 工作目录（默认当前目录） |
+| `--init` | 初始化当前工作目录，生成 `.kie/code.json` |
+| `--run <cmd>` | 先执行命令并注入上下文（可重复） |
+| `--agent` | 开启自动执行代理循环（默认已开启，兼容保留） |
+| `--chat` | 切换为纯对话模式（关闭 agent 自动执行） |
+| `--route <mode>` | 路由策略：`auto` / `quality` / `balanced` / `fast` |
+| `--max-steps <n>` | agent 最大执行轮数（默认 5） |
+| `-y, --yes` | agent 模式自动确认执行命令 |
+| `--session <id>` | 使用指定 code 会话 |
+| `--new-session` | 新建 code 会话 |
+| `-f, --file <path>` | 附加文件内容到上下文（可重复） |
+| `--no-tree` | 不附带项目结构摘要 |
+| `--tree-limit <n>` | 项目结构最多注入多少条（默认 120） |
+| `--file-max-chars <n>` | 每个附加文件最多注入字符数（默认 8000） |
+
+### `kie code` 交互指令
+
+| 指令 | 作用 |
+|------|------|
+| `/help` | 查看帮助 |
+| `/clear` | 清空当前 code 会话上下文 |
+| `/cwd` | 查看当前 code 工作目录 |
+| `/init` | 初始化 `.kie/code.json` |
+| `/model [id|序号]` | 查看或切换模型 |
+| `/route [mode]` | 查看或设置路由策略 |
+| `/models` | 查看分阶段模型池、权重与历史指标 |
+| `/models add <phase> <model> [weight]` | 增加/更新阶段模型权重 |
+| `/models rm <phase> <model>` | 删除阶段模型 |
+| `/models strategy <argmax|weighted-random>` | 设置路由决策策略 |
+| `/approve on|off` | 设置是否自动确认执行命令 |
+| `/sessions [id|序号]` | 查看或切换 code 会话 |
+| `/files` | 查看当前附加文件 |
+| `/file <路径>` | 追加文件到上下文 |
+| `/run <命令>` | 在 code 工作目录执行命令，并把输出注入上下文 |
+| `/tree on|off` | 开关项目结构注入 |
+| `/status` | 查看当前 code 状态 |
+| `exit` / `quit` | 退出 code 对话 |
+
+---
+
+## `kie image` — 生成图片
+
+根据文字描述生成图片，提交异步任务并自动轮询，完成后下载到当前目录的 `kie-image/` 文件夹。
+
+```bash
+kie image 一只在月球上弹吉他的猫，赛博朋克风格
+```
+
+流程：提交任务 → 等待处理 → 打印图片链接 → 下载到本地。
+
+---
+
+## 常见使用场景
+
+### 快速问一个问题
+
+```bash
+kie chat 用 Python 写个快速排序，加注释
+```
+
+### 长时间结对编程
+
+```bash
+kie chat --new
+# 进入交互模式后：
+/file ./src/api.ts
+/run npm test
+# 持续提问…
+```
+
+### 分析日志
+
+```bash
+type build.log | kie chat 总结失败原因并给出修复建议
+```
+
+### 多项目切换会话
+
+```bash
+kie chat --resume project-a    # 项目 A
+kie chat --resume project-b    # 项目 B
+```
+
+---
+
+## 开发与构建
+
+```bash
+npm install      # 安装依赖
+npm run build    # 编译 TypeScript → dist/
+npm start -- chat   # 运行（不全局安装时）
+```
+
+发布到 npm 前会自动执行 `npm run build`（`prepublishOnly`）。
+
+---
+
+## 常见问题
+
+### 提示缺少 API Key？
+
+先执行：
+
+```bash
+kie config --set-api-key <KEY>
+```
+
+### `/compress` 之后消息变少了？
+
+这是预期行为：旧对话被合并成一条摘要，只保留最近几轮原文。若误操作可用 `/clear` 清空后重新开始。
+
+### 管道模式会保存会话吗？
+
+不会。只有交互模式（`kie chat` 不带参数）会读写会话文件。
+
+### API Key 会打进 npm 包吗？
+
+不会。Key 只存在你本机配置里；发布包只包含编译后的 `dist/`。
+
+---
+
+## 许可证
+
+请根据项目实际情况补充。

package/dist/api.js

@@ -0,0 +1,29 @@
+import { DEFAULT_CHAT_MODEL } from './models.js';
+import { sendChatByProvider } from './providers/index.js';
+/** 收集完整回复（用于会话压缩等内部调用） */
+export async function getChatCompletion(options) {
+    let full = '';
+    await sendChatMessage({
+        ...options,
+        onChunk: (text) => {
+            full += text;
+        },
+    });
+    return full;
+}
+/** 按模型自动路由 Claude / GPT(OpenAI 兼容) 接口 */
+export async function sendChatMessage(options) {
+    const { apiKey, baseUrl, messages, onChunk, model = DEFAULT_CHAT_MODEL, maxTokens = 4096, thinkingFlag = true, signal, } = options;
+    const request = {
+        apiKey,
+        baseUrl,
+        messages,
+        model,
+        maxTokens,
+        thinkingFlag,
+        signal,
+        onChunk,
+    };
+    await sendChatByProvider(request);
+}
+export { kieUploadFile } from './kie-http.js';