dsh-liketavern

dsh-liketavern

基于 DeepSeek Harness 原生 Agent 运行时的 SillyTavern 角色扮演插件

中文 · English · 更新日志

dsh-liketavern 将 SillyTavern（ST）的角色卡、提示词预设、世界书、正则、EJS 模板与前端交互卡生态引入 DeepSeek Harness（dsh）。它不另起独立的发信通道，而是直接运行在 dsh 的会话与 Agent 管线之上——由宿主负责模型连接、长上下文历史与工具调度，由插件负责提示词编排、沙箱渲染与事务级剧情状态管理。 为什么选择 dsh-liketavern 1. 剧情状态与分支真正隔离，重试绝不“串味” 传统角色扮演工具在重新生成或回退历史消息时，长期记忆、世界状态与卡片变量往往停留在最新轮次，导致旧分支带入“未来记忆”。

在 dsh-liketavern 中，角色资产（角色卡 / 预设 / 人设）全局共享，而剧情状态（Story）严格按分支隔离。每一轮楼层写入均先记录预写式日志（WAL）再落盘正文。无论是重新生成、编辑 AI 回复，还是通过宿主消息栏「在新对话中分支」，系统都会先在独立草稿中回滚未继承楼层的派生记忆、世界状态与变量，再原子发布并绑定子会话——原时间线与新分支互不干扰。 2. 不打断叙事的 Agent 长期记忆与动态世界观 插件围绕长线剧情构建了三层上下文机制： 三级世界书（Lorebooks）：支持全局、角色专属与当前剧情私有世界书，兼容常驻条目、递归扫描、次要关键词、反向排除与逻辑与/或触发。 世界变化层（World State Delta）：记录设定在故事推进中的新增、变更与失效，使静态设定随剧情自然演进。 BM25 长期记忆：融合词频相关性与时间衰减权重。日常对话中模型直接流式回复，仅在缺少设定或需要固化已确定事实时，才通过宿主原生 PTC（程序化工具调用）按需调用 tavern_* 工具读写记忆与设定；超出容量后在会话空闲期自动生成可溯源的归档摘要。 3. 开箱即用的 ST 生态兼容：EJS、酒馆助手与原生 MVU 角色卡与预设：支持 V1 / V2 / V3 规范的 PNG 与 JSON 角色卡导入导出、多开场白切换、内嵌世界书与 ST 提示词预设。DeepSeek 官方 API Key 通道支持按冻结的预设布局直接投影消息结构。 EJS 模板与持久检查点：内置兼容 ST 语法的 EJS 提示词模板引擎，支持条件、循环、异步宏、世界书装饰器及 lodash、zod、faker、jsonrepair 等工具库，并支持跨步骤的 QuickJS 虚拟机快照恢复。 酒馆助手子集与原生 MVU：支持全局 / 预设 / 角色三级脚本库、剧情变量持久化、同页事件通信与局部消息刷新；内置原生 MVU（Model-View-Update）状态更新执行器，兼容数据流驱动的复杂状态栏角色卡。 4. 默认零信任的第三方代码隔离 角色卡附带的正则、模板与 HTML 脚本均视为不受信任输入： 提示词组装、世界书评估、正则替换、Markdown 渲染与 EJS 模板统一在可超时终止的 Worker 线程及 QuickJS/WASM 沙箱内执行，不暴露 Node、DOM、网络或模块加载器。 HTML 交互卡面运行在无同源权限的 sandbox="allow-scripts" iframe 中，仅通过受控桥接协议执行枚举业务操作与高度同步，杜绝第三方卡面脚本逃逸至宿主主窗口。 安装与升级 前置要求：Node.js >= 24.0.0、DeepSeek Harness、pnpm，且已在 dsh 中配置好可用的模型。当前开发基线为 0.2.2-rc.1；en

打开 dsh 桌面端 「插件 → 添加插件」，填入以下仓库标签地址并安装，完成后重启桌面端：

Web / CLI 在线安装

在已验证的 0.2.0-rc.1 和 0.2.2-alpha.2 中，插件安装时 pnpm 可能提示 profile 内缺少宿主 peer 依赖：这些包由运行中的 dsh 宿主提供，提示本身不代表安装失败。仍需确认宿主版本符合上述范围，并在启动后检查插件是否正常加载；其它 peer 冲突不能一概忽略。 Release 离线包安装

从 v0.5.11 Release 下载 dsh-liketavern-0.5.11.tgz（可配合同页的 SHA256SUMS.txt 校验完整性），在下载目录执行：

版本检查与升级 检查更新：进入 「设置 → Tavern → 关于」，分别查看当前插件与最新发布的宿主版本要求、开发验证基线和兼容记录。有新版时点击 「更新到…」 查看安装步骤；宿主版本未知也可查询，兼容性会显示为待确认。 桌面端升级：先查阅 CHANGELOG.md 并备份数据；点击关于页的 「更新到… → 复制安装地址」，在桌面端「插件 → 添加插件」中使用新版标签地址安装，完成后完全退出并重启桌面端。安装由宿主插件管理器处理。 Web / CLI 升级：使用新版标签重新执行 dsh plugin --profile web add 并重启 dsh web。升级会自动沿用既有数据目录。

当前 dsh 0.2.2-rc.1 的原生版本列表与一键更新面向 registry 来源。本项目通过 Git 标签与 Release 分发，固定的旧标签不会自动切换到新标签，因此关于页提供独立的 GitHub 发布检查和明确的新安装地址。v0.5.9 及更早版本的旧检查器只识别精确宿主 peer，不能解析新版开放范围；首次升级请直接使用上方的 v0.5.11 地址安装一次。 新版将安装门槛与实际验证范围分别展示；满足版本要求不等于所有功能已在该宿主实测。 快速上手