chen731215-dev/dsh-tavern-v2 ↗★ 1
dsh-tavern
DeepSeek 酒馆 - DSH 角色扮演插件:角色卡、世界书、预设、记忆、关系、剧情选项。
AI 分析
核心用途是为 DSH 提供升级版的角色扮演管理系统。适合需要深度定制 AI 人设、世界观、记忆和关系网,进行沉浸式角色扮演和文本创作的用户。
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:chen731215-dev/dsh-tavern-v2说明文档
阅读完整 README ↗🎮 使用指南
1️⃣ 在酒馆面板设置角色卡 / 世界书 / 预设
打开 设置 → 酒馆管理,你会看到三个卡片区:
| 区域 | 作用 | 操作 |
|---|---|---|
| 🎭 角色卡 | 定义角色的人设、性格、说话方式、首条消息 | 拖入 PNG / JSON 角色卡文件(SillyTavern 格式),可导入多份 |
| 📚 世界书 | 定义世界观、场景、NPC、规则(按关键词触发省 token) | 拖入 JSON 世界书文件,或点「+ 新增条目」手动建 |
| ⚙️ 预设 | 预置写作风格、破限词条、行为模块 | 拖入 JSON 预设文件,或点「+ 新增条目」手动建 |
保存:三个区域的内容会自动写入当前预设的目录文件,无需手动保存。
💡 新建空白预设:点「+ 新建」创建的是完全空白的预设(无任何角色卡/世界书/词条),方便从零搭建;想基于现有预设改造就点「⧉ 复制」。
2️⃣ 生成 Agent 预设
角色卡/世界书/预设设置好后,该预设就是一个完整的「Agent 预设」——它同时具备:
- DSH 原生 Agent 预设:在 DSH 聊天顶部的预设选择器里可见、可选
- 酒馆注入内容:角色卡文本、世界书条目、预设词条会在每次请求时自动注入系统提示
切换「完整角色卡本体」请用聊天顶部预设选择器选择后新开会话;酒馆面板里的下拉只让 世界书/记忆/关系网 跟随。
3️⃣ 新建聊天并选择 Agent 预设
- 点 + 新会话(新建一个聊天)
- 在聊天顶部的预设选择器里,选中你要用的 Agent 预设(比如刚才配好的那个)
- 开始聊天——AI 会自动读取该预设的角色卡/世界书/词条,无需手动粘贴设定
⚠️ 关键:Agent 预设是在会话创建时绑定到聊天的(DSH 事件流记录)。所以先选预设,再开始聊。
4️⃣ 对已经生成的聊天修改角色卡/世界书,会有什么效果?
这是最容易困惑的一点,说清楚:
| 操作 | 对已有聊天的影响 |
|---|---|
| 修改角色卡(如改人设、加描述) | ✅ 立即生效:下一次生成回复时,AI 会用新角色卡。但历史已生成的消息不变(不会重写) |
| 修改世界书(加条目、改关键词) | ✅ 立即生效:后续请求按新世界书注入。历史消息不变 |
| 修改预设词条(加破限、改风格) | ✅ 立即生效:后续生成用新词条 |
| 切换当前会话绑定的预设 | ⚠️ 需在聊天顶部选择器切换(会写 DSH 事件流);酒馆面板的下拉只影响 世界书/记忆/关系网 跟随 |
| 删除/重命名预设 | ⚠️ 已绑定该预设的会话:删除后绑定失效(回退默认);重命名不影响绑定(按 id 绑定) |
一句话总结:修改角色卡/世界书/预设 = 对后续生成即时生效,历史消息保持不变。
5️⃣ 使用建议
- 想保持角色一致性:建好角色卡后尽量少改;要调整时直接改酒馆面板,下一次回复就生效,不用重开聊天
- 想开新剧情/新角色:用「+ 新建」建空白预设,配新角色卡,新开会话选择它——老会话的角色不受影响
- 角色卡和世界书分开管理:角色卡管"是谁",世界书管"世界长什么样",分开维护更清晰
- 记忆让剧情连贯:配合「记忆总结」功能,AI 会记住之前的剧情,修改角色卡后依然保持连贯
- 成人内容:在酒馆面板启用「成人模式」,并搭配成人词条预设(如破限词条)使用
5️⃣ 使用建议
- 想保持角色一致性:建好角色卡后尽量少改;要调整时直接改酒馆面板,下一次回复就生效,不用重开聊天
- 想开新剧情/新角色:用「+ 新建」建空白预设,配新角色卡,新开会话选择它——老会话的角色不受影响
- 角色卡和世界书分开管理:角色卡管"是谁",世界书管"世界长什么样",分开维护更清晰
- 记忆让剧情连贯:配合「记忆总结」功能,AI 会记住之前的剧情,修改角色卡后依然保持连贯
- 成人内容:在酒馆面板启用「成人模式」,并搭配成人词条预设(如破限词条)使用