Wucai Code

AI命令行工具（Vibe Working）

安装 • 快速开始 • 功能特性 • 文档

Wucai Code是命令行AI工具，从Gemini CLI改进而来，专门针对Qwen3-Coder模型进行优化。它通过代码理解、智能编排，自动化任务和增强您的开发工作流。

免费选项可用

使用以下任一免费选项，无需成本即可开始使用Wucai Code：

Qwen OAuth（推荐）

• 每天2,000次请求，无令牌限制
• 每分钟60次请求速率限制
• 使用您的qwen.ai账户进行身份验证
• 自动凭证管理和刷新
• 如果您已使用OpenAI兼容模式初始化，使用/auth命令切换到Qwen OAuth

区域免费层级

• 推荐：使用Qwen OAuth，每天2,000次免费请求

详细设置说明，请查看授权。

[!WARNING] 令牌使用说明：Wucai Code可能在每个周期内发出多个API调用，导致更高的令牌使用量（类似Claude Code）。

核心功能

• 代码理解和编辑 - 查询和编辑超出传统上下文窗口限制的大型代码库
• 工作流自动化 - 自动化操作任务，如处理拉取请求和复杂的变基
• 增强解析器 - 专门针对Qwen-Coder模型优化的适配解析器

安装

前置条件

确保您已安装Node.js 20版本或更高版本。

curl -qL https://www.npmjs.com/install.sh | sh

从npm安装

npm install -g @wucai/wucai-code@latest
wucai --version

使用Homebrew全局安装（macOS/Linux）

brew install wucai-code

快速开始

# 启动Wucai Code
wucai

# 首次使用建议：启用完全授权模式（避免每次操作都按Enter）
> /approvals
# 选择 "完全授权 (Full Access)"

# 示例命令
> 解释这个代码库结构
> 帮我重构这个函数
> 为这个模块生成单元测试

会话管理

通过可配置的会话限制来控制令牌使用，以优化成本和性能。

配置会话令牌限制

在您的主目录中创建或编辑.wucai/settings.json：

{
  "sessionTokenLimit": 32000
}

会话命令

• /compact - 压缩对话历史以在令牌限制内继续
• /clear - 清除所有对话历史并重新开始
• /stats - 检查当前令牌使用和限制

注意：会话令牌限制适用于单个对话，而非累积API调用。

授权

根据您的需求选择首选的身份验证方法：

1. Qwen OAuth（推荐 - 30秒内开始使用）

最简单的开始方式 - 完全免费且提供慷慨的配额：

# 只需运行此命令并按照浏览器身份验证步骤操作
wucai

流程如下：

1. 即时设置：CLI自动打开您的浏览器
2. 一键登录：使用您的qwen.ai账户进行身份验证
3. 自动管理：凭证在本地缓存供将来使用
4. 无需配置：零设置要求 - 直接开始编码！

免费层级好处：

• ✅ 每天2,000次请求（无需令牌计数）
• ✅ 每分钟60次请求速率限制
• ✅ 自动凭证刷新
• ✅ 个人用户零成本
• ℹ️ 注意：为保持服务质量可能会进行模型回退

2. API密钥方式

使用阿里云百炼API密钥：

配置方法：

1. 环境变量

   export DASHSCOPE_API_KEY="your_api_key_here"

2. 项目.env文件 在项目根目录创建.env文件：

   DASHSCOPE_API_KEY=your_api_key_here

申请API密钥

• 阿里云百炼 (申请API密钥)

Wucai Code会自动使用默认配置：

• BASE_URL: https://dashscope.aliyuncs.com/compatible-mode/v1
• MODEL: qwen3-coder-plus

使用示例

探索代码库

cd your-project/
wucai

# 架构分析
> 描述这个系统架构的主要组成部分
> 主要依赖关系是什么，它们如何交互？
> 找到所有API端点及其身份验证方法

代码开发

# 重构
> 重构这个函数以提高可读性和性能
> 将这个类转换为使用依赖注入
> 将这个大模块拆分成更小、更专注的组件

# 代码生成
> 为用户管理创建REST API端点
> 为身份验证模块生成单元测试
> 为所有数据库操作添加错误处理

自动化工作流

# Git自动化
> 分析过去7天的git提交，按功能分组
> 从最近的提交中创建更新日志
> 找到所有TODO注释并创建GitHub议题

# 文件操作
> 将此目录中的所有图像转换为PNG格式
> 将所有测试文件重命名为遵循*.test.ts模式
> 找到并删除所有console.log语句

调试和分析

# 性能分析
> 识别这个React组件中的性能瓶颈
> 找到代码库中所有的N+1查询问题

# 安全审计
> 检查潜在的SQL注入漏洞
> 找到所有硬编码的凭证或API密钥

常用任务

理解新代码库

> 核心业务逻辑组件有哪些？
> 数据如何在系统中流动？
> 使用了哪些主要设计模式？

代码重构和优化

> 这个模块的哪些部分可以优化？
> 帮我重构这个类以遵循SOLID原则
> 添加适当的错误处理和日志记录
> 将回调转换为async/await模式
> 为昂贵的操作实现缓存

文档和测试

> 为所有公共API生成全面的JSDoc注释
> 为这个组件编写包含边缘情况的单元测试
> 创建OpenAPI格式的API文档
> 添加解释复杂算法的内联注释
> 为这个模块生成README

开发加速

> 使用身份验证设置新的Express服务器
> 创建带有TypeScript和测试的React组件
> 实现速率限制中间件
> 为新架构添加数据库迁移
> 为这个项目配置CI/CD流水线

命令和快捷键

会话命令

• /approvals - 推荐： 设置批准模式，选择"完全授权"避免每次按Enter
• /help - 显示可用命令
• /clear - 清除对话历史
• /compact - 压缩历史以节省令牌
• /stats - 显示当前会话信息
• /exit或/quit - 退出Wucai Code

键盘快捷键

• Ctrl+C - 取消当前操作
• Ctrl+D - 退出（在空行上）
• 上/下 - 浏览命令历史

身份验证

有关详细的身份验证设置，请参阅身份验证指南。

故障排除

如果您遇到问题，请查看故障排除指南。

致谢

本项目基于Google Gemini CLI。我们感谢并赞赏Gemini CLI团队的出色工作，同时感谢Qwen-Coder的模型支持。我们的主要工作是给企业提供私有化部署解决方案，以及更好的vibe working体验。

许可证

LICENSE