BACK
Local AI · RAG · Knowledge Graph

Local Knowledge Assistant

面向个人长期知识资产的本地优先 RAG 系统,把 Markdown、检索、答案生成、Notion 同步与知识图谱治理整合为一个可持续维护的工作台。

Role独立开发者
Status持续迭代
StackPython / FastAPI / Vue 3
本地知识库助手的问答与检索工作台

把个人知识库做成可查询、可治理的系统

这个项目以本地 Markdown 为知识源,围绕个人长期知识资产建立完整闭环:内容入库、元数据标准化、向量索引、检索精排、答案生成、关系维护与图谱浏览都在同一工作区内完成。

系统默认优先在本机完成索引和检索;生成答案时可调用 DeepSeek,并在不可用时回退到本地 Ollama。敏感问题也可以关闭云端模型,保持本地生成。

Python
Streamlit
FastAPI
Vue 3
Element Plus
Sentence Transformers
Ollama

从本地文档到可引用答案

检索链路按职责拆分,既保证 Apple Silicon 上的安装稳定性,也保留后续替换索引或模型的空间。

01 / INGEST
内容切分
读取 Markdown 与结构化元数据,按可配置窗口生成文本片段。
02 / EMBED
本地向量化
使用多语言 Sentence Transformer,在本机生成并复用向量。
03 / RERANK
召回与精排
NumPy 余弦召回后使用 CrossEncoder 重排,控制来源分布。
04 / ANSWER
生成与引用
组合相关片段生成答案,并保留来源供核对与继续探索。

检索之外,更重要的是知识治理

系统把文档类型、状态、scope、summary、普通标签、Wiki 标签和强关系统一进 front matter。内容入库和关系维护都先生成预览,确认后才写回文件,避免自动化直接污染知识源。

多 Workspace 机制让不同知识域共享同一套能力但保持数据隔离;索引重建会复用未变化片段的向量,只处理新增或正文发生变化的内容。

让本地知识与 Notion 保持可控同步

项目支持 Notion 导入与同步,后台任务展示实时进度、重试日志和失败原因。同步状态会记录断点,内容哈希用于跳过没有变化的条目;项目与长期问题之间的双向关系也会同步为数据库属性。

所有写入动作都遵循“预览、确认、执行”的边界,密钥只保存在本地环境文件中,不进入仓库。

把分散文档变成可探索的关系网络

知识图谱区分人工确认的强关系、由 scope 和 Wiki 标签形成的弱关系,以及待确认的候选关系。用户可以按文档类型、目录、scope、标签和关键词筛选,也可以聚焦某一节点的一跳关系。

本地知识库助手的知识图谱浏览界面
图谱浏览:在同一视图中查看文档节点、强弱关系、筛选统计与节点详情。

覆盖知识资产的完整维护流程

01
问答与检索
可选检索范围、scope、返回数量、来源上限与精排策略,并决定是否生成答案。
02
内容与索引
从粘贴文本或本地文件生成规范文档,按需重建索引和知识图谱。
03
标签与关系
辅助分析标签和候选关系,但把最终写入决定保留给用户。
04
Notion 工作流
支持导入、后台同步、失败重试、断点恢复和手动上传回退。
05
多工作区
在一个应用中切换不同知识域,保持索引、配置与状态互相隔离。
06
本地优先
检索与治理默认留在设备上,云端生成可选,并提供 Ollama 本地回退。