DreamLand

让故事与陪伴，有一个归处。原 LeslieTavern，现统一使用 DreamLand 品牌。

提供 澄光、月幕、梦境手帖、蔚蓝终端 四套完整界面风格，支持亮色、暗色和氛围控制。点击会话栏的外观按钮，或进入“设置 → 通用与外观”切换；Cupertino 与经典界面保留。品牌插画是概念图，实际界面见 可切换截图预览 与 主题与品牌说明。

English | 简体中文

DreamLand 是基于 SillyTavern 开发的实验性桌面聊天分支。SillyTavern 的聊天、角色卡、群聊、World Info、Swipe、模型适配和 JSONL 存储仍是权威核心；Leslie 功能以可选扩展和服务形式叠加，普通聊天在这些功能不可用时仍应保持可用。

本仓库同时包含 airi/ 桌面陪伴前端。DreamLand 与 AIRI 共享一个 Git 根目录和项目版本，由本仓库统一继续演化；两个应用保留各自的 npm/pnpm 依赖边界，通过默认关闭的 Leslie Bridge v1 对接。

当前处于可运行原型阶段，不是 SillyTavern 官方版本，也不是经过签名的正式发行版。

主要功能

• 保留 SillyTavern 的角色卡、群聊、World Info、Swipe、模型适配和 JSONL 聊天格式。
• 提供 Windows Electron 桌面入口、单一 DreamLand 启动入口、应用内本地服务控制和便携构建脚本。
• 提供 Leslie 身份、Persona / 剧情线隔离，以及彼此可产生少量记忆共鸣的故事线与现实线聊天。现实线只提取去剧情核心性格，由当前 API 动态生成开场，并严格保存为普通即时消息；朋友圈另有桌面双栏布局、真实已读、连续评论回复、可查看点赞名单、按角色授权主动发帖、独立记忆和托盘后台运行。
• 提供火山引擎角色语音配置、试听与回复自动朗读。
• 提供可选的互动引导输入：围绕当前用户 Persona 生成三个可点击回复，并回到原有聊天生成链路；故事线单角色聊天还可使用“剧情罗盘”生成三个跨场景、跨阶段且具有长期影响的主线篇章、可选轮数建议，并把用户采用的主线固定在聊天界面。手机端使用独立标题条和底部抽屉查看主线，不占用聊天头部按钮空间。
• 提供 AI 角色工坊：可使用当前聊天 API（包括 DeepSeek 等）或本地 OpenAI-compatible 模型生成 CCV3 草稿；结果只在内存中预览，用户明确应用后才进入角色编辑器。
• 提供统一的本地 GGUF 模型目录：桌面设置会扫描模型、列出可用的 KoboldCpp 连接方式，并在选中模型后自动启动和连接；Ollama、llama.cpp 等手动设置可折叠展开。模型权重、推理程序和运行日志保持本地，不提交到 Git。
• 在线 API 密钥按账号和服务商保存；切换接口后可直接复用，Windows 上的本地密钥文件使用当前用户的 DPAPI 加密。
• 提供默认关闭、进程令牌保护的 Leslie Bridge v1，让 AIRI 复用当前角色、聊天、记忆、模型和火山语音。
• 将源码、运行时、用户数据和分发包明确分离，避免私人聊天进入 Git。

快速开始

开发环境

要求 Node.js 20 或更高版本、npm 和 Git。

git clone https://github.com/LeslieH666/LeslieTavern.git
cd LeslieTavern
npm ci
npm ci --prefix src/electron
npm run start

浏览器服务启动后默认使用本机地址。需要 Electron 桌面壳时运行：

npm run start:electron

如需运行完整仓库校验：

npm ci --prefix tests
npm run validate

validate 会依次执行仓库边界检查、DreamLand 源码 lint、测试目录 lint 和单元测试。端到端测试需要单独启动服务：

npm run test:e2e --prefix tests

如果要开发 AIRI，进入 airi/ 后使用其 pnpm 工作区：

cd airi
pnpm install --frozen-lockfile
pnpm run dev

已整理的本机工作区

本项目只保留一个日常启动入口：

• 启动 DreamLand.cmd：启动 DreamLand 桌面端。
• 备份用户数据.cmd
• 打开用户数据目录.cmd
• 查看运行日志.cmd

启动后可在“设置 → 模型连接”中选择并连接本地模型。同一私有子网的手机访问 DreamLand 时，也可选择电脑 models/ 中的模型并请求电脑启动；AIRI 与本地模型的停止操作仍仅在 Electron 桌面端开放。脚本和服务使用项目根目录下的本地 data/、Runtime/、Config/ 与 Run/；这些目录不会进入 Git。 启用局域网监听后，与访问地址属于同一私有子网的设备无需逐个填写 IP；切换家庭 Wi-Fi 或手机热点后会自动使用新子网，公网及未用于当前连接的其他网段仍被拒绝。 AIRI 启动、自动角色绑定和使用方法见 DreamLand 与 AIRI 启动指南。AIRI 不需要手动选择聊天 provider、模型或音色。

本地模型与角色工坊

统一模型目录是项目根目录下的 models/。可将单文件 GGUF 直接放在这里或其子目录中。现有 Qwen3.5 和 Peach 2.0 模型分别位于：

models/Qwen3.5-text-9B-NSFW-RP-RolePlay/Qwen3.5-text-9B-NSFW-RP-RolePlay.Q4_K_M.gguf
models/Peach-2.0-9B-8k-Roleplay/Peach-2.0-9B-8k-Roleplay.Q4_K_M.gguf

模型文件不会进入 Git；下载来源、8GB 显存建议和运行时说明见 models/README.md。一键连接目前使用项目内安装的 KoboldCpp，并固定监听本机地址，不需要填写端口。文件识别只说明它是可尝试加载的 GGUF；具体模型架构和电脑资源仍由运行时在启动时验证。

使用流程：

1. 将下载的单文件 GGUF 放进项目的 models/ 或其子目录。双击 启动 DreamLand.cmd，打开“设置 → 模型连接 → 本地 API”；可点击“打开模型目录”直接定位。
2. 在电脑端或同一私有子网的手机上，从 KoboldCpp 卡片选择扫描到的模型，点击“连接所选模型”或“一键识别并自动配置”。快捷识别会优先连接已运行的适配模型；没有运行中的模型时，电脑会启动所选 GGUF。页面等待就绪并自动填入聊天连接设置；无需提前在电脑端运行模型。电脑端可在同一卡片点击“停止本地模型”以释放显存。手机端操作时，DreamLand 电脑服务须保持运行且可从手机访问。
3. 打开“AI 角色工坊”，在“角色卡生成接口”中选择当前聊天 API 或当前已连接的本地模型。
4. 检查简报、知识核对、JSON 草稿和质量审校；预览不会自动写入角色目录。
5. 只有点击“带入角色编辑器”并在原有编辑流程中保存，才会创建正式角色卡。
6. 也可以在“手动创建”的二级界面中选择标准 JSON 角色卡和头像，点击“导入并填充创建表单”，确认字段后使用原有“创建角色”按钮保存。

本地模型是否遵循某条内容约束取决于模型权重、推理运行时和当前提示词；项目不把“无限制”作为稳定性或安全性保证。角色工坊的本地接口只负责本次草稿生成，不会替换全局聊天 API 设置。

角色记忆的“自动整理”也支持独立模型分层：打开角色记忆面板的“设置与安全”，在“记忆整理模型”中选择跟随聊天 API、DeepSeek API、本地 KoboldCpp / llama.cpp，或独立 OpenAI-compatible 接口。DeepSeek 选项使用与聊天 API 相同的 OpenAI Chat Completions 格式；该选择按每个角色记忆档案保存，记忆抽取和成长整理不会改变角色正常聊天的模型设置；旧版记忆档案会自动迁移并保留迁移前备份。

设置 → 模型连接中的“启用本地模型加载”是项目侧总开关。关闭后会阻止聊天、角色工坊和记忆整理调用本地模型，并把项目连接状态置为未连接；它不会删除 GGUF 文件。KoboldCpp / llama.cpp 是独立进程，需要单独停止才能释放显存。

模型不会作为新的 API provider 出现在列表中；一键连接仍使用原有的 KoboldCpp 聊天适配器。非 GGUF 格式、Ollama、llama.cpp、自行启动的服务以及地址和端口调整都保留在“展开高级连接设置”中。

在线 API 密钥

在“设置 → 模型连接”输入在线接口密钥后，点击连接或切换接口就会保存到该账号的本机密钥库。切换回来时显示已保存状态，留空即可复用；密钥明文不会回填到输入框或浏览器本地存储。Windows 运行方式使用当前系统用户的 DPAPI 加密 secrets.json，旧版明文密钥文件在读取时原位迁移；加密失败时保留原文件。旧版留下的历史备份不会自动改写，仍需按明文密钥文件妥善保管。密钥文件随账号和电脑绑定，移到另一台电脑或 Windows 用户下需重新输入。其他操作系统继续使用原有的本机密钥文件格式。

项目结构

LeslieTavern/
├─ .github/        GitHub Issue、PR 与 CI 配置
├─ airi/           集成的 AIRI 桌面前端源码与 pnpm 工作区
├─ docs/           架构、路线图、设计和数据说明
├─ packaging/      Windows 本机与便携版脚本
├─ public/         浏览器端界面与扩展
│  ├─ scripts/leslie-character-workshop/
│  ├─ scripts/leslie-character-import*.js
│  ├─ scripts/leslie-story-choices.js
│  └─ scripts/leslie-local-model-core.js
├─ scripts/        仓库维护和数据迁移工具
├─ src/            服务端、Electron、Bridge 与 Leslie 模块
│  ├─ electron/    Electron 主进程和桌面入口
│  ├─ leslie-bridge/
│  ├─ leslie-identity/
│  ├─ leslie-memory/
│  ├─ leslie-moments/
│  └─ leslie-tts/
├─ tests/          单元测试与端到端测试
├─ models/         本地模型说明；权重文件不入 Git
├─ data/           本地用户数据，仅保留占位文件进入 Git
└─ README.md       项目入口

核心边界可以概括为：

SillyTavern chat engine
├─ Leslie UI extensions
│  ├─ identity / memory / moments / voice
│  ├─ story choices
│  └─ character workshop providers
├─ Existing model adapters
└─ Optional Leslie Bridge v1
   └─ AIRI companion frontend

DreamLand 负责提示词组装、角色与聊天状态、记忆、模型和持久化；AIRI 负责显示模型、输入、回复展示、音频播放和口型同步。AIRI 不会建立第二套角色提示词，也不会自行选择模型或音色。完整边界见 AIRI Bridge 说明。

用户数据与隐私

在“设置 → 用户空间”中，电脑本机的管理员可以为默认用户设置密码并启用多用户空间。首次启用会将原有聊天、角色、演示数据及项目根目录的旧备份迁入密码保护的加密空间，并保留一份加密的初始回退副本。之后可在设置中创建更多用户，并通过“切换用户”回到选择页。正常退出或登出会重新封存当前空间；密码丢失后无法解密该空间。异常断电或强制结束进程可能留下运行中的明文工作目录，重新登录会尝试封存并恢复它。

在“设置 → 用户空间”中，电脑本机的管理员可以为默认用户设置密码并启用多用户空间。首次启用会将原有聊天、角色、演示数据及项目根目录的旧备份迁入密码保护的加密空间，并保留一份加密的初始回退副本。之后可在设置中创建更多用户，并通过“切换用户”回到选择页。正常退出或登出会重新封存当前空间；密码丢失后无法解密该空间。异常断电或强制结束进程可能留下运行中的明文工作目录，重新登录会尝试封存并恢复它。

角色卡、聊天、密钥、记忆、语音配置、日志、缓存、备份和本地运行时均被 .gitignore 排除。提交或报告问题前请运行：

npm run check:repo

不要在 Issue、Pull Request、日志或截图中附带聊天正文、角色文件、API 密钥或其他私人数据。详见 数据与打包说明 和 安全策略。

文档

• 项目概览
• 开发路线图
• 界面设计基线
• Cupertino UI 重构与回退说明
• 角色卡工作流
• AIRI Bridge 说明
• DreamLand 与 AIRI 启动指南
• 数据与打包说明
• 贡献指南
• 变更记录

上游与许可证

DreamLand 是 SillyTavern 的衍生项目，并非官方发行版。上游项目及原作者保留其各自权利；衍生代码继续采用 GNU AGPL-3.0 许可证。网络部署和修改版本分发同样需要遵守 AGPL-3.0。