fix(production-readiness): 3-batch production readiness cleanup — 12 tasks
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

Batch 1 — User-facing fixes:
- B1-1: Pipeline verified end-to-end (14 Rust commands, 8 frontend invoke, fully connected)
- B1-2: MessageSearch restored to ChatArea with search button in DeerFlow header
- B1-3: Viking cleanup — removed 5 orphan invokes (no Rust impl), added addWithMetadata + storeWithSummaries methods + summary generation UI
- B1-4: api-fallbacks transparency — added _isFallback markers + console.warn to all 6 fallback functions

Batch 2 — System health:
- B2-1: Document drift calibration — TRUTH.md/README.md numbers verified and updated
- B2-2: @reserved annotations on 15 SaaS handler functions with no frontend callers
- B2-3: Scheduled Task Admin V2 — new service + page + route + sidebar navigation
- B2-4: TRUTH.md Pipeline/Viking/ScheduledTask records corrected

Batch 3 — Long-term quality:
- B3-1: hand_run_status/hand_run_list verified as fully implemented (not stubs)
- B3-2: Identity snapshot rollback UI added to RightPanel
- B3-3: P2 code quality — 4 fixes (TODO comments, fire-and-forget notes, design notes, table name validation), 2 verified N/A, 1 upstream
- B3-4: Config PATCH→PUT alignment (admin-v2 config.ts matched to SaaS backend)
This commit is contained in:
iven
2026-04-03 21:34:56 +08:00
parent 305984c982
commit 2ceeeaba3d
17 changed files with 1157 additions and 81 deletions

View File

@@ -77,7 +77,7 @@ docs/
## Crate 架构
ZCLAW 核心由 8 个 Rust Crate 组成:
ZCLAW 核心由 10 个 Rust Crate 组成:
| Crate | 层级 | 职责 |
|-------|------|------|
@@ -85,9 +85,12 @@ ZCLAW 核心由 8 个 Rust Crate 组成:
| `zclaw-memory` | L2 | 存储层 (SQLite, 会话管理) |
| `zclaw-runtime` | L3 | 运行时 (LLM 驱动, 工具, Agent 循环) |
| `zclaw-kernel` | L4 | 核心协调 (注册, 调度, 事件, 工作流) |
| `zclaw-skills` | - | 技能系统 (SKILL.md 解析, 执行器) |
| `zclaw-hands` | - | 自主能力 (Hand/Trigger 注册管理) |
| `zclaw-protocols` | - | 协议支持 (MCP, A2A) |
| `zclaw-skills` | L5 | 技能系统 (SKILL.md 解析, 执行器) |
| `zclaw-hands` | L5 | 自主能力 (Hand/Trigger 注册管理) |
| `zclaw-protocols` | L5 | 协议支持 (MCP, A2A) |
| `zclaw-pipeline` | L5 | Pipeline DSL (v1/v2, 模板) |
| `zclaw-growth` | L5 | 记忆增长 (FTS5 + TF-IDF) |
| `zclaw-saas` | 独立 | SaaS 后端 (Axum + PostgreSQL) |
### 依赖关系
@@ -100,7 +103,12 @@ zclaw-runtime (→ types, memory)
zclaw-kernel (→ types, memory, runtime)
desktop/src-tauri (→ kernel, skills, hands, channels, protocols)
┌───┴───┬───────┬───────────┬──────────┐
│ │ │ │ │
skills hands protocols pipeline growth
desktop/src-tauri (→ kernel, skills, hands, protocols)
zclaw-saas (独立运行于 8080 端口)
```
## 支持的 LLM 提供商
@@ -113,13 +121,17 @@ desktop/src-tauri (→ kernel, skills, hands, channels, protocols)
| zhipu | `https://open.bigmodel.cn/api/paas/v4` | 智谱 GLM |
| openai | `https://api.openai.com/v1` | OpenAI |
| anthropic | `https://api.anthropic.com` | Anthropic Claude |
| gemini | `https://generativeai.googleapis.com/v1beta` | Google Gemini |
| local | `http://localhost:11434/v1` | Ollama/LMStudio |
## 项目状态
- **架构迁移**: Phase 5 完成 - 内部 Kernel 集成
- **Agent 智能层**: Phase 1-3 完成
- **测试覆盖**: 161 E2E tests passing, 26 Rust tests passing
- **Rust Crates**: 10 个 (171 Tauri 命令, 383 单元测试)
- **SaaS 平台**: 131 API 路由, 12 模块, 34 数据表
- **前端**: React 19 + Zustand 18 Stores, 135 组件
- **安全审计**: V1 通过 (B+)
## 贡献指南
@@ -130,4 +142,4 @@ desktop/src-tauri (→ kernel, skills, hands, channels, protocols)
---
**最后更新**: 2026-03-22
**最后更新**: 2026-04-03