docs(wiki): 重构为模块化知识库 — 按模块组织而非按文档类型
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
问题: 旧 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 工作区状态文件
This commit is contained in:
@@ -7,51 +7,24 @@ tags: [issues, bugs]
|
||||
|
||||
# 已知问题
|
||||
|
||||
> 从 [[index]] 导航到此处。完整缺陷清单见 `docs/TRUTH.md §3`
|
||||
> 从 [[index]] 导航。完整清单见 `docs/TRUTH.md §3`
|
||||
|
||||
## P0 — 必然崩溃
|
||||
## 当前状态
|
||||
|
||||
| ID | 问题 | 状态 |
|
||||
|----|------|------|
|
||||
| SEC2-P0-01 | skill_execute 反序列化崩溃 | 已修复 |
|
||||
| SEC2-P0-02 | TaskTool::default() panic | 已修复 |
|
||||
|
||||
## P1 — 功能失效
|
||||
|
||||
| ID | 问题 | 状态 |
|
||||
|----|------|------|
|
||||
| SEC2-P1-01 | FactStore trait 零实现 | 已修复 |
|
||||
| SEC2-P1-02 | agent-templates 路径错误 (缺 /api/v1) | 已修复 |
|
||||
| SEC2-P1-03 | hand-execution-complete 无监听 | 已修复 |
|
||||
| SEC2-P1-04 | InMemoryStorage RwLock unwrap 级联 | 已修复 |
|
||||
| SEC2-P1-05~07 | HandRun 持久化静默忽略 (3处) | 已修复 |
|
||||
| SEC2-P1-08 | FTS 索引更新静默失败 | 已修复 |
|
||||
| SEC2-P1-09 | Worker dispatch 静默失败 | 已修复 |
|
||||
|
||||
## P1.5 — 代码质量
|
||||
|
||||
| ID | 问题 | 状态 |
|
||||
|----|------|------|
|
||||
| SEC2-P1.5-01 | Capability _ => false 通配符 | 已修复 |
|
||||
| SEC2-P1.5-02 | billing let _ = ... 冗余 | 已修复 |
|
||||
| SEC2-P1.5-03 | relay SSE 错误路径 send 失败未记录 | 已修复 |
|
||||
| SEC2-P1.5-04 | WASM runner 缺少状态注解 | 已修复 |
|
||||
| SEC2-P1.5-05 | Tauri 命令无连接状态标注 | 已修复 |
|
||||
| SEC2-P1.5-06 | extract_token_usage 静默丢弃解析错误 | 已修复 |
|
||||
| SEC2-P1.5-07 | relay current_key_id 防御性 unwrap | 已修复 |
|
||||
|
||||
## P2 — 代码质量(待处理)
|
||||
|
||||
10 项代码质量问题 (SEC2-P2-01~10),非阻塞性。详见 `docs/TRUTH.md §3.3`
|
||||
| 级别 | 数量 | 状态 |
|
||||
|------|------|------|
|
||||
| P0 (崩溃) | 2 | 全部已修复 |
|
||||
| P1 (功能失效) | 9 | 全部已修复 |
|
||||
| P1.5 (代码质量) | 7 | 全部已修复 |
|
||||
| P2 (代码质量) | 10 | 待处理 |
|
||||
|
||||
## 长期观察项
|
||||
|
||||
| 问题 | 说明 | 行动 |
|
||||
| 问题 | 说明 | 位置 |
|
||||
|------|------|------|
|
||||
| Tauri 命令孤儿 70 个 | 无前端调用且无 @reserved | 逐步标注或清理 |
|
||||
| Embedding 未激活 | EmbeddingClient trait 已写但未调用 | 发布后迭代 |
|
||||
| SaaS embedding deferred | pgvector 索引就绪,生成未实现 | 发布后迭代 |
|
||||
| webhook 死代码 | 5 路由定义但未挂载 | 待删除 |
|
||||
| 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/` |
|
||||
|
||||
→ 模块状态见 [[module-status]]
|
||||
→ 开发规范见 [[development]]
|
||||
→ 模块详情见各模块页面: [[routing]] [[chat]] [[saas]] [[memory]]
|
||||
|
||||
Reference in New Issue
Block a user