e790cf171a
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
受 Karpathy LLM Wiki 启发，将分散在 docs/ + memory/ + CLAUDE.md 的项目知识 编译为 8 个结构化 wiki 页面，解决新会话冷启动时上下文浪费问题。 - wiki/index.md: 主索引入口 (~200行)，CLAUDE.md @import 自动加载 - wiki/architecture.md: 系统架构编译 (crate依赖/客户端路由/聊天流/LLM驱动) - wiki/module-status.md: 9个子系统状态 + Hands详情 + 测试覆盖 - wiki/data-flows.md: 6条核心数据流 (聊天/路由/记忆/认证/管家/Pipeline) - wiki/development.md: 开发规范 (闭环工作法/验证命令/提交规范) - wiki/known-issues.md: 缺陷状态 (P0/P1已修复，P2待处理) - wiki/file-map.md: 代码库文件地图 (crates/desktop/admin-v2/docs) - wiki/log.md: Append-only 变更日志 - CLAUDE.md: 添加 @wiki/index.md + §8.3 收尾流程增加 wiki 维护步骤
2.8 KiB
2.8 KiB
title, updated, status, tags
| title | updated | status | tags | ||
|---|---|---|---|---|---|
| 子系统状态 | 2026-04-11 | active |
|
子系统状态
从 index 导航到此处。数字真相源:
docs/TRUTH.md
活跃子系统
| 子系统 | 状态 | 最新变更 | 关键文件 |
|---|---|---|---|
| 管家模式 (Butler) | 活跃 | 04-09 ButlerRouter + 双模式UI + 痛点持久化 + 冷启动 | middleware/butler_router.rs, pain_storage.rs |
| Hermes 管线 | 活跃 | 04-09 4 Chunk: 自我改进+用户建模+NL Cron+轨迹压缩 | experience_store.rs, user_profiler.rs, nl_schedule_parser.rs |
| 聊天流 (ChatStream) | 稳定 | 04-02 ChatStore 拆分为 4 Store | streamStore.ts, conversationStore.ts |
| 记忆管道 (Memory) | 稳定 | 04-02 闭环: 对话→提取→FTS5+TF-IDF→检索→注入 | crates/zclaw-growth/ |
| SaaS 认证 (Auth) | 稳定 | Token池 RPM/TPM 轮换 + JWT pwv 失效 | saas/auth/handlers.rs |
| Pipeline DSL | 稳定 | 04-01 17 YAML 模板 + DAG 执行器 | crates/zclaw-pipeline/ |
| Hands 系统 | 稳定 | 9 启用 (详见下方) | crates/zclaw-hands/ |
| 技能系统 (Skills) | 稳定 | 75 SKILL.md + 语义路由 | crates/zclaw-skills/ |
| 中间件链 | 稳定 | 14 层 (含 DataMasking@90, ButlerRouter, TrajectoryRecorder@650) | crates/zclaw-runtime/src/middleware/ |
Hands 详细状态
| Hand | 功能 | 状态 | 依赖 |
|---|---|---|---|
| Browser | 浏览器自动化 | 可用 | WebDriver |
| Collector | 数据收集聚合 | 可用 | — |
| Researcher | 深度研究 | 可用 | LLM |
| Clip | 视频处理 | 需 FFmpeg | FFmpeg |
| Twitter 自动化 | 可用 | OAuth 1.0a (写操作) | |
| Whiteboard | 白板演示 | 可用 | 导出开发中 |
| Slideshow | 幻灯片生成 | 可用 | — |
| Speech | 语音合成 | 可用 | Browser TTS |
| Quiz | 测验生成 | 可用 | — |
| Predictor | 预测分析 | 禁用 | 无 Rust 实现 |
| Lead | 销售线索发现 | 禁用 | 无 Rust 实现 |
Tauri 命令分布
| 类别 | 数量 | 说明 |
|---|---|---|
| 有前端调用 | 92 | 正常使用中 |
| @reserved | 20 | 已标注保留 |
| 孤儿 | 70 | 无前端调用且无标注 |
测试覆盖
| 层级 | 数量 | 状态 |
|---|---|---|
| Rust workspace | 684 | 全通过 |
| SaaS 集成 | 138 | 全通过 (需 PostgreSQL) |
| 前端 vitest | 330 | 330 passed + 1 skipped |
| Admin V2 | 61 | 17 文件 |
SaaS API 分布
12 个路由模块: account / agent_template / auth / billing / knowledge / migration / model_config / prompt / relay / role / scheduled_task / telemetry
总计 140 端点 (138 标准 + 2 dev-only)
数据表 (34 个)
核心表: users, agents, conversations, messages, knowledge_, billing_, agent_templates, model_configs, roles, permissions, scheduled_tasks, telemetry
→ 架构细节见 architecture → 已知问题见 known-issues