Researchtwin

🚀 ResearchTwin：科研知识的联邦智能网络

ResearchTwin 是一个开源的联邦平台，它能将研究人员的出版物、数据集和代码仓库转化为可对话的数字孪生体。该平台基于双模态神经胶质优化（BGNO）架构构建，支持人类与 AI 智能体协作，以加速科学发现。

在线平台：researchtwin.net | 加入网络

🚀 快速开始

托管模式（第 3 层） — 零配置

1. 访问 researchtwin.net/join.html
2. 使用您的姓名、电子邮件和研究标识符进行注册
3. 您的数字孪生体将立即上线

本地节点（第 1 层） — 完全控制

git clone https://github.com/martinfrasch/researchtwin.git
cd researchtwin
pip install -r backend/requirements.txt
cp node_config.json.example node_config.json
# 使用您的详细信息编辑 node_config.json
python run_node.py --config node_config.json

Docker 部署

cp .env.example .env  # 添加您的 API 密钥
docker-compose up -d --build

所需 API 密钥：ANTHROPIC_API_KEY（用于 Claude RAG） 可选：S2_API_KEY、GITHUB_TOKEN、DISCORD_BOT_TOKEN、SMTP 凭证

✨ 主要特性

• 整合多模态研究成果：集成来自 Semantic Scholar、Google Scholar、GitHub 和 Figshare 的多模态研究成果。
• 实时计算 S-Index 指标：跨所有输出类型实时计算 S-Index 指标（质量 × 影响 × 协作）。
• 交互式研究探索：提供对话式聊天机器人界面，用于交互式研究探索。
• 支持机器间研究发现：通过带有 Schema.org 类型的 Inter - Agentic Discovery API 支持机器间的研究发现。
• 联邦式架构：采用类似 Discord 的 联邦式架构，支持本地节点、中心节点和托管边缘节点。

📦 安装指南

托管模式（第 3 层）

访问 researchtwin.net/join.html 进行注册，即可立即使用。

本地节点（第 1 层）

git clone https://github.com/martinfrasch/researchtwin.git
cd researchtwin
pip install -r backend/requirements.txt
cp node_config.json.example node_config.json
# 使用您的详细信息编辑 node_config.json
python run_node.py --config node_config.json

Docker 部署

cp .env.example .env  # 添加您的 API 密钥
docker-compose up -d --build

💻 使用示例

嵌入 S-Index 小部件

在您的实验室网站、Google Sites 页面或个人主页上展示您的 S-Index：

<iframe
  src="https://researchtwin.net/embed.html?slug=YOUR-SLUG"
  width="440" height="180"
  style="border:none; border-radius:12px;"
  loading="lazy">
</iframe>

将 YOUR - SLUG 替换为您的研究人员标识符（例如 martin - frasch）。

Google Sites：编辑页面 > 插入 > 嵌入 > “按 URL” 标签 > 粘贴 https://researchtwin.net/embed.html?slug=YOUR-SLUG

WordPress：添加自定义 HTML 块并粘贴 iframe 代码。

小部件将显示研究人员的姓名、S-Index 分数、h 指数、引用次数和论文数量。数据将从实时 API 源自动更新。

查看实际效果 | 完整嵌入说明

📚 详细文档

🔧 技术细节

BGNO（双模态神经胶质优化）

数据来源          神经胶质层          神经层         接口层
┌──────────────┐    ┌─────────────┐    ┌──────────────┐    ┌────────────┐
│Semantic Scholar│───▶│             │    │              │    │  网页聊天  │
│Google Scholar │───▶│  SQLite     │───▶│  RAG with    │───▶│  Discord   │
│GitHub API     │───▶│  缓存 +    │    │  Claude API  │    │  智能体 API │
│Figshare API   │───▶│  速率限制 │    │              │    │  嵌入组件  │
└──────────────┘    └─────────────┘    └──────────────┘    └────────────┘

• 连接器层：拉取论文（S2 + GS 去重）、代码仓库（GitHub）、数据集（Figshare）和 ORCID 元数据。
• 神经胶质层：SQLite 缓存，TTL 为 24 小时，速率限制，S2 + GS 标题相似度合并（阈值 0.85）。
• 神经层：使用 Claude 的 RAG — 上下文组装、提示工程、对话合成。
• 接口层：D3.js 知识图谱、聊天小部件、Discord 机器人、REST API。

联邦网络层级

智能体间发现 API

带有 Schema.org @type 注释的机器可读端点：

仓库结构

researchtwin/
├── backend/
│   ├── main.py              # FastAPI 端点（REST + 发现 API）
│   ├── researchers.py        # SQLite 研究人员 CRUD + 令牌管理
│   ├── database.py           # SQLite 架构、WAL 模式、迁移
│   ├── models.py             # 所有端点的 Pydantic 模型
│   ├── rag.py                # 用于 Claude 的 RAG 上下文组装
│   ├── qic_index.py          # S-Index / QIC 计算引擎
│   ├── email_service.py      # 用于配置文件更新代码的 SMTP 服务
│   ├── connectors/           # 数据源连接器
│   │   ├── semantic_scholar.py
│   │   ├── scholarly_lib.py  # 通过 scholarly 访问 Google Scholar
│   │   ├── github_connector.py
│   │   └── figshare.py
│   └── discord_bot/          # 带有 /research 和 /sindex 的 Discord 机器人
├── frontend/
│   ├── index.html            # 带有 D3.js 知识图谱的主仪表板
│   ├── join.html             # 自助注册页面
│   ├── update.html           # 电子邮件验证的配置文件更新页面
│   ├── privacy.html          # 隐私政策页面
│   └── widget-loader.js      # 可嵌入的聊天小部件
├── run_node.py               # 第 1 层本地节点启动器
├── node_config.json.example  # 本地节点配置模板
├── docker-compose.yml        # Docker 编排文件
├── nginx/                    # Nginx 反向代理 + SSL
└── whitepaper.tex            # LaTeX 手稿

📄 许可证

本项目采用 MIT 许可证。详情请见 LICENSE。

👥 贡献

欢迎贡献代码！请查看 项目看板 以了解跟踪的问题。

• 新的连接器（ORCID 增强、PubMed、OpenAlex）
• 基于隶属关系的地理映射
• 用于智能体间发现的 MCP 服务器
• UI/UX 改进
• 错误修复和优化

📞 联系我们

• 平台：researchtwin.net
• 邮箱：martin@researchtwin.net
• 问题反馈：GitHub Issues

赋能研究人员和 AI 智能体共同发现、协作和创新。