TauriTavern/docs/TechStack.md

TauriTavern 技术栈文档

本文档详细描述TauriTavern项目使用的技术栈和依赖，为开发者提供技术选型参考。

1. 核心框架

1.1 Tauri

• 版本: Tauri v2
• 用途: 跨平台应用框架，提供原生功能访问
• 优势:
  • 比Electron更轻量
  • 更好的安全模型
  • 使用系统WebView而非捆绑Chromium
  • 支持多平台构建
• 文档: Tauri官方文档

1.2 Rust

• 版本: Rust 1.70+
• 用途: 后端逻辑实现，替代原SillyTavern的Node.js后端
• 优势:
  • 高性能
  • 内存安全
  • 强类型系统
  • 优秀的并发模型
• 文档: Rust官方文档

1.3 前端框架

• 框架: 保留SillyTavern原有的前端代码
• 核心技术: HTML, CSS, JavaScript (jQuery)
• 构建工具: Webpack (用于库打包)

2. 后端技术栈

2.1 Rust库和框架

库/框架	用途
serde	JSON序列化/反序列化
tokio	异步运行时
reqwest	HTTP客户端
tiktoken-rs	OpenAI 系列 tokenizer 计数/编解码
tauri-api	Tauri API访问
rusqlite	SQLite数据库访问（可选）
log	日志记录
env_logger	日志配置
async-trait	异步trait支持
thiserror	错误处理

2.2 架构模式

• Clean Architecture: 采用领域驱动设计和清晰的关注点分离
• 分层架构:
  • 领域层 (Domain): 核心业务逻辑和实体
  • 应用层 (Application): 用例和服务
  • 基础设施层 (Infrastructure): 外部服务集成和持久化
  • 表示层 (Presentation): API和命令处理

2.3 数据存储

• 主要存储: 文件系统 (JSON文件)
• 数据位置: 用户数据目录，遵循平台标准

3. 前端技术栈

3.1 保留的SillyTavern技术

技术	用途
jQuery	DOM操作和事件处理
Bootstrap	UI组件和响应式布局
Showdown	Markdown渲染
DOMPurify	HTML净化
Highlight.js	代码高亮
localForage	客户端存储

3.2 前端构建工具

• Webpack: 用于打包第三方库
• Babel: JavaScript转译

3.3 前端与后端通信

• Tauri API: 使用Tauri提供的IPC机制
• 命令模式: 通过invoke调用Rust后端函数
• 桥接层: tauri-bridge.js 提供 invoke/listen/convertFileSrc 统一封装
• 请求注入: src/tauri/main/interceptors.js 同时拦截 fetch 与 jQuery.ajax
• 路由分发: src/tauri/main/router.js + src/tauri/main/routes/* 按业务域分模块处理
• AI注入路由: src/tauri/main/routes/ai-routes.js 承接 Chat Completion 与 tokenizer 端点
• 上下文能力: src/tauri/main/context.js 负责缓存、DTO转换与公共 helper

4. 开发工具

4.1 IDE和编辑器

• 推荐IDE:
  • VS Code (前端和Rust)
  • IntelliJ IDEA + Rust插件
  • Rust Analyzer (Rust语言服务器)

4.2 构建和包管理

• Rust: Cargo
• 前端: npm/pnpm
• 应用打包: Tauri CLI

4.3 测试工具

• Rust单元测试: Rust内置测试框架
• 集成测试: 自定义测试框架
• 前端测试: 保留SillyTavern的测试方法

4.4 CI/CD

• GitHub Actions: 自动构建和测试
• 发布管理: GitHub Releases

5. 第三方服务集成

5.1 AI提供商API

服务	集成方式	用途
OpenAI	REST API	GPT模型访问
Anthropic	REST API	Claude模型访问
Custom OpenAI-compatible	REST API	兼容OpenAI协议的自定义端口接入
本地模型	HTTP API	本地AI模型访问
其他提供商	各自API	多样化模型选择

5.2 其他服务

• 更新检查: GitHub API
• 翻译服务: 保留SillyTavern的集成

6. 安全考虑

6.1 API密钥管理

• 存储: 安全存储在用户数据目录
• 访问控制: 最小权限原则

6.2 数据安全

• 本地存储: 所有数据存储在本地
• 无远程传输: 除非用户明确配置
• 权限隔离: 使用Tauri的权限模型

7. 性能优化

7.1 Rust优化

• 异步处理: 使用tokio进行异步操作
• 内存管理: 利用Rust的所有权系统
• 并行处理: 适当使用并行计算

7.2 前端优化

• 资源加载: 优化资源加载顺序
• 库注入链路: lib.js 静态导入 src/dist/lib.core.bundle.js；重库通过 getHljs()/getReadability() 动态加载 src/dist/lib.optional.bundle.js
• 延迟加载: 非关键资源延迟加载
• 构建缓存: webpack filesystem cache 提升增量构建速度

8. 兼容性和迁移

8.1 数据兼容性

• 角色卡片兼容: 使用与SillyTavern相同的PNG格式角色卡片
• 聊天记录兼容: 使用与SillyTavern相同的JSONL格式聊天记录
• 群组数据兼容: 保持与SillyTavern相同的群组数据格式
• 主题兼容: 支持SillyTavern的主题格式
• 导入/导出支持: 支持导入/导出SillyTavern数据

8.2 API兼容性

• 模块化注入架构: 使用 bootstrap/context/interceptors/routes 拆分原单体入口
• 动态导入模式: 启动阶段由 init.js 统一加载 tauri-main.js
• 前端拦截: 通过 fetch + jQuery.ajax 双通道拦截无缝替换HTTP请求
• 路由域隔离: 系统/设置/扩展/资源/角色/聊天路由分文件维护，降低耦合
• 扩展兼容: 支持现有扩展系统

9. 部署和分发

9.1 打包格式

• Windows: MSI, EXE
• macOS: DMG, App Bundle
• Linux: AppImage, DEB, RPM
• 移动平台: APK, IPA

9.2 更新机制

• 自动更新: 使用Tauri的更新API
• 增量更新: 可能的增量更新支持
• 版本管理: 语义化版本控制