架构概览

应用由什么组成复制小节链接

KnowRealm 桌面端使用 Tauri 2、React 和 TypeScript。本地 FastAPI 服务随桌面应用启动，负责业务处理、任务和数据访问，普通用户无需单独部署服务。

桌面界面
   ↓ 本机接口
本地业务服务与任务处理
   ├─ SQLite 业务数据库
   ├─ 本地来源文件与配置
   └─ 按需调用模型、语音转写与搜索服务

官网是独立的 Next.js 项目，不是桌面应用的在线版本，也不共享桌面用户的数据目录。

本地数据复制小节链接

SQLite 与本地文件共同承载业务事实。搜索索引可重建，不能替代原始资料。应用的本地接口绑定到本机并使用启动令牌，不作为对外公开的通用服务。

数据目录、导出与迁移见数据与隐私。

页面与助手共用业务能力复制小节链接

页面操作与助手操作复用业务服务。能由程序稳定完成的校验、排期和统计使用程序规则；语义理解、总结和生成按需调用模型。

助手写入经过受控执行与授权，模型本身不直接任意修改数据库。长期业务事实保存在业务数据库中，对话执行状态不作为唯一业务凭据。

后台任务与恢复复制小节链接

转写、总结、习题生成和评分等耗时处理进入本地任务系统。对话的一轮回答与多步业务执行分别保存状态，页面离开、取消和重试有不同含义。

恢复能力需要按具体场景验证，不能从持久化实现推断任意中断都能无损续跑。当前验证边界见文档版本。

代码目录复制小节链接

开始开发前阅读开发与贡献及仓库当前规则。