Literature Memory

🚀 進行中的項目

本項目是一個靈活的系統，可用於管理各類來源（如論文、書籍、網頁等），並將其與知識圖譜集成，極大提升了知識管理的效率和便捷性。

🚀 快速開始

該系統與 MCP 內存服務器 集成，用於持久化知識圖譜存儲。使用前請確保滿足此先決條件。

1. 使用我們的架構創建一個新的 SQLite 數據庫：

# 創建新數據庫
sqlite3 sources.db < create_sources_db.sql

2. 安裝來源管理服務器：

# 為 Claude 桌面安裝，指定數據庫路徑
fastmcp install source-manager-server.py --name "Source Manager" -e SQLITE_DB_PATH=/path/to/sources.db

✨ 主要特性

核心功能

• 採用內部 UUID 系統的統一來源標識符系統。
• 支持多種來源類型，包括論文、網頁、書籍、視頻和博客。
• 每個來源支持多個標識符，如 arXiv、DOI、語義學者、ISBN、URL。
• 具備結構化筆記功能，支持標題和內容記錄。
• 可跟蹤來源狀態，如未讀、閱讀中、已完成、已歸檔。

實體集成

• 能將來源鏈接到知識圖譜實體。
• 可跟蹤來源與實體之間的關係。
• 支持靈活的關係類型，如討論、介紹、擴展、評估等。
• 集成了記憶圖功能。

📦 安裝指南

數據庫創建

# 創建新數據庫
sqlite3 sources.db < create_sources_db.sql

服務器安裝

# 為 Claude 桌面安裝，指定數據庫路徑
fastmcp install source-manager-server.py --name "Source Manager" -e SQLITE_DB_PATH=/path/to/sources.db

💻 使用示例

基礎用法

管理來源

# 添加新來源
add_source("example_paper.pdf", "paper")

# 模糊匹配添加標識符
fuzzy_match_and_add_identifier("related_work.pdf", "arXiv")

實體關係

# 建立來源與實體的關係
link_source_to_entity(source_id, entity_name, relation_type)

# 查看所有關聯的實體
get_associated_entities(source_id)

📚 詳細文檔

架構

核心表結構

-- 來源表
CREATE TABLE sources (
    id UUID PRIMARY KEY,
    title TEXT NOT NULL,
    type TEXT CHECK(type IN ('paper', 'webpage', 'book', 'video', 'blog')) NOT NULL,
    identifiers JSONB NOT NULL,
    status TEXT CHECK(status IN ('unread', 'reading', 'completed', 'archived')) DEFAULT 'unread'
);

-- 來源筆記
CREATE TABLE source_notes (
    source_id UUID REFERENCES sources(id),
    note_title TEXT NOT NULL,
    content TEXT NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    PRIMARY KEY (source_id, note_title)
);

-- 實體鏈接
CREATE TABLE source_entity_links (
    source_id UUID REFERENCES sources(id),
    entity_name TEXT,
    relation_type TEXT CHECK(relation_type IN ('discuss', 'introduce', 'extend', 'assess', etc.)),
    PRIMARY KEY (source_id, entity_name)
);

最佳實踐

1. 數據組織：按類型分類來源，使用結構化筆記記錄關鍵信息。
2. 狀態管理：定期更新來源狀態，確保跟蹤最新進展。
3. 標識符管理：為每個來源添加儘可能多的標識符，以便於後續檢索和關聯。

🔧 技術細節

1. 數據匹配：採用模糊匹配算法，基於標題和類型進行來源識別。
2. 擴展性：支持自定義關係類型和實體分類，便於個性化需求。
3. 性能優化：通過索引優化查詢速度，確保高效的數據檢索。

🤝 貢獻指南

1. 參與項目：訪問我們的倉庫頁面，瞭解如何加入團隊。
2. 創建功能分支：為新功能開發獨立的代碼分支。
3. 添加測試用例：確保新增功能通過全面的測試驗證。
4. 提交拉取請求：將您的更改貢獻到主項目。