docs: archive legacy planning and frontend assets

This commit is contained in:
zyl
2026-03-26 19:30:07 +08:00
parent b90955d1b5
commit 11c0b0fc70
25 changed files with 68 additions and 29 deletions

View File

@@ -0,0 +1,222 @@
# sgClaw 项目协作甘特图
## 一、完整时间线Mermaid 甘特图)
![甘特图 1](https://mermaid.ink/img/Z2FudHQKICAgIHRpdGxlIHNnQ2xhdyAy5ZGo5byA5Y+R6K6h5YiS77yI5YWz6ZSu6Lev5b6E77yaUDFhK1Ay77yJCiAgICBkYXRlRm9ybWF0IFlZWVktTU0tREQKICAgIGF4aXNGb3JtYXQgRGF5ICVkCiAgICAKICAgIHNlY3Rpb24g5YWz6ZSu6Lev5b6E4q2QCiAgICBQMWHnjq/looPmkK3lu7ogICAgICAgICAgIDpwMWExLCAyMDI2LTAzLTA0LCAyZAogICAgUDFhIFBpcGXljY/orq7lvIDlj5EgICAgICA6Y3JpdCwgcDFhMiwgYWZ0ZXIgcDFhMSwgMWQKICAgIFAxYStQMuiBlOiwg1BpcGXpgJrkv6EgICAgOmNyaXQsIHAxYTMsIGFmdGVyIHAxYTIsIDJkCiAgICBQMWHlrozlloQxNeS4qkFjdGlvbiAgICAgOmNyaXQsIHAxYTQsIGFmdGVyIHAxYTMsIDFkCiAgICBXMemHjOeoi+eikea8lOekuiAgICAgICAgICA6bWlsZXN0b25lLCBtMSwgYWZ0ZXIgcDFhNCwgMGQKICAgIFAxYStQMWLpm4bmiJBSdW50aW1lICAgIDpwMWE1LCBhZnRlciBwMWE0LCAxZAogICAgUDFhIE1BQ+WuieWFqOetlueVpSAgICAgICA6cDFhNiwgYWZ0ZXIgcDFhNSwgMWQKICAgIFAxYSBidWfkv67lpI0gICAgICAgICAgIDpwMWE3LCBhZnRlciBwMWE2LCAyZAogICAgUDFh5Luj56CB5a6h5p+l5Lqk5LuYICAgICAgIDptaWxlc3RvbmUsIG0yLCBhZnRlciBwMWE3LCAxZAogICAgCiAgICBzZWN0aW9uIFAy5rWP6KeI5Zmo5a+55o6lCiAgICBQMueOr+Wig+aQreW7uiAgICAgICAgICAgIDpwMmEsIDIwMjYtMDMtMDQsIDJkCiAgICBQMiBQcm9jZXNzSG9zdOahhuaetiAgICA6cDJiLCBhZnRlciBwMmEsIDFkCiAgICBQMitQMWHogZTosINQaXBlICAgICAgICA6Y3JpdCwgcDJjLCBhZnRlciBwMmIsIDJkCiAgICBQMiBDb21tYW5kUm91dGVy5a+55o6lICA6cDJkLCBhZnRlciBwMmMsIDFkCiAgICBQMiBNQUPnmb3lkI3ljZUgICAgICAgICAgOnAyZSwgYWZ0ZXIgcDJkLCAxZAogICAgUDIrUDQgVUnlr7nmjqUgICAgICAgICAgOnAyZiwgYWZ0ZXIgcDJlLCAxZAogICAgUDIgYnVn5L+u5aSNICAgICAgICAgICAgOnAyZywgYWZ0ZXIgcDJmLCAyZAogICAgUDLkuqTku5ggICAgICAgICAgICAgICAgOm1pbGVzdG9uZSwgYWZ0ZXIgcDJnLCAxZAogICAgCiAgICBzZWN0aW9uIFAxYuS4muWKoeaUr+aMgQogICAgUDFi546v5aKD5pCt5bu6ICAgICAgICAgICA6cDFiMSwgMjAyNi0wMy0wNCwgMmQKICAgIFAxYiBTa2lsbExvYWRlcuW8gOWPkSAgIDpwMWIyLCBhZnRlciBwMWIxLCAzZAogICAgUDFiIE1lbW9yeeW8gOWPkSAgICAgICAgOnAxYjMsIGFmdGVyIHAxYjIsIDJkCiAgICBQMWIrUDFh6ZuG5oiQUnVudGltZSAgICA6cDFiNCwgYWZ0ZXIgcDFiMywgMWQKICAgIFAxYitQMyBTa2lsbOa1i+ivlSAgICAgIDpwMWI1LCBhZnRlciBwMWI0LCAxZAogICAgUDFiIENyaXRpY+ivhOS8sOWZqCAgICAgIDpwMWI2LCBhZnRlciBwMWI1LCAxZAogICAgUDFiIGJ1Z+S/ruWkjSAgICAgICAgICAgOnAxYjcsIGFmdGVyIHAxYjYsIDFkCiAgICBQMWLkuqTku5ggICAgICAgICAgICAgICA6bWlsZXN0b25lLCBhZnRlciBwMWI3LCAxZAogICAgCiAgICBzZWN0aW9uIFAz5Lia5Yqh5oqA6IO9CiAgICBQM+WcuuaZr+iwg+eglCAgICAgICAgICAgIDpwM2EsIDIwMjYtMDMtMDQsIDFkCiAgICBQM+m7hOmHkeagt+acrOWItuS9nCAgICAgICAgOnAzYiwgYWZ0ZXIgcDNhLCAzZAogICAgUDPmj5DnpLror43lt6XnqIsgICAgICAgICAgOnAzYywgYWZ0ZXIgcDNiLCAxZAogICAgUDMgQUnmibnph4/nv7vor5EgICAgICAgICA6cDNkLCBhZnRlciBwM2MsIDNkCiAgICBQM+i0qOmHj+aKveajgCAgICAgICAgICAgIDpwM2UsIGFmdGVyIHAzZCwgMmQKICAgIFAz5Lqk5LuYU2tpbGzku5PlupMgICAgICAgOm1pbGVzdG9uZSwgYWZ0ZXIgcDNlLCAwZAogICAgCiAgICBzZWN0aW9uIFA05YmN56uv5Y+R5biDCiAgICBQNOeOr+Wig+aQreW7uiAgICAgICAgICAgIDpwNGEsIDIwMjYtMDMtMDQsIDJkCiAgICBQNCBVSeWOn+Wei+iuvuiuoSAgICAgICAgIDpwNGIsIGFmdGVyIHA0YSwgMWQKICAgIFA0IFNpZGUgUGFuZWzlvIDlj5EgICAgIDpwNGMsIGFmdGVyIHA0YiwgMmQKICAgIFA0IFNraWxs5ZCO5Y+w5byA5Y+RICAgICAgOnA0ZCwgYWZ0ZXIgcDRjLCAxZAogICAgUDQrUDIgSVBD5a+55o6lICAgICAgICAgOnA0ZSwgYWZ0ZXIgcDRkLCAxZAogICAgUDTmtYvor5XmoYbmnrbmkK3lu7ogICAgICAgIDpwNGYsIGFmdGVyIHA0ZSwgMWQKICAgIFA0IEUyRea1i+ivlSAgICAgICAgICAgIDpwNGcsIGFmdGVyIHA0ZiwgMmQKICAgIFA05omT5YyF5Y+R5biDICAgICAgICAgICAgOm1pbGVzdG9uZSwgcDRoLCBhZnRlciBwNGcsIDFkCiAgICAKICAgIHNlY3Rpb24g5YWo5ZGY6YeM56iL56KRCiAgICDnjq/looPmkK3lu7rlrozmiJAgICAgICAgICAgOm1pbGVzdG9uZSwgYWZ0ZXIgcDFhMSBwMmEgcDFiMSBwM2EgcDRhLCAwZAogICAgVzHph4znqIvnopEo6ZO+6Lev5omT6YCaKSAgICA6bWlsZXN0b25lLCBtMV9hbGwsIDIwMjYtMDMtMDgsIDBkCiAgICBFMkXmtYvor5XlkaggICAgICAgICAgICAgOmFjdGl2ZSwgZTJlLCAyMDI2LTAzLTExLCAyZAogICAgVzLph4znqIvnopEo5q2j5byP5Y+R5biDKSAgICA6bWlsZXN0b25lLCBtMl9hbGwsIDIwMjYtMDMtMTQsIDBkCg==)
<details>
<summary>📋 点击查看 Mermaid 源码</summary>
```mermaid
gantt
title sgClaw 2周开发计划关键路径P1a+P2
dateFormat YYYY-MM-DD
axisFormat Day %d
section 关键路径⭐
P1a环境搭建 :p1a1, 2026-03-04, 2d
P1a Pipe协议开发 :crit, p1a2, after p1a1, 1d
P1a+P2联调Pipe通信 :crit, p1a3, after p1a2, 2d
P1a完善15个Action :crit, p1a4, after p1a3, 1d
W1里程碑演示 :milestone, m1, after p1a4, 0d
P1a+P1b集成Runtime :p1a5, after p1a4, 1d
P1a MAC安全策略 :p1a6, after p1a5, 1d
P1a bug修复 :p1a7, after p1a6, 2d
P1a代码审查交付 :milestone, m2, after p1a7, 1d
section P2浏览器对接
P2环境搭建 :p2a, 2026-03-04, 2d
P2 ProcessHost框架 :p2b, after p2a, 1d
P2+P1a联调Pipe :crit, p2c, after p2b, 2d
P2 CommandRouter对接 :p2d, after p2c, 1d
P2 MAC白名单 :p2e, after p2d, 1d
P2+P4 UI对接 :p2f, after p2e, 1d
P2 bug修复 :p2g, after p2f, 2d
P2交付 :milestone, after p2g, 1d
section P1b业务支持
P1b环境搭建 :p1b1, 2026-03-04, 2d
P1b SkillLoader开发 :p1b2, after p1b1, 3d
P1b Memory开发 :p1b3, after p1b2, 2d
P1b+P1a集成Runtime :p1b4, after p1b3, 1d
P1b+P3 Skill测试 :p1b5, after p1b4, 1d
P1b Critic评估器 :p1b6, after p1b5, 1d
P1b bug修复 :p1b7, after p1b6, 1d
P1b交付 :milestone, after p1b7, 1d
section P3业务技能
P3场景调研 :p3a, 2026-03-04, 1d
P3黄金样本制作 :p3b, after p3a, 3d
P3提示词工程 :p3c, after p3b, 1d
P3 AI批量翻译 :p3d, after p3c, 3d
P3质量抽检 :p3e, after p3d, 2d
P3交付Skill仓库 :milestone, after p3e, 0d
section P4前端发布
P4环境搭建 :p4a, 2026-03-04, 2d
P4 UI原型设计 :p4b, after p4a, 1d
P4 Side Panel开发 :p4c, after p4b, 2d
P4 Skill后台开发 :p4d, after p4c, 1d
P4+P2 IPC对接 :p4e, after p4d, 1d
P4测试框架搭建 :p4f, after p4e, 1d
P4 E2E测试 :p4g, after p4f, 2d
P4打包发布 :milestone, p4h, after p4g, 1d
section 全员里程碑
环境搭建完成 :milestone, after p1a1 p2a p1b1 p3a p4a, 0d
W1里程碑(链路打通) :milestone, m1_all, 2026-03-08, 0d
E2E测试周 :active, e2e, 2026-03-11, 2d
W2里程碑(正式发布) :milestone, m2_all, 2026-03-14, 0d
```
</details>
## 二、关键路径可视化
```
Day 1-2 ━━━━━━━━━━━━━━━━━━━━━━ 环境搭建(并行)
Day 3 ━━━━━┻━━━━━━━━━━━━━━━━━ P1a Pipe 协议开发 ⭐
Day 4-5 ━━━┻━━━━━━━━━━━━━━━━━ P1a + P2 联调 Pipe ⭐⭐⭐
┃ (关键路径,阻塞所有人)
【W1 里程碑】链路打通
Day 6 ━━━━━┻━━━━━━━━━━━━━━━━━ 三组并行集成:
├─ P1a + P1b (Runtime)
├─ P1b + P3 (Skill)
└─ P2 + P4 (UI)
Day 7 ━━━━━┫ 安全策略 + AI 翻译
Day 8-9 ━━━┻━━━━━━━━━━━━━━━━━ 全员 E2E 测试
Day 10 ━━━━▼━━━━━━━━━━━━━━━━━ P4 打包发布
【W2 里程碑】正式发布
```
## 三、并行度分析
```
Day 1-2: ████████████████████ 5 人并行(环境搭建)
Day 3: ████ P1a 单人关键路径
Day 4-5: ████████ P1a+P2 双人关键路径 ⭐
Day 6-7: ████████████████ 4 人并行P3 独立)
Day 8-9: ████████████████████ 5 人并行E2E 测试)
Day 10: ████ P4 单人发布
关键瓶颈Day 4-5P1a + P2 联调)
```
## 四、依赖关系图
![依赖关系图 2](https://mermaid.ink/img/Z3JhcGggVEQKICAgIEFbRGF5IDEtMjog546v5aKD5pCt5bu6XSAtLT4gQltEYXkgMzogUDFhIFBpcGUg5Y2P6K6uXQogICAgQiAtLT4gQ1tEYXkgNC01OiBQMWErUDIg6IGU6LCDIFBpcGUg4q2QXQogICAgQyAtLT4gRFtEYXkgNSDmmZo6IFcxIOmHjOeoi+eikV0KICAgIAogICAgRCAtLT4gRTFbRGF5IDY6IFAxYStQMWIg6ZuG5oiQXQogICAgRCAtLT4gRTJbRGF5IDY6IFAxYitQMyBTa2lsbF0KICAgIEQgLS0+IEUzW0RheSA2OiBQMitQNCBVSV0KICAgIAogICAgRTEgLS0+IEZbRGF5IDc6IOWuieWFqCtBSV0KICAgIEUyIC0tPiBGCiAgICBFMyAtLT4gRgogICAgCiAgICBGIC0tPiBHW0RheSA4LTk6IEUyRSDmtYvor5VdCiAgICBHIC0tPiBIW0RheSAxMDogUDQg5omT5YyF5Y+R5biDXQogICAgCiAgICBzdHlsZSBDIGZpbGw6I2ZmNmI2YixzdHJva2U6I2M5MmEyYSxjb2xvcjojZmZmCiAgICBzdHlsZSBEIGZpbGw6IzUxY2Y2NixzdHJva2U6IzJmOWU0NCxjb2xvcjojZmZmCiAgICBzdHlsZSBIIGZpbGw6IzUxY2Y2NixzdHJva2U6IzJmOWU0NCxjb2xvcjojZmZmCg==)
<details>
<summary>📋 点击查看 Mermaid 源码</summary>
```mermaid
graph TD
A[Day 1-2: 环境搭建] --> B[Day 3: P1a Pipe 协议]
B --> C[Day 4-5: P1a+P2 联调 Pipe ⭐]
C --> D[Day 5 晚: W1 里程碑]
D --> E1[Day 6: P1a+P1b 集成]
D --> E2[Day 6: P1b+P3 Skill]
D --> E3[Day 6: P2+P4 UI]
E1 --> F[Day 7: 安全+AI]
E2 --> F
E3 --> F
F --> G[Day 8-9: E2E 测试]
G --> H[Day 10: P4 打包发布]
style C fill:#ff6b6b,stroke:#c92a2a,color:#fff
style D fill:#51cf66,stroke:#2f9e44,color:#fff
style H fill:#51cf66,stroke:#2f9e44,color:#fff
```
</details>
## 五、人员负载分析
| 日期 | P1a| P1b | P2 | P3 | P4 | 总负载 |
|-----|---------|-----|----|----|----|----|
| Day 1-2 | 🟢 中 | 🟢 中 | 🟢 中 | 🟢 中 | 🟢 中 | 5 人 |
| Day 3 | 🔴 高 | 🟡 低 | 🟡 低 | 🟢 中 | 🟢 中 | 2 人高负载 |
| Day 4-5 | 🔴 极高 | 🟢 中 | 🔴 极高 | 🟢 中 | 🟢 中 | **2 人关键路径** |
| Day 6 | 🔴 高 | 🔴 高 | 🟢 中 | 🟢 中 | 🟢 中 | 2 人高负载 |
| Day 7 | 🟢 中 | 🔴 高 | 🟢 中 | 🔴 高 | 🟢 中 | 2 人高负载 |
| Day 8-9 | 🟢 中 | 🟢 中 | 🟢 中 | 🟢 中 | 🟢 中 | 5 人 E2E |
| Day 10 | 🟡 低 | 🟡 低 | 🟡 低 | 🟡 低 | 🔴 高 | 1 人高负载 |
**图例**:🔴 极高/高负载 🟡 低负载 🟢 正常负载
---
## 六、风险热力图
```
风险等级
时间 │ 低 │ 中 │ 高 │ 极高
─────────┼────┼────┼────┼─────
Day 1-2 │ ✓ │ │ │
Day 3 │ │ ✓ │ │
Day 4-5 │ │ │ │ ⭐⭐⭐ ← Pipe 通信不通
Day 6 │ │ │ ✓ │
Day 7 │ │ ✓ │ │
Day 8-9 │ │ ✓ │ │
Day 10 │ │ ✓ │ │
```
**极高风险Day 4-5**P1a + P2 联调失败,阻塞所有后续工作
**预案**
1. Day 4 晚上还没通 → P1b 全力支援
2. Day 5 中午还没通 → 启动降级方案HTTP
---
## 七、里程碑验收清单
### ✅ W1 里程碑Day 5 晚上)
**演示场景**
1. P4 打开 Side Panel UI
2. 输入:"点击页面上的登录按钮"
3. Vue → C++ → Rust → 大模型mock→ Rust → C++ → 浏览器
4. 浏览器真实点击按钮
**验收标准**
- [ ] Pipe 双向通信稳定(无消息丢失)
- [ ] 15 个 BrowserAction 全部测试通过
- [ ] MAC 白名单生效(非白名单域名被拦截)
- [ ] 延迟 < 100ms从命令到执行完成
---
### ✅ W2 里程碑Day 10
**交付物**
- [ ] `.deb` 安装包(银河麒麟 V10
- [ ] `.exe` 安装包Windows 10/11
- [ ] 6 个业务场景演示视频
- [ ] 完整文档API + Skill 开发指南 + 部署手册)
**验收标准**
- [ ] 两平台安装成功
- [ ] E2E 测试全部通过
- [ ] 单元测试覆盖率 > 70%
- [ ] 内存占用 < 10MBsgClaw 进程)
- [ ] 无已知 P0/P1 级 bug
---
**文档版本**v1.0
**最后更新**2026-03-04
**维护者**:项目经理