前言¶

DeepSeek Harness (DSH) 的核心设计理念是「一切皆插件」。对于角色扮演开发者而言，在 DSH 中复用现有的 SillyTavern (Tavern) 角色卡资源是一个实际需求。DSH RolePlay 旨在解决这一痛点，它不仅兼容 Tavern 角色卡，还提供了原生的 Agent RolePlay 能力。

插件概览¶

DSH RolePlay 是 DeepSeek Harness 的 Tavern 角色卡兼容与原生 Agent RolePlay 插件。插件由 RiemannRe3 维护，采用 MIT 许可证。它将角色卡库、对话界面和右侧功能页整合在同一个视图中，选卡和配置无需离开当前对话。

系统要求与安装¶

使用前需满足以下条件：

• Node.js 版本：22.19.0 至 22.x，或 24.13.1 至 24.x。
• 环境依赖：需先安装 DeepSeek Harness。

安装步骤如下：

1. 在终端执行安装命令，将插件安装至 DSH 的 web profile：

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

2. 启动 DSH Web 服务：

    dsh web

核心功能¶

插件提供以下核心能力：

• 角色卡兼容：支持 Character Card V2/V3 的 PNG 与 JSON 导入。
• 多模态配置：支持多开场、世界书、预设、Persona 与 Regex。
• 生态接口：兼容 EJS、iframe、MVU 与 TavernHelper 常用接口。
• 卡内交互：支持卡内 HTML、交互按钮和独立前端运行状态。
• 会话管理：支持会话保存、刷新恢复与重启恢复。
• 界面整合：卡库、对话和右侧功能页在同一个界面里。

使用流程¶

安装完成后，通过以下步骤开始使用：

1. 打开设置，选择模型提供商，填写 API Key 和模型名称。
2. 进入对话界面，点击左侧的「酒馆」入口。
3. 点击「导入」，选择 Character Card V2/V3 的 PNG 或 JSON 文件。
4. 展开角色卡，选择开场并创建新游戏。
5. 进入对话后，页面右侧可以打开世界书、预设、Regex、前端、卡片和 Persona 等功能页。

插件管理¶

在 DSH 设置中找到「插件 -> DSH RolePlay」可以启用或停用插件。停用后，酒馆入口和相关运行能力不会加载，但已导入的角色卡和会话数据仍会保留，重新启用即可继续使用。

若需更新或卸载，可执行以下命令：

• 更新：

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

• 卸载：

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

注意事项¶

• 插件以 DSH 进程权限运行，使用时需注意安全与权限范围。
• 请在使用前查看源码与许可证，确保符合使用规范。

参考资料¶

• DSH RolePlay GitHub 仓库
• DSH RolePlay 社区目录