知识库管理系统 - 需求与决策记录
1. 项目背景
用户拥有大量收藏文章（md / txt / 链接 / 视频），希望建立一个本地知识库管理系统：
- 通过分级标签体系组织知识
- 通过 LLM 自动分析文章主题并归类
- 同主题文章聚合为单一知识 MD
- 完整的变更追踪（类似 git diff）
- 通过前端 UI 进行所有操作
2. 原始需求
| 编号 |
需求 |
| R1 |
使用 tag-system 技能建立分级标签管理体系 |
| R2 |
LLM 分析文章主题，在已有体系中匹配标签；找不到时可在当前体系下新增标签类别 |
| R3 |
同主题文章聚合为一篇 MD 知识（如"大模型部署方法.md"） |
| R4 |
记录每篇文章对聚合知识的变更（描述 + 变更行），支持类似 git diff 的展示 |
| R5 |
前端：标签管理 + 文章录入 + 知识查看（含时间轴） |
| R6 |
文章格式支持 md/txt/链接，视频暂缓 |
| R7 |
Spring Boot + Vue 架构，fullstack-merge-deploy 技能合并部署，端口 7945 |
3. 关键决策（已确认）
| 决策点 |
选择 |
说明 |
| 数据库 |
MySQL 8+ |
JSON 字段足够使用，部署熟悉度高 |
| LLM 接入 |
OpenAI 兼容 |
通过 base_url + api_key + model 配置 |
| 聚合粒度 |
LLM 主题自由生成 |
LLM 根据文章归纳主题名，匹配现有 knowledge 标题，避免重复 |
| 版本策略 |
全量快照 |
每次变更保存完整 MD 内容，同时存 diff 行便于时间轴展示 |
| 链接处理 |
自动抓取 + 手动回退 |
Jsoup + readability 解析，失败弹窗提示手动贴入 |
| 用户认证 |
单用户登录 |
JWT，首次启动引导设置管理员账号 |
| 标签初始状态 |
全手动构建 |
空白启动，所有分类由用户手动创建 |
| LLM 配置 |
前端配置 + DB 存储 |
api_key 用 AES 加密入库 |
4. 非功能性要求
- 端口：7945（合并部署）
- Java：17（Spring Boot 3.2 最低要求）
- 构建：Maven
- 包名：
com.knowledge.extractor
- 编码：UTF-8 全链路
5. 范围排除
- ❌ 视频文章解析（后续迭代）
- ❌ 多用户 RBAC（仅单用户）
- ❌ 移动端适配（PC 优先）
- ❌ 全文搜索引擎接入（MySQL LIKE 即可，后续可加 ES）
