Files
zclaw_openfang/wiki/known-issues.md
iven 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
docs(wiki): 重构为模块化知识库 — 按模块组织而非按文档类型
问题: 旧 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 工作区状态文件
2026-04-11 00:36:26 +08:00

951 B

title, updated, status, tags
title updated status tags
已知问题 2026-04-11 active
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