个人文献知识库

文献管理的现实痛点

学术研究中，文献管理工具往往是割裂的：文献数据库用于检索，笔记软件用于记录，知识图谱工具用于连接想法。这种割裂导致检索结果无法自动沉淀为可复用的知识，每次研究项目都可能从零开始搜索，过去看过的论文、做过的笔记难以被有效召回和关联。

核心能力与关键流程

本技能构建了一个本地化的、面向学术场景的个人知识中枢，其工作流程围绕“沉淀-检索-连接”三个核心环节：

1. 数据入库（沉淀）：支持四种数据来源统一入库，构建知识底层：

- SmartLib 检索结果：对接全球学术文献 API，在检索后可一键将结构化元数据（含 DOI、摘要、来源链接等）保存到本地 db/literature.json。
- 用户上传文件：直接保存 PDF、Word、Markdown 或 BibTeX 文件，由系统自动提取元数据。
- 资讯与报道：通过 URL 或粘贴文本，将重要的学术新闻、博客文章纳入知识库。
- 个人数据：实验数据、CSV 表格、研究笔记等个人学术产物。

1. 混合检索策略：提供两种互补的检索方式，满足不同场景需求：

- 向量语义检索：将文献摘要等文本向量化，支持基于语义相似度的搜索，适合查找概念相关但关键词不匹配的内容。向量化支持免费的硅基流动 BGE-M3 模型或付费的高精度模型。
- 传统分词检索：基于 jieba 分词的精确关键词检索，适合查找特定术语、标题或作者。两种检索结果会合并呈现。

1. 知识网络自动维护（连接）：继承了 LLM Wiki 的理念，入库文献后，LLM 会自动创建和更新 Wiki 知识页面，用 [[wiki-links]] 格式链接相关概念。当批量入库≥5篇文献时，会自动执行 Lint 健康检查，检测知识网络中的矛盾、过时概念和孤立页面，促进知识结构的有序化。

适用边界与关键设计

• 配额与成本：外部文献检索（通过 SmartLib API）消耗共享配额，但本地知识库内的检索、管理、导出等操作完全免费。配额耗尽时，仅暂停外部检索，本地功能不受影响。
• 数据所有权与安全：所有数据存储在本地 ~/.workbuddy/academic-kb/ 目录，raw/ 目录下的原始文件不可变。API Key 仅用于向量化服务，且存储于本地。
• 研究专题隔离：创建的“研究专题”是主知识库的只读快照，可以在专题内自由做笔记、分析，而不会污染主库的文献数据和 Wiki 结构，便于针对不同课题进行专注研究。