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 智能體共同發現、協作和創新。