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 维护步骤
71 lines
2.8 KiB
Markdown
71 lines
2.8 KiB
Markdown
---
|
|
title: 子系统状态
|
|
updated: 2026-04-11
|
|
status: active
|
|
tags: [status, modules]
|
|
---
|
|
|
|
# 子系统状态
|
|
|
|
> 从 [[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 | 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]]
|