chen731215-dev/dsh-tavern
DSH 原生酒馆管理面板,入口:设置 → 通用设置 → 酒馆管理(原生)。多角色卡/多世界书/多预设,会话级预设隔离;世界书智能关键词注入省 60-70% 上下文;记忆总结 + 角色关系网;剧情选项一键发送;创作/扮演双模式;NSFW 成人模式。免费非商用(CC BY-NC-SA 4.0)。安装:dsh plugin --profile web add dsh-tavern
编辑导读Editor's Brief
## 核心特性
- 该插件在 DSH 中提供 SillyTavern 风格面板,可通过拖放 PNG、JSON 和 preset 文件导入并管理角色卡、世界书和预设。
- 它可分别存储多个预设,并将其绑定到会话,使角色卡、世界书、记忆和关系数据在会话切换时加载。
- 世界书注入支持全文或关键词触发模式:全局条目每次都会注入,基于关键词的角色条目仅在对话文本匹配其关键词时注入。
- 记忆模块可手动或自动总结最近对话轮次,将摘要写入记忆文件,并注入系统提示词。
- 它可以从 AI 回复生成剧情选项按钮、编辑 AI 回复、在总结时提取角色关系,并创建同名 DSH Agent 预设,便于在聊天头部切换。
## 使用场景
- 角色扮演对话:将 SillyTavern 角色卡和世界书导入 DSH,并自动注入聊天,无需手动粘贴设定。
- 按会话区分的预设工作流:不同对话使用独立的角色、世界书、记忆和关系配置。
- 节省上下文的角色扮演配置:使用关键词触发的世界书条目,而不是每轮都注入全部设定。
- 面向成人或 NSFW 的角色扮演配置:结合酒馆预设、成人模式注入和匹配的 DSH Agent 预设。
## 技术细节
- 安装可通过 DSH 插件市场、在 DSH 插件目录中使用 npm 安装,或将本地源码复制到插件目录完成,之后重启 DSH。
- 预设数据存储在 ~/.dsh/.agent-presets/ 下,包括 session-bindings.json 以及每个预设的文件,例如 agent.cordis.yml、characters.json、worldbooks.json、presets.json、memory.md 和 relations.json。
- 该插件集成到 DSH 设置中的“设置 → 常规设置 → Tavern Management (Native)”,可将酒馆预设保存到 Harness,以作为 Agent 预设使用。
- 该项目以 CC BY-NC-SA 4.0 许可分发源代码,要求署名、非商业使用,并且衍生作品采用相同许可协议。
## 注意事项
- 该许可禁止商业使用,包括付费下载、广告变现、商业产品集成、外包、与使用挂钩的捐赠,或其他直接或间接营利目的。
- NSFW 或成人模式行为需要同时配置包含成人词条的酒馆预设,并切换到生成的同名 Agent 预设;仅启用开关并不足够。
- 仓库元数据将许可证列为 NOASSERTION,而 README 中说明为 CC BY-NC-SA 4.0,因此用户在再分发前应查看许可协议文件。
## Core Features
- The plugin provides a SillyTavern-style panel in DSH for importing and managing character cards, world books, and presets through drag-and-drop PNG, JSON, and preset files.
- It stores multiple presets separately and binds them to sessions, allowing character cards, world books, memory, and relationship data to load when a session changes.
- World book injection supports full-text or keyword-triggered modes, with global entries injected every time and keyword-based character entries injected only when conversation text matches their keywords.
- The memory module can summarize recent conversation turns manually or automatically, write summaries into memory files, and inject them into system prompts.
- It can generate plot option buttons from AI replies, edit AI replies, extract character relationships during summarization, and create a same-named DSH Agent preset for switching in the chat header.
## Use Cases
- Role-playing conversations where SillyTavern character cards and world books are imported into DSH and injected into chats without manually pasting settings.
- Session-specific preset workflows where different conversations use separate character, world book, memory, and relationship configurations.
- Context-saving role-play setups that use keyword-triggered world book entries instead of injecting all lore every turn.
- Adult or NSFW-oriented role-play configurations that combine tavern presets, adult mode injection, and a matching DSH Agent preset.
## Technical Details
- Installation is performed through the DSH plugin market, npm installation in the DSH plugin directory, or local source copying into the plugin directory, followed by restarting DSH.
- Preset data is stored under ~/.dsh/.agent-presets/, including session-bindings.json and per-preset files such as agent.cordis.yml, characters.json, worldbooks.json, presets.json, memory.md, and relations.json.
- The plugin integrates with DSH settings under Settings → General Settings → Tavern Management (Native) and can save tavern presets to Harness for use as Agent presets.
- The project is distributed as source code under CC BY-NC-SA 4.0, which requires attribution, non-commercial use, and share-alike licensing for derivatives.
## Notes
- The license prohibits commercial use, including paid downloads, advertising monetization, commercial product integration, outsourcing, donations tied to use, or other direct or indirect profit-making purposes.
- NSFW or adult-mode behavior requires both a configured tavern preset containing adult terms and switching to the generated same-named Agent preset; enabling the switch alone is not sufficient.
- The repository metadata lists license as NOASSERTION, while the README states CC BY-NC-SA 4.0, so users should review the license file before redistribution.
安装Install
dsh plugin add dsh-tavern
把 chen731215-dev/dsh-tavern 加入你的 DSH 配置(web profile)即可启用。
READMEREADME
dsh-tavern
🎴 为 DeepSeek Harness 打造的原生 SillyTavern 风格角色卡 / 世界书管理面板,让 DSH 的 RP 工作流不再裸奔。
⚠️ 源码公开申明(非 OSI 开源)
本项目采用 CC BY-NC-SA 4.0 协议进行源码公开(注:因含非商业条款,不符合 OSI 对"开源软件"的严格定义,准确表述为"源码公开 / 非商业共享")。
- ✅ 允许个人学习、研究、使用、修改、非商业分发
- ❌ 禁止商业用途 —— "商业目的"采用宽泛解释:任何以营利为直接或间接目的的使用均视为商用,包括但不限于:收费下载/付费使用、广告变现、商业产品集成、靠本插件接外包/赚打赏/引流变现等
- 📝 搬运/转载必须注明来源(保留原作者署名和仓库链接)
- 🔄 衍生作品必须使用相同协议(修改后也需源码公开且非商业)
DSH 插件生态兼容说明:本插件为独立仓库、独立许可,不会污染 DSH 本体(DSH 自身采用何种协议与本插件无关)。他人做"插件合集分发"时,须在合集中单独标注本插件的 CC BY-NC-SA 4.0 协议及来源。
维权说明:本项目保留 GitHub 发布时间戳与 LICENSE 文本作为著作权证据。发现违规商用可发函要求下架,依据为著作权 + 本许可条件。
作者:chen731215 | 仓库:https://github.com/chen731215-dev/dsh-tavern
🚀 一键下载使用
npm install -g dsh-tavern # 全局安装(按需)
dsh plugin add dsh-tavern # DSH 插件市场/命令安装
安装后重启 DSH,进入 设置 → 通用设置 → 酒馆管理(原生) 即可使用。
完整使用流程(角色扮演)
- 导入角色卡:PNG 或 JSON 拖入「角色卡」区域
- 导入世界书:JSON 拖入「世界书」区域
- 导入预设:JSON 拖入「预设」区域(如你自己的 RP 预设)
- 创建/选择酒馆预设:顶部下拉框新建并命名(如「我的预设」)
- 保存到 Harness:点「💾 保存到 Harness」
- 启用注入:勾选「启用预设直接注入」;生效范围选「全局」或把当前会话加入白名单
- 切换 Agent 预设:聊天顶部把 Agent 预设切换成同名预设(或点酒馆管理里的「⚡ 切到Agent预设」)
- 开始角色扮演:AI 会直接从酒馆预设读取角色卡/世界书,不需要你手动贴设定
功能特性
🎭 角色卡管理
- 支持导入 SillyTavern 格式角色卡(PNG/JSON)
- 多角色卡管理,每个预设独立保存
- 角色卡自带世界书自动同步
- 一键注入当前对话
📚 世界书管理
- 支持导入 SillyTavern 世界书 JSON
- 卡片式可折叠 UI,按世界书分组
- 条目名称(comment)和关键词(keys)正确显示
- 智能注入:全局条目每次注入,角色条目按关键词触发,节省 60-70% 上下文
- 注入模式切换:全文注入 / 关键词触发
- 拖放导入区域
⚙️ 预设管理
- 多预设管理,每个预设独立保存角色卡/世界书/记忆/关系网
- 会话级预设绑定,切换对话自动加载对应预设
- 白名单模式:只有加入白名单的会话才注入预设
- 预设删除、批量删除、全选
- 预设名称自动同步到会话名称
- 自动生成同名 DSH Agent 预设,聊天顶部直接切换
- Agent 预设管理:搜索、分组折叠、批量删除、来源识别(酒馆/DSH自带/其他)
🧠 记忆模块
- 手动总结:读取最近 N 楼对话,自动写入记忆
- 自动总结:每 N 楼自动总结一次
- 预设级记忆隔离,切换预设自动加载对应记忆
- 记忆注入系统提示,AI 能看到总结内容
🔗 角色关系网
- 总结时自动提取角色关系
- 可视化关系图谱
- 预设级关系网隔离
🎬 剧情选项
- AI 每次回复输出 3 个剧情选项
- 可点击选项自动填入输入框并发送
- 自定义输入框,支持手动输入行动
- 独立开关,不依赖成人模式
🔞 NSFW / 成人模式
- 暴力破限注入,集成历史共识破限法
- 开启 NSFW 自动开启成人模式
- 预设词条正确注入并生效
- 写 NSFW 的正确姿势(重要):光勾 NSFW 开关不够,必须在酒馆里改好预设(导入/选用带成人词条的预设模块)并搭配已配置好的 agent 预设(点「💾 保存到 Harness」生成、聊天顶部切换到同名 agent 预设)两者一起使用,破限 + 角色设定才会完整生效
🎨 AI 回复美化
- 自动识别角色卡格式(<世界>、 等)
- 剧情选项渲染为可点击按钮
- 编辑 AI 回复,修改后 AI 顺着改后的内容继续
🔒 会话隔离
- 每个会话独立保存角色卡/世界书/预设/记忆
- 切换会话自动加载对应配置
- 跨工作区会话过滤,只显示当前工作区会话
安装方法
方法一:dsh 插件市场(推荐)
- 打开 dsh 设置 → 插件
- 搜索
dsh-tavern - 点击安装
方法二:npm 安装
# 在 dsh 插件目录执行
npm install dsh-tavern
方法三:本地安装
- 下载源码
- 复制到 dsh 插件目录
- 重启 dsh
使用说明
1. 基础设置
- 打开 dsh 设置 → 酒馆管理
- 导入角色卡(拖放或选择文件)
- 导入世界书
- 导入预设(如你自己的 RP 预设)
2. 会话绑定
- 在"当前会话预设"下拉框选择预设
- 勾选"启用此会话的预设注入(白名单)"
- 勾选"成人模式(强破注入)"(如需 NSFW)
- 勾选"剧情选项"(如需 AI 输出选项)
💡 写 NSFW 请这样配:① 在酒馆管理面板「预设」区块改好/选好预设(含成人词条模块);② 勾选「成人模式(强破注入)」;③ 点「💾 保存到 Harness」并在聊天顶部把 Agent 预设切换成同名预设。酒馆预设 + agent 预设两者搭配一起用才会完整生效——只开开关不配预设,破限不全;只改预设没切到对应 agent 预设,注入不生效。
3. 世界书智能注入
- 注入模式选择"关键词触发"可大幅节省上下文
- 无关键词的全局条目(世界观/规则)每次注入
- 有关键词的角色条目仅当对话命中关键词时注入
4. 记忆总结
- 设置总结楼数(如 20 楼)
- 点击"立即总结"或开启自动总结
- 总结内容自动写入记忆并注入系统提示
配置文件
- 预设根目录:
~/.dsh/.agent-presets/ - 会话绑定:
~/.dsh/.agent-presets/session-bindings.json - 每个预设目录包含:
agent.cordis.yml- 角色卡characters.json- 角色卡列表worldbooks.json- 世界书presets.json- 预设词条memory.md- 记忆relations.json- 关系网
更新日志
许可协议
本项目采用 CC BY-NC-SA 4.0(知识共享 署名-非商业性使用-相同方式共享 4.0 国际)协议。
注:因含非商业条款,本项目不符合 OSI 对"开源软件"的严格定义,准确表述为"源码公开 / 非商业共享"。
你可以
- ✅ 个人学习、研究、使用
- ✅ 修改、二次开发
- ✅ 非商业性分发、转载
你不可以
- ❌ 用于任何商业目的 —— "商业目的"采用宽泛解释:任何以营利为直接或间接目的的使用均视为商用,包括但不限于:
- 收费下载、付费使用、会员制
- 广告变现、流量变现
- 商业产品集成、SaaS 服务集成
- 靠本插件接外包、赚打赏、引流变现
- 其他任何直接或间接获取经济利益的使用
- ❌ 移除原作者署名和来源声明
- ❌ 对衍生作品使用更宽松的协议
你必须
- 📝 注明原作者(chen731215)和来源仓库链接
- 🔄 衍生作品采用相同的 CC BY-NC-SA 4.0 协议源码公开
- 📦 做插件合集分发时,须在合集中单独标注本插件的协议及来源
维权
本项目保留 GitHub 发布时间戳与 LICENSE 文本作为著作权证据。发现违规商用可发函要求下架。
详见 LICENSE 文件。
amruthpillai/reactive-resume
anywhere-labs/deepseek-harness-desktop
tt-a1i/archify
strukto-ai/mirage
liustack/modlens
omdsh-dev/DSH-better-sidebar
dsh-market/dsh-market