Files

iven 0eb30c0531 docs: reorganize documentation structure

- Create docs/README.md as documentation index
- Add WORK_SUMMARY_2026-03-16.md for today's work
- Move test reports to docs/test-reports/
- Move completed plans to docs/archive/completed-plans/
- Move research reports to docs/archive/research-reports/
- Move technical reference to docs/knowledge-base/
- Move all plans from root plans/ to docs/plans/

New structure:
docs/
├── README.md                         # Documentation index
├── DEVELOPMENT.md                    # Development guide
├── OPENVIKING_INTEGRATION.md         # OpenViking integration
├── USER_MANUAL.md                    # User manual
├── ZCLAW_AGENT_INTELLIGENCE_EVOLUTION.md
├── archive/                          # Archived documents
├── knowledge-base/                   # Technical knowledge
├── plans/                            # Execution plans
└── test-reports/                     # Test reports

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-03-16 08:21:01 +08:00

agent-provider-config.md

feat(hands): restructure Hands UI with Chinese localization

2026-03-14 23:16:32 +08:00

feature-checklist.md

feat(hands): restructure Hands UI with Chinese localization

2026-03-14 23:16:32 +08:00

frontend-integration.md

feat(hands): restructure Hands UI with Chinese localization

2026-03-14 23:16:32 +08:00

hands-integration-lessons.md

feat(hands): restructure Hands UI with Chinese localization

2026-03-14 23:16:32 +08:00

openfang-technical-reference.md

docs: reorganize documentation structure

2026-03-16 08:21:01 +08:00

openfang-websocket-protocol.md

feat(hands): restructure Hands UI with Chinese localization

2026-03-14 23:16:32 +08:00

README.md

docs: create comprehensive system analysis report

2026-03-15 00:01:39 +08:00

tauri-desktop.md

feat(hands): restructure Hands UI with Chinese localization

2026-03-14 23:16:32 +08:00

troubleshooting.md

feat(hands): restructure Hands UI with Chinese localization

2026-03-14 23:16:32 +08:00

README.md

ZCLAW 知识库

记录开发过程中的经验、问题和解决方案，为项目演化提供知识储备。

目录结构

knowledge-base/
├── README.md                    # 本文件 - 索引
├── openfang-websocket-protocol.md   # OpenFang WebSocket 协议实际实现
├── troubleshooting.md           # 常见问题排查
├── frontend-integration.md      # 前端集成模式
├── agent-provider-config.md     # Agent 和 LLM 提供商配置
├── tauri-desktop.md            # Tauri 桌面端开发笔记
├── feature-checklist.md        # 功能清单和验证状态
└── hands-integration-lessons.md # Hands 集成经验总结

系统分析: 完整的系统偏离分析和演化路线图见 ../SYSTEM_ANALYSIS.md

快速索引

协议与通信

主题	文件	关键词
WebSocket 流式聊天	openfang-websocket-protocol.md	流式响应, 事件类型, 消息格式
REST API	openfang-websocket-protocol.md	Agent, Hands, Health

故障排查

问题类型	文件	常见原因
连接失败	troubleshooting.md	端口、认证、配置
流式响应不工作	troubleshooting.md	事件类型、代理配置
LLM 错误	troubleshooting.md	API Key 未配置

开发指南

主题	文件	说明
前端集成	frontend-integration.md	React + Zustand 模式
Agent 配置	agent-provider-config.md	LLM 提供商配置
Tauri 开发	tauri-desktop.md	桌面端开发注意事项
功能清单	feature-checklist.md	所有功能的验证状态
Hands 集成	hands-integration-lessons.md	Hands 功能集成经验

版本历史

日期	版本	变更
2026-03-14	v1.1	添加 Hands 集成经验总结、功能清单
2026-03-14	v1.0	初始创建，记录 OpenFang WebSocket 协议发现

贡献指南

当遇到以下情况时，请更新知识库：

发现协议与文档不一致 - 记录实际行为
解决了一个棘手的 bug - 记录根因和解决方案
找到了更好的实现方式 - 记录模式和最佳实践
踩了坑 - 记录避坑指南

文档格式

# 主题

## 问题描述
简要描述遇到的问题

## 根本原因
解释为什么会发生

## 解决方案
具体的解决步骤

## 代码示例
相关代码片段

## 相关文件
列出涉及的源文件