144 lines
5.3 KiB
Markdown
144 lines
5.3 KiB
Markdown
# 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. 还是不行，把上面两样发给我。
|
||
|
||
---
|
||
|
||
*内部试用版。发布件仓库，不含源码。*
|