sanguo/sanguo_moziplus_v3
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: 完成 v0.4 所有文档

Browse Source 
新增:
- DEPLOYMENT.md - 完整部署指南
- README.md - 项目说明和快速开始

更新内容:
- 部署步骤详解
- tmux 操作指南
- Web 访问配置
- 故障排查指南
- 高级配置选项
- 生产部署方案 (systemd/launchd)
- 安全注意事项

v0.4 完整交付:
✅ 设计文档 (04-design-v0.4.md)
✅ 快速参考 (04-quick-reference.md)
✅ 示例工作流 (05-example-workflows.md)
✅ 部署指南 (DEPLOYMENT.md)
✅ 项目说明 (README.md)
✅ 三实例项目结构
✅ 角色 Skills
✅ 系统脚本 (tmux/启动/消息/测试)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Claude Dev
2026-06-30 22:40:38 +08:00
parent a8ac23f699
commit ddccd8fbfa
2 changed files with 585 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+242 -1
View File
@@ -1,3 +1,244 @@
# sanguo_moziplus_v3
多agent框架和基础设施
**三实例 AI 协作开发环境** - 基于 Claude Code + GLM-5.2
## 版本
**v0.4** - 设计和基础设施完成 (2026-06-30)
## 概述
sanguo_moziplus_v3 是一个多实例 AI 协作开发环境，通过三个独立的 Claude Code 实例协同工作，模拟真实开发团队中的不同角色：
```
┌─────────────────────────────────────────────┐
│ tmux sanguo_dev 会话 │
│ │
│ ┌───────────┐ ┌───────────┐ ┌───────────┐ │
│ │ architect │ │ backend │ │ frontend │ │
│ │ 架构师 │ │ 后端开发 │ │ 前端开发 │ │
│ │ pane #0 │ │ pane #1 │ │ pane #2 │ │
│ └───────────┘ └───────────┘ └───────────┘ │
│ │
│ 共享 Superpowers Skills (~/.claude/skills/) │
│ 共享 GLM-5.2 后端 │
└─────────────────────────────────────────────┘
```
## 特性
- **三实例协作**: 架构师、后端、前端三个角色独立运行
- **角色隔离**: 通过 CLAUDE.md 定义清晰的角色边界
- **共享技能库**: 所有实例共享 Superpowers skills
- **跨实例通信**: SendMessage + 文件消息队列
- **Web 访问**: 通过 ttyd 实现浏览器访问
## 快速开始
### 1. 验证环境
```bash
~/.claude/messages/sanguo/test-sanguo-env.sh
```
### 2. 启动环境
```bash
~/.claude/messages/sanguo/start-sanguo-env.sh
```
### 3. 启动实例
在各 tmux pane 中分别执行：
```bash
# pane 0
cd ~/.claude/projects/sanguo-main && claude
# pane 1
cd ~/.claude/projects/sanguo-backend && claude
# pane 2
cd ~/.claude/projects/sanguo-frontend && claude
```
## 文档
| 文档 | 描述 |
|------|------|
| [DEPLOYMENT.md](./DEPLOYMENT.md) | 部署指南 |
| [docs/design/04-design-v0.4.md](./docs/design/04-design-v0.4.md) | 完整设计文档 |
| [docs/04-quick-reference.md](./docs/04-quick-reference.md) | 快速参考 |
| [docs/05-example-workflows.md](./docs/05-example-workflows.md) | 示例工作流 |
## 项目结构
```
sanguo_moziplus_v3/
├── DEPLOYMENT.md # 部署指南
├── README.md # 本文件
├── docs/
│ ├── design/
│ │ ├── 02-design-v0.2.md # v0.2 设计 (CCB 方案)
│ │ ├── 03-design-v0.3.md # v0.3 设计 (内置 Agent)
│ │ └── 04-design-v0.4.md # v0.4 设计 (三实例方案) ✅
│ ├── 04-quick-reference.md # 快速参考
│ └── 05-example-workflows.md # 示例工作流
│
├── ~/.claude/projects/ # 项目目录
│ ├── sanguo-main/ # 架构师项目
│ │ └── .claude/CLAUDE.md # 架构师角色定义
│ ├── sanguo-backend/ # 后端项目
│ │ └── .claude/CLAUDE.md # 后端角色定义
│ └── sanguo-frontend/ # 前端项目
│ └── .claude/CLAUDE.md # 前端角色定义
│
├── ~/.claude/skills/ # 角色 Skills
│ ├── architect-role/ # 架构师 skill
│ ├── backend-dev/ # 后端 skill
│ └── frontend-dev/ # 前端 skill
│
└── ~/.claude/messages/sanguo/ # 系统脚本
├── start-sanguo-env.sh # 启动脚本
├── message.sh # 消息队列
└── test-sanguo-env.sh # 测试脚本
```
## 角色
### architect (架构师/项目经理)
**项目**: `~/.claude/projects/sanguo-main`
**职责**:
- 需求分析和理解
- 架构设计和技术选型
- 任务拆分和优先级排序
- 代码审核和质量把关
- 最终验收和 Git 提交管理
**限制**: 绝对不亲自编写代码
### backend (后端开发)
**项目**: `~/.claude/projects/sanguo-backend`
**职责**:
- 服务端代码实现
- API 设计和实现
- 数据库设计和 Migration
- 单元测试和集成测试
**限制**: 只处理后端任务，拒绝前端任务
### frontend (前端开发)
**项目**: `~/.claude/projects/sanguo-frontend`
**职责**:
- 前端组件开发
- 页面布局和样式
- 用户交互逻辑
- 浏览器兼容性
**限制**: 只处理前端任务，拒绝后端任务
## 协作方式
### SendMessage 跨实例通信
```javascript
// architect → backend
SendMessage({
to: "backend",
summary: "实现用户 API",
message: "需要实现用户查询 API，包括..."
})
// backend → architect
SendMessage({
to: "main",
summary: "后端完成",
message: "已完成用户 API，文件包括..."
})
```
### 备选方案: 文件消息队列
```bash
# 发送消息
~/.claude/messages/sanguo/message.sh send backend "任务内容"
# 读取消息
~/.claude/messages/sanguo/message.sh read
```
## 技术栈
| 组件 | 技术/版本 |
|------|----------|
| **Claude Code** | v2.1.187+ |
| **Superpowers** | Marketplace |
| **GLM-5.2** | 智谱 AI |
| **ttyd** | v1.7.7 |
| **tmux** | v3.7 |
## 环境要求
- macOS 或 Linux
- Claude Code v2.1.166+
- tmux
- ttyd
- Bash
## 安装
### 1. 克隆仓库
```bash
git clone http://192.168.2.154:3000/sanguo/sanguo_moziplus_v3.git
cd sanguo_moziplus_v3
```
### 2. 运行测试
```bash
~/.claude/messages/sanguo/test-sanguo-env.sh
```
### 3. 启动环境
```bash
~/.claude/messages/sanguo/start-sanguo-env.sh
```
详细步骤见 [DEPLOYMENT.md](./DEPLOYMENT.md)
## 状态
**v0.4 设计和基础设施: ✅ 完成**
- ✅ 完整设计文档
- ✅ 快速参考文档
- ✅ 示例工作流文档
- ✅ 部署指南
- ✅ 三实例项目结构
- ✅ 角色 Skills
- ✅ tmux 配置
- ✅ 启动脚本
- ✅ 消息队列系统
- ✅ 环境测试脚本
**待用户操作**:
- ⏳ 启动 tmux 环境
- ⏳ 在各 pane 启动 Claude Code
- ⏳ 测试 SendMessage 协作
## 许可证
[待定]
## 联系方式
- 仓库: http://192.168.2.154:3000/sanguo/sanguo_moziplus_v3