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: 中间件链
|
||||
updated: 2026-04-17
|
||||
updated: 2026-04-21
|
||||
status: active
|
||||
tags: [module, middleware, runtime]
|
||||
---
|
||||
@@ -104,6 +104,37 @@ trait AgentMiddleware: Send + Sync {
|
||||
|
||||
`crates/zclaw-kernel/src/kernel/mod.rs:248-361` — `create_middleware_chain()` 方法,15 次 `chain.register()`(含 2 个条件注册: SkillIndex, Compaction)。注册顺序与执行顺序不同,chain 按 priority 升序排列后执行。
|
||||
|
||||
## 功能清单
|
||||
|
||||
| 优先级 | 中间件 | 功能 | 状态 |
|
||||
|--------|--------|------|------|
|
||||
| @78 | EvolutionMiddleware | 进化引擎注入 | ✅ |
|
||||
| @80 | ButlerRouter | 管家语义路由 + XML fencing | ✅ |
|
||||
| @90 | DataMasking | PII 脱敏 | ✅ |
|
||||
| @100 | Compaction | 上下文压缩 (条件注册) | ✅ |
|
||||
| @150 | Memory | 记忆自动提取 + 注入 | ✅ |
|
||||
| @180 | Title | 对话标题生成 | ✅ |
|
||||
| @200 | SkillIndex | 技能索引注入 (条件注册) | ✅ |
|
||||
| @300 | DanglingTool | 悬空工具清理 | ✅ |
|
||||
| @350 | ToolError | 工具错误处理 | ✅ |
|
||||
| @360 | ToolOutputGuard | 工具输出守卫 | ✅ |
|
||||
| @400 | Guardrail | 安全护栏 | ✅ |
|
||||
| @500 | LoopGuard | 循环检测 (防无限) | ✅ |
|
||||
| @550 | SubagentLimit | 子代理数量限制 | ✅ |
|
||||
| @650 | TrajectoryRecorder | 轨迹记录+压缩 | ✅ |
|
||||
| @700 | TokenCalibration | Token 校准 | ✅ |
|
||||
|
||||
## 测试链路
|
||||
|
||||
| 功能 | 测试文件 | 测试数 | 覆盖状态 |
|
||||
|------|---------|--------|---------|
|
||||
| 管家路由 | middleware/butler_router.rs | 12 | ✅ |
|
||||
| 数据脱敏 | middleware/data_masking.rs | 9 | ✅ |
|
||||
| 进化中间件 | middleware/evolution.rs | 4 | ✅ |
|
||||
| 轨迹记录 | middleware/trajectory_recorder.rs | 4 | ✅ |
|
||||
| 其余 11 层 | — | 0 | ⚠️ 无独立测试 |
|
||||
| **合计** | 4/15 文件有测试 | **29** | |
|
||||
|
||||
## 关联模块
|
||||
|
||||
- [[butler]] — ButlerRouter 是管家模式的核心
|
||||
@@ -119,3 +150,10 @@ trait AgentMiddleware: Send + Sync {
|
||||
| `crates/zclaw-runtime/src/middleware/` | 15 个中间件实现 (15个 .rs 文件) |
|
||||
| `crates/zclaw-kernel/src/kernel/mod.rs:248-361` | 注册入口 |
|
||||
| `crates/zclaw-saas/src/main.rs` | SaaS HTTP 中间件注册 (10 层) |
|
||||
|
||||
## 已知问题
|
||||
|
||||
- ✅ **TrajectoryRecorder 未注册** — V13-GAP-01 已修复 (在 @650 注册)
|
||||
- ✅ **Admin 端点 404 而非 403** — admin_guard_middleware 已修复
|
||||
- ⚠️ **SkillIndex 条件注册** — 无技能时不注册,长期观察
|
||||
- ⚠️ **11/15 中间件无独立测试** — 仅 butler_router/data_masking/evolution/trajectory_recorder 有测试
|
||||
|
||||
Reference in New Issue
Block a user