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，进入 设置 → 通用设置 → 酒馆管理（原生） 即可使用。

完整使用流程（角色扮演）

1. 导入角色卡：PNG 或 JSON 拖入「角色卡」区域
2. 导入世界书：JSON 拖入「世界书」区域
3. 导入预设：JSON 拖入「预设」区域（如你自己的 RP 预设）
4. 创建/选择酒馆预设：顶部下拉框新建并命名（如「我的预设」）
5. 保存到 Harness：点「💾 保存到 Harness」
6. 启用注入：勾选「启用预设直接注入」；生效范围选「全局」或把当前会话加入白名单
7. 切换 Agent 预设：聊天顶部把 Agent 预设切换成同名预设（或点酒馆管理里的「⚡ 切到Agent预设」）
8. 开始角色扮演：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 回复美化

• 自动识别角色卡格式（<世界>、<Status_block> 等）
• 剧情选项渲染为可点击按钮
• 编辑 AI 回复，修改后 AI 顺着改后的内容继续

🔒 会话隔离

• 每个会话独立保存角色卡/世界书/预设/记忆
• 切换会话自动加载对应配置
• 跨工作区会话过滤，只显示当前工作区会话

安装方法

方法一：dsh 插件市场（推荐）

1. 打开 dsh 设置 → 插件
2. 搜索 dsh-tavern
3. 点击安装

方法二：npm 安装

# 在 dsh 插件目录执行
npm install dsh-tavern

方法三：本地安装

1. 下载源码
2. 复制到 dsh 插件目录
3. 重启 dsh

使用说明

1. 基础设置

1. 打开 dsh 设置 → 酒馆管理
2. 导入角色卡（拖放或选择文件）
3. 导入世界书
4. 导入预设（如你自己的 RP 预设）

2. 会话绑定

1. 在"当前会话预设"下拉框选择预设
2. 勾选"启用此会话的预设注入（白名单）"
3. 勾选"成人模式（强破注入）"（如需 NSFW）
4. 勾选"剧情选项"（如需 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 - 关系网

更新日志

见 CHANGELOG.md

许可协议

本项目采用 CC BY-NC-SA 4.0（知识共享 署名-非商业性使用-相同方式共享 4.0 国际）协议。

注：因含非商业条款，本项目不符合 OSI 对"开源软件"的严格定义，准确表述为"源码公开 / 非商业共享"。

你可以

• ✅ 个人学习、研究、使用
• ✅ 修改、二次开发
• ✅ 非商业性分发、转载

你不可以

• ❌ 用于任何商业目的 —— "商业目的"采用宽泛解释：任何以营利为直接或间接目的的使用均视为商用，包括但不限于：
  • 收费下载、付费使用、会员制
  • 广告变现、流量变现
  • 商业产品集成、SaaS 服务集成
  • 靠本插件接外包、赚打赏、引流变现
  • 其他任何直接或间接获取经济利益的使用
• ❌ 移除原作者署名和来源声明
• ❌ 对衍生作品使用更宽松的协议

你必须

• 📝 注明原作者（chen731215）和来源仓库链接
• 🔄 衍生作品采用相同的 CC BY-NC-SA 4.0 协议源码公开
• 📦 做插件合集分发时，须在合集中单独标注本插件的协议及来源

维权

本项目保留 GitHub 发布时间戳与 LICENSE 文本作为著作权证据。发现违规商用可发函要求下架。

详见 LICENSE 文件。