chinosk6/dsh-roleplay 预览 preview

chinosk6/dsh-roleplay

Deepseek Harness 角色扮演插件 用于DeepSeek Harness的角色扮演对话、角色卡创作和图像生成

Project Overview项目介绍

dsh-roleplay is a native roleplaying plugin built exclusively for DeepSeek Harness (DSH). It can be installed, updated, and removed directly via DSH’s built-in plugin management command, with options to pull the package from npm or directly from its GitHub repository. Core features include support for generating and importing Tavern-style character cards, an interactive workflow for creating new character cards from scratch, and integration with multiple image generation APIs to produce roleplay-related art. To install from GitHub, you can specify a branch or tag to pull a specific version of the plugin.

This plugin is targeted at users who enjoy creating and roleplaying with custom characters using DeepSeek large language models. Users can start right away by importing an existing Tavern character card, or they can walk through the plugin’s interactive step-by-step prompt to build a fully custom character card that matches their exact needs. When generating character art, users can pick from multiple available APIs based on their access to cloud or local resources, supporting both cloud-based fast generation and local offline generation.

For the plugin to work correctly, you need DSH version 0.1.0-rc.6 or newer, Node.js 22.19 or newer, and pnpm 9 or newer as your package manager. After you uninstall the plugin, any cached character cards and generated images will remain in the $DSH_HOME/roleplay/ directory, so you need to delete those files manually if you want to fully remove all plugin data. If you install from source and pnpm blocks the build script, you will need to add an exception for dsh-roleplay in your pnpm workspace config to allow the build to run.

这是一款专为 DeepSeek Harness (DSH) 开发的原生角色扮演插件,可通过 DSH 的内置插件管理命令直接从 npm 公共 registry 或 GitHub 源码仓库安装、更新和卸载。核心功能包括支持酒馆格式角色卡的生成、导入,还提供交互式创建角色卡的工作流,同时集成了多个接口生成角色扮演相关图片。它归属于视觉媒体、会话上下文和预设提示词分类,遵循 MIT 许可证开源发布。

这款插件面向喜欢在 DeepSeek 大模型对话中进行角色扮演创作的用户,用户既可以导入已有的酒馆格式角色卡快速开始体验,也可以通过插件提供的交互式引导一步步创建符合自己需求的全新角色卡。生成角色相关图片时,用户可以根据自身资源情况选择调用不同接口,同时满足云端快速生成和本地部署离线生成的不同需求。

运行该插件要求 DSH 版本不低于 0.1.0-rc.6,Node.js 版本不低于 22.19,包管理器需要使用 9 以上版本的 pnpm。卸载插件后,角色卡和生成图片的缓存会残留在 DSH 家目录的 roleplay 文件夹下,需要用户手动删除。从 GitHub 源码安装时,如果 pnpm 提示忽略构建脚本,需要手动修改配置允许构建。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 12 stars - an early-stage project星标 12,属于早期项目
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add -w dsh-roleplay

把 chinosk6/dsh-roleplay 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-roleplay

npm

English | 简体中文

  • DeepSeek Harness 角色扮演插件

screenshot1

功能

  • 酒馆兼容角色卡生成 / 导入,支持交互式创建角色卡

  • 图片生成,支持:

    • NAI 官方接口
    • ai.erp.sex 三方接口
    • Stable Diffusion WebUI 本地接口

环境要求

  • dsh 0.2.0-rc.2+(仍在 dsh 0.1.x 上请安装 dsh-roleplay@0.5.2)
  • Node 22.19+
  • pnpm 9+

安装

从 npm

dsh plugin --profile web add -w dsh-roleplay

从 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 安装会运行 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

Windows 上若 npx / pnpm 被执行策略拦住,可直接:

node node_modules/typescript/bin/tsc -p tsconfig.json --noEmit
node node_modules/typescript/bin/tsc -p tsconfig.client.json --noEmit
node scripts/build.mjs

添加本地仓库到 dsh

dsh plugin --profile web add -w .

之后重启 dsh web

致谢

  • 支持导入 RP-Hub 角色卡,部分提示词参考了此项目。
← 上一个 Prev dsh-opencode-free-models 下一个 Next dsh-studio →