| 依赖 | 最低版本 | 用途 |
|---|---|---|
| Docker | 20+ | 容器化部署(推荐) |
| Docker Compose | 2+ | 多服务编排 |
| Git | 2.30+ | 克隆仓库 |
| DeepSeek API Key | — | LLM 调用(申请地址) |
不需要 Docker? 可以用 Python 3.11+ 和 Node.js 18+ 分别手动启动前后端(见下方"手动安装"章节)。
git clone https://github.com/MonSp/MDH.git
cd MDHcp .env.example .env编辑 .env,填入至少一个 LLM API Key:
DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx
DEEPSEEK_BASE_URL=https://api.deepseek.com
DEEPSEEK_MODEL=deepseek-chatdocker compose up -d首次启动需要拉取镜像和构建,约 2-5 分钟。
# 检查容器状态
docker compose ps
# 健康检查
curl http://localhost:8765/health访问 **http://localhost:8080**,你将看到 3D 虚拟办公室界面。
# 确保 Python 3.11+
python --version
# 安装依赖
pip install -r backend/requirements.txt
# 配置
cp .env.example .env
# 编辑 .env 填入 DEEPSEEK_API_KEY
# 启动后端
python backend/server.py后端运行在 http://localhost:8765,WebSocket 在 ws://localhost:8765/ws。
# 确保 Node.js 18+
node --version
# 安装依赖
npm install --legacy-peer-deps
# 启动开发服务器
npm run dev前端运行在 http://localhost:5173。
cd orchestrator
npm install
npm test在 CEO Chat 面板中输入:
分析当前项目的代码质量并给出改进建议
预期输出:
- CEO 智能体分析任务复杂度,判定为"简单"路径
- SimpleExecutor 执行代码分析
- 返回代码质量报告,包含改进建议列表
开发一个用户登录功能,包含前端表单、后端 API 和单元测试
预期输出:
- CEO 智能体判定为"复杂"路径
- 动态组建团队:架构师 + 前端开发 + 后端开发 + QA
- 工作流引擎按 DAG 顺序执行:架构设计 → 前端实现 → 后端实现 → 测试
- 审查智能体把控代码质量
- 技能自动进化,经验规则入库
帮我整理这段会议记录:[粘贴你的会议内容]
预期输出:
- 识别为文档模式
- 启动纪要 DAG 工作流(提取/起草/校对)
- 输出结构化会议纪要
| 变量 | 必填 | 默认值 | 说明 |
|---|---|---|---|
DEEPSEEK_API_KEY |
是 | — | DeepSeek API 密钥 |
DEEPSEEK_BASE_URL |
否 | https://api.deepseek.com |
API 端点 |
DEEPSEEK_MODEL |
否 | deepseek-chat |
模型名称 |
EXECUTOR_URL |
否 | http://localhost:8767 |
远端执行器地址 |
EXECUTOR_TOKEN |
否 | — | 执行器认证 Token |
BACKEND_TOKEN |
否 | 自动生成 | 后端 API 认证 Token |
CORS_ORIGINS |
否 | http://localhost:8080,http://localhost:9090 |
允许的跨域来源 |
A: 检查容器状态:
docker compose logs backend
docker compose logs frontend确保 DEEPSEEK_API_KEY 已正确配置。
A:
- 确认后端已启动:
curl http://localhost:8765/health - 检查浏览器控制台是否有 CORS 错误
- 确认防火墙未阻止 8765 端口
A: 检查以下三个位置:
.env文件中的DEEPSEEK_API_KEY- 前端 localStorage 中的
deepseek_api_key - WebSocket 会话中的
api_key
A:
# 跳过 legacy 测试
cd backend && python -m pytest tests/ --ignore=tests/legacy -q
# 确保安装了所有测试依赖
pip install -r backend/requirements.txtA: 使用 --legacy-peer-deps 标志:
npm install --legacy-peer-depsA:
# 单独构建各服务
docker compose build backend
docker compose build frontend
# 使用国内镜像加速(如需要)
# 编辑 daemon.json 添加 registry-mirrorsA: 在 .env 中配置其他提供商的 API Key,或在前端设置面板中切换。MDH 支持 9 个提供商:DeepSeek、OpenAI、Anthropic、Gemini、Ollama、Moonshot、XAI 等。
- 用户指南 — 详细的使用指南
- Agent 角色配置 — 自定义角色和技能
- 设计文档 — 架构和设计决策
- Docker 部署指南 — 生产环境部署
- API 参考 — REST API 端点文档
- 贡献指南 — 参与开发