docs(guide): rewrite CLAUDE.md with ZCLAW-first perspective

Major changes:
- Shift from "OpenFang desktop client" to "independent AI Agent desktop app"
- Add decision principle: "Is this useful for ZCLAW? Does it affect ZCLAW?"
- Simplify project structure and tech stack sections
- Replace OpenClaw vs OpenFang comparison with unified backend approach
- Consolidate troubleshooting from scattered sections into organized FAQ
- Update Hands system documentation with 8 capabilities and status
- Stream
This commit is contained in:
iven
2026-03-20 19:30:09 +08:00
parent 3518fc8ece
commit 6f72442531
63 changed files with 8920 additions and 857 deletions

View File

@@ -7,25 +7,26 @@
```
knowledge-base/
├── README.md # 本文件 - 索引
├── openfang-websocket-protocol.md # OpenFang WebSocket 协议实际实现
├── zclaw-technical-reference.md # ZCLAW 技术参考
├── websocket-protocol.md # WebSocket 协议文档
├── configuration.md # 配置系统文档
├── troubleshooting.md # 常见问题排查
├── frontend-integration.md # 前端集成模式
├── agent-provider-config.md # Agent 和 LLM 提供商配置
├── tauri-desktop.md # Tauri 桌面端开发笔记
├── feature-checklist.md # 功能清单和验证状态
├── tauri-desktop.md # Tauri 桌面端开发笔记
├── feature-checklist.md # 功能清单和验证状态
└── hands-integration-lessons.md # Hands 集成经验总结
```
> **系统分析**: 完整的系统偏离分析和演化路线图见 [../SYSTEM_ANALYSIS.md](../SYSTEM_ANALYSIS.md)
## 快速索引
### 协议与通信
| 主题 | 文件 | 关键词 |
|------|------|--------|
| WebSocket 流式聊天 | [openfang-websocket-protocol.md](./openfang-websocket-protocol.md) | 流式响应, 事件类型, 消息格式 |
| REST API | [openfang-websocket-protocol.md](./openfang-websocket-protocol.md#rest-api) | Agent, Hands, Health |
| WebSocket 流式聊天 | [websocket-protocol.md](./websocket-protocol.md) | 流式响应, 事件类型, 消息格式 |
| REST API | [zclaw-technical-reference.md](./zclaw-technical-reference.md) | Agent, Hands, Health |
| 配置系统 | [configuration.md](./configuration.md) | TOML, 环境变量 |
### 故障排查
@@ -49,8 +50,9 @@ knowledge-base/
| 日期 | 版本 | 变更 |
|------|------|------|
| 2026-03-19 | v2.0 | 重构为 ZCLAW 独立产品文档 |
| 2026-03-14 | v1.1 | 添加 Hands 集成经验总结、功能清单 |
| 2026-03-14 | v1.0 | 初始创建,记录 OpenFang WebSocket 协议发现 |
| 2026-03-14 | v1.0 | 初始创建 |
---