docs: wiki 全量更新 — 2026-04-14 代码验证驱动
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 77K行(274 .rs)、Tauri 189命令、SaaS 137 routes - Admin V2 17页、SaaS 16模块(含industry)、@reserved 22 - SQL 20迁移/42表、TODO/FIXME 4个、dead_code 16 内容更新: - known-issues: V13-GAP 全部标记已修复 + 三端联调测试结果 - middleware: 14层 runtime + 10层 SaaS HTTP 完整清单 - saas: industry模块、路由模块13个、数据表42个 - routing: Store含industryStore、21个Store文件 - butler: 行业配置接入ButlerPanel、4内置行业 - log: 三端联调+V13修复记录追加
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: 中间件链
|
||||
updated: 2026-04-11
|
||||
updated: 2026-04-14
|
||||
status: active
|
||||
tags: [module, middleware, runtime]
|
||||
---
|
||||
@@ -20,7 +20,7 @@ tags: [module, middleware, runtime]
|
||||
|
||||
## 代码逻辑
|
||||
|
||||
### 15 层中间件(注册顺序见 `kernel/mod.rs:190-360`)
|
||||
### 14 层 Runtime 中间件(注册顺序见 `kernel/mod.rs:248-361`)
|
||||
|
||||
| # | 中间件 | 文件 | 职责 | 注册条件 |
|
||||
|---|--------|------|------|----------|
|
||||
@@ -37,9 +37,24 @@ tags: [module, middleware, runtime]
|
||||
| 11 | ToolOutputGuard | `middleware/tool_output_guard.rs` | 工具输出安全检查 | 始终 |
|
||||
| 12 | Guardrail | `middleware/guardrail.rs` | shell_exec/file_write/web_fetch 安全规则 | 始终 |
|
||||
| 13 | SubagentLimit | `middleware/subagent_limit.rs` | 限制并发子 agent | 始终 |
|
||||
| 14 | TrajectoryRecorder | `middleware/trajectory_recorder.rs` | 轨迹记录 + 压缩 | 始终 (V13-FIX-01 注册) |
|
||||
| 14 | TrajectoryRecorder | `middleware/trajectory_recorder.rs` | 轨迹记录 + 压缩 | 始终 (V13-FIX-01 已注册) |
|
||||
|
||||
### 优先级分类(来自 `middleware.rs` 头注释)
|
||||
### 10 层 SaaS HTTP 中间件(`zclaw-saas/src/main.rs`)
|
||||
|
||||
| # | 中间件 | 职责 | 层级 |
|
||||
|---|--------|------|------|
|
||||
| 1 | public_rate_limit_middleware | 公共端点限流 (20次/分钟/IP) | 公共路由 |
|
||||
| 2 | api_version_middleware | API 版本校验 | 公共 + 认证路由 |
|
||||
| 3 | request_id_middleware | 请求 ID 注入 | 公共 + 认证路由 |
|
||||
| 4 | rate_limit_middleware | 认证端点限流 (5次/分钟/IP) | 认证路由 |
|
||||
| 5 | auth_middleware | JWT 认证 + 权限校验 | 认证路由 |
|
||||
| 6 | TimeoutLayer | 请求超时 15s | 认证路由 |
|
||||
| 7 | api_version_middleware (relay) | API 版本校验 | Relay 路由 |
|
||||
| 8 | request_id_middleware (relay) | 请求 ID 注入 | Relay 路由 |
|
||||
| 9 | quota_check_middleware | 配额检查 | Relay 路由 |
|
||||
| 10 | CORS / 其他 layer | 跨域等 | 全局 |
|
||||
|
||||
### 优先级分类(Runtime,来自 `middleware.rs` 头注释)
|
||||
|
||||
| 范围 | 类别 | 包含的中间件 |
|
||||
|------|------|-------------|
|
||||
@@ -82,7 +97,7 @@ trait AgentMiddleware: Send + Sync {
|
||||
|
||||
### 注册位置
|
||||
|
||||
`crates/zclaw-kernel/src/kernel/mod.rs:190-345` — `create_middleware_chain()` 方法,13 次 `chain.register()` + 1 个条件注册。
|
||||
`crates/zclaw-kernel/src/kernel/mod.rs:248-361` — `create_middleware_chain()` 方法,14 次 `chain.register()` + 1 个条件注册 (SkillIndex)。
|
||||
|
||||
## 关联模块
|
||||
|
||||
@@ -97,4 +112,5 @@ trait AgentMiddleware: Send + Sync {
|
||||
|------|------|
|
||||
| `crates/zclaw-runtime/src/middleware.rs` | AgentMiddleware trait + MiddlewareChain |
|
||||
| `crates/zclaw-runtime/src/middleware/` | 14 个中间件实现 (14个 .rs 文件) |
|
||||
| `crates/zclaw-kernel/src/kernel/mod.rs:190-345` | 注册入口 |
|
||||
| `crates/zclaw-kernel/src/kernel/mod.rs:248-361` | 注册入口 |
|
||||
| `crates/zclaw-saas/src/main.rs` | SaaS HTTP 中间件注册 (10 层) |
|
||||
|
||||
Reference in New Issue
Block a user