📦 使用包管理器安装（Windows · macOS · Linux · Canary）
在 PowerShell 中运行：
scoop bucket add Darkatse https://github.com/Darkatse/Scoop-Darkatse.git
scoop install Darkatse/TauriTavernTauriTavern 正在等待 Homebrew Cask 审核。审核完成前，请使用上方下载按钮获取 macOS 安装包。
Arch Linux · AUR
使用你喜欢的 AUR 助手安装 tauritavern-bin：
yay -S tauritavern-bin该软件包由 @LX2000WASD 维护，感谢他在 TauriTavern-aur 中的持续维护贡献！
Debian · Ubuntu · Fedora · openSUSE · NixOS
脚本会自动识别系统并选择合适的安装方式，也支持其他已经安装 Nix 的 Linux。
稳定版
curl -fsSL https://raw.githubusercontent.com/Darkatse/TauriTavern/main/scripts/install-linux.sh | shCanary
curl -fsSL https://raw.githubusercontent.com/Darkatse/TauriTavern/main/scripts/install-linux.sh \
| sh -s -- --channel canaryNix / NixOS
已经安装 Nix 的用户可以直接加入当前用户 profile：
# 稳定版
nix profile add github:Darkatse/TauriTavern#tauritavern
# Canary
nix profile add github:Darkatse/TauriTavern/Canary#canaryCanary 包含最新改进，也可能不如稳定版可靠。Windows、macOS 和移动平台可从 Canary Release 下载。
Tip
iOS 用户：通过 TestFlight 公开外测 安装，需要 iOS 16 或更高版本。请注意 TestFlight 版本需要遵守苹果的 TestFlight 规则，存在使用限制。
Windows 便携版（Portable）：需系统已安装 WebView2 运行时。
TauriTavern 把 SillyTavern 移植为真正的原生应用：前端完整保留上游体验（已同步 1.18.0），后端从 Node.js 重构为 Rust（Tauri v2）。
不需要安装 Node.js，不需要命令行，安装即用。你的角色卡、聊天记录、预设、世界书与前端扩展，全部兼容。
注：TauriTavern 是独立维护的开源项目，并非 SillyTavern 官方客户端。TauriTavern 完全免费且开源，遵循 AGPL-3.0 许可协议。请在使用前仔细阅读许可条款。
- 🖥️ 全平台原生：Windows、macOS、Linux、Android、iOS，桌面与移动同一份体验
- 🎭 完整 SillyTavern 体验：前端同步上游 1.18.0，数据格式与目录布局完全兼容
- 🧩 前端扩展生态：内置原生 Git，安装、更新、切换分支都在界面内完成（不支持上游 Node-only 后端插件）
- 🔄 内置多设备同步：局域网加密配对同步，或经远端 TT-Sync v2 自动上传
- 🤖 Agent 框架：工具调用、Skills、子代理与运行时间线，持续演进中
- 📦 一键迁移：SillyTavern 数据导出脚本 + 应用内导入，平滑搬家
- ⚡ 性能工程：分阶段启动、聊天虚拟DOM加载，超长聊天记录依然流畅
- 🔒 数据自主：数据完全保存在本地，支持便携模式
本项目 Rust 后端是遵循 Clean Architecture 的 Cargo workspace（src-tauri/crates/）：
tauritavern：Tauri host、命令层与组合根tt-application·tt-ports·tt-domain·tt-contracts：用例、端口、领域模型与跨 crate 契约tt-adapter-*：存储、HTTP、媒体、同步、扩展、分词等具体实现
前端为上游 SillyTavern + 模块化 Tauri 注入层（src/tauri/main/），经 window.__TAURITAVERN__ 平台 ABI 与 Rust 后端通信。详情请见 docs/BackendStructure.md 与 docs/FrontendGuide.md。
🛠 开发与构建（前置要求 · 常用命令 · Tauri Pilot · 便携构建 · FasTools）
前置要求：Rust stable（支持 edition 2024）· Node.js 20.19.x 或 22.12+ · pnpm · Tauri CLI
git clone https://github.com/Darkatse/TauriTavern.git
cd TauriTavern
pnpm install常用命令：
pnpm run check # 前端 guardrails/类型/契约 + Rust dev check
pnpm run web:build # 构建前端资源包（Rspack）
pnpm run tauri:dev # 桌面开发模式
pnpm run tauri:build # 构建桌面发行包
pnpm run android:dev # Android 开发模式
pnpm run ios:dev # iOS 开发模式Tauri Pilot（AI Agent 界面调试）
项目已接入 Tauri Pilot 的开发专用插件与权限。它让 AI Agent 通过可访问性快照检查和操作桌面端 WebView；普通开发与发行命令不会启用这项能力。
cargo install tauri-pilot-cli # 仅首次需要
pnpm run tauri:dev:pilot应用启动后，在另一终端按以下顺序操作：
tauri-pilot ping
tauri-pilot snapshot -i
tauri-pilot click @e3 # 使用当前 snapshot 返回的 ref
tauri-pilot diff -i
tauri-pilot logs --level error交互前先取得 snapshot，每次只执行一个操作；异步更新后使用 wait，并优先用 assert 验证结果。支持 MCP 的 Agent 可将 tauri-pilot mcp 注册为 stdio server。
便携版构建：pnpm run tauri:build:portable（默认输出至 release/）；运行时可通过 TAURITAVERN_RUNTIME_MODE=portable 或 portable.flag 强制启用便携策略。
FasTools：超级好用的开发与部署调试工具箱，强烈推荐。pnpm run fastools:build 进行构建，pnpm run fastools:run 运行。
- 📖 在线文档站：中英双语，含指南、Agent、架构、API 与下载
- docs/FrontendGuide.md：前端架构与扩展指南
- docs/FrontendHostContract.md：宿主层对外契约
- docs/BackendStructure.md：后端 Clean Architecture 与 crate 边界
- docs/CurrentState/：已落地模块的实现状态
欢迎 Issue 与 PR。提交前请阅读 CONTRIBUTING.md。除紧急修复外，PR 请以 dev 为目标分支。
基于 SillyTavern 与 Tauri 构建，并感谢 Cocktail、Tavern-Helper、LittleWhiteBox、MikTik，以及维护 TauriTavern AUR 软件包 的 @LX2000WASD。
以 AGPL-3.0 许可发布（与 SillyTavern 同系列许可协议）。
我们尽力用爱打造 ❤️ —— TauriTavern 团队