# wfh-cli

**Repository Path**: wangfenghuan3399/wfh-cli

## Basic Information

- **Project Name**: wfh-cli
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-04
- **Last Updated**: 2025-10-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Gemini CLI - 国内大模型版

[![中文文档](https://img.shields.io/badge/文档-中文-blue)](./README_CN.md)
[![English](https://img.shields.io/badge/docs-English-blue)](./README.md)

Gemini CLI 是一个开源 AI 助手，现已支持国内主流大语言模型！

## 🌟 新特性

✨ **支持国内大模型**

- DeepSeek（深度求索） - 性价比之王
- 通义千问 (Qwen) - 阿里云出品
- Kimi (Moonshot) - 超长上下文
- 豆包 (Doubao) - 字节跳动
- GLM - 智谱 AI

🔍 **支持国内搜索引擎**

- Bing 搜索（推荐）
- 百度搜索

## 🚀 快速开始

### 1. 安装

```bash
# 全局安装
npm install -g wfh/wfh-cli

# 或使用 Homebrew (macOS/Linux)
brew install gemini-cli
```

### 2. 配置

创建配置文件 `~/.wfh/.env`：

```bash
# 选择模型提供商
LLM_PROVIDER=deepseek

# 配置 API Key
DEEPSEEK_API_KEY=sk-your-api-key-here

# 配置搜索引擎
SEARCH_ENGINE=bing
BING_SEARCH_API_KEY=your-bing-api-key
```

### 3. 启动

```bash
# 使用便捷脚本
./start-chinese-llm.sh deepseek

# 或直接启动
gemini
```

## 📖 获取 API Key

### DeepSeek (推荐)

1. 访问 https://platform.deepseek.com/
2. 注册并创建 API Key
3. 新用户有免费额度

### 通义千问

1. 访问 https://dashscope.aliyun.com/
2. 登录阿里云账号
3. 创建 API Key

### Kimi

1. 访问 https://platform.moonshot.cn/
2. 注册账号
3. 创建 API Key

### Bing 搜索 API

1. 访问 https://www.microsoft.com/en-us/bing/apis/bing-web-search-api
2. 注册免费账号（每月 3000 次）
3. 获取 API Key

## 💡 使用示例

```bash
# 启动 CLI
gemini

# 在 CLI 中使用
> 帮我分析这个代码库的架构

> 搜索最新的 Node.js LTS 版本

> 写一个 Express.js 的 REST API 示例
```

## 📚 详细文档

- **[国内大模型配置指南](./CHINESE_LLM_SETUP.md)** - 完整配置教程
- **[原版文档](./README.md)** - 查看原始 Gemini CLI 文档

## 🎯 模型对比

| 模型         | 优势       | 价格       | 适用场景           |
| ------------ | ---------- | ---------- | ------------------ |
| **DeepSeek** | 推理能力强 | ⭐⭐⭐⭐⭐ | 代码生成、技术问答 |
| **通义千问** | 中文理解好 | ⭐⭐⭐⭐   | 中文内容创作       |
| **Kimi**     | 超长上下文 | ⭐⭐⭐     | 长文档分析         |
| **豆包**     | 响应快     | ⭐⭐⭐⭐⭐ | 快速原型           |
| **GLM**      | 多模态     | ⭐⭐⭐⭐   | 图文混合任务       |

## 🔧 高级配置

### 环境变量说明

```bash
# 模型配置
LLM_PROVIDER=deepseek        # 提供商选择
LLM_API_KEY=sk-xxx           # 统一 API Key 变量
LLM_MODEL=deepseek-chat      # 自定义模型名称
LLM_BASE_URL=https://...     # 自定义 API 地址

# 搜索引擎
SEARCH_ENGINE=bing           # bing, baidu, google
BING_SEARCH_API_KEY=xxx      # Bing API Key
SERPAPI_KEY=xxx              # 百度搜索需要
```

### 项目级配置

在项目根目录创建 `.gemini/.env`：

```bash
# 项目特定配置会覆盖全局配置
LLM_PROVIDER=qwen
QWEN_API_KEY=sk-project-key
```

## ⚠️ 注意事项

1. **API Key 安全**：不要将 API Key 提交到代码仓库
2. **费用控制**：按 token 计费，注意使用量
3. **功能差异**：
   - 国内模型不支持 Google Search grounding
   - 嵌入功能需要单独配置
   - 部分高级功能可能不可用

## 🆘 常见问题

**Q: 如何切换不同的模型？**
A: 修改 `~/.wfh/.env` 中的 `LLM_PROVIDER` 变量

**Q: 支持哪些搜索引擎？**
A: Bing（推荐）、百度、Google

**Q: API 调用失败怎么办？**
A: 检查网络连接、API Key 是否有效、是否有足够额度

**Q: 能同时使用多个模型吗？**
A: 可以通过环境变量快速切换，或在不同项目中配置不同模型

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

## 📄 License

Apache License 2.0

---

<p align="center">
  基于 Google Gemini CLI 改造，支持国内大模型
</p>