跳到主要内容

安装与更新

普通用户应优先使用 GitHub Releases 提供的桌面安装包。贡献者或需要调试最新版功能的用户可以从源码启动。Open-Science 是 Electron 应用，渲染层同时支持受令牌保护的本地 Web 访问。

阅读平台
选择会在章节间保留。

选择安装方式​

下载安装包​

  1. 打开 Open-Science Releases。
  2. 选择与你的操作系统和 CPU 架构对应的安装包。
  3. 阅读安装器显示的许可说明并完成安装，再启动应用；首次运行会进入五步 Onboarding。
  4. 若系统拦截未签名应用，请只从 AIPOCH 官方 GitHub 仓库重新下载，并按操作系统安全提示确认来源。

在发行页 Assets 中选择安装包，不要把自动生成的源码 ZIP 当成桌面安装包。可下载格式以该次发行实际提供的文件为准。

电脑确认架构文件选择与安装
macOS，Apple Silicon“关于本机”显示 Apple M 系列芯片选择 mac-arm64.dmg，打开后将应用拖入 Applications，再从该目录启动
macOS，Intel“关于本机”显示 Intel 处理器选择 mac-x64.dmg，安装到 Applications；应用要求 macOS 12 或更高版本

通过 Homebrew 安装

也可以通过 Homebrew 安装：

brew install --cask open-science

Homebrew 自动选择 Apple Silicon 或 Intel。安装后在 Settings → General → About 检查实际版本，包管理器可能安装比文档基线更新的版本。标签版本安装说明。

安装位置用于存放应用程序；向导中的 Data location 用于科研文件和运行环境，两者分别设置。安装后继续首次设置。

从源码运行​

要求：Git、Node.js 22、npm，以及 Electron 在当前平台的构建前提。代理框架可在应用中安装或选择。仓库会在安装阶段生成 Prisma Client、应用补丁并准备 Electron 原生依赖。

需要复现源码安装时，先从 Changelog 确定目标发布标签，再安装依赖。默认克隆跟随分支，不会固定到某个发布版本。记录所选标签、源码提交及运行时版本，便于他人复现环境。

将下方 RELEASE_TAG 替换为所选发行页的完整标签（包括开头的 v）。如果需要跟随开发分支，省略 --branch RELEASE_TAG --depth 1；这条路线会使用默认分支。

git clone --branch RELEASE_TAG --depth 1 https://github.com/aipoch/open-science.git
cd open-science
npm install
npm run dev

构建生产包前先运行：

npm run build

npm run build 会依次完成 TypeScript 检查以及 renderer、preload、main 三个 Electron 构建目标。若只想验证 Web/headless 入口，应使用仓库已有的 headless 参数和单独的数据目录，避免测试数据进入默认存储。

完成首次配置​

首次运行需要的外部能力​

能力是否必需用途
OpenCode、Claude Agent、Codex 或 CodeBuddy至少一个驱动对话式 agent session
模型接入执行代理请求时必需可用支持的订阅或 API 提供方；订阅无需单独 API 密钥
Python / R可选Notebook 代码执行；可以使用检测到的系统环境或应用管理环境
网络推荐安装运行时、连接 Provider、GitHub、远程服务和 MCP Connectors
SSH 主机可选Compute 面板中的远程任务与结果回收

本地数据​

首次设置显示用于产物、Notebook 文件和运行环境等大型科研文件的托管数据位置。应用设置和对话历史仍保存在配置位置，迁移科研数据目录不等于完整备份应用。不要与源码仓库混用；需要迁移时使用存储，不要在应用运行时手动移动内部文件。

确认安装可用​

应用能够打开、Environment 必需检查通过、代理已安装、模型连接通过，才能执行代理请求。模型接入可以使用支持的订阅或 API；Codex 订阅不要求另行购买 API 密钥。需要执行 Python/R 时还要准备相应运行时，能预览 CSV 或 PDF 并不表示 Notebook 可运行。

接着阅读首次设置与提供方及本地模型设置。

检查应用更新​

在 Settings → General → About 检查安装版本，点击 Check now 查询更新。安装前确认目标版本并完成正在运行的任务。源码开发版与打包安装版的更新表现可能不同。更新前保留重要输出的导出副本，不要手动重命名应用内部数据目录。

出现 Install Open-Science before updating 时，应用正在只读位置运行。选择 Install in Applications，或通过 Finder 将应用移入 Applications。安装完成后使用 Restart，或退出当前副本、从 Applications 重新打开，再检查更新。Continue using 只会继续使用当前副本，不会让该位置变为可更新。安装失败时先按显示的错误处理。

排查安装与启动问题​

失败位置首先检查
安装包或应用启动核对下载来源、操作系统与 CPU 架构，再阅读系统提示
源码安装确认 node --version、npm --version 可用，npm install 已完成；依赖下载中断时重试
首次配置阅读 Environment 中未通过的检查，解决其提示的具体要求
首次代理请求确认 Agent 为 Active/Ready，并在 Model 页面执行 Test connection
提供方或本地浏览器连接检查报错中的端口、代理或证书信息，参见故障排查
最后于 更新