AlterDo

AlterDo 是一个类似于 Manus/Cowork 的智能 AI Agent 助手。它基于 Claude Code SDK 构建 Agent 核心部分，Agent 运行在云端沙箱环境中。

快速开始

# 1. 启动依赖服务 (MySQL 8 + Redis 7.2)
cd deploy && docker-compose -f docker-compose.dev.yml up -d

# 2. 启动后端服务
cd backend && go mod download && go run cmd/server/main.go

# 3. 启动会话服务
cd backend/session/ && make run

# 3. 启动前端服务
cd frontend && pnpm install
pnpm -F @alterdo/user-console dev      # 用户控制台 (localhost:3000)
pnpm -F @alterdo/admin-dashboard dev   # 管理后台 (localhost:3001)

# 4. 启动客户端
cd /frontend/packages/tauri-app && pnpm install
pnpm tauri dev #客户端

详细的运行说明请查看 快速开始文档。

项目结构

alterdo/
├── backend/              # Go 后端服务
│   ├── cmd/             # 服务入口
│   ├── internal/        # 内部代码 (handler, service, model, middleware)
│   ├── pkg/             # 可导出库 (config, logger, database, redis)
│   ├── migrations/      # 数据库迁移文件
│   └── configs/         # 配置文件
├── frontend/            # Vue 3 前端
│   ├── packages/
│   │   ├── user-console/     # 用户控制台
│   │   └── admin-dashboard/  # 管理后台
│   └── pnpm-workspace.yaml
├── deploy/              # 部署配置
│   └── docker-compose.dev.yml
├── docs/                # 项目文档
│   ├── project-initialization/  # 项目初始化设计文档
│   └── getting-started.md       # 快速开始
├── openapi/             # OpenAPI 规范
│   └── api.yml
└── README.md

文档

文档	说明
快速开始	启动和开发指南
项目初始化方案	初始化设计文档总览
后端架构设计	后端详细设计
前端架构设计	前端详细设计
API 规范	RESTful API 规范
数据库设计	数据库表结构
AI Agent 开发指南	文档格式规范

技术栈

后端

• 语言: Go 1.21+
• 框架: Gin
• 数据库: MySQL 8.0
• 缓存: Redis 7.2
• ORM: GORM
• 认证: JWT

前端

• 框架: Vue 3
• UI 组件: TDesign Vue Next
• 状态管理: Pinia
• 构建工具: Vite
• 类型系统: TypeScript

开发

后端开发

cd backend
make run        # 开发模式运行
make test       # 运行测试
make lint       # 代码检查
make fmt        # 代码格式化

前端开发

用户控制台：

cd frontend/packages/user-console
pnpm install # 安装依赖
pnpm dev        # 启动开发服务器
pnpm build      # 构建生产版本

管理后台：

cd frontend/packages/admin-dashboard
pnpm install # 安装依赖
pnpm dev        # 启动开发服务器
pnpm build      # 构建生产版本

许可证

[待定]