一个本地优先、多模型可切换的角色对话应用。创建带设定的虚拟角色，与不同角色进行 AI 驱动的对话。
- 角色管理 — 创建/编辑/删除角色，自定义人设（personality）、开场白、语气风格；六步创建向导 + SillyTavern V2 角色卡导入/导出
- 多轮对话 — 与不同角色进行连续对话，保留完整历史
- 多 tab 会话工作区 — 应用内多会话并行，后台流式继续生成，刷新后恢复
- 模板变量 — 角色设定中使用
{{user}}/{{char}}动态替换用户昵称和角色名称 - 多模型支持 — 可切换 LLM Provider（Claude / OpenAI / 兼容 API）
- 流式输出 — 打字机效果逐字显示回复，支持停止生成
- 对话内模型切换 / 重生成 — 聊天头部模型徽标可随时切换当前对话的 Provider 与模型；对最后一条 AI 回复不满意，可点击「重生成」一键重新生成
- 首启引导与错误提示 — 未配置 AI 接口时聊天区显示引导卡直达设置页；操作失败以可关闭的错误条提示，不再写入消息记录
- 搜索历史消息 — 跨对话关键词搜索，点击结果自动跳转到命中消息并短暂高亮定位
- 本地存储 — 所有数据存于本地 SQLite，无需联网依赖
- API Key 管理 — 内置设置面板管理密钥
- 模拟器 — 22 款文字模拟器浏览/类型筛选/一键 iframe 运行；AI 驱动游戏可用「重新同步」按钮将主应用接口 Key 同步注入模拟器（SIM-API-1 后自动同步为常态）；导入第三方
.html文件时自动识别游戏类型（AI 驱动/纯本地），误判可点卡片「重新识别」按钮修正；「存档管理」面板（导出/导入/删除）可统一管理存档；可导入第三方.html游戏（仅本地文件 ≤5MB，SHA-256 去重、冲突自动改名，导入后存外置数据目录不随包分发，风险与适配见程序内「导入游戏与安全须知」）
# 1. 克隆项目
git clone https://github.com/Penumbra-Noviter/conver-system.git
cd conver-system
# 2. 创建虚拟环境
python -m venv .venv
source .venv/Scripts/activate # Windows (Git Bash)
# 或 .venv\Scripts\activate # Windows (PowerShell)
# 3. 安装依赖
pip install -r backend/requirements.txt
# 4. 配置环境变量
cp backend/.env.example .env # 复制到项目根目录（config 相对 CWD 读取）
# 编辑 .env，填入基础配置；API Key 通过 UI 设置面板填写（存本地数据库）
# 5. 启动服务
uvicorn backend.app.main:app --reload --host 127.0.0.1 --port 8000打开浏览器访问 **http://localhost:8000**（Swagger 接口文档：http://localhost:8000/docs）
桌面版：Windows 桌面应用（Tauri 壳 + 打包后端）已交付，一键构建与冒烟见 桌面版文档。
- 文档规范 — 文档架构与单一事实来源规则
- 项目介绍 — 背景、关键决策、常碰坑点
- 架构设计 — 目录结构、数据流、数据库设计
- API 接口设计 — 所有 REST API 定义
- LLM 集成设计 — 多模型接入层架构
- 桌面版构建与冒烟 — Tauri 桌面版构建链、数据目录、已知限制
- Tauri 环境搭建 — Rust 工具链安装与构建注意事项
本程序采用 MIT 许可协议，详见 LICENSE 文件。
内置的 22 款文字模拟器为第三方作者作品，其授权范围见 NOTICE.md。
- 本地优先 — 所有数据存本地，不依赖云端服务
- Provider 透明 — LLM 接入层抽象化，切换模型不改业务代码
- 渐进增强 — 网页版为先，桌面端已交付（Tauri 壳 + PyInstaller 打包后端，前端零改动）
- 配置内聚 — API Keys 通过 settings 接口管理，不硬编码
模拟器模块内置的 22 款文字模拟器为第三方作者作品（来源：作者公开分享的单文件 HTML 游戏）。作者已确认授权（2026-08-14）：允许二次转发与分享，不可商用。本应用不修改游戏本体内容（仅静态托管 + iframe 运行），分发时请保留本条授权说明；商用用途请联系原作者另行授权。