docs(wiki): 全量代码验证驱动更新 — 10页基于实际扫描非文档推测
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
关键数字修正: - Rust 74.5K行(原66K), Tauri命令 183(原182), SaaS路由 121 - 前端组件 104, lib/ 85文件, Store 17+4子store - TODO/FIXME 仅 8 个(前端4+Rust4) 内容增强: - 中间件完整14层注册清单含注册条件和优先级分类 - Store完整目录结构, Pipeline完整目录树 - Hands测试分布, Memory 16个Tauri命令列表 - 管家模式: 关键词路由→语义路由(TF-IDF)修正 - 代码健康度指标新增
This commit is contained in:
@@ -7,7 +7,7 @@ tags: [module, hands, skills]
|
||||
|
||||
# Hands + Skills
|
||||
|
||||
> 从 [[index]] 导航。关联模块: [[chat]] [[middleware]]
|
||||
> 从 [[index]] 导航。关联模块: [[chat]] [[middleware]] [[butler]]
|
||||
|
||||
## 设计思想
|
||||
|
||||
@@ -19,40 +19,60 @@ tags: [module, hands, skills]
|
||||
|
||||
## 代码逻辑
|
||||
|
||||
### Hands (9 启用 + 2 禁用)
|
||||
### Hands (9 启用)
|
||||
|
||||
| Hand | 功能 | 依赖 | 配置 |
|
||||
|------|------|------|------|
|
||||
| Browser | 浏览器自动化 | WebDriver | `hands/Browser/HAND.toml` |
|
||||
| Collector | 数据收集聚合 | — | `hands/Collector/HAND.toml` |
|
||||
| Researcher | 深度研究 | LLM | `hands/Researcher/HAND.toml` |
|
||||
| Clip | 视频处理 | FFmpeg | `hands/Clip/HAND.toml` |
|
||||
| Twitter | Twitter 自动化 | OAuth 1.0a | `hands/Twitter/HAND.toml` |
|
||||
| Whiteboard | 白板演示 | — | `hands/Whiteboard/HAND.toml` |
|
||||
| Slideshow | 幻灯片生成 | — | `hands/Slideshow/HAND.toml` |
|
||||
| Speech | 语音合成 | Browser TTS | `hands/Speech/HAND.toml` |
|
||||
| Quiz | 测验生成 | — | `hands/Quiz/HAND.toml` |
|
||||
| Predictor | 预测分析 | **禁用** | 无 TOML/无 Rust 实现 |
|
||||
| Lead | 销售线索 | **禁用** | 无 TOML/无 Rust 实现 |
|
||||
每个 Hand 有独立的 `hands/<Name>.HAND.toml` 配置和 `crates/zclaw-hands/src/hands/` 下的 Rust 实现。
|
||||
|
||||
| Hand | 功能 | 依赖 | 测试数 | 配置 |
|
||||
|------|------|------|--------|------|
|
||||
| Browser | 浏览器自动化 (23 Tauri命令) | WebDriver | 8 | `hands/browser.HAND.toml` |
|
||||
| Collector | 数据收集聚合 | — | 8 | `hands/collector.HAND.toml` |
|
||||
| Researcher | 深度研究 | LLM | 22 | `hands/researcher.HAND.toml` |
|
||||
| Clip | 视频处理 | FFmpeg | 30 | `hands/clip.HAND.toml` |
|
||||
| Twitter | Twitter 自动化 (12 API v2) | OAuth 1.0a | 25 | `hands/twitter.HAND.toml` |
|
||||
| Whiteboard | 白板演示 | — | — | `hands/whiteboard.HAND.toml` |
|
||||
| Slideshow | 幻灯片生成 | — | 13 | `hands/slideshow.HAND.toml` |
|
||||
| Speech | 语音合成 | Browser TTS | — | `hands/speech.HAND.toml` |
|
||||
| Quiz | 测验生成 | — | — | `hands/quiz.HAND.toml` |
|
||||
|
||||
Hands 测试分布(前 5): Clip(30), Twitter(25), Researcher(22), Slideshow(13), Browser(8)
|
||||
|
||||
### 禁用 Hands
|
||||
|
||||
| Hand | 状态 | 说明 |
|
||||
|------|------|------|
|
||||
| Predictor | 禁用 | 无 TOML/无 Rust 实现,仅概念定义 |
|
||||
| Lead | 禁用 | 无 TOML/无 Rust 实现,仅概念定义 |
|
||||
|
||||
### 触发流
|
||||
|
||||
```
|
||||
UI 触发 → handStore.trigger(handName, params)
|
||||
→ Tauri invoke('hand_trigger', { handName, params })
|
||||
→ Tauri invoke('hand_execute', { handName, params })
|
||||
→ Kernel → Hand 执行
|
||||
→ needs_approval? → 等待 approvalStore 确认
|
||||
→ 执行结果 → Tauri Event emit
|
||||
→ handStore 更新状态 + 记录日志
|
||||
```
|
||||
|
||||
### Skills (75 个)
|
||||
Hand 相关 Tauri 命令 (8 个):
|
||||
`hand_list, hand_execute, hand_approve, hand_cancel, hand_get, hand_run_status, hand_run_list, hand_run_cancel`
|
||||
|
||||
### Skills (75 个目录)
|
||||
|
||||
```
|
||||
skills/
|
||||
├── SKILL_001_数据分析.md
|
||||
├── SKILL_002_报告生成.md
|
||||
├── ... (75 个 SKILL.md 文件)
|
||||
├── accessibility-auditor/ api-tester/
|
||||
├── agentic-identity-trust/ app-store-optimizer/
|
||||
├── agents-orchestrator/ backend-architect/
|
||||
├── ai-engineer/ brand-guardian/
|
||||
├── analytics-reporter/ chart-visualization/
|
||||
├── chinese-writing/ classroom-generator/
|
||||
├── code-review/ consulting-analysis/
|
||||
├── content-creator/ data-analysis/
|
||||
├── data-consolidation-agent/ deep-research/
|
||||
├── devops-automator/ evidence-collector/
|
||||
├── ... (75 个目录,每个含 SKILL.md)
|
||||
```
|
||||
|
||||
每个 SKILL.md 定义:
|
||||
@@ -68,23 +88,27 @@ skills/
|
||||
```
|
||||
用户消息 → SemanticSkillRouter
|
||||
→ TF-IDF 计算消息与 75 个技能的相似度
|
||||
→ 返回最匹配的技能
|
||||
→ ButlerRouter 使用此结果增强 system prompt
|
||||
→ 返回 { skill_id, confidence }
|
||||
→ ButlerRouter 使用 RoutingHint 增强 system prompt
|
||||
```
|
||||
|
||||
在 kernel 中通过 `SemanticRouterAdapter` 桥接到 `ButlerRouterBackend` trait。
|
||||
|
||||
## 关联模块
|
||||
|
||||
- [[chat]] — 消息流中可能触发 Hand/Skill
|
||||
- [[butler]] — ButlerRouter 使用语义路由匹配技能
|
||||
- [[middleware]] — 技能注入通过中间件实现
|
||||
- [[middleware]] — SkillIndex 中间件注入技能索引
|
||||
|
||||
## 关键文件
|
||||
|
||||
| 文件 | 职责 |
|
||||
|------|------|
|
||||
| `crates/zclaw-hands/src/` | 9 个 Hand 实现 |
|
||||
| `crates/zclaw-hands/src/hands/` | 9 个 Hand 实现 |
|
||||
| `crates/zclaw-skills/src/semantic_router.rs` | TF-IDF 语义路由 |
|
||||
| `skills/*.md` | 75 个技能定义 |
|
||||
| `hands/*/HAND.toml` | Hand 配置 |
|
||||
| `crates/zclaw-skills/src/` | 技能解析和索引 |
|
||||
| `skills/*/SKILL.md` | 75 个技能定义 |
|
||||
| `hands/*.HAND.toml` | 9 个 Hand 配置 |
|
||||
| `desktop/src/store/handStore.ts` | 前端 Hand 状态 |
|
||||
| `desktop/src/store/approvalStore.ts` | 审批状态 |
|
||||
| `desktop/src/store/browserHandStore.ts` | Browser Hand 专用 |
|
||||
| `desktop/src-tauri/src/kernel_commands/hand.rs` | Hand Tauri 命令 (8) |
|
||||
|
||||
Reference in New Issue
Block a user