前言¶
在 DeepSeek Harness（DSH）里做智能体扩展时，常见需求不止是接入一个模型或工具，而是把角色设定、角色卡管理、图片生成等能力放进同一个 web profile 中使用。DSH 的理念是「一切皆插件」，社区目录作为独立站点收录部分插件，与 DeepSeek / 幻方没有官方从属关系。
dsh-roleplay 是 chinosk6 维护的 DSH 插件，面向 DeepSeek Harness，提供角色扮演、角色卡创作/导入和图片生成能力。
这是什么¶
dsh-roleplay 是一个 DSH 插件，主要用于：
- 角色扮演对话
- 角色卡创作与导入
- 调用图片生成接口
许可证为 MIT。
环境要求¶
使用前需要满足以下条件：
dsh0.1.0-rc.6+- Node
22.19+ pnpm9+
核心功能¶
下面介绍已核实的能力。
角色扮演¶
插件支持 Role-play conversations，也就是在 DSH 中进行角色扮演式对话。
角色卡创作与导入¶
插件支持角色卡创作，并支持酒馆兼容角色卡的生成 / 导入。
具体包括：
- 支持交互式创建角色卡
- 支持酒馆兼容角色卡生成 / 导入
- 支持导入 RP-Hub 角色卡
README 中提到，部分提示词参考了 RP-Hub 项目。
图片生成¶
插件支持图片生成，并可接入以下接口：
- NAI 官方接口
ai.erp.sex三方接口- Stable Diffusion WebUI 本地接口
安装与启用¶
先确认环境满足上面的版本要求，再选择安装来源。
从 npm 安装¶
如果插件已经发布到 npm，可以使用下面的命令安装到 web profile：
dsh plugin --profile web add -w dsh-roleplay
这条命令会把 dsh-roleplay 添加到当前 web profile 的插件列表中。
从 GitHub 安装¶
也可以直接从 GitHub 仓库安装：
dsh plugin --profile web add -w github:chinosk6/dsh-roleplay
如果安装时需要指定分支或 tag，可以使用 # 后面的版本引用：
dsh plugin --profile web add -w github:chinosk6/dsh-roleplay#v0.1.0
Git 安装的构建脚本配置¶
从 GitHub 安装时，插件会运行 prepare 来构建 lib/。
如果 pnpm 提示忽略了 build script，可以在下面的文件中配置允许构建：
~/.dsh/profiles/web/pnpm-workspace.yaml
配置内容如下：
allowBuilds:
dsh-roleplay: true
配置完成后，再重新执行安装或启动流程。
更新插件¶
更新插件使用下面的命令：
dsh plugin --profile web update dsh-roleplay
更新完成后，需要重启 dsh。
卸载插件¶
卸载插件使用下面的命令：
dsh plugin --profile web remove dsh-roleplay
注意：卸载后，角色卡和生成图片的缓存仍可能留在：
$DSH_HOME/roleplay/
如果需要彻底清理，需要手动删除该目录中的相关文件。
本地构建与添加¶
如果要从本地仓库使用，可以先构建，再添加本地目录。
构建插件¶
在项目目录中执行：
pnpm install
pnpm run build
这一步会安装依赖并执行构建脚本。
添加本地仓库到 dsh¶
构建完成后，将当前本地仓库目录添加到 DSH：
dsh plugin --profile web add -w .
之后需要重启 dsh web。
适用场景与注意¶
这个插件适合以下几类使用场景：
- 在 DSH 的 web profile 中使用角色扮演对话
- 需要导入或创建角色卡
- 需要调用 NAI、
ai.erp.sex或 Stable Diffusion WebUI 等图片生成接口 - 希望统一管理 DSH 插件、更新和卸载
使用前需要注意：
- 插件会以当前
dsh进程权限运行，安装前应检查源码和许可证 - 本项目许可证为 MIT
- 从 GitHub 安装时可能触发
prepare构建流程 - 卸载插件不会自动清理
$DSH_HOME/roleplay/下的缓存文件
相关链接¶
dsh-roleplay 的价值在于把角色扮演、角色卡管理和图片生成能力纳入 DSH 插件体系中，减少单独搭建流程的成本。
目录页：
- https://www.skillhub.cn/plugins/chinosk6/dsh-roleplay
GitHub：
- https://github.com/chinosk6/dsh-roleplay
