DSH RolePlay

August 30, 2026 · View on GitHub

npm version GitHub Release License: MIT

DSH RolePlay 是 DeepSeek Harness 的角色扮演插件。项目方向是 Agent RolePlay；当前版本先解决 SillyTavern 角色卡及其常用生态在 DSH 中的导入和运行。

支持 Character Card V2/V3、多个开场、世界书、预设、Persona、Regex、EJS、MVU、TavernHelper 常用接口和卡内前端。

DSH RolePlay 的卡库、对话和卡内界面

卡库、对话和右侧功能页在同一个界面里。选卡、换开场、调世界书或查看脚本状态，不用离开当前对话。

Windows 安装

1. 准备 Node.js

需要以下任一 Node.js 版本：

  • Node.js 22.19.0 至 22.x
  • Node.js 24.13.1 至 24.x

在 PowerShell 中检查当前版本：

node --version
npm --version

如果命令不存在，先从 Node.js 官网 安装符合要求的版本，再重新打开 PowerShell。

2. 安装 DeepSeek Harness

npm install --global @deepseek-ai/dsh@0.1.1-rc.2

安装完成后检查命令是否可用：

dsh --version

3. 安装 DSH RolePlay

dsh plugin --profile web add @riemannre3/dsh-roleplay

这条命令会把插件安装到 DSH 的 web profile。更新插件时再次执行同一条命令即可。

4. 启动 DSH Web

dsh web

保持这个 PowerShell 窗口运行，打开终端中显示的本机地址。

首次使用时：

  1. 打开“设置 → 模型”。
  2. 选择模型提供商，填写 API Key 和模型名称。
  3. 回到“对话”，进入左侧“酒馆”。
  4. 点击“导入”，选择 Character Card V2/V3 的 PNG 或 JSON。
  5. 展开角色卡，选择开场并创建新游戏。

进入对话后，页面右侧可以打开世界书、预设、Regex、前端、卡片和 Persona。

5. 启用与停用

在 DSH 设置中启用或停用 DSH RolePlay

打开“设置 → 插件 → DSH RolePlay”，可以随时启用或停用插件。停用后，“酒馆”入口和相关运行能力不会加载；已经导入的角色卡和会话数据仍会保留，重新启用即可继续使用。

6. 下载与帮助

下载最新版 · npm · 问题反馈

下载演示卡

安装插件后，可以下载这些 Character Card V3 PNG，直接从“酒馆 → 导入”开始：

来源、改作说明和许可证见 演示卡说明。

角色卡

角色卡详情页

角色描述、场景、首条消息、备选开场和扩展字段都可以直接查看和编辑。支持 Character Card V2/V3 的 PNG 与 JSON。

Persona

Persona 管理页

Persona 独立管理，可以在不同对话中切换，不必反复改角色卡。

世界书

世界书编辑页

世界书条目有触发词、插入位置、顺序和启用状态。角色卡自带的世界书会随卡导入，也可以单独调整。

预设与上下文

对话补全预设编辑页

预设按槽位编辑，角色描述、世界书、历史消息和系统提示的顺序可以直接调整。

一次真实请求的上下文装配结果

发送前可以检查本轮实际上下文，看到每一段内容来自哪里，以及最终使用的角色和 Token。

MVU、EJS 与卡内前端

卡内界面与前端运行面板

卡内 HTML、按钮和 iframe 可以直接显示在消息里。右侧前端页集中查看脚本、运行事件、MVU 状态和错误；EJS、Regex 与 TavernHelper 常用接口也由兼容层接入。

头图和各功能页来自不同演示内容，用来检查现代对话界面、复杂世界书、变量更新和卡内脚本。来源、修改内容和许可见 内容与许可说明。

现在支持

  • Character Card V2/V3 PNG 与 JSON
  • 多开场、世界书、预设、Persona 与 Regex
  • EJS、iframe、MVU 与 TavernHelper 常用接口
  • 卡内 HTML、交互按钮和独立前端运行状态
  • 会话保存、刷新恢复与重启恢复
更新、卸载、离线安装与源码构建

更新

dsh plugin --profile web add @riemannre3/dsh-roleplay
dsh web

卸载

dsh plugin --profile web remove @riemannre3/dsh-roleplay

离线安装

从 Releases 下载 .tgz 文件：

dsh plugin --profile web add C:\Downloads\dsh-roleplay-<version>.tgz
dsh web

源码构建

git clone https://github.com/RiemannRe3/DSH-RolePlay.git
cd DSH-RolePlay
npm ci --legacy-peer-deps
npm run build
dsh plugin --profile web add .
dsh web

License

插件代码使用 MIT License。演示角色卡及截图中的卡片内容按 CC BY 4.0 使用，详见 THIRD_PARTY_NOTICES.md。