暖酒馆（Warm Tavern）

手机端「酒馆式」AI 角色聊天应用。全中文界面、大控件、暖色治愈风；支持 OpenAI 兼容 API（默认 DeepSeek），数据默认仅保存在本机。

功能亮点

• 角色卡：创建 / 编辑；导入导出 JSON；支持酒馆 PNG 卡
• 对话：流式输出、停止、重新生成、Swipe 换回复、编辑与删除消息、多会话
• 人设 & 世界书：用户 Persona；关键词 / 常驻条目注入
• API：自备密钥（BYOK）；自定义 Base URL 与模型
• 体验：晦涩参数带中文说明；可导入聊天背景；护眼暖色主题

更完整的规划见 docs/PRODUCT.md。

下载安装

1. 打开 Releases 下载最新 warm_tavern-*.apk
2. 在 Android 上允许「安装未知应用」后安装

源码仓库不包含 APK 二进制，正式包仅通过 Release 分发。

快速开始（使用）

1. 打开 设置 → 填写 API：
   • 地址：https://api.deepseek.com/v1（默认）
   • 模型：deepseek-chat（默认）
   • 密钥：你的 DeepSeek / 兼容服务 Key
2. 可选：点「测试连接」
3. 角色 → 选择示例「小暖」或导入角色卡 → 开始聊天

从源码构建

环境要求

• Flutter stable（3.24+，开发验证：3.44）
• JDK 17
• Android SDK（建议 compileSdk 36）

构建步骤

git clone https://github.com/8867899/warm-tavern.git
cd warm-tavern
flutter pub get
flutter run                 # 调试
flutter build apk --release # 发布 APK

产物路径：

build/app/outputs/flutter-apk/app-release.apk

Windows 提示

若工程在 D:、Pub 缓存在 C:，Kotlin 增量编译可能因跨盘路径失败。可将 PUB_CACHE 设到与工程同盘，或在 android/gradle.properties 中保持 kotlin.incremental=false（本仓库已配置）。

项目结构

lib/
  core/          # 主题、存储、API 客户端
  models/        # 数据模型
  providers/     # 应用状态
  screens/       # 页面（角色 / 对话 / 世界书 / 人设 / 设置）
  services/      # 提示词构建、角色卡解析
  widgets/       # 通用组件
assets/images/   # 默认背景与应用图标
docs/            # 产品与设计说明

隐私

• 聊天、角色、设置默认仅存本机
• API 密钥使用系统加密存储（不可用时回退本地偏好）
• 不会把你的 Key 上传到本项目维护者的服务器
• 对话内容仅发送到你配置的 API 地址

请勿在 Issue / PR 中粘贴真实密钥。详见 SECURITY.md。

贡献

欢迎 Issue 与 PR。请先阅读 CONTRIBUTING.md 与 CODE_OF_CONDUCT.md。

版本与更新日志

见 CHANGELOG.md。

许可证

MIT © 2026 8867899

致谢

• 交互灵感来自开源社区中的酒馆类前端（如 SillyTavern）
• Flutter 与各插件维护者