sciencemate/README.md

# ScienceMate

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

数据和计算都在**你自己的机器上**：项目是本地 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 10 / 11（64 位）

从 [Releases](https://desktop-9el2944.taile9f15e.ts.net/wangd/sciencemate/releases) 下 **`ScienceMate-Setup.exe`**，双击。

它会装到 `%LOCALAPPDATA%\Programs\ScienceMate` 并自己启动 —— **不需要管理员权限**。

第一次运行 Windows 会拦一下（应用还没买签名证书）：**「更多信息」→「仍要运行」**。每台机器只需要这一次。

---

## 装完第一件事

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

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

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

## 更新

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

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

## 你的东西放在哪

| | |
|---|---|
| macOS | `~/.harness-framework/` |
| Windows | `%LOCALAPPDATA%\afs\` |

里面是设置库（仅本人可读）、每个项目一个 git 仓库、以及出问题时要看的 `logs/backend.log`。

卸载 = 删掉应用（macOS 扔废纸篓；Windows 删 `%LOCALAPPDATA%\Programs\ScienceMate`）。数据留在上面那个目录，你自己决定要不要删。

## 系统要求

- **macOS** 13 或更新，Apple Silicon（M 系列）
- **Windows** 10 / 11，64 位
- 约 1.5 GB 磁盘
- 一个能用的模型 API key

Python、git、LaTeX 都随包带，**不用先装任何东西**，也不需要管理员权限。

## 出问题了

1. 看日志：macOS `~/.harness-framework/logs/backend.log`，Windows `%LOCALAPPDATA%\afs\logs\backend.log`
2. 应用自检 —— 它会印出数据根、界面、harness、git、PDF 引擎、版本、沙箱各在哪，有一项是 `not found` 就是它：

   ```sh
   # macOS
   "/Applications/ScienceMate.app/Contents/Resources/python/bin/python3" -m app.launcher doctor
   ```
   ```powershell
   # Windows
   & "$env:LOCALAPPDATA\Programs\ScienceMate\Resources\python\python.exe" -m app.launcher doctor
   ```
3. 还是不行，把上面两样发给我。

---

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