环境要求
- Node.js 18.18+
- pnpm 8+ (推荐) 或 npm/yarn
- Docker (可选,用于容器化部署)
快速开始
- 克隆项目并安装依赖
```bash
git clone
cd ai-sdk-computer-use
pnpm install # 推荐使用pnpm
```
- 配置环境变量
复制环境变量模板并配置:
```bash
cp .env.example .env.local
```
编辑 .env.local 文件,配置必要的环境变量:
```bash
# AI模型API密钥(至少配置一个)
ANTHROPIC_API_KEY=your_anthropic_key # Claude模型
DASHSCOPE_API_KEY=your_dashscope_key # 通义千问
DEEPSEEK_API_KEY=your_deepseek_key # DeepSeek(可选)
OPENROUTER_API_KEY=your_openrouter_key # OpenRouter(可选)
GEMINI_API_KEY=your_google_gemini_key # Google Gemini(可选)
# E2B桌面自动化(Computer Use功能必需)
E2B_API_KEY=your_e2b_key
# Supabase认证(可选,不配置则以独立模式运行)
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_key
# 第三方集成(可选)
FEISHU_BOT_WEBHOOK=your_feishu_webhook # 飞书机器人
WECHAT_BOT_WEBHOOK=your_wechat_webhook # 企微机器人
WECHAT_BOT_ACCESS_TOKEN=your_wechat_token
DULIDAY_TOKEN=your_duliday_token # DulidayHR系统
# MCP集成(可选)
EXA_API_KEY=your_exa_search_key # Exa搜索
```
- 启动开发服务器
```bash
pnpm dev # 使用Turbopack加速开发构建
```
- 访问应用
- 主应用: [http://localhost:3000](http://localhost:3000)
- 配置管理: [http://localhost:3000/admin/settings](http://localhost:3000/admin/settings)
- LLM测试: [http://localhost:3000/test-llm-reply](http://localhost:3000/test-llm-reply)
- 健康检查: [http://localhost:3000/api/health](http://localhost:3000/api/health)
开发命令
```bash
# 开发
pnpm dev # 启动开发服务器(Turbopack)
pnpm build # 构建生产版本
pnpm start # 启动生产服务器
# 测试
pnpm test # 运行单元测试(watch模式)
pnpm test:run # 运行单元测试(单次)
pnpm test:ui # 可视化测试界面
pnpm test:coverage # 生成测试覆盖率报告
pnpm test:mcp # 测试MCP连接
# 代码质量
pnpm lint # ESLint检查
pnpm format # Prettier格式化
pnpm format:check # 检查格式化
npx tsc --noEmit # TypeScript类型检查
# Docker