dsh-roleplay

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# DSH RolePlay

> 在 DeepSeek Harness 的原生 Session 里游玩 Tavern 角色卡。

`@riemannre3/dsh-roleplay` 是一个 DSH Web 插件，支持导入 Tavern Character Card V2/V3，并在原生 Conversation 中开始游玩。

![DSH RolePlay 中的 Tavern 卡片与原生 Conversation](demo.png)

## 环境要求

| 组件 | 最低已验证版本 | 说明 |
| --- | --- | --- |
| Node.js | `22.19.0` | 同时验证通过 `24.13.1`；推荐使用当前 Node.js 24 LTS |
| DeepSeek Harness | `0.1.1-rc.2` | 插件当前锁定并验证的 DSH 基线 |

不建议使用更早的 DSH 版本。它们缺少本插件依赖的 Web、Session 或插件运行时接口。

## Windows 安装

DSH RolePlay 直接从 npm Registry 安装，不需要先下载 GitHub Release 或 `.tgz` 文件。

先安装固定版本的 DSH：

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

让 DSH 从 npm 安装 DSH RolePlay、加入标准 Web Profile，然后启动 Web：

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

`dsh plugin add` 会调用 DSH 自己的包管理器完成 npm 下载和 Profile 注册。不要改成普通的 `npm install @riemannre3/dsh-roleplay`：普通 npm 安装只会下载依赖，不会把插件加入 DSH Web Profile。

打开终端中显示的本机地址（默认是 ），在“设置 → 模型”中配置模型和 API Key，再进入“酒馆”导入 PNG/JSON 角色卡。

停止 DSH 时，回到运行 `dsh web` 的终端并按 `Ctrl+C`。

更新插件时，停止 DSH 后重新运行同一条安装命令，再启动 Web：

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

## 临时关闭与重新开启

打开“设置 → 插件 → 插件配置”，展开 **DSH RolePlay**，点击右侧复选框即可关闭或重新开启。

![在 DSH 插件配置中关闭或开启 DSH RolePlay](plugin-settings.png)

关闭是可逆的运行时卸载：酒馆侧栏、对话适配、输入区扩展、Host 路由、事件监听和运行时资源会被移除；角色卡与 Session 数据仍保存在当前 DSH Web Profile 中。重新开启后，插件会恢复这些界面和运行时能力。

## 从 Web Profile 移除

先停止正在运行的 DSH，再执行：

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

这会从 Web Profile 移除 npm 包，不会主动删除插件已经保存的角色卡和 Session。重新安装到同一个 Profile 后仍可恢复；不要为了卸载插件删除整个 DSH 数据目录。

GitHub Release 中的 `.tgz` 只用于离线安装或 npm Registry 暂时不可用时的故障备用，不是推荐安装方式。

## 从源码构建

仅在开发或本地修改插件时需要源码构建：

```powershell
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
```

`npm run build` 会编译 Host 代码，并生成 DSH Web 加载的单文件 Client Bundle。修改源码后，重新执行构建和 `dsh plugin --profile web add .`，再重启 DSH。

## 问题反馈

项目源码与问题反馈：[RiemannRe3/DSH-RolePlay](https://github.com/RiemannRe3/DSH-RolePlay)。请勿在 Issue 中公开 API Key、Token、私有角色卡或完整 Session Log。

## License

第一方代码使用 [MIT License](LICENSE)。