iven/zclaw_openfang
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

docs(wiki): 同步知识库 — 04-21 经验积累+Skill工具调用修复
Some checks failed
CI / Lint & TypeCheck (push) Has been cancelled
Details
CI / Unit Tests (push) Has been cancelled
Details
CI / Build Frontend (push) Has been cancelled
Details
CI / Rust Check (push) Has been cancelled
Details
CI / Security Scan (push) Has been cancelled
Details
CI / E2E Tests (push) Has been cancelled
Details

Browse Source
This commit is contained in:
iven
2026-04-21 01:12:51 +08:00
parent c1dea6e07a
commit 2f5e9f1755
10 changed files with 194 additions and 109 deletions
Download Patch File Download Diff File Expand all files Collapse all files

32
docs/TRUTH.md
View File

@@ -11,35 +11,37 @@
| 指标 | 实际值 | 验证方式 |
|------|--------|----------|
| Rust Crates | 10 个 (编译通过) | `cargo check --workspace` |
| Rust 代码行数 | ~77,000 (crates) + ~61,400 (src-tauri) = ~138,400 | wc -l (2026-04-12 V13 验证) |
| Rust 单元测试 | 477 个 (#[test]) + 326 个 (#[tokio::test]) = 803 | `grep '#\[test\]' crates/` + `grep '#\[tokio::test\]'` (2026-04-18 审计验证) |
| Rust 代码行数 | 80,754 (crates, 288 .rs) + 21,213 (src-tauri, 69 .rs) = 101,967 (357 .rs文件) | `wc -l` (2026-04-19 代码验证) |
| Rust 单元测试 | 640 个 (#[test], 含 src-tauri 89) + 347 个 (#[tokio::test], 含 src-tauri 17) = 987 | `grep '#\[test\]' crates/ src-tauri/` (2026-04-19 代码验证) |
| Rust 测试运行通过 | 797 workspace (sqlx 0.8 升级后 2026-04-19 验证) | `cargo test --workspace --exclude zclaw-saas` |
| Cargo Warnings (非 SaaS) | **0 个** (仅 sqlx-postgres 外部依赖 1 个) | `cargo check --workspace --exclude zclaw-saas` (2026-04-15 清零) |
| Rust 测试运行通过 | 684 workspace + 138 SaaS = 822 | Hermes 4 Chunk `cargo test --workspace` 2026-04-09 |
| Tauri 命令 | 190 个 | `grep '#\[.*tauri::command'` (2026-04-16 验证) |
| **Tauri 命令有前端调用** | **104 处** | `grep invoke( desktop/src/` (2026-04-16 验证) |
| **Tauri 命令已标注 @reserved** | **89 个** | Rust 源码 @reserved 标注 (2026-04-15 全量标注) |
| **Tauri 命令孤儿 (无调用+无标注)** | **~0 个** (190 - 104 invoke - 89 @reserved ≈ -3，差异来自内部命令调用) | (2026-04-16 校准) |
| **Tauri 命令有前端调用** | **104 处 / 91 唯一命令** | `grep invoke( desktop/src/` (2026-04-19 验证) |
| **Tauri 命令已标注 @reserved** | **97 个** | Rust 源码 @reserved 标注 (2026-04-19 代码验证) |
| **Tauri 命令孤儿 (无调用+无标注)** | **~0 个** (190 - 104 invoke - 97 @reserved ≈ -11，差异来自内部命令调用) | (2026-04-19 校准) |
| SKILL.md 文件 | 75 个 | `ls skills/*.md \| wc -l` |
| Hands 启用 | 7 个 (6 HAND.toml + 1 系统内部 _reminder) | Browser/Collector/Researcher/Clip/Twitter/Quiz = 6 个有 HAND.toml；ReminderHand 通过 kernel 编程注册（`_` 前缀豁免 HAND.toml 扫描） |
| Hands 开发中 | 3 个 | Whiteboard/Slideshow/Speech（HAND.toml 仅存在于 worktree 开发分支，无 `impl Hand for`，未合并到主分支） |
| Hands 已删除 | 3 个 | Whiteboard/Slideshow/Speech — 空壳实现已删除 (04-17 Phase 5, 净减 ~5400 行) |
| Hands 禁用 | 2 个 | Predictor, Lead（概念定义存在，无 TOML 配置文件或 Rust 实现） |
| Pipeline 模板 | 18 个 YAML | `pipelines/` 目录全量统计 (2026-04-18 验证) |
| Pipeline 模板 | 18 个 YAML | `pipelines/` 目录全量统计 (2026-04-19 验证) |
| SaaS API 端点 | 137 个 .route() | `grep .route( crates/zclaw-saas/` (2026-04-16 验证) |
| SaaS 路由模块 | 12 个 + industry | account/agent_template/auth/billing/knowledge/migration/model_config/prompt/relay/role/scheduled_task/telemetry/industry（scheduled_task: 后端 5 CRUD + Admin V2 前端 service/page/route/nav） |
| SaaS 数据表 | 34 个（含 saas_schema_version） | CREATE TABLE 全量统计 |
| SaaS 模块目录 | 16 个 | `ls crates/zclaw-saas/src/*/` (2026-04-19 验证: account/agent_template/auth/billing/industry/knowledge/migration/model_config/models/prompt/relay/role/scheduled_task/tasks/telemetry/workers) |
| SaaS 数据表 | 42 个 CREATE TABLE | CREATE TABLE 全量统计 (2026-04-19 验证) |
| SaaS Workers | 7 个 | log_operation/cleanup_rate_limit/cleanup_refresh_tokens/record_usage/update_last_used/aggregate_usage/generate_embedding |
| LLM Provider | 8 个 | Kimi/Qwen/DeepSeek/Zhipu/OpenAI/Anthropic/Gemini/Local |
| Zustand Store | 25 个 | find desktop/src/store/ -name "*.ts" (2026-04-18 审计，workflowBuilderStore 已删除) |
| React 组件 | 105 个 (.tsx/.ts) | find desktop/src/components/ (2026-04-15 新增 HealthPanel.tsx) |
| Zustand Store | 25 个 (16 根 + chat/4 + saas/5) | find desktop/src/store/ -name "*.ts" (2026-04-19 验证) |
| React 组件 | 102 个 (.tsx/.ts, 11 子目录) | find desktop/src/components/ (2026-04-19 验证) |
| 前端 TypeScript 测试 | 31 个文件 (6 store + 5 lib + 1 config + 1 stabilization + 18 E2E spec) | Phase 3-4 全量 |
| 前端 lib | 76 个 .ts | find desktop/src/lib/ (2026-04-15 删除 intelligence-client/ 9 文件) |
| 前端 lib | 75 个 .ts (71 顶层 + workflow-builder/3 + __tests__/1) | find desktop/src/lib/ (2026-04-19 验证) |
| 前端测试运行通过 | 344 passed + 1 skipped | `pnpm vitest run` (2026-04-15 验证) |
| 生产构建 | **通过** (14.8s, 0 require 残留) | `pnpm build` (2026-04-15 验证) |
| Admin V2 页面 | 17 个 | admin-v2/src/pages/ 全量统计 (2026-04-18 验证) |
| 桌面端设置页面 | 19 个 | SettingsLayout.tsx tabs: 通用/用量统计/积分详情/模型与API/MCP服务/技能/IM频道/工作区/数据与隐私/安全存储/SaaS平台/订阅与计费/语义记忆/安全状态/审计日志/定时任务/心跳配置/提交反馈/关于 |
| Admin V2 页面 | 17 个 | admin-v2/src/pages/ 全量统计 (2026-04-19 验证) |
| 桌面端设置页面 | 19 个 | SettingsLayout.tsx tabs: 通用/模型与API/MCP服务/IM频道/工作区/数据与隐私/安全存储/SaaS平台/订阅与计费/技能管理/语义记忆/安全状态/审计日志/定时任务/心跳配置/系统健康/实验性功能/提交反馈/关于 |
| Admin V2 测试 | 17 个文件 (61 tests) | vitest 统计 |
| 中间件层 | 15 层 | `grep chain.register kernel/mod.rs` (2026-04-19 校准: EvolutionMiddleware@78, ButlerRouter@80, DataMasking@90, Compaction@100, Memory@150, Title@180, SkillIndex@200, DanglingTool@300, ToolError@350, ToolOutputGuard@360, Guardrail@400, LoopGuard@500, SubagentLimit@550, TrajectoryRecorder@650, TokenCalibration@700) |
| Intelligence 文件 | 16 个 .rs | `ls src-tauri/src/intelligence/` (2026-04-19 验证) |
| dead_code 标注 | 0 个 | `grep '#\[dead_code\]' crates/ src-tauri/` (2026-04-19 验证) |
| TODO/FIXME | 前端 1 + Rust 1 = 2 | `grep TODO/FIXME` (2026-04-19 验证) |
---