Web UI Agent Platform based on AI CODE
npm install aico-cuiCUI Server 是一个基于 Claude Code 的 Web UI 代理平台,提供完整的 AI 对话界面、文件系统管理、权限控制和 MCP(Model Context Protocol)集成。
#### 通用安装
``bash`
npm install -g aico-cui
aico-cui start
#### Windows 用户
Windows 用户可能会遇到 native 模块编译问题,我们提供了专门的解决方案:
`cmd方法 1: 使用专用安装脚本(推荐)
powershell -ExecutionPolicy Bypass -File scripts/install-windows.ps1
详细的 Windows 安装指南:
- 📖 Windows 快速安装指南
- 🔧 详细故障排除指南
$3
`bash
克隆项目
git clone
cd aico-cui安装依赖
npm install开发模式运行
npm run dev
`🏗️ 构建桌面应用
本项目支持使用 Tauri 构建原生桌面应用程序,支持 Windows、macOS 和 Linux 平台。
$3
构建当前平台的应用程序:
`bash
pnpm build:tauri
`$3
`bash
仅构建当前平台(默认)
pnpm build:tauri尝试构建所有平台(需要特定环境配置)
pnpm build:tauri --all跳过前端构建(如果前端已构建)
pnpm build:tauri --skip-web
`$3
`bash
macOS
pnpm build:tauri:macWindows
pnpm build:tauri:windowsLinux
pnpm build:tauri:linux
`$3
项目已配置 GitHub Actions,可以自动构建所有平台:
1. 创建发布标签:
`bash
git tag v0.0.16
git push origin v0.0.16
`2. 手动触发:访问 GitHub Actions 页面手动触发构建
3. 下载产物:在 Actions 页面下载各平台的应用包
📖 详细构建指南:BUILD_GUIDE.md
📁 项目结构
`
cui/
├── src/ # 后端源代码
│ ├── server.ts # Express 服务器
│ ├── routes/ # API 路由
│ ├── services/ # 业务逻辑服务
│ ├── middleware/ # Express 中间件
│ └── web/ # 前端 React 应用
├── src-tauri/ # Tauri 桌面应用
│ ├── src/ # Rust 源代码
│ └── tauri.conf.json # Tauri 配置
├── dist/ # 构建输出
├── scripts/ # 构建和部署脚本
└── docs/ # 文档
`🧪 测试
`bash
运行所有测试
npm test运行单元测试
npm run unit-tests运行集成测试
npm run integration-tests测试覆盖率
npm run test:coverage交互式测试界面
npm run test:ui
`📚 文档
- 构建指南 - Tauri 应用构建详细说明
- Windows 安装指南 - Windows 平台安装说明
- Claude Agent SDK 指南 - AI Agent 集成说明
🔐 管理员权限说明
$3
系统代理功能需要管理员权限来修改系统网络设置。如果您看到"需要管理员权限"的错误,请按照以下方法之一操作:
#### Windows 用户
方法 1:使用提权脚本(推荐)
`powershell
在 PowerShell 中运行
.\scripts\elevate-windows.ps1或在命令行中运行
scripts\elevate-windows.bat
`方法 2:手动以管理员身份运行
1. 关闭当前程序
2. 右键点击程序图标或快捷方式
3. 选择"以管理员身份运行"
4. 在 UAC 提示框中点击"是"
方法 3:从管理员 PowerShell 启动
`powershell
以管理员身份打开 PowerShell
cd D:\work\workspace-aico\cui
pnpm dev
`#### macOS/Linux 用户
`bash
使用 sudo 运行
sudo npm run dev或
sudo pnpm dev
`注意:
- 系统代理功能会修改系统网络设置
- 关闭应用时会自动恢复原始代理配置
- 只有在需要使用系统代理功能时才需要管理员权限
- 其他功能(如对话、文件管理等)不需要管理员权限
🔧 配置
应用配置通过环境变量和配置文件管理:
`bash
复制配置文件模板
cp .env.example .env编辑配置
vi .env
`主要配置项:
-
PORT - 服务器端口(默认:13001)
- NODE_ENV - 运行环境(development/production)
- ANTHROPIC_API_KEY - Claude API 密钥
- LOG_LEVEL - 日志级别🚢 部署
$3
`bash
启动服务
npm run start:pm2停止服务
npm run stop:pm2重启服务
npm run restart:pm2查看状态
npm run status:pm2查看日志
npm run logs:pm2
`$3
`bash
构建镜像
docker build -t aico-cui .运行容器
docker run -p 13001:13001 aico-cui
``欢迎提交 Issue 和 Pull Request!
MIT License