npm package: @ia-ccun/ask-ai-cli
Description: AI CLI - 终端与 AI 对话工具，支持多个国内 AI 提供商
Author: xujianjiang
Latest version: 0.0.2

# @ia-ccun/ask-ai-cli

AI CLI - 终端与 AI 对话工具，支持多个国内 AI 提供商

## 功能特性

- 🤖 支持多个 AI 提供商
- 💬 流式输出，打字机效果
- 🔄 交互模式，连续对话
- ⚡ 简单易用的配置命令
- 📋 丰富的模型选择

## 安装

```bash
npm i -g @ia-ccun/ask-ai-cli
```

## 快速开始

```bash
# 1. 配置 AI 提供商
ai config set provider siliconflow

# 2. 设置 API Key
ai config set api-key <your-api-key>

# 3. 开始对话
ai "你好，请介绍一下自己"
```

## 配置文件

配置文件存储在 `~/.ask-ai/` 目录下：

```
~/.ask-ai/
├── config.json    # 用户配置 (provider, model, api-keys)
└── models.json    # 可用模型列表
```

## 支持的 AI 提供商

| 提供商 | 默认模型 | 免费额度 | 说明 |
|--------|----------|----------|------|
| **硅基流动** | Qwen/Qwen2.5-7B-Instruct | 有免费额度 | [注册链接](https://cloud.siliconflow.cn/i/AvDmOKTO) |
| **DeepSeek** | deepseek-chat | 有免费额度 | 代码能力强 |
| **MiniMax** | abab6.5s-chat | 有免费额度 | 国产大模型 |
| **阿里云** | qwen-turbo | 100万 tokens/月 | 通义千问 |
| **百度文心** | ernie-speed-8k | 有免费额度 | ERNIE 系列 |
| **腾讯混元** | hunyuan-lite | 有免费额度 | 腾讯系 |
| **智谱 GLM** | glm-4-flash | **完全免费** | 清华技术 |
| **讯飞星火** | lite | **永久免费** | 科大讯飞 |
| **字节豆包** | doubao-pro-32k | 新用户 50 万 token | 火山引擎 |
| **百川智能** | baichuan4 | 1000万 tokens | 王小川团队 |

## 使用命令

### 问答

```bash
# 简单问答
ai "用 Python 写一个快速排序"

# 指定模型
ai --model qwen-plus "解释什么是递归"

# 指定提供商
ai --provider zhipu "你好"

# 关闭流式输出
ai --stream false "你的问题"
```

### 交互模式

```bash
# 交互模式（连续对话）
ai -i

# 退出按 Ctrl+C
```

### 配置管理

```bash
# 查看当前配置
ai config

# 设置提供商
ai config set provider siliconflow
ai config set provider aliyun
ai config set provider wenxin
ai config set provider hunyuan
ai config set provider zhipu
ai config set provider xfyun
ai config set provider douyin
ai config set provider baichuan

# 设置 API Key
ai config set api-key <your-api-key>

# 设置默认模型
ai config set model qwen-turbo

# 查看配置项
ai config get provider
ai config get model
ai config get api-key
```

### 模型列表

```bash
# 查看当前提供商的可用模型
ai models

# 查看指定提供商的可用模型
ai models aliyun
ai models zhipu
ai models xfyun
```

## 命令行选项

| 选项 | 简写 | 描述 | 默认值 |
|-----|------|------|--------|
| `--model <model>` | `-m` | 指定 AI 模型 | 提供商默认 |
| `--provider <provider>` | `-p` | 指定 AI 提供商 | siliconflow |
| `--stream` | `-s` | 启用流式输出 | true |
| `--interactive` | `-i` | 交互式对话模式 | false |

## 免费模型推荐

### 🎉 强烈推荐（完全免费）

- **智谱 GLM**: `glm-4-flash` - 完全免费，支持 128K 上下文
- **讯飞星火**: `lite` - 永久免费，QPS=2

### 高性价比

- **阿里云**: `qwen-turbo` - 100万 tokens/月免费
- **百度文心**: `ernie-speed-8k` - 免费额度充足

## 使用示例

### 硅基流动（推荐）
[注册链接](https://cloud.siliconflow.cn/i/AvDmOKTO) - 新用户有免费额度

```bash
ai config set provider siliconflow
ai config set api-key <siliconflow-key>
ai "用 Python 写一个快速排序"
```

### 阿里云通义千问
ai config set provider aliyun
ai config set api-key <aliyun-key>
ai --model qwen-plus "用 JavaScript 写一个二分查找"

# 智谱 GLM (免费)
ai config set provider zhipu
ai config set api-key <zhipu-key>
ai "写一首关于春天的诗"

# 讯飞星火 (永久免费)
ai config set provider xfyun
ai config set api-key <xfyun-key>
ai "解释什么是机器学习"

# 百度文心一言
ai config set provider wenxin
ai config set api-key <wenxin-key>
ai "用 Python 写一个冒泡排序"

# 腾讯混元
ai config set provider hunyuan
ai config set api-key <hunyuan-key>
ai "你好"

# 字节豆包
ai config set provider douyin
ai config set api-key <douyin-key>
ai "写一篇日记"

# 百川智能
ai config set provider baichuan
ai config set api-key <baichuan-key>
ai "介绍你自己"
```

## 帮助

```bash
# 查看帮助
ai --help

# 查看版本
ai --version

# 查看可用模型
ai models
ai models aliyun
```

## 许可证

MIT