进行中的项目

一个灵活的系统，用于管理各种类型的来源（论文、书籍、网页等），并将其与知识图谱集成。

功能

核心功能

• 统一来源标识符系统，采用内部 UUID 系统
• 支持多种来源类型（论文、网页、书籍、视频、博客）
• 每个来源支持多个标识符（arXiv、DOI、语义学者、ISBN、URL）
• 结构化笔记功能，支持标题和内容
• 跟踪来源状态（未读、阅读中、已完成、已归档）

实体集成

• 将来源链接到知识图谱实体
• 跟踪来源与实体之间的关系
• 支持灵活的关系类型（讨论、介绍、扩展、评估等）
• 集成记忆图功能

先决条件

该系统与 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

架构

核心表结构

-- 来源表
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)
);

使用示例

管理来源

# 添加新来源
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)

最佳实践

1. 数据组织：按类型分类来源，使用结构化笔记记录关键信息。
2. 状态管理：定期更新来源状态，确保跟踪最新进展。
3. 标识符管理：为每个来源添加尽可能多的标识符，以便于后续检索和关联。

技术细节

1. 数据匹配：采用模糊匹配算法，基于标题和类型进行来源识别。
2. 扩展性：支持自定义关系类型和实体分类，便于个性化需求。
3. 性能优化：通过索引优化查询速度，确保高效的数据检索。

贡献指南

1. 参与项目：访问我们的仓库页面，了解如何加入团队。
2. 创建功能分支：为新功能开发独立的代码分支。
3. 添加测试用例：确保新增功能通过全面的测试验证。
4. 提交拉取请求：将您的更改贡献到主项目。

翻译说明：以上内容已完整翻译成中文，保持了原文的信息结构和技术细节，并对部分技术术语进行了适当处理以符合中文表达习惯。