# Agent for Science 科研平台

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

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

---

## macOS 安装

一条命令（Apple Silicon）：

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

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

<details>
<summary>想先看脚本做什么，或者手动装</summary>

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

先看再跑：

```sh
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](https://desktop-9el2944.taile9f15e.ts.net/wangd/agent-for-science/releases) 直接下 `.dmg` 拖进「应用程序」。走浏览器下载的话，第一次打开会被系统拦（应用还没买签名证书）：
**系统设置 → 隐私与安全性 → 拉到最下面「仍要打开」→ 再确认一次**。每台机器只需要这一次。

</details>

## 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. 应用自检：
   ```sh
   "/Applications/Agent for Science.app/Contents/Resources/python/bin/python3" -m app.launcher doctor
   ```
   它会印出数据根、界面、harness、git、PDF 引擎、版本、沙箱各在哪 —— 有一项是 `not found` 就是它。
3. 还是不行，把上面两样发给我。

---

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