sciencemate/README.md

# Agent for Science 科研平台

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

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

---

## macOS 安装

一条命令（Apple Silicon）：

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

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

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

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

先看再跑：

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

</details>

## Windows 安装

一条命令（PowerShell）：

```powershell
irm https://desktop-9el2944.taile9f15e.ts.net/wangd/sciencemate/raw/branch/main/install.ps1 | iex
```

装完会自己打开。**不会弹「Windows 已保护你的电脑」** —— SmartScreen 只拦带「网络来源标记」的文件，那个标记是浏览器打的，这条路用 `Invoke-WebRequest`，不打。

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

脚本只做四件事：下载 `Setup.exe` → 用 `SHA256SUMS` 核对 → 去掉网络来源标记 → 运行安装器（自解压到 `%LOCALAPPDATA%\Programs\AgentForScience` 并启动）。任何一步失败就停。

先看再跑：

```powershell
irm https://desktop-9el2944.taile9f15e.ts.net/wangd/sciencemate/raw/branch/main/install.ps1 -OutFile install.ps1
notepad install.ps1
.\install.ps1
```

只想看它打算做什么、先不动手：`$env:AFS_DRY_RUN=1; .\install.ps1`
只装不启动：`$env:AFS_NO_LAUNCH=1; .\install.ps1`

也可以从 [Releases](https://desktop-9el2944.taile9f15e.ts.net/wangd/sciencemate/releases) 直接下 `AgentForScience-Setup.exe` 双击。走浏览器下载的话，第一次运行 SmartScreen 会拦一下：**更多信息 → 仍要运行**。

**不需要管理员权限**，装在你自己的用户目录下。

</details>

> **双击启动后会有一个控制台黑窗** —— 那是壳（它负责起后端、开浏览器、退出时收摊）。**别关它**，关了后端就一起停了。内嵌窗口的版本还在做。

---

## 装完第一件事

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

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

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

## 更新

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

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

> Windows 版的自更新还没接（v0.4.0 只发了安装器）。有新版本时重新跑一次上面那条 `irm ... | iex` 即可，项目数据不受影响。

## 你的东西放在哪

**macOS**

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

**Windows**

```
%LOCALAPPDATA%\afs\           数据（同上三样）
%LOCALAPPDATA%\Programs\AgentForScience\   程序本体
```

卸载 = macOS 把「应用程序」里的图标扔进废纸篓；Windows 删掉 `%LOCALAPPDATA%\Programs\AgentForScience` 整个目录。两边数据都留在上面那个数据目录，你自己决定要不要删。

## 系统要求

|  | macOS | Windows |
|---|---|---|
| 版本 | 13 或更新，Apple Silicon（M 系列） | 10 / 11，64 位 |
| 磁盘 | 约 1.5 GB | 约 1 GB（装完 915 MB） |
| 权限 | 普通用户 | 普通用户，**不用管理员** |

两边都要一个能用的模型 API key。Python、git、LaTeX（tectonic）、跑实验用的 bash 都随包带，**不用先装任何东西**。

## 出问题了

1. 看日志最后几十行：
   - macOS：`~/.harness-framework/logs/backend.log`
   - Windows：`%LOCALAPPDATA%\afs\logs\backend.log`
2. 应用自检：

   macOS
   ```sh
   "/Applications/Agent for Science.app/Contents/Resources/python/bin/python3" -m app.launcher doctor
   ```
   Windows
   ```powershell
   & "$env:LOCALAPPDATA\Programs\AgentForScience\Resources\python\python.exe" -m app.launcher doctor
   ```

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

---

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