115 lines
3.1 KiB
Markdown
115 lines
3.1 KiB
Markdown
# sgClaw 团队协作架构图
|
||
|
||
## 📄 文档说明
|
||
|
||
这是一个**独立的可视化架构图文档**，用于向领导清晰展示 sgClaw 项目的团队分工、协作关系和技术架构。
|
||
|
||
## 🎯 包含的图表
|
||
|
||
1. **团队协作总架构（5 人分工全景）**
|
||
- 每个人干什么？
|
||
- 为什么要这样干？
|
||
- 产出物是什么？
|
||
|
||
2. **人员接口对接关系图**
|
||
- P1a ↔ P2：关键路径对接（极高优先级）
|
||
- P1a ↔ P1b：Runtime 集成对接
|
||
- P1b ↔ P3：Skill 加载对接
|
||
- P2 ↔ P4：UI 交互对接
|
||
|
||
3. **数据流全链路**
|
||
- 从用户输入到浏览器执行的完整流程
|
||
- 8 步数据流转详解
|
||
|
||
4. **关键路径时间轴**
|
||
- 为什么 Day 4-5 是瓶颈？
|
||
- 风险预案是什么？
|
||
|
||
5. **技术栈分层**
|
||
- 每层对应哪些人员？
|
||
- 每层负责什么模块？
|
||
|
||
6. **为什么这样分工？**
|
||
- 设计依据和决策背景
|
||
- 常见问题解答
|
||
|
||
## 🚀 如何查看
|
||
|
||
### 方法 1：本地浏览器直接打开（推荐）
|
||
|
||
```bash
|
||
# 在文件管理器中双击打开
|
||
团队协作架构图.html
|
||
```
|
||
|
||
### 方法 2：局域网查看（适合开会演示）
|
||
|
||
```bash
|
||
cd /home/zyl/projects/sgClaw/docs
|
||
./查看架构图.sh
|
||
```
|
||
|
||
然后在浏览器中访问显示的 URL，例如：
|
||
- 本机：`http://localhost:8888/团队协作架构图.html`
|
||
- 局域网：`http://192.168.x.x:8888/团队协作架构图.html`
|
||
|
||
### 方法 3：导出为 PDF
|
||
|
||
在浏览器中打开后：
|
||
1. 点击右下角的「📄 打印 PDF」按钮
|
||
2. 或按 `Ctrl+P`（Windows/Linux）/ `Cmd+P`（macOS）
|
||
3. 选择「另存为 PDF」
|
||
4. 保存
|
||
|
||
## 💡 使用建议
|
||
|
||
### 给领导汇报时
|
||
|
||
1. **先看"团队协作总架构"**（第一图）
|
||
- 一目了然看到 5 个人各自负责什么
|
||
- 理解为什么要这样分工
|
||
|
||
2. **重点讲"关键路径"**（第四图）
|
||
- 强调 Day 4-5 的 P1a + P2 联调是整个项目的瓶颈
|
||
- 说明有风险预案
|
||
|
||
3. **数据流全链路**（第三图）
|
||
- 演示一个完整的业务场景
|
||
- 让领导理解 5 个人的工作如何串联起来
|
||
|
||
### 给技术人员讲解时
|
||
|
||
1. **技术栈分层**（第五图）
|
||
- 清晰展示模块划分
|
||
- 说明依赖关系（从下往上）
|
||
|
||
2. **接口对接关系**（第二图）
|
||
- 详细展示每对人员之间的接口协议
|
||
- 包含代码示例
|
||
|
||
## 📋 文件清单
|
||
|
||
```
|
||
/home/zyl/projects/sgClaw/docs/
|
||
├── 团队协作架构图.html # 主文档（独立 HTML，无外部依赖）
|
||
├── 查看架构图.sh # 启动脚本（局域网查看）
|
||
└── 架构图使用说明.md # 本文档
|
||
```
|
||
|
||
## 🎨 特性
|
||
|
||
- ✅ **零依赖**：单文件 HTML，不需要网络，不需要额外资源
|
||
- ✅ **深色主题**：适合投影演示，保护眼睛
|
||
- ✅ **响应式设计**：自适应不同屏幕尺寸
|
||
- ✅ **打印友好**：可直接打印或导出 PDF
|
||
- ✅ **可视化清晰**：颜色编码（P1a 红色、P2 蓝色、P3 绿色等）
|
||
|
||
## 🔄 更新记录
|
||
|
||
- **v1.0** (2026-03-04)：初版发布，包含 6 张核心架构图
|
||
|
||
---
|
||
|
||
**维护者**：项目经理
|
||
**最后更新**：2026-03-04
|