Agent for Science 科研平台

装上、打开、说一句你想研究什么 —— 它自己写代码、跑计算、看结果、出论文。

数据和计算都在你自己的机器上：项目是本地 git 仓库，模型 key 只存在本机。

---

macOS 安装

一条命令（Apple Silicon）：

curl -fsSL https://desktop-9el2944.taile9f15e.ts.net/wangd/agent-for-science/raw/branch/main/install.sh | sh

装完会自己打开。不会弹「无法验证开发者」 —— 那个提示只对浏览器下载的文件出现，这条路用 curl，系统不会拦。

想先看脚本做什么，或者手动装

脚本只做五件事：下载 dmg → 用 SHA256SUMS 核对 → 挂载 → 复制进「应用程序」→ 打开。任何一步失败就停。

先看再跑：

curl -fsSL https://desktop-9el2944.taile9f15e.ts.net/wangd/agent-for-science/raw/branch/main/install.sh -o install.sh
less install.sh
sh install.sh

只想看它打算做什么、先不动手：AFS_DRY_RUN=1 sh install.sh

也可以从 Releases 直接下 .dmg 拖进「应用程序」。走浏览器下载的话，第一次打开会被系统拦（应用还没买签名证书）： 系统设置 → 隐私与安全性 → 拉到最下面「仍要打开」→ 再确认一次。每台机器只需要这一次。

Windows

打包器已经能出便携目录和安装器，但还没在这里发布。先用 macOS 版。

---

装完第一件事

打开后它问两个问题，第二个可以跳过：

1. 用哪个模型 —— 填提供商、地址、API key。key 加密后存在这台机器上，不发去别处。
2. 有没有组织服务器 —— 一个人用直接跳过。

然后就可以新建项目、开始提问了。

更新

应用自己会看有没有新版本，有就在界面上出一行「有新版本 · 现在更新」。点一下，它下载、校验签名、重启自己。更新只换程序，不碰你的项目数据。

发布件都带 ed25519 签名，签名对不上一律拒收。

你的东西放在哪

~/.harness-framework/
  db.sqlite            设置与索引（仅本人可读）
  project-worktrees/   每个项目一个 git 仓库
  logs/backend.log     出问题时看这里

卸载 = 把「应用程序」里的图标扔进废纸篓。数据留在上面那个目录，你自己决定要不要删。

系统要求

• macOS 13 或更新，Apple Silicon（M 系列）
• 约 1.5 GB 磁盘
• 一个能用的模型 API key

Python、git、LaTeX 都随包带，不用先装任何东西。

出问题了

1. 看 ~/.harness-framework/logs/backend.log 最后几十行
2. 应用自检：

   "/Applications/Agent for Science.app/Contents/Resources/python/bin/python3" -m app.launcher doctor
   

   它会印出数据根、界面、harness、git、PDF 引擎、版本、沙箱各在哪 —— 有一项是 not found 就是它。
3. 还是不行，把上面两样发给我。

---

内部试用版。发布件仓库，不含源码。