Files
zclaw_openfang/wiki/known-issues.md
iven e790cf171a
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): 创建 LLM Wiki 知识库 — 编译后项目画像
受 Karpathy LLM Wiki 启发,将分散在 docs/ + memory/ + CLAUDE.md 的项目知识
编译为 8 个结构化 wiki 页面,解决新会话冷启动时上下文浪费问题。

- wiki/index.md: 主索引入口 (~200行),CLAUDE.md @import 自动加载
- wiki/architecture.md: 系统架构编译 (crate依赖/客户端路由/聊天流/LLM驱动)
- wiki/module-status.md: 9个子系统状态 + Hands详情 + 测试覆盖
- wiki/data-flows.md: 6条核心数据流 (聊天/路由/记忆/认证/管家/Pipeline)
- wiki/development.md: 开发规范 (闭环工作法/验证命令/提交规范)
- wiki/known-issues.md: 缺陷状态 (P0/P1已修复,P2待处理)
- wiki/file-map.md: 代码库文件地图 (crates/desktop/admin-v2/docs)
- wiki/log.md: Append-only 变更日志
- CLAUDE.md: 添加 @wiki/index.md + §8.3 收尾流程增加 wiki 维护步骤
2026-04-11 00:20:17 +08:00

2.0 KiB

title, updated, status, tags
title updated status tags
已知问题 2026-04-11 active
issues
bugs

已知问题

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

长期观察项

问题 说明 行动
Tauri 命令孤儿 70 个 无前端调用且无 @reserved 逐步标注或清理
Embedding 未激活 EmbeddingClient trait 已写但未调用 发布后迭代
SaaS embedding deferred pgvector 索引就绪,生成未实现 发布后迭代
webhook 死代码 5 路由定义但未挂载 待删除

→ 模块状态见 module-status → 开发规范见 development