研学港 Researchopia 用户指南

User Guide | 研学并进，智慧共享

📋 项目概述 | Project Overview

中文 | Chinese

研学港 Researchopia 是一个现代化的学术论文评分平台，旨在为研究者提供优质的学术资源评价和交流环境。我们致力于构建一个研究者的理想国，让学术智慧在这里汇聚和传播。


核心理念："研学并进，智慧共享"

官方网站：https://www.researchopia.com

English

Researchopia is a modern academic paper rating platform designed to provide researchers with high-quality academic resource evaluation and communication environment. We are committed to building an ideal research community where academic wisdom converges and spreads.


Core Philosophy: "Where Research Meets Community"

Official Website: https://www.researchopia.com

🔍
智能搜索 | Smart Search
Advanced paper search with multi-dimensional evaluation system
👥
研究社区 | Research Community
Professional platform for academic exchange and discussion
🔧
多平台工具 | Multi-platform Tools
Browser extensions and Zotero integration for seamless workflow

🌐 网站使用指南 | Website Usage Guide

基本功能 | Basic Features

功能介绍
  • 学术论文搜索：输入论文标题、DOI、作者或关键词进行智能搜索
  • 多维度评价：查看论文的引用指数、影响因子、同行评价等
  • 个性化推荐：基于研究兴趣获得相关论文推荐
  • 学者档案：查看研究者的学术贡献和研究方向
Feature Introduction
  • Academic Paper Search: Search by title, DOI, author, or keywords
  • Multi-dimensional Evaluation: View citation metrics, impact factors, peer reviews
  • Personalized Recommendations: Get relevant paper suggestions based on research interests
  • Scholar Profiles: Explore researchers' academic contributions and research areas

使用步骤 | Usage Steps

访问网站 | Access Website
打开浏览器，访问 https://www.researchopia.com
Open your browser and visit https://www.researchopia.com
搜索论文 | Search Papers
在搜索框中输入论文信息，支持DOI、标题、作者等多种搜索方式
Enter paper information in the search box, supporting DOI, title, author, and other search methods
查看结果 | View Results
浏览搜索结果，查看论文的详细信息、评分和相关指标
Browse search results, view detailed paper information, ratings, and related metrics
💡
小贴士 | Tips:
使用DOI搜索能获得最准确的结果 | Using DOI search provides the most accurate results

🔧 浏览器扩展 | Browser Extension

扩展简介

研学港浏览器扩展基于最新的 Manifest V3 规范开发，为学术研究者提供便捷的论文搜索和管理工具。扩展支持Chrome、Edge等主流浏览器，能够自动检测学术网页中的DOI并提供一键搜索功能。

Extension Overview

The Researchopia browser extension is developed based on the latest Manifest V3 specification, providing convenient paper search and management tools for academic researchers. The extension supports mainstream browsers such as Chrome and Edge, and can automatically detect DOIs in academic web pages and provide one-click search functionality.

主要功能 | Key Features

🔍
智能DOI检测 | Smart DOI Detection
自动识别网页中的DOI号码，支持多种格式和来源
📌
悬浮拖拽图标 | Floating Draggable Icon
常驻浮动图标，支持拖拽移动和边缘吸附
📖
集成侧边栏 | Integrated Sidebar
点击图标展开侧边栏，直接在页面中使用研学港功能

安装步骤 | Installation Steps

下载扩展文件 | Download Extension Files
从研学港项目中获取 extension 文件夹
Get the extension folder from the Researchopia project
打开扩展管理页面 | Open Extension Management
chrome://extensions/
在Chrome浏览器地址栏输入上述地址，或通过菜单"更多工具→扩展程序"进入
Enter the above address in Chrome's address bar, or access via menu "More tools → Extensions"
启用开发者模式 | Enable Developer Mode
打开页面右上角的"开发者模式"开关
Turn on the "Developer mode" toggle in the top right corner
加载扩展 | Load Extension
点击"加载已解压的扩展程序"，选择 extension 文件夹
Click "Load unpacked" and select the extension folder

使用方法 | Usage Instructions

基本使用流程
  1. 访问学术网页：打开包含DOI的学术论文页面（如Nature、Science、IEEE等）
  2. 自动检测：扩展会自动检测页面中的DOI号码
  3. 查看悬浮图标：检测成功时，悬浮图标会显示绿色指示器
  4. 打开侧边栏：点击悬浮图标打开研学港侧边栏
  5. 自动搜索：检测到的DOI会自动填入搜索框并执行搜索
Basic Usage Flow
  1. Visit Academic Pages: Open academic paper pages containing DOIs (e.g., Nature, Science, IEEE)
  2. Automatic Detection: The extension automatically detects DOI numbers on the page
  3. Check Floating Icon: When detection succeeds, the floating icon shows a green indicator
  4. Open Sidebar: Click the floating icon to open the Researchopia sidebar
  5. Automatic Search: Detected DOIs are automatically filled in the search box and executed

支持的网站 | Supported Websites

🔬
顶级期刊 | Top Journals
Nature, Science, Cell, The Lancet
📚
学术出版商 | Publishers
Springer, Elsevier, Wiley, IEEE
📖
学术平台 | Academic Platforms
arXiv, PubMed, ResearchGate, JSTOR
✅
扩展优势 | Extension Benefits:
• 基于Manifest V3，安全可靠 | Based on Manifest V3, secure and reliable
• 支持拖拽定位，用户体验佳 | Supports drag positioning, excellent user experience
• 响应式设计，适配各种屏幕 | Responsive design, adapts to various screens

📚 Zotero插件 | Zotero Plugin

插件简介

研学港Zotero插件专为Zotero 8设计，采用bootstrap架构，完美集成研学港功能到Zotero文献管理器中。插件在Zotero的条目面板中添加自定义区域，让用户可以直接在Zotero中查看论文的研学港评分和相关信息。

Plugin Overview

The Researchopia Zotero plugin is specifically designed for Zotero 8, using a bootstrap architecture to perfectly integrate Researchopia functionality into the Zotero reference manager. The plugin adds a custom section to Zotero's item pane, allowing users to view Researchopia ratings and related information directly within Zotero.

核心特性 | Core Features

🔗
条目面板集成 | Item Pane Integration
在Zotero条目详情中直接显示研学港信息
🔄
自动同步 | Auto Sync
选择文献条目时自动加载对应的论文评价数据
⚙️
灵活配置 | Flexible Configuration
支持自定义面板高度、加载超时等参数

系统要求 | System Requirements

兼容性要求
  • Zotero版本：Zotero 7.0 及以上（推荐Zotero 8 beta）
  • 操作系统：Windows、macOS、Linux
  • 网络连接：需要访问研学港服务器
  • 浏览器内核：基于Firefox Gecko引擎
Compatibility Requirements
  • Zotero Version: Zotero 7.0 and above (Zotero 8 beta recommended)
  • Operating System: Windows, macOS, Linux
  • Network Connection: Requires access to Researchopia servers
  • Browser Engine: Based on Firefox Gecko engine

安装方法 | Installation Methods

方法一：自动构建安装（推荐） | Method 1: Auto Build Installation (Recommended)

运行构建脚本 | Run Build Script
.\build.ps1
在 zotero-plugin 目录下运行PowerShell脚本
Run PowerShell script in the zotero-plugin directory
打开Zotero | Open Zotero
启动Zotero 8 beta，进入"工具→插件"菜单
Launch Zotero 8 beta, go to "Tools → Plugins" menu
安装插件文件 | Install Plugin File
点击"从文件安装插件"，选择生成的 researchopia-zotero-<version>.xpi 文件
Click "Install Plugin From File" and select the generated researchopia-zotero-<version>.xpi file

方法二：手动构建 | Method 2: Manual Build

创建XPI文件 | Create XPI File
# Linux/Mac zip -r researchopia-zotero.xpi . -x "*.git*" "README.md" "build.ps1" "*.xpi" "*.zip" # Windows Compress-Archive -Path * -DestinationPath researchopia-zotero.zip Rename-Item researchopia-zotero.zip researchopia-zotero.xpi
安装到Zotero | Install to Zotero
按照方法一的步骤2-3进行安装
Follow steps 2-3 from Method 1 for installation

使用指南 | Usage Guide

验证安装 | Verify Installation
安装成功后，重启Zotero，在任意文献条目的详情面板中应能看到"研学港 Researchopia"区域
After successful installation, restart Zotero. You should see the "研学港 Researchopia" section in any item's detail panel
选择文献条目 | Select Literature Item
在Zotero文库中点击任意含有DOI的文献条目
Click on any literature item with DOI in your Zotero library
查看研学港信息 | View Researchopia Info
插件会自动提取DOI并在研学港面板中加载对应的论文评价信息
The plugin automatically extracts DOI and loads corresponding paper evaluation information in the Researchopia panel

插件配置 | Plugin Configuration

可配置参数
  • 面板高度：默认70vh，可通过首选项调整
  • 加载超时：默认3000ms，适合网络环境调整
  • 服务器地址：支持切换到本地开发服务器
  • 自动刷新：选择条目时是否自动更新URL
Configurable Parameters
  • Panel Height: Default 70vh, adjustable via preferences
  • Load Timeout: Default 3000ms, adjustable for network environment
  • Server Address: Supports switching to local development server
  • Auto Refresh: Whether to automatically update URL when selecting items
// 配置示例 | Configuration Example extensions.researchopia.paneHeight = "80vh" extensions.researchopia.loadTimeoutMs = 5000
💡
使用技巧 | Usage Tips:
• 插件支持DOI、arXiv ID等多种标识符 | Supports DOI, arXiv ID and other identifiers
• 可在Zotero首选项中调整插件行为 | Plugin behavior can be adjusted in Zotero preferences
• 支持离线使用，但需要网络连接加载数据 | Supports offline usage, but requires network to load data

🚀 高级功能 | Advanced Features

API集成 | API Integration

开发者功能

研学港提供完整的API接口，支持第三方应用集成。开发者可以通过API获取论文评分、统计数据等信息，构建自定义的学术工具。

Developer Features

Researchopia provides comprehensive API interfaces supporting third-party application integration. Developers can obtain paper ratings, statistical data, and other information through APIs to build custom academic tools.

数据同步 | Data Synchronization

跨平台同步

用户的搜索历史、收藏列表、个人设置等数据可在不同设备和平台间同步，确保一致的使用体验。

Cross-platform Sync

User search history, favorites, personal settings and other data can be synchronized across different devices and platforms, ensuring a consistent user experience.

批量操作 | Batch Operations

📊
批量评分 | Batch Rating
同时处理多篇论文的评分和分析
📁
文献管理 | Literature Management
创建和管理个人文献集合
📈
统计报告 | Statistical Reports
生成研究领域的趋势分析报告

🛠️ 故障排除 | Troubleshooting

常见问题 | Common Issues

浏览器扩展问题 | Browser Extension Issues

扩展无法加载 | Extension Won't Load
解决方案：
  • 确保已启用开发者模式
  • 检查扩展文件夹是否完整
  • 重新加载扩展或重启浏览器
Solutions:
  • Ensure developer mode is enabled
  • Check if extension folder is complete
  • Reload extension or restart browser
DOI检测失败 | DOI Detection Failed
可能原因：
  • 页面DOI格式不标准
  • 网页加载未完成
  • 扩展权限不足
Possible Causes:
  • Non-standard DOI format on page
  • Page loading incomplete
  • Insufficient extension permissions

Zotero插件问题 | Zotero Plugin Issues

插件安装失败 | Plugin Installation Failed
解决步骤：
  1. 确认Zotero版本是否为7.0+
  2. 检查XPI文件是否损坏
  3. 尝试重新下载插件文件
  4. 以管理员权限运行Zotero
Solution Steps:
  1. Confirm Zotero version is 7.0+
  2. Check if XPI file is corrupted
  3. Try re-downloading plugin files
  4. Run Zotero with administrator privileges
面板无法显示 | Panel Won't Display
检查项目：
  • 网络连接是否正常
  • 文献条目是否包含DOI
  • 插件是否已启用
  • Zotero是否需要重启
Check Items:
  • Network connection is normal
  • Literature item contains DOI
  • Plugin is enabled
  • Zotero needs restart

性能优化 | Performance Optimization

优化建议
  • 网络环境：确保稳定的网络连接，避免频繁超时
  • 浏览器性能：定期清理浏览器缓存，关闭不必要的标签页
  • 系统资源：监控系统内存使用，避免资源不足影响扩展运行
  • 更新维护：及时更新扩展和插件版本，获取最新功能和修复
Optimization Suggestions
  • Network Environment: Ensure stable network connection, avoid frequent timeouts
  • Browser Performance: Regularly clear browser cache, close unnecessary tabs
  • System Resources: Monitor system memory usage, avoid resource shortage affecting extension operation
  • Update Maintenance: Timely update extension and plugin versions for latest features and fixes
⚠️
注意事项 | Important Notes:
• 如遇到问题请先查看浏览器控制台错误信息 | Check browser console error messages first when encountering issues
• 建议使用最新版本的浏览器和Zotero | Recommend using latest versions of browser and Zotero
• 定期备份重要的研究数据和设置 | Regularly backup important research data and settings

技术支持 | Technical Support

获取帮助

如果您在使用过程中遇到问题，可以通过以下方式获取支持：

  • 访问官方网站的帮助中心
  • 在GitHub项目页面提交Issue
  • 加入用户交流群组
  • 查阅详细的API文档
Get Help

If you encounter problems during use, you can get support through the following ways:

  • Visit the help center on the official website
  • Submit issues on the GitHub project page
  • Join user community groups
  • Consult detailed API documentation