让 DeepSeek Harness 的 Agent 扮演任何角色:全局扮演开关、酒馆 v2 角色卡(JSON 导入导出)、中立/角色化思考切换,内置 skill 支持一句话生成角色卡。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-cosplay
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:ZelinW1/dsh-cosplay
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
让 DeepSeek Harness 的 Agent 扮演任何角色。
这是什么?
一个 DSH(DeepSeek Harness)插件。开启后,Agent 会以你选定的角色人格、语气和行为守则来对话,同时保留干活的能力(写代码、查资料、读文件正常)。内置一条「蓝色大肥鱼」;也可以自己创建任意角色,或者一句话让 Agent 帮你搜设定、生成角色卡。
功能
- 全局开关:设置页一键开/关。开着的时候所有会话都进入角色扮演;关掉立即恢复默认人格(下一轮对话生效)。
- 思考风格:默认「中立思考」——模型思考时保持专业分析,只在回复里扮演,保 Agent 能力;全沉浸可切「角色化思考」(注:概率触发,可能影响 Agent 任务能力,仅适用于 Deepseek v4,方法参考:https://github.com/victorchen96/deepseek_v4_rolepaly_instruct )。
- 角色卡:对齐 SillyTavern(酒馆)v2 规范;支持导入/导出标准 v2 JSON。
- 自然语言建卡:直接说"帮我生成一个角色卡,角色为:XXX",Agent 会自己搜索设定、整理成卡、写入角色库。
- 内置默认角色:蓝色大肥鱼(鲸鱼娘)🐋,装完即用。
安装
桌面版
在左侧栏 插件 页安装本插件,或让 Agent 帮你装:
安装插件 dsh-cosplay
装完完全退出并重启桌面版(关窗口不等于退出,后台仍会继续跑任务)。
命令行
dsh plugin --profile <profile> add dsh-cosplay
装完重启 dsh 即可。前提:pnpm 在 PATH(Windows 上确保 pnpm.cmd 可用)。
依赖说明:运行时只需额外装一个
@deepseek-ai/schemastery;其余服务包(cordis、dsh-settings、dsh-tools、dsh-system-prompt、dsh-typert-protocol)由 dsh 自带解析,无需单独安装。
使用
- 打开设置 → 「角色扮演」→ 打开开关(默认关闭)。
- 选一个角色(默认蓝色大肥鱼),也可以新建、导入,或让 Agent 帮你生成。
- 新建一个会话正常聊天——下一轮对话起,Agent 就是那个角色了。
- 想换角色:设置页点「设为当前」,或对话里让 Agent 用
cosplay_switch切换;随时关开关恢复默认。
角色卡字段
对齐酒馆 v2:name、description(身份)、personality(性格)、scenario(场景)、first_mes(开场白)、mes_example(示例对话)、system_prompt(置顶指令块)……全部自由文本,想写多详细写多详细。插件特有的 style(语气)、rules(守则)、behavior(行为)也随卡存储,导出时放进 v2 的 extensions,互相不干扰。
兼容性
| DSH 版本 | 支持情况 |
|---|---|
| 0.2.x(含桌面版 0.2.0-rc.2) | ✅ 支持 |
| 0.1.x 及更早 | ❌ 不支持,请改用旧版插件 dsh-cosplay@0.4.0 |
⚠️ 从 0.4.0 升级的用户:角色库不会自动迁移,升级后列表里只有内置的「蓝色大肥鱼」。你原来的角色仍在
$DSH_HOME/settings.yaml.imported文件里(cosplay:段),可以照着用设置页的「导入角色卡」逐个重建,或手工把那段内容填进新位置。
许可
见 LICENSE 文件。
链接
同类插件
PC2005-cloud/dsh-pet#dsh-pet★ 6436
DSH Web UI 桌面宠物,Windows / macOS / Linux 三端可用:浏览器浮层或透明置顶桌面窗口,106 个透明动画、带挤压与粒子的甩抛反弹物理、随会话事件实时联动的工作状态气泡、碎碎念与带持久记忆的对话、余额展示、表情包配图、多开同屏,并支持直接放入的自定义动画与宠物种类(pet pack)。
flizzywine/dsh-tavern#dsh-tavern★ 1655
基于 DeepSeek Harness 的 Agent 酒馆,兼容 SillyTavern 生态,人物卡导入即玩,支持多种模型和手机游玩。桌面端从「设置 → 酒馆启动器」安装酒馆。 基于 2NF/dsh-profile-bridge(MIT)改造的启动器:把酒馆下载到独立 DSH 配置并在重启时切换。与上游插件不能同装——两者都占用 /profile-bridge 通道。
Alterssss/dsh-bili-whale★ 1070
一条按自己作息过日子的 B 站插件:宿主里每 60 秒一次心跳,在设定的作息窗口里随机挑一个时刻叫醒专用会话(今天不想看是按概率跳过),再交给自带的 38 个子命令——信息流、字幕、弹幕、评论、ffmpeg 抽帧、两本日记。每天最多发 N 条评论/动态并 @ 主人(默认 3,按配额账本计数,撞到限流或验证码就停手)。同时轮询评论回复、私信和直播间弹幕;除主人以外的回复先入队,等主人在设置页批准。设置 → 养鱼 写 ~/.dsh/bili-whale.config.json;cookie 单独在 ~/.bili-ai/credentials.json,只写不回显。HTTP 路由只认回环地址并过 DSH 信任栅栏。抽帧需要 Node 18+ 与 ffmpeg。
Nagi-ovo/dsh-ads★ 730
2005 年中文站点风格的整活广告插件:侧栏广告/信息流/角落弹窗 + 假关闭叉,素材全虚构。
yyh-001/dsh-meme★ 583
聊天表情包:纯文本斗图、情绪主动发图、像 QQ/微信 一样发图、AI 自动学图、自定义表情包。
vlln/whale-girl★ 412
桌面宠物(QQ 宠物形态):右下角悬浮、可拖拽/投喂/玩耍。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。