docs(wiki): 系统性更新 — L0速览+L1模块标准化+L2功能链路映射(33条)
Some checks failed
CI / Lint & TypeCheck (push) Has been cancelled
CI / Unit Tests (push) Has been cancelled
CI / Build Frontend (push) Has been cancelled
CI / Rust Check (push) Has been cancelled
CI / Security Scan (push) Has been cancelled
CI / E2E Tests (push) Has been cancelled
Some checks failed
CI / Lint & TypeCheck (push) Has been cancelled
CI / Unit Tests (push) Has been cancelled
CI / Build Frontend (push) Has been cancelled
CI / Rust Check (push) Has been cancelled
CI / Security Scan (push) Has been cancelled
CI / E2E Tests (push) Has been cancelled
三层架构增强: - L0 index.md: 用户功能清单+跨模块数据流全景图+导航树增强 (92→143行) - L1 8个模块页标准化: 功能清单/API接口/测试链路/已知问题 routing(252→326) chat(101→157) saas(153→230) memory(182→333) butler(137→179) middleware(121→159) hands-skills(218→257) pipeline(111→156) - L1 新增2页: security.md(157行) data-model.md(180行) - L2 feature-map.md: 33条端到端功能链路映射(408行) 维护机制: CLAUDE.md §8.3 wiki触发规则 5→9条 设计文档: docs/superpowers/specs/2026-04-21-wiki-systematic-overhaul-design.md
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: ZCLAW 项目知识库
|
||||
updated: 2026-04-19
|
||||
updated: 2026-04-21
|
||||
status: active
|
||||
---
|
||||
|
||||
@@ -45,27 +45,78 @@ status: active
|
||||
| TODO/FIXME | 前端 1 + Rust 1 = 2 | `grep TODO/FIXME` (2026-04-19 验证) |
|
||||
| dead_code | 0 个 | `grep '#\[dead_code\]'` (2026-04-19 验证) |
|
||||
|
||||
## 用户功能清单
|
||||
|
||||
> ZCLAW 能做什么?按用户视角组织,快速定位功能所属模块。
|
||||
|
||||
| 类别 | 功能 | 用户入口 | Wiki 详情 |
|
||||
|------|------|----------|-----------|
|
||||
| 对话 | 发消息、流式响应、多模型切换 | 聊天面板 | [[chat]] |
|
||||
| 分身 | 创建/切换/配置 Agent | 侧边栏 Agent 列表 | [[chat]] |
|
||||
| 自主 | 触发 Browser/Collector/Twitter 等 | 自动化面板 | [[hands-skills]] |
|
||||
| 记忆 | 搜索历史、自动注入上下文 | 设置 > 语义记忆 | [[memory]] |
|
||||
| 配置 | 模型/API/工作区/安全存储 | 设置面板 (19 页) | [[development]] |
|
||||
| SaaS | 登录注册、订阅计费、Admin 管理 | SaaS 平台 / Admin 后台 | [[saas]] |
|
||||
| 管家 | 痛点积累、行业配置、简洁/专业模式 | 聊天面板 (默认模式) | [[butler]] |
|
||||
| Pipeline | YAML 模板选择、配置、DAG 执行 | 工作流面板 | [[pipeline]] |
|
||||
| 安全 | JWT 认证、TOTP 2FA、操作审计 | 设置 > 安全存储 | [[security]] |
|
||||
| 数据 | PostgreSQL (SaaS 42表) + SQLite/FTS5 (本地记忆) | — | [[data-model]] |
|
||||
|
||||
## 跨模块数据流全景图
|
||||
|
||||
> 一个请求的完整生命周期(SaaS relay 主路径)。详细流程见 [[routing]] 和 [[chat]]。
|
||||
|
||||
```
|
||||
用户输入
|
||||
↓
|
||||
React 组件 (ChatPanel.tsx)
|
||||
↓
|
||||
Zustand Store (chatStore.sendMessage)
|
||||
↓
|
||||
getClient() 路由决策 ──→ SaaS Relay (主路径) ──→ 本地 Kernel (降级)
|
||||
↓ ↓ ↓
|
||||
Tauri invoke SSE 连接 直接调用
|
||||
↓ ↓ ↓
|
||||
Kernel Runtime SaaS → Token Pool Runtime
|
||||
↓ → LLM Provider ↓
|
||||
Middleware Chain (15层) ↓ Middleware Chain
|
||||
↓ 流式 SSE 返回 ↓
|
||||
LLM Driver ←─────────────────┘ LLM Driver
|
||||
↓ ↓
|
||||
Tauri Event emit Tauri Event emit
|
||||
↓ ↓
|
||||
streamStore.onDelta ←────────────────────────────┘
|
||||
↓
|
||||
UI 更新 (消息气泡渲染)
|
||||
```
|
||||
|
||||
## 模块导航树
|
||||
|
||||
```
|
||||
ZCLAW
|
||||
├── [[routing]] 客户端路由 — 5分支+降级,SaaS Relay是主路径
|
||||
│ └── [[chat]] 聊天系统 — 3种ChatStream,Store拆为4+1
|
||||
├── [[routing]] 客户端路由 — 连接断了吗?数据走哪条路?看这里
|
||||
│ └── [[chat]] 聊天系统 — 消息怎么发?流式怎么接?Store 怎么拆?
|
||||
│
|
||||
├── [[saas]] SaaS平台 — 认证/Token池/计费/Admin,Tauri的中枢
|
||||
├── [[saas]] SaaS平台 — 用户/计费/Admin API 都在这里
|
||||
│ ├── 认证 JWT + Cookie + Token池 RPM/TPM轮换
|
||||
│ ├── 计费 配额实时递增 + Alipay/WeChat
|
||||
│ └── Admin V2 17页管理后台
|
||||
│
|
||||
├── [[butler]] 管家模式 — 默认交互范式,语义路由+冷启动+痛点
|
||||
├── [[butler]] 管家模式 — 用户看到什么?行业怎么配?痛点怎么积?
|
||||
│
|
||||
├── [[middleware]] 中间件链 — 15层runtime + 10层SaaS HTTP
|
||||
├── [[middleware]] 中间件链 — 请求经过哪些处理?优先级怎么排?
|
||||
│
|
||||
├── [[memory]] 记忆管道 — 对话→提取→FTS5+TF-IDF→检索→注入+进化引擎
|
||||
├── [[memory]] 记忆管道 — 对话怎么变记忆?怎么检索?怎么注入?
|
||||
│
|
||||
├── [[hands-skills]] Hands(7注册) + Skills(75) + MCP — 自主能力+语义技能+外部工具协议
|
||||
├── [[hands-skills]] Hands(7注册) + Skills(75) — Agent能做什么动作?懂什么技能?
|
||||
│
|
||||
├── [[pipeline]] Pipeline DSL — YAML+DAG执行器+18模板
|
||||
├── [[pipeline]] Pipeline DSL — 工作流怎么配?DAG怎么跑?有哪些模板?
|
||||
│
|
||||
├── [[security]] 安全体系 — JWT/Cookie/TOTP/CSP/限流/加密
|
||||
│
|
||||
├── [[data-model]] 数据模型 — 42表PostgreSQL + FTS5本地存储
|
||||
│
|
||||
├── [[feature-map]] 功能链路映射 — 每个功能从前端到后端的完整路径+测试
|
||||
│
|
||||
├── [[development]] 开发规范 — 闭环工作法/验证命令/提交规范
|
||||
├── [[known-issues]] 已知问题 — P0/P1已修复,P2待处理
|
||||
|
||||
Reference in New Issue
Block a user