快速开始
三种运行方式、首次配置与数据落点
三种运行方式
ReinAgent 面向普通用户提供免安装的绿色单文件，面向开发者提供源码运行。三种方式共用同一份本地数据底座与配置目录。
| 方式 | 命令 / 入口 | 前置条件 |
|---|---|---|
| 桌面绿色版 | 前往 Releases 下载对应系统的可执行文件（Linux AppImage / 二进制、Windows 便携 .exe、macOS 应用） | 无需 Node.js / Python / Rust，解压或双击即跑 |
| 源码运行 | bun install 后执行 bun run tauri dev | 需要 Bun ≥ 1.1、Node.js ≥ 20、Rust stable |
| 正式打包 | bun run tauri build | 产物输出至 src-tauri/target/release/bundle/ |
源码运行
# 依赖安装（务必使用 Bun，仓库以 bun.lock 锁定版本）
bun install
# 开发模式：前端开发服务器 + Tauri 桌面窗口
bun run tauri dev项目使用 Bun（
bun@1.4.2 与 bun.lock）作为唯一包管理器。严禁使用 npm / pnpm 更改锁定文件。首次配置
启动后在设置中完成两件事即可开始工作：
| 配置项 | 说明 | 关键字段 |
|---|---|---|
| 模型供应商 | 预设 DeepSeek、OpenAI、Anthropic Claude、Google Gemini、Ollama、SiliconFlow 等，也可自由添加自定义兼容端点 | 服务商、API 格式、Base URL、API Key |
| 工作区项目 | 指定本地目录或 SSH 远程仓库作为 Agent 的工作范围 | 项目路径 |
API Key 保存在本地文件
~/.ReinAgent/provider_config.json，不上传任何三方服务器。数据落点
| 数据 | 位置 |
|---|---|
| 模型配置 | ~/.ReinAgent/provider_config.json |
| 会话与任务库 | ~/.ReinAgent/conversations.db（SQLite WAL） |
| 代码检查点 | ~/.ReinAgent/checkpoints/<taskId>/ |
| 知识库与笔记本 | ~/.ReinAgent/notebooks/（多层文件夹与真实 .md 文件） |
| 默认工作区 | ~/.ReinAgent/DefaultProject/ |