技术架构
从文档到长文的完整工程链路
知识架构负责把文档沉淀为可检索、可追溯、可编辑的知识；系统栈负责把这些能力变成一个可运行的自托管应用。
№ 01 · 知识架构
三层构建 + 写作检索回路
上传的文档先转换为 Markdown、分段、做 embedding 与索引，随后沉淀为三层知识；写作时优先利用 Wiki 综合层，并行融合关键词、direct embedding 与 LightRAG mix，再统一组装章节上下文并回写反哺。
上传文档
→
转换 Markdown
→
分段
→
Embed & 索引
第 1 层 · 原始文档块
第 2 层 · LightRAG 实体图谱
第 3 层 · LLM 知识 Wiki
写作检索
Wiki 综合层优先
+
关键词 · direct embedding · LightRAG mix 并行融合
→
统一组装章节上下文
每次生成回写反哺 Wiki（飞轮）
№ 02 · 系统技术栈
五层技术栈
从浏览器到 LLM 提供商，每一层职责清晰。
浏览器层
React 19 · Tailwind CSS · shadcn/ui · d3-force
Next.js App Router
页面、API 路由、认证、设置、任务队列
Prisma + SQLite
数据持久化与查询（可选 PostgreSQL）
Python Workers
转换、语义分块、LightRAG 索引、Wiki 综合、导出
LLM Providers
OpenAI 兼容端点 · Anthropic · Ollama · 本地服务
№ 03 · 项目结构
关键目录说明
源码组织围绕知识与写作两条主线展开。
| 路径 | 用途 |
|---|---|
src/app | Next.js 页面和 API 路由。 |
src/lib/documents | 文档生命周期、分段、分块、索引和存储。 |
src/lib/rag · wiki · search | LightRAG 集成、Wiki 综合和检索。 |
src/lib/writing | 头脑风暴、大纲、上下文组装、章节生成、审阅和导出。 |
workers/python | 转换、分块、LightRAG 索引和导出 worker。 |
electron · packaging | 桌面端外壳与 Windows x64、macOS Apple Silicon 打包；安装包内置 Node.js 24.18.0 与 CPython 3.14.6。 |
№ 04 · 技术栈一览
构建于现代、成熟的技术之上
Next.js 16
React 19
Python 3.14.6
Prisma
SQLite
Tailwind CSS
LightRAG
d3-force
Apache-2.0
Offline-first