xx-ai-cli 0.1.57 → 0.1.58

package/README.md

@@ -1,7 +1,8 @@
 # 🤖 XX-AI-CLI
 
-> 国内主流大模型命令行工具，支持 DeepSeek、通义千问、智谱GLM、豆包、Kimi 等。
+> 国内主流大模型命令行工具，支持 DeepSeek、通义千问、智谱GLM、豆包、Kimi、MiniMax、腾讯混元、百度文心等 8 大平台。
 
+[![npm](https://img.shields.io/npm/v/xx-ai-cli)](https://www.npmjs.com/package/xx-ai-cli)
 [![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18-green)](https://nodejs.org)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue)](https://www.typescriptlang.org)
 
@@ -9,294 +10,238 @@
 
 ## ✨ 功能特性
 
-- 🗨️ **交互式对话** - 多轮对话，支持历史上下文，**自动持久化**
+- 🗨️ **交互式对话** - 多轮对话，支持历史上下文，自动持久化
+- 🤖 **Agent 模式** - 自主执行任务，调用工具（文件读写、命令执行、联网搜索）
 - ⚡ **单次提问** - 快速问答，流式输出
 - 💻 **代码助手** - 生成、解释、优化、Review 代码
 - 📄 **文件分析** - 读取本地文件让 AI 分析
 - 🔧 **命令建议** - 自然语言转 Shell 命令
-- 🔄 **多模型切换** - 随时切换不同 AI 服务商
-- 🎯 **一键初始化** - `xxcli init` 交互式向导，新用户 1 分钟完成配置
+- 🔄 **多模型切换** - 对话中随时切换，无需重启
+- 🎯 **一键初始化** - `xx init` 交互式向导，新用户 1 分钟完成配置
 - 📚 **历史会话** - 查看、恢复任意历史对话
 - 🔗 **管道输入** - `cat file | xx "问题"` 无缝联动其他工具
 
-## 📦 支持的模型
-
-| 模型          | Provider   | 获取 API Key                                                         |
-| ------------- | ---------- | -------------------------------------------------------------------- |
-| DeepSeek      | `deepseek` | [platform.deepseek.com](https://platform.deepseek.com)               |
-| 通义千问      | `qwen`     | [dashscope.console.aliyun.com](https://dashscope.console.aliyun.com) |
-| 智谱 GLM      | `glm`      | [open.bigmodel.cn](https://open.bigmodel.cn)                         |
-| 豆包          | `doubao`   | [console.volcengine.com](https://console.volcengine.com/ark)         |
-| 月之暗面 Kimi | `moonshot` | [platform.moonshot.cn](https://platform.moonshot.cn)                 |
-
 ---
 
-## � API Key 安全性说明
-
-我们深知 API Key 是你访问 AI 服务的凭证，安全性至关重要。以下是本工具对 Key 的完整处理机制，请放心使用。
-
-### ✅ Key 绝不离开你的设备
-
-- **本工具不设任何服务端**，没有后台、没有中转服务器，所有 AI 请求均由你的设备**直连**各模型官方 API（DeepSeek、阿里云、智谱等）
-- Key **仅用于构造请求头** `Authorization: Bearer <key>`，直接发送给对应平台，全程不经过任何第三方
-- 本工具代码**完全开源**，你可以自行审查 [`src/core/stream.ts`](src/core/stream.ts) 中的网络请求逻辑
-
-### ✅ Key 的存储位置
-
-当你使用 `xxcli model set-key` 或 `xxcli init` 保存 Key 时，Key **仅写入你本机的用户配置目录**：
+## 📦 支持的模型
 
-| 系统          | 配置文件路径                   |
-| ------------- | ------------------------------ |
-| macOS / Linux | `~/.config/ai-cli/config.json` |
-| Windows       | `%APPDATA%\ai-cli\config.json` |
+| 模型          | Provider   | 默认模型       | 获取 API Key                                                         |
+| ------------- | ---------- | -------------- | -------------------------------------------------------------------- |
+| DeepSeek      | `deepseek` | deepseek-chat  | [platform.deepseek.com](https://platform.deepseek.com)               |
+| 通义千问      | `qwen`     | qwen-turbo     | [dashscope.console.aliyun.com](https://dashscope.console.aliyun.com) |
+| 智谱 GLM      | `glm`      | glm-4-flash    | [open.bigmodel.cn](https://open.bigmodel.cn)                         |
+| 豆包          | `doubao`   | doubao-pro-4k  | [console.volcengine.com](https://console.volcengine.com/ark)         |
+| 月之暗面 Kimi | `moonshot` | moonshot-v1-8k | [platform.moonshot.cn](https://platform.moonshot.cn)                 |
+| MiniMax 海螺  | `minimax`  | abab6.5s-chat  | [api.minimax.chat](https://api.minimax.chat)                         |
+| 腾讯混元      | `hunyuan`  | hunyuan-pro    | [cloud.tencent.com](https://cloud.tencent.com/product/hunyuan)       |
+| 百度文心一言  | `ernie`    | ernie-4.0-8k   | [qianfan.baidu.com](https://qianfan.baidu.com)                       |
 
-- 该文件**不在项目目录内**，不会被 `git commit` 提交
-- 只有当前用户有读写权限
-- 你可以随时运行 `xxcli config show` 查看配置文件的完整路径
+---
 
-### ✅ 所有显示均已脱敏
+## 🚀 快速开始
 
-无论是 `xxcli model list` 还是 `xxcli config show`，界面上显示的 Key 均经过**脱敏处理**：
+### 安装
 
-```
-sk-ab****efgh
+```bash
+npm install -g xx-ai-cli
 ```
 
-截图或分享配置信息时无需担心 Key 被看到。
+安装后提供两个命令：`xx`（短别名，推荐）和 `xxcli`（完整名）。
 
-### ✅ 三种方式存储 Key（安全性递增）
+### 初始化
 
 ```bash
-# 方式一：命令行直接传入（会留在 shell history，安全性较低）
-xxcli model set-key deepseek sk-xxxxxxxxxxxxxxxx
-
-# 方式二：隐藏输入模式（输入不会显示和记录到 shell history，推荐）
-xxcli model set-key deepseek
-# 然后在提示符下输入 Key，输入内容不会回显
-
-# 方式三：环境变量（Key 永不写入磁盘，最安全）
-export DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxx
-xx chat   # 自动读取环境变量，重启终端后自动失效
+xx init
 ```
 
-**环境变量一览：**
+向导会引导你：选择模型 → 输入 API Key → 设置默认模型 → 开启流式输出，1 分钟完成配置。
 
-| 模型          | 环境变量名         |
-| ------------- | ------------------ |
-| DeepSeek      | `DEEPSEEK_API_KEY` |
-| 通义千问      | `QWEN_API_KEY`     |
-| 智谱 GLM      | `GLM_API_KEY`      |
-| 豆包          | `DOUBAO_API_KEY`   |
-| 月之暗面 Kimi | `MOONSHOT_API_KEY` |
-| MiniMax 海螺  | `MINIMAX_API_KEY`  |
-| 腾讯混元      | `HUNYUAN_API_KEY`  |
-| 百度文心一言  | `ERNIE_API_KEY`    |
+---
 
-> 💡 **推荐做法**：将 `export DEEPSEEK_API_KEY=...` 写入 `~/.zshrc` 或 `~/.bashrc`，Key 不落盘且持久生效。
+## 📖 使用示例
 
-### ✅ 历史会话自动脱敏
+### 💬 交互式对话
 
-对话历史保存在 `~/.config/ai-cli/history/` 目录下。即使你在对话中不小心粘贴了 Key，保存时也会**自动识别并脱敏**（替换为 `sk-ab********[REDACTED]`），不会以明文形式存储。
+```bash
+xx chat
+xx chat --model qwen
+xx chat --system "你是一个 Python 专家"
+```
 
----
+**对话内置命令（输入 `/` 可查看全部）：**
 
-## �🚀 快速开始
+| 命令       | 说明                   |
+| ---------- | ---------------------- |
+| `/clear`   | 清空当前对话           |
+| `/model`   | 切换模型（无需退出）   |
+| `/history` | 查看最近 10 条历史会话 |
+| `/exit`    | 退出（会话自动保存）   |
 
-### 安装依赖
+### 🤖 Agent 模式（自主执行任务）
 
 ```bash
-npm install
+xx agent "帮我查一下杭州今天的天气"
+xx agent "读取 src/index.ts，找出潜在 Bug"
+xx agent "帮我改一下 deepseek 的 API Key"
+xx agent --model deepseek "分析当前项目结构"
 ```
 
-### 构建
+**Agent 对话内置命令（输入 `/` 可查看全部）：**
+
+| 命令           | 说明               |
+| -------------- | ------------------ |
+| `/clear`       | 清空当前对话       |
+| `/tools`       | 查看可用工具列表   |
+| `/context`     | 查看当前上下文内容 |
+| `/tokens`      | Token 消耗统计     |
+| `/model`       | 切换模型           |
+| `/cache clear` | 清空工具缓存       |
+| `/exit`        | 退出               |
+
+### ⚡ 单次提问
 
 ```bash
-npm run build
+xx ask "什么是 CAP 定理"
+xx ask "解释 React Hooks" --model glm
+xx ask "写个斐波那契数列" --no-stream
 ```
 
-### 链接到全局
+### 💻 代码助手
 
 ```bash
-npm link
-```
+# 生成代码
+xx code gen "用 TypeScript 写一个单例模式"
 
-> 安装后提供两个命令：`xxcli`（完整名）和 `xx`（短别名）
+# 解释代码
+xx code explain ./src/index.ts
 
-### 或者直接用 tsx 运行（开发模式）
+# 优化代码
+xx code optimize ./src/utils.ts
 
-```bash
-npm run dev -- chat
+# Code Review
+xx code review ./src/api.ts
 ```
 
-### 🎯 首次使用 — 运行初始化向导
+### 📄 文件分析
 
 ```bash
-xxcli init
-# 或
-xx init
+xx file ./package.json "这个项目依赖了哪些主要库？"
+xx file ./src/index.ts "帮我找出潜在的 Bug"
 ```
 
-向导会引导你：选择要配置的模型 → 输入 API Key → 设置默认模型 → 开启流式输出
-
-配置完成后即可开始使用！
-
----
-
----
+### 🔧 Shell 命令建议
 
-## 📖 使用示例
+```bash
+xx cmd "找出所有大于 1MB 的文件"
+xx cmd "查看端口 8080 被哪个进程占用"
+xx cmd "统计当前目录下 ts 文件数量"
+```
 
-### 🔗 管道输入（与其他工具联动）
+### 🔗 管道输入
 
 ```bash
-# 分析错误日志
 cat error.log | xx "帮我分析这个错误"
-
-# 生成 Git commit message
 git diff | xx "帮我写 commit message"
-
-# Review 代码文件
 cat src/utils.ts | xx "帮我 code review"
-
-# 分析 JSON 配置
-cat package.json | xx "这个项目用了哪些主要依赖"
-
-# 无问题时自动分析内容
-cat README.md | xx
 ```
 
 ### 📚 历史会话管理
 
 ```bash
-# 列出最近 20 条历史会话
-xxcli history list
-xx history list
-
-# 查看某条历史会话详情
-xxcli history show <ID>
-
-# 从历史会话继续对话
-xxcli history resume <ID>
-
-# 清空所有历史
-xxcli history clear
-
-# 对话中用 /history 快速查看最近 10 条
+xx history list          # 列出最近 20 条历史会话
+xx history show <ID>     # 查看某条历史详情
+xx history resume <ID>   # 从历史会话继续对话
+xx history clear         # 清空所有历史
 ```
 
 ---
 
-## 🔧 配置
-
-### 设置 API Key
-
-```bash
-# DeepSeek（推荐，性价比高）
-xxcli model set-key deepseek sk-xxxxxxxxxxxxxxxx
-
-# 通义千问
-xxcli model set-key qwen sk-xxxxxxxxxxxxxxxx
-
-# 智谱 GLM
-xxcli model set-key glm xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxx
-
-# 豆包
-xxcli model set-key doubao xxxxxxxxxxxxxxxx
-
-# Kimi
-xxcli model set-key moonshot sk-xxxxxxxxxxxxxxxx
-```
-
-### 切换默认模型
-
-```bash
-xxcli model use deepseek
-xxcli model use qwen
-xxcli model use glm
-```
-
-### 查看配置
+## 🔧 模型管理
 
 ```bash
-xxcli model list    # 查看所有模型状态
-xxcli config show   # 查看当前配置
+# 查看所有模型状态
+xx model list
+
+# 设置 API Key
+xx model set-key deepseek sk-xxxxxxxxxxxxxxxx
+xx model set-key qwen sk-xxxxxxxxxxxxxxxx
+xx model set-key glm xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxx
+xx model set-key doubao xxxxxxxxxxxxxxxx
+xx model set-key moonshot sk-xxxxxxxxxxxxxxxx
+xx model set-key minimax xxxxxxxxxxxxxxxx
+xx model set-key hunyuan xxxxxxxxxxxxxxxx
+xx model set-key ernie xxxxxxxxxxxxxxxx
+
+# 切换默认模型
+xx model use deepseek
+xx model use qwen
+
+# 检测连通性
+xx model check deepseek
 ```
 
 ---
 
-## 📖 使用示例
-
-### 💬 交互式对话
+## ⚙️ 高级配置
 
 ```bash
-xxcli chat
-xxcli chat --model qwen
-xxcli chat --system "你是一个 Python 专家"
-```
-
-**对话内置命令：**
+# 查看当前配置
+xx config show
 
-| 命令       | 说明                       |
-| ---------- | -------------------------- |
-| `/clear`   | 清空当前对话               |
-| `/model`   | 查看当前模型               |
-| `/history` | 快速查看最近 10 条历史会话 |
-| `/exit`    | 退出（会话自动保存）       |
+# 关闭流式输出
+xx config set stream false
 
-### ⚡ 单次提问
+# 设置历史长度
+xx config set historySize 30
 
-```bash
-xxcli ask "什么是 CAP 定理"
-xxcli ask "解释 React Hooks" --model glm
-xxcli ask "写个斐波那契数列" --no-stream
+# 显示 AI 思考过程（DeepSeek R1 / Qwen3 等推理模型）
+xx agent --thinking "你的问题"
 ```
 
-### 💻 代码助手
+---
 
-```bash
-# 生成代码
-xxcli code gen "用 TypeScript 写一个单例模式"
-xxcli code gen "实现 LRU 缓存" --model deepseek
+## � API Key 安全性说明
 
-# 解释代码（可以传文件路径或直接输入代码）
-xxcli code explain ./src/index.ts
-xxcli code explain "const fn = () => {}"
+### Key 绝不离开你的设备
 
-# 优化代码
-xxcli code optimize ./src/utils.ts
+- **本工具不设任何服务端**，所有 AI 请求均由你的设备**直连**各模型官方 API
+- Key **仅用于构造请求头** `Authorization: Bearer <key>`，全程不经过任何第三方
+- 代码**完全开源**，可自行审查 [`src/core/stream.ts`](src/core/stream.ts)
 
-# Code Review
-xxcli code review ./src/api.ts
-```
-
-### 📄 文件分析
+### Key 的存储位置
 
-```bash
-xxcli file ./package.json "这个项目依赖了哪些主要库？"
-xxcli file ./src/index.ts "帮我找出潜在的 Bug"
-xxcli file ./README.md "用一句话总结这个项目"
-```
+| 系统          | 配置文件路径                   |
+| ------------- | ------------------------------ |
+| macOS / Linux | `~/.config/ai-cli/config.json` |
+| Windows       | `%APPDATA%\ai-cli\config.json` |
 
-### 🔧 Shell 命令建议
+### 三种方式存储 Key（安全性递增）
 
 ```bash
-xxcli cmd "找出所有大于 1MB 的文件"
-xxcli cmd "查看端口 8080 被哪个进程占用"
-xxcli cmd "递归删除所有 node_modules 目录"
-xxcli cmd "统计当前目录下 ts 文件数量"
-```
+# 方式一：命令行直接传入（会留在 shell history）
+xx model set-key deepseek sk-xxxxxxxxxxxxxxxx
 
----
+# 方式二：隐藏输入模式（推荐）
+xx model set-key deepseek
+# 在提示符下输入 Key，输入内容不会回显
 
-## ⚙️ 高级配置
+# 方式三：环境变量（最安全，Key 永不写入磁盘）
+export DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxx
+xx chat
+```
 
-```bash
-# 关闭流式输出
-xxcli config set stream false
+**环境变量一览：**
 
-# 设置历史长度
-xxcli config set historySize 30
-```
+| 模型          | 环境变量名         |
+| ------------- | ------------------ |
+| DeepSeek      | `DEEPSEEK_API_KEY` |
+| 通义千问      | `QWEN_API_KEY`     |
+| 智谱 GLM      | `GLM_API_KEY`      |
+| 豆包          | `DOUBAO_API_KEY`   |
+| 月之暗面 Kimi | `MOONSHOT_API_KEY` |
+| MiniMax 海螺  | `MINIMAX_API_KEY`  |
+| 腾讯混元      | `HUNYUAN_API_KEY`  |
+| 百度文心一言  | `ERNIE_API_KEY`    |
 
 ---
 
@@ -305,15 +250,19 @@ xxcli config set historySize 30
 ```
 src/
 ├── commands/       # CLI 命令实现
+│   ├── agent.ts    # Agent 自主任务模式
 │   ├── chat.ts     # 交互式对话
 │   ├── ask.ts      # 单次提问
 │   ├── code.ts     # 代码助手
 │   ├── file.ts     # 文件分析
 │   ├── cmd.ts      # 命令建议
-│   └── model.ts    # 模型/配置管理
+│   ├── model.ts    # 模型/配置管理
+│   └── history.ts  # 历史会话管理
 ├── core/
-│   ├── config.ts   # 配置管理
-│   ├── session.ts  # 会话/历史
+│   ├── config.ts   # 配置 & 模型定义
+│   ├── tools.ts    # Agent 工具集（文件/命令/搜索）
+│   ├── search.ts   # 联网搜索（必应 + wttr.in）
+│   ├── session.ts  # 会话/历史持久化
 │   ├── stream.ts   # 流式 API 调用
 │   └── prompt.ts   # Prompt 模板
 ├── ui/

package/dist/commands/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/commands/agent.ts"],"names":[],"mappings":"AAEA,OAAO,EAA6D,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAgBlH,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA2TD,wBAAgB,gBAAgB,IAAI,IAAI,CAoBvC;AAGD,wBAAsB,YAAY,CAChC,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAgTf"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/commands/agent.ts"],"names":[],"mappings":"AAEA,OAAO,EAA6D,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAkBlH,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA2TD,wBAAgB,gBAAgB,IAAI,IAAI,CAoBvC;AAGD,wBAAsB,YAAY,CAChC,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAgTf"}