Prompt 模板管理系统——所有 LLM prompt 从硬编码迁移到基于文件的模板系统，支持变量插值和 UI 管理。
- Prompt 模板引擎 —
electron/prompt-engine.ts提供模板加载、Mustache 风格变量插值（{{variable}}、{{#array}}循环、\{{escape}}）、列表、保存、重置功能。18 个单元测试覆盖。 - 10 个内置默认模板 —
electron/prompt-defaults.ts包含编译管道（6 个）、QA 管道（3 个）、工具（1 个）的完整模板定义。 - PromptTemplateManager 组件 — 设置页新增"Prompt 模板"标签页，展示模板卡片网格、变量面板（中文说明）、消息编辑器（system/user/assistant/tool Tab）、保存/重置操作。
- 5 个 IPC 通道 —
prompt:list-templates、prompt:get-template、prompt:save-template、prompt:reset-template、prompt:render-preview。
- 编译管道 5 个 prompt 迁移 —
llm-service.ts（compile-analysis、compile-generation）和compile-service.ts（compile-plan、compile-review、compile-retry）从硬编码 ChatMessage 数组改为模板调用。 - QA 管道 3 个 prompt 迁移 —
qa-service.ts（qa-main、qa-review、qa-archive-check）从硬编码改为模板调用。删除buildSystemPrompt函数。 - 工具 prompt 迁移 —
url-fetcher.ts（url-extract）和ipc-handlers.ts（ipc-compile-retry）从硬编码改为模板调用。 - 模板目录自动初始化 —
kb-init.ts在知识库初始化时自动创建schema/prompts/目录和 10 个模板子目录。
electron/schema-loader.ts— 旧的 schema 文件拼接加载器，已被模板系统完全替代。
- 新增
tests/prompt-engine.test.ts— 18 个模板引擎单元测试。 - IPC mock 扩展 —
mock-ipc.ts新增 5 个 prompt 模板 mock 方法。
LLM 配置模块全面重构——多供应商管理、场景化配置、用户完全自定义。
- 多 LLM 供应商管理 — 用户可添加、编辑、删除多个 LLM 供应商配置，每个配置包含：名称、协议（OpenAI/Anthropic/自定义）、Base URL、API Key、模型名称、Max Tokens、Temperature、Top P、启用扩展思考。
- 场景化配置 — 为编译、问答、内容审查三个场景分别选择不同的 LLM 模型。每个场景附带能力说明（推理能力、指令遵循、知识理解等），帮助用户选择合适的模型。
- 连接测试 — 每个 LLM 配置支持一键测试连接，验证 API Key 和端点是否有效。
- LLMManager 组件 — 全新的 LLM 管理 UI，包含供应商列表、添加/编辑表单、场景配置三个部分。
- 删除 models.dev 库 — 移除硬编码的供应商列表（
src/providers.ts），改为用户完全自定义。 - 配置存储分离 — LLM 配置从
settings.json分离到独立的llm-config.json文件。 - 场景配置存储 — 新增
llm-config.json存储供应商列表和场景配置（编译/问答/审查各使用哪个供应商）。 - 向后兼容 — 旧的
settings.llm配置作为 fallback，新配置优先。
- 新增
electron/llm-store.ts— LLM 配置管理模块，提供 CRUD 操作、场景配置、验证函数。 - 新增 30 个单元测试 — 覆盖
llm-store.ts的所有导出函数。 - 新增 15 个组件测试 — 覆盖
LLMManager.tsx的主要用户流程。 - IPC 通道扩展 — 新增 8 个 LLM 配置相关的 IPC 通道。
编译质量与资料摄入全面加固——提示词工程化、验证器修复、图片资产支持。
- Schema few-shot 示例 —
compile-rules.md新增完整格式示例（YAML frontmatter + 多节正文 + 链接章节），links-rules.md新增 4 个正确/错误链接对比示例，system.md重构角色定义与行为准则。所有内置 schema 版本升至 v4，已有知识库自动更新。 - 验证器修复 —
validateMultiPage前端合并逻辑修复（frontmatter + 页面主体不再被拆散评分），YAML 多行列表解析器重写（sources:\n - file.md格式正确识别），type字段从 3 个扩展到 7 个允许值。 - 分析阶段注入格式 —
compileNewPages()的分析步骤现在也能看到输出格式规范，不只生成步骤。 - 质量评审脚本 —
tests/compile-prompt-review.ts：用真实 schema + 真实 raw 文件测试编译质量，输出逐页评分和问题汇总。当前 MiniMax-M2.7 平均 88/100。 - LLM 可观测性 — 每次 LLM 请求在控制台输出模型、prompt 大小、耗时。
- 图片资产自动导入 — 导入 Markdown 文件时自动发现并复制引用的本地图片（
、<img>标签等），支持 PNG/JPEG/GIF/WebP/SVG/BMP。 - Markdown 图片渲染 — Wiki 页面中的本地图片自动通过
assets:read通道以 base64 渲染。 - image/webp 等图片格式加入支持的文件类型列表。
- 审查模型独立配置 — 设置中可指定
review_llm（模型+Key+Base URL），编译时用独立模型审查内容质量。新增enable_content_review开关。 - 批量编译 UI — RawFileList 新增"全部编译"按钮 + 进度条 + 逐文件结果汇总。文件行实时显示当前编译步骤（如"LLM 生成 Wiki 页面"）。
- 一键重置 Wiki — 高级设置中新增"重置所有 Wiki 页面"按钮，删除所有页面、清空索引和编译日志、重置 raw 文件为待编译状态。
- wiki:delete 现在同步清理 SQLite 和 LanceDB 向量。
- 批量编译缺少 progress 监听器导致进度条不更新 — 已修复。
updateSourceStatus在非 compiled 状态下也写入last_compiled_at，导致重置后文件仍被判为已编译 — 改为仅在 status='compiled' 时写入。
llm-service.ts：max_tokens4096 → 8192，QA 流式路径中 archive check 改为本地快速判断（消除 5-15s 后置等待）。compile-validator.ts：##小节要求从 2 个降为 1 个（warn），页长阈值放宽。compile-prompt-review.ts：新增编译质量评审脚本。- 测试超时从 30s 调至 60s，LLM 集成测试默认读取
%APPDATA%/knowcompile/settings.json。
资料摄入全面改造——不只是拖文件。
- PDF 文本提取 — 真正的 PDF 支持，自动提取文本内容。损坏或扫描件 PDF 给出明确中文提示。
- 文本粘贴摄入 — 直接粘贴 Markdown/纯文本，系统自动保存为
.md文件。 - 网页链接摄入 — 粘贴 URL，LLM 自动抓取网页正文并转为 Markdown。
- 批量编译 — "全部编译"按钮，一次编译所有未处理的文件，完成后汇总结果。
- 文件内容预览 — 点击文件名展开 raw 文件内容预览，不用离开应用。
- 导入文件校验 — 自动拒绝超大文件（>50MB）、不支持的格式、重复文件。
- 用户友好错误 — 编译失败显示中文提示，不再是 JavaScript 异常。
- 设计打磨 — 去掉重复的 raw/ 侧边栏，Emoji 图标模式 Tab，输入引导文案，编译完成提示"切换到 Wiki 视图查看"。
electron/url-fetcher.ts：URL 抓取 + LLM 正文提取electron/fs-manager.ts：新增validateRawFile()、readRawContent()，copyToRaw 错误处理electron/compile-service.ts：新增extractPDFText()（pdf-parse v2）src/components/IngestInput.tsx：三种摄入模式（拖放/粘贴/URL）src/components/RawFileList.tsx：批量编译、预览、中文错误映射src/views/IngestView.tsx：重构为编排层- 14 个新测试（fs-manager 9 + IngestInput 5）
渲染层测试基础设施建设——React 组件测试从 0 到 45 个用例。
- 渲染层测试 — 5 个新测试文件，45 个 test case，覆盖纯函数和 React 组件。
- IPC mock 工厂 —
createMockIPC()覆盖 40+ 个 IPC 通道，每个通道默认返回合理值，支持 per-test 定制。 - jsdom 测试环境 — vitest 双环境（node + jsdom），后端测试和渲染层测试在同一个
npm test中运行。
src/test-utils/mock-ipc.ts：IPC mock 工厂src/test-utils/render.tsx：组件测试渲染入口（自动 stubwindow.electronAPI）src/test-utils/setup.ts：DOM 匹配器注册- 导出
stripLeadingFrontmatter、convertWikiLinks为可测试的纯函数 - 45 个新测试：
stripThinking/extractThinking（11）、MarkdownRenderer 纯函数（10）、IconSidebar（4）、PageList（6）、ChatMessage（14）
统一日志和可观测性——评估 AI 问答的每个环节。
- Session ID 串联 — 每次 QA 生成唯一
qaSessionId，贯穿 LLM 日志 → QA 管道 → 知识缺口 → 反馈，完整链路可追踪。 - 成本追踪 — LLM 日志新增
promptTokens、responseTokens、costEstimate字段（估算值，仅供参考）。 - 错误分类 — LLM 日志新增
errorCategory：timeout / rate_limit / auth / network / other。 - 反馈权重审计 — QA 分析新增
feedbackWeightsApplied，记录哪些来源页面被反馈调整了权重及原因。 - QA 分析面板 — SystemView 新增"QA 分析"Tab：管道耗时、检索健康、LLM 统计、成本、知识缺口、当前参数。
- Markdown 日报 —
generateDailyReport()生成 QA 日报，可存档到 wiki/reports/。 - 缺口统计 —
getGapStats()按主题聚合、每日趋势、已解决/未解决分布。
report-generator.ts：QA 日报生成器QAAnalyticsPanel.tsx：QA 分析面板组件- 19 个新单元测试（token 估算、成本计算、错误分类）
知识迭代引擎——知识库在问答中自我生长。
- 知识缺口检测 — LLM 无法回答时自动记录问题到知识缺口列表。缺口面板展示未回答的问题，点击可跳转摄入。
- 智能归档建议 — LLM 判断回答是否包含有价值的综合/对比/新洞察，自动建议归档为 Wiki 页面。
- 知识生长面板 — 实时显示本次会话的归档数、缺口数、反馈数，让知识积累可视化。
- 反馈驱动检索 — 被多次标记"有帮助"的来源页面自动提升检索权重（×1.3），被标记"不准确"的降低（×0.7）。
gap-store.ts：知识缺口 JSONL 持久化checkArchiveWorthy()：轻量 LLM 归档判断（预过滤 + 解析）isArchiveCandidate()/parseArchiveVerdict()/parseReviewVerdict()：可测试的纯函数- 24 个新单元测试（gap-store 10 + archive/review 14）
AI 问答模块全面升级：从单轮等待变成流式多轮对话，检索质量大幅提升，交互细节补齐。
- 流式回答 — LLM token 逐字推送到前端，不再等待完整生成。支持中途停止，断网保留部分答案并提示重试。
- 多轮对话 — 自动维护对话历史，最近 N 轮上下文传入 LLM。支持会话管理：新建、切换、删除。
- 反馈系统 — 对回答打分（有帮助/不准确/需更详细），反馈持久化到对话记录和 LLM 日志。
- 行内引用 — 答案正文通过 Markdown 渲染，来源列表链接到答案底部。
- ConversationList 侧边栏 — 会话列表、时间戳、切换/删除操作。
- 混合检索 — FlexSearch 关键词 + LanceDB 向量 RRF 融合，精确术语匹配不再遗漏。
- 查询改写 — 60+ 中文 AI 术语同义词词典，查询扩展后嵌入，关键词提取辅助关键词搜索。
- 推理过程展示 —
<think>标签内容保留并在可折叠面板中显示（支持 DeepSeek 等 reasoning 模型）。 - 查询建议 — LLM 在回答末尾生成 3 个后续问题，点击直接填入输入框。
- 内容审查（可选） —
qa_review_enabled开启后二次 LLM 校验答案是否基于来源，默认关闭。
- preload 安全加固 —
on()方法增加白名单检查，与invoke()一致。 stripThinking()提取到共享electron/utils.ts，消除 4 处重复。chat()重构为runLLM()+chatStream()，统一 Anthropic/OpenAI 流式路径。semanticQA()提取buildContext()，新增semanticQAStream()。- 文档体系建立：ARCHITECTURE.md、CHANGELOG.md、CONTRIBUTING.md、VERSION。
- 流式竞态条件：每个请求带唯一 correlation ID，切换会话/卸载时 AbortController 取消。
- 流式渲染性能：requestAnimationFrame 批量更新，避免每秒 60+ 次 setState。
- 资料摄入（拖放 PDF/Markdown/纯文本）
- LLM 编译（两步 CoT 生成 Wiki 页面）
- AI 问答（7 步语义检索管道）
- 全文搜索（FlexSearch）
- 知识图谱（Cytoscape.js）
- 导出备份（HTML/Markdown/ZIP）
- 索引层（SQLite + LanceDB）
- 语义检索（bge-m3 本地 embedding）
- 增量编译（5 步管道 + 内容审查 + 矛盾检测）
- 问答归档
- 系统诊断仪表盘
- Schema 版本管理