<!-- Markdown version of https://seris.im/zh/docs/install/ -->

# 安装 Seris

Seris 以 DMG 形式提供,适用于 Apple Silicon 芯片的 Mac。从 GitHub 最新发布页下载 Seris_0.1.2_aarch64.dmg,把 Seris 拖到“应用程序”,在系统设置中允许首次启动,然后接入一个模型。

## 下载与安装

- 从[最新发布页](https://github.com/aowang-ai/seris/releases/latest)下载 [Seris_0.1.2_aarch64.dmg](https://github.com/aowang-ai/seris/releases/download/v0.1.2/Seris_0.1.2_aarch64.dmg)。
- 打开磁盘映像,把 Seris.app 拖到“应用程序”。
- 从“应用程序”打开 Seris。

## 首次启动

Seris 采用 ad-hoc 签名,未经 Apple 公证。若首次启动被拦截,前往 系统设置 → 隐私与安全性,为 Seris 选择“仍要打开”。具体步骤见 [Apple 支持文章](https://support.apple.com/102445)。

## 接入模型

打开 Settings → Models,配置提供商并选择默认模型。使用 Ollama 或 LM Studio 时,先启动本地服务。测试连接会发送一次简短的模型请求,可能产生提供商费用。各提供商的配置见[模型](https://seris.im/zh/docs/models/)。

## 升级

先退出 Seris,打开新的 DMG,替换“应用程序”中的应用。会话、模型元数据、自选、策略与回测结果都保存在应用包之外,升级后仍在。升级后 macOS 可能会请你授权访问钥匙串中已有的模型凭据。

## 从源码运行

需要 `.node-version` 中指定的 Node 版本、pnpm 12.5.1、Rust,以及你所用操作系统的 Tauri 构建依赖。

```
git clone https://github.com/aowang-ai/seris.git
cd seris
pnpm install --frozen-lockfile
pnpm tauri:dev
```

用 `pnpm typecheck` 与 `pnpm test` 检查,用 `pnpm tauri:build` 打包。单独开发 gateway 时,先运行 `pnpm build`,再运行 `pnpm core:gateway`;它会输出一次性的浏览器启动链接,没有模型凭据也能启动。

## 数据保存在哪里

桌面版把会话、设置、已安装的 skill、策略与生成的文件保存在系统应用数据目录中。可用 `SERIS_DATA_DIR` 指定其他目录,用 `SERIS_WORKSPACE` 指定 agent 的任务目录。模型 API key 存放在 macOS 凭据库中。

文档: https://seris.im/zh/docs/
