首页 / 实战项目

知识库智能体 · 实战复盘

当前版本 v7.6.0

一个本地部署的知识库智能体:自动更新知识库、每日自动总结、智能问答检索,可整体打包交付客户、C 盘零占用。下面把这个项目从 3.0 到 7.6 的版本演进、架构取舍和踩过的坑完整摊开。

核心能力

检索、溯源、自动化、权限,一个本地知识库系统的四块地基。

🔍 三路召回检索

关键词、向量、知识图谱三路召回,在构造候选集时就按知识库卡住边界——不是「先取 60 条再砍掉 55 条」,检索隔离从架构层做对。

📎 引用溯源

答案里的来源可以点开,右侧抽屉给出命中段和前后各两块原文。匹配走整句包含 + 字符相似度,不跑向量;对不上就如实标注「弱匹配」。

⚙️ 工作流引擎

线性「触发器 + 步骤清单」,刻意不做自由画布。每一步写明要不要花 token,只有停用没有删除,每次运行逐步留记录,能查到是哪一步崩的。

👥 多租户权限

可见范围 6 档(仅自己 → 对外)× 权限等级 5 级(可见/可读/可下载/可维护/可管理),还有独立的「AI 可引用」开关——给人看 ≠ 给 AI 吃。

✂️ 网页剪藏

贴一个链接,抓正文存进知识库:按链接查重、可指定归档目录、记录来源出处。剪藏全程不调模型,零成本。

⌨️ Ctrl+K 命令面板

全局命令面板搜资料原话并直接跳页,走独立检索接口,一次模型都不调——快,且不花钱。

版本演进时间线

一版一个明确主题,做完就发版打 tag。这是从 3.0 到 7.6 的完整路径。

v3.0双模式重新定义

「极简 / 专业」两种模式:极简留清爽留白,专业下侧栏分三组、设置页拆成 5 个二级标签 + 11 张三级折叠卡片。

v3.1入口收敛 + 效率三件套

一个入口一个页面,消灭「同一房间两扇门」;新增待办、收藏夹、16 条提示词模板;内容搜索两路召回 RRF 融合、零模型调用。顺手修掉一个「开关从没被配置填过」的沉默 bug。

v5.0侧栏折叠导航

4 个分组逐个展开收起,默认全收起——14 个入口平铺把会话列表挤没了,折叠后侧栏常态只剩 4 行组名。

v5.1访问控制地基

多人共用从设计稿变成真能开关:可见范围 6 档、权限等级 5 级、AI 可引用独立开关、多工作空间。检索隔离下沉到召回链路内部,不是加层中间件了事。

v6.0信息架构对标返工

先对标 Dify / MaxKB / FastGPT / RAGFlow / AnythingLLM / Open WebUI / LobeChat 出分析报告,再动工:一级目录正名(知识→知识库、调优→引擎)、修层级倒挂、批量建号、审计导出。

v7.0默认极简 + 首启引导

默认进极简模式;首启二选一(团队共用 / 单机自用),选单机就关闭登录——不会把人锁在门外。

v7.1Ctrl+K 全局命令面板

搜资料原话 + 跳页面,一次模型都不调。

v7.2资料库目录树

左树右栏 + 拖拽归档 + 多级目录。删文件夹只删容器:子目录上浮、文档退回上一级,绝不连带删资料。

v7.3引用溯源

命中段 + 前后原文的溯源抽屉,弱匹配诚实标注,不装准。

v7.4工作流

线性触发器 + 步骤清单,逐步留痕,能查是哪一步崩的。

v7.5网页剪藏

给「能力在、门没开」的后端抓取接口装上前端入口——这类断点最隐蔽:静态看不出来、跑起来不报错,只有每个按钮都点一遍才会发现。

v7.6布局返工 + 多端适配

内容主列 1240、对话列 900,断点覆盖笔记本 / 抽屉侧栏 / 手机三档,改前改后全程截图自查。

实测数据

不是纸面指标,是本机 6 篇示例资料 / 62 分块环境下的实测值。

4ms内容搜索服务端耗时
100.0融合后最高相关分
447/500图谱实体 / 关系
16条内置模板 · 4 分类

这个项目教会我的事

1
能力要有门

后端接口从 3.x 就写好了,前端一次都没调过——「能力在、门没开」的断点最隐蔽,只有把每个按钮都点一遍才能发现。

2
一版一个主题

每个版本只讲一个明确的故事,做完就发版打 tag 存快照。混着做,出了问题都不知道该怪哪个改动。

3
先对标再动手

6.0 的信息架构返工先对标了 7 个一线产品再动工。自己闷头想出来的「调优」「产出」,用户根本看不懂。

4
诚实比聪明重要

溯源对不上就标「弱匹配」,不装准;权限隔离在召回层就卡住,不靠后置过滤装样子。糊弄用户的地方迟早都会露馅。

去看知识图解 → 进学习台系统学 ← 返回首页