36a1c87d87
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
问题: 旧 wiki 按文档类型组织（architecture/data-flows/file-map）， 修复 Butler Router 需要读 4 个文件才能拼凑全貌。 且 SaaS Relay 主路径 vs 本地降级的优先级描述不准确。 重构为模块化结构，每个模块页自包含： - 设计思想: 为什么这样设计 - 代码逻辑: 数据流 + 关键代码 - 关联模块: 依赖关系 新增模块页: - routing.md: 客户端路由 (明确 SaaS Relay 是主路径，不是本地模式) - chat.md: 聊天系统 (3种实现 + Token Pool 中转机制) - butler.md: 管家模式 (路由/冷启动/痛点/双模式UI) - memory.md: 记忆管道 (提取→FTS5→检索→注入) - saas.md: SaaS平台 (认证/Token池/计费/Admin) - middleware.md: 中间件链 (14层 + 优先级) - hands-skills.md: Hands(9) + Skills(75) - pipeline.md: Pipeline DSL 删除旧文件: architecture.md, data-flows.md, module-status.md, file-map.md (内容已分布到对应模块页中) 添加 .gitignore 排除 Obsidian 工作区状态文件
31 lines
951 B
Markdown
31 lines
951 B
Markdown
---
|
|
title: 已知问题
|
|
updated: 2026-04-11
|
|
status: active
|
|
tags: [issues, bugs]
|
|
---
|
|
|
|
# 已知问题
|
|
|
|
> 从 [[index]] 导航。完整清单见 `docs/TRUTH.md §3`
|
|
|
|
## 当前状态
|
|
|
|
| 级别 | 数量 | 状态 |
|
|
|------|------|------|
|
|
| P0 (崩溃) | 2 | 全部已修复 |
|
|
| P1 (功能失效) | 9 | 全部已修复 |
|
|
| P1.5 (代码质量) | 7 | 全部已修复 |
|
|
| P2 (代码质量) | 10 | 待处理 |
|
|
|
|
## 长期观察项
|
|
|
|
| 问题 | 说明 | 位置 |
|
|
|------|------|------|
|
|
| Tauri 命令孤儿 70 个 | 无前端调用且无 @reserved | `desktop/src-tauri/src/lib.rs` |
|
|
| Embedding 未激活 | EmbeddingClient trait 已写但 NoOp | `zclaw-growth/src/retrieval/semantic.rs` |
|
|
| SaaS embedding deferred | pgvector 索引就绪，生成未实现 | `zclaw-saas/src/workers/generate_embedding.rs` |
|
|
| webhook 死代码 | 5 路由定义但未挂载 | `zclaw-saas/src/webhook/` |
|
|
|
|
→ 模块详情见各模块页面: [[routing]] [[chat]] [[saas]] [[memory]]
|