docs(wiki): 创建 LLM 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
受 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 维护步骤
This commit is contained in:
57
wiki/known-issues.md
Normal file
57
wiki/known-issues.md
Normal file
@@ -0,0 +1,57 @@
|
||||
---
|
||||
title: 已知问题
|
||||
updated: 2026-04-11
|
||||
status: active
|
||||
tags: [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]]
|
||||
Reference in New Issue
Block a user