---
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]]