# sanguo_moziplus_v3 v0.4 快速参考

## 启动环境

### 方式一：使用启动脚本 (推荐)

```bash
~/.claude/messages/sanguo/start-sanguo-env.sh
```

### 方式二：手动启动

```bash
# 启动 tmux 会话
tmux new -s sanguo_dev

# 配置三个 pane
# 在 pane 0: cd ~/.claude/projects/sanguo-main
# 按 Ctrl+B, 然后按 % 水平分割
# 在 pane 1: cd ~/.claude/projects/sanguo-backend
# 按 Ctrl+B, 然后按 " 垂直分割
# 在 pane 2: cd ~/.claude/projects/sanguo-frontend
```

## 三实例角色

| Pane | 角色 | 项目目录 | CLAUDE.md |
|------|------|----------|-----------|
| **0** | architect (架构师) | `~/.claude/projects/sanguo-main` | 架构师/项目经理 |
| **1** | backend (后端) | `~/.claude/projects/sanguo-backend` | 后端开发 |
| **2** | frontend (前端) | `~/.claude/projects/sanguo-frontend` | 前端开发 |

## 启动 Claude Code

在每个 pane 中：

```bash
# pane 0 (architect)
cd ~/.claude/projects/sanguo-main
claude

# pane 1 (backend)
cd ~/.claude/projects/sanguo-backend
claude

# pane 2 (frontend)
cd ~/.claude/projects/sanguo-frontend
claude
```

## tmux 快捷键

| 快捷键 | 功能 |
|--------|------|
| `Ctrl+B 0` | 切换到 pane 0 |
| `Ctrl+B 1` | 切换到 pane 1 |
| `Ctrl+B 2` | 切换到 pane 2 |
| `Ctrl+B o` | 在 pane 间循环切换 |
| `Ctrl+B %` | 水平分割 |
| `Ctrl+B "` | 垂直分割 |
| `Ctrl+B 方向键` | 切换到指定方向 pane |
| `Ctrl+B d` | 分离会话 (detach) |

## SendMessage 跨实例通信

### 从 architect 发送任务到 backend

```javascript
SendMessage({
  to: "backend",
  summary: "实现用户认证 API",
  message: "需要实现 JWT 认证系统，包括登录、注册、刷新 token 端点..."
})
```

### 从 backend 返回结果到 architect

```javascript
SendMessage({
  to: "main",
  summary: "后端任务完成",
  message: "已完成用户认证 API 实现..."
})
```

### 备选方案：文件消息队列

```bash
# 发送消息
~/.claude/messages/sanguo/message.sh send backend "实现用户API"

# 读取消息
~/.claude/messages/sanguo/message.sh read

# 列出消息
~/.claude/messages/sanguo/message.sh list
```

## Web 访问

### 启动 ttyd

```bash
ttyd -p 8088 tmux attach -t sanguo_dev
```

### 访问地址

```
http://YOUR_LAN_IP:8088
```

### 查看本机 IP

```bash
ifconfig | grep "inet " | grep -v 127.0.0.1
```

## 角色 Skills

### 可用 Skills

```bash
~/.claude/skills/
├── architect-role/    # 架构师专属
├── backend-dev/       # 后端开发专属
├── frontend-dev/      # 前端开发专属
├── CODE-REVIEW/       # 三实例共享
├── test-engineer/     # 三实例共享
└── ... (100+ Superpowers skills)
```

## 典型工作流

### 1. 架构师接收需求

```
用户: "实现用户认证系统"
   ↓
architect (pane 0) 接收
```

### 2. 规划和拆分

```
architect:
- 分析需求
- 规划技术方案
- 拆分为前后端任务
```

### 3. 指派任务

```
architect → backend:  SendMessage({ to: "backend", message: "..." })
architect → frontend: SendMessage({ to: "frontend", message: "..." })
```

### 4. 执行和返回

```
backend: 执行后端任务 → SendMessage({ to: "main", message: "..." })
frontend: 执行前端任务 → SendMessage({ to: "main", message: "..." })
```

### 5. 审查和验收

```
architect:
- 审查后端代码
- 审查前端代码
- 整合测试
- Git 提交
```

## 故障排查

### SendMessage 不工作

使用文件消息队列备选方案。

### 角色隔离不生效

确认 CLAUDE.md 文件存在且内容正确。

### tmux 会话丢失

```bash
# 查看所有会话
tmux ls

# 恢复会话
tmux attach-session -t sanguo_dev
```

### 端口被占用

```bash
# 查找占用进程
lsof -i :8088

# 更换端口
ttyd -p 8089 tmux attach -t sanguo_dev
```

## 配置文件

| 文件 | 路径 |
|------|------|
| **tmux 配置** | `~/.tmux-sanguo.conf` |
| **启动脚本** | `~/.claude/messages/sanguo/start-sanguo-env.sh` |
| **消息脚本** | `~/.claude/messages/sanguo/message.sh` |
| **settings.json** | `~/.claude/settings.json` |

## 相关文档

- [完整设计文档](./design/04-design-v0.4.md)
- [SendMessage 验证结果](./design/04-design-v0.4.md#phase-5-sendmessage-机制验证)