PureTavern

PureTavern 是一个以 SillyTavern 为上游的第三方客户端，采用“纯前端 + 可选后端”的设计。

当前版本默认不依赖后端服务，可以直接部署到 Cloudflare Pages、GitHub Pages 或其他静态托管平台；同时提供 Python、Node.js、Go 三种可选远程代理，以及 Android、iOS、HarmonyOS、桌面和 VS Code 外壳的本地传输。

PureTavern 是独立第三方项目，不是 SillyTavern 官方发行版。

在线演示

https://pure-tavern.netlify.app/

https://pure-tavern.pages.dev/

密钥与隐私（重点）

PureTavern 默认使用纯前端模式，API Key 等密钥保存在用户当前浏览器的 IndexedDB 中，不会上传到项目维护者的服务器。前端模式下，模型密钥只发送给用户主动配置的模型服务商；用户主动启用远程后端模式后，最终上游 URL、请求头（包含 Provider Key）和请求体会先发送给用户配置并信任的远程后端，再由其转发给模型服务商。

密钥的本地保存不等于安全加密：同源脚本、用户安装的第三方扩展、浏览器插件、开发者工具或被篡改的部署站点仍可能读取密钥。请使用可信部署并谨慎安装第三方扩展。

特点

不需要运行 SillyTavern Node.js 服务端；
保留原版 SillyTavern 界面、提示词系统和前端扩展兼容层；
首次启动时从应用内离线导入酒馆助手 4.8.19 和 Prompt Template 1.16，之后不重复安装或覆盖用户选择；
角色、聊天、设置、世界书、预设、密钥和资源保存在浏览器 IndexedDB；
支持本地 ZIP 数据导入、导出和恢复点；
支持浏览器直连允许 CORS 的聊天补全服务平台；
可选使用带访问 Key 的 Python、Node.js 或 Go 远程代理转发聊天补全请求并透传 SSE；
Android、iOS、HarmonyOS、Windows/macOS/Linux 和 VS Code 支持 shell 内本地后端传输，不复制 Provider 业务逻辑；
使用 Service Worker 和 Build ID 缓存静态资源，同版本重复访问无需逐文件校验；
为未来的远程备份、Vault 和其他私网模型桥接继续保留扩展接口。

架构

SillyTavern Legacy UI
        │
PureTavern Compatibility Hook
        │
Feature Modules / Capability Ports
        │
IndexedDB + Service Worker + Browser/Shell/Remote Transport
        │
Optional Native Shell Bridge or Python/Node.js/Go Remote Proxy

Legacy UI：继续使用上游 SillyTavern 的界面和纯前端业务逻辑；
Compatibility Hook：在浏览器中接管原版 /api/** 请求；
Feature Modules：按角色、聊天、设置、资源、扩展等能力拆分；
Browser Storage：业务数据写入 IndexedDB，静态代码使用 CacheStorage；
Optional Backend：已实现聊天补全的 shell 本地传输和远程 CORS 代理；后端只发包，Provider 构造与响应处理仍在前端。远程备份和 Vault 仍待后续实现。

开发与构建

pnpm install
pnpm dev

开发服务默认监听 http://127.0.0.1:8899/，端口被占用时会直接报错，不会自动回退到其他端口。

生产构建：

pnpm build

静态产物位于：

apps/web/dist

这是不绑定托管服务商的通用静态产物，可以部署到 Cloudflare Pages、GitHub Pages、普通静态服务器，也会直接作为 Android 外壳的 Web 内容。

远程代理（可选）

参考后端位于 apps/remote-server，提供 Python、无第三方生产依赖的 Node.js，以及可打包为跨平台单文件的 Go 实现。它们只代理前端已经构造好的最终聊天补全 HTTP 请求，不存储 URL、访问 Key、Provider Key 或请求内容。以下是 Python 快速启动示例：

cd apps/remote-server/python
python -m pip install -r requirements.txt
$env:PURE_TAVERN_PROXY_KEY = "替换为随机访问密钥"
python -m uvicorn app:app --host 0.0.0.0 --port 8000

局域网 IP、CORS、HTTPS 和安全配置见该目录的 README。远程后端模式下，连接 URL、Key 和模式目前只保存在页面内存中，刷新后不会保留。

Android APK

Android 外壳位于 apps/mobile，只消费 apps/web/dist，不包含 Provider 业务逻辑；平台目录仅实现文件保存与 HttpURLConnection 本地传输。更新 Web 业务代码后无需修改 Java Provider 逻辑。

# 构建 Web 并同步到 Android
pnpm android:sync

# 构建可安装的 Debug APK
pnpm android:debug

# 同步后用 Android Studio 打开
pnpm android:open

本地 Android 构建需要 JDK 21、Android SDK Platform 36 和 Build Tools 36。APK 输出位置：

apps/mobile/android/app/build/outputs/apk/debug/app-debug.apk

GitHub Actions 不会在提交代码时自动打包。需要 APK 时，在仓库的 Actions → Build Android APK → Run workflow 中手动触发，完成后下载 Debug APK artifact。Debug APK 适合测试；正式发布仍需配置私有签名密钥并构建 Release APK/AAB。

iOS IPA

同一个 apps/mobile Capacitor 外壳也包含 iOS Xcode 工程，继续消费 apps/web/dist，并通过薄 URLSession 插件提供相同本地传输协议：

pnpm ios:sync
pnpm ios:open # 仅 macOS

GitHub Actions 的 Build iOS IPA workflow 仅手动触发，在 macOS runner 生成 unsigned IPA。未签名 IPA 需要用户自行签名；App Store/TestFlight 发布必须配置 Apple Developer 证书和 Provisioning Profile。

HarmonyOS NEXT HAP

HarmonyOS NEXT 6.1.0(23) ArkTS Stage 外壳位于 apps/harmony，只消费 apps/web/dist。ArkWeb 通过 https://puretavern.local/ 本地同源和 rawfile 请求拦截加载完整 Web 产物，NetworkKit 提供 shell 本地传输，业务 Feature Modules 不感知鸿蒙平台。

# 构建 Web 并同步到 Harmony rawfile
pnpm harmony:sync

# 已安装 DevEco/Harmony CLI 时构建 HAP
pnpm harmony:build

GitHub Actions 的 Build HarmonyOS NEXT HAP workflow 仅手动触发，不需要填写版本号；它会自动读取根 package.json 的当前版本，在 ubuntu-22.04 安装固定版本 HarmonyOS Linux command-line-tools 并生成：

PureTavern-<version>-harmonyos-next-arm64-unsigned.hap

该 HAP 默认未签名。安装到真机或发布到应用市场前，必须配置 HarmonyOS 调试或发布签名；证书、Profile、密钥库和密码不得提交到仓库。

桌面端

Tauri 2 桌面外壳位于 apps/desktop，同样只消费 apps/web/dist。一套 Rust reqwest 传输支持 Windows、macOS 和 Linux，Feature Modules 不感知桌面平台。

# 构建 Web 并打开桌面开发窗口
pnpm desktop:dev

# 构建当前系统的桌面程序和安装包
pnpm desktop:build

桌面产物位于 apps/desktop/src-tauri/target/release。GitHub Actions 的 Build Desktop Bundles workflow 仅手动触发，可生成 Windows x64 NSIS 安装版与便携 EXE、macOS x64/ARM64 DMG，以及 Linux x64 AppImage、DEB 和 RPM 测试包。

VS Code 扩展

apps/vscode-extension 将同一份 apps/web/dist 内置到 VSIX。点击 Activity Bar 的 PT 图标会打开或激活唯一的 PureTavern 编辑器标签页；扩展 Host 的受令牌保护 localhost 代理提供本地传输和 SSE。

pnpm vscode:build
pnpm vscode:package

扩展 ID 为 lianues.pure-tavern，作者为 Limerence。可以从以下扩展市场安装和体验：

GitHub Actions 的 Build VS Code Extension workflow 仅手动触发。

测试版发布

GitHub Actions 的 Build Test Release workflow 用于手动创建一次完整测试版发布。运行时填写不带 v 的稳定版本号，例如 0.2.0。

CI 会先构建并验证以下产物：

PureTavern-<version>-web.zip；
PureTavern-<version>-android-universal.apk（测试签名）；
PureTavern-<version>-windows-x64-setup.exe；
PureTavern-<version>-windows-x64-portable.exe；
PureTavern-<version>-macos-x64.dmg；
PureTavern-<version>-macos-arm64.dmg；
PureTavern-<version>-linux-x64.AppImage；
PureTavern-<version>-linux-x64.deb；
PureTavern-<version>-linux-x64.rpm；
PureTavern-<version>-ios-unsigned.ipa；
PureTavern-VSCode-<version>.vsix。

只有全部平台成功后，CI 才会：

创建 chore(test-release): 0.2.0 版本提交；
创建 test-v0.2.0 annotated tag；
创建标题为 0.2.0 Test、正文为空的 GitHub Prerelease；
上传上述全部标准化平台包。

构建期间如果 main 已前移，发布阶段会拒绝提交和打 Tag，避免用过期源码创建 Release。当前测试版移动端和桌面端没有正式发布者签名：Android 为 Debug APK，iOS 为 unsigned IPA，桌面包会触发对应系统的未签名应用警告。

浏览器限制

纯 Web 前端模式无法绕过目标服务的 CORS、TLS 和 Private Network Access 策略。远程代理可以绕过 Provider CORS，但普通浏览器到代理本身仍受 CORS、TLS、Mixed Content 和 PNA 限制；HTTPS 网页通常必须使用 HTTPS 代理，网页代码无法关闭该限制。Android、iOS、HarmonyOS、桌面和 VS Code 外壳会通过各自的 host bridge 访问用户配置的 HTTP/HTTPS 地址，但 HTTP 会明文暴露代理 Key、Provider Key、提示词和响应，仅适合可信测试局域网。当前浏览器密钥存储与远程后端运行时 Key 都不应视为安全 Vault。

许可证

PureTavern 使用 AGPL-3.0 许可证。

项目包含或衍生自 SillyTavern 的上游资源时，同时遵循对应的上游许可证和署名要求。

社区支持

LinuxDO

Lianues/PureTavern

Measured star growth

About

README.md