前言¶
在 DSH（DeepSeek Harness）的插件生态里，Agent 默认以固定人格工作。如果你希望它换成某个角色的语气和行为，同时保留写代码、查资料、读文件等任务能力，就需要一个可以整体开启、随时关闭的角色层。
dsh-cosplay 就是针对这个需求：它是一个 DSH 插件，用全局开关让 Agent 进入角色扮演，并提供与 SillyTavern（酒馆）v2 规范对齐的角色卡导入/导出能力。
这里说明一下背景：DSH 的理念是「一切皆插件」；社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，不应视作官方应用商店。
这是什么¶
- 插件名：
dsh-cosplay - 维护者：ZelinW1
- 许可证：MIT
- GitHub：
https://github.com/ZelinW1/dsh-cosplay
一句话定位：让 DeepSeek Harness 的 Agent 扮演任何角色。
开启后，Agent 会以选定角色的人格、语气和行为守则对话，同时保留 Agent 能力：写代码、查资料、读文件仍然正常。
核心功能¶
-
全局开关
设置页可以一键开/关。开着时，所有会话进入角色扮演；关掉后立即恢复默认人格，下一轮对话生效。默认关闭。 -
思考风格
默认是中立思考：模型思考时保持专业分析，只在回复里扮演角色。
也可以切换角色化思考。角色化思考为概率触发，可能影响 Agent 任务能力，仅适用于 Deepseek v4。 -
角色卡
角色卡对齐 SillyTavern（酒馆）v2 规范，支持导入/导出标准 v2 JSON。 -
自然语言建卡
可以让 Agent 搜索设定、整理成卡，并写入角色库。 -
内置默认角色
内置一条默认角色：蓝色大肥鱼（鲸鱼娘），安装后可直接使用。 -
插件特有字段
style、rules、behavior随角色卡存储。导出时，这些字段会放进 v2 的extensions。
安装与启用¶
安装命令：
dsh plugin --profile web add dsh-cosplay
安装后重启 dsh 即可。
前提是 pnpm 在 PATH 中；Windows 上确保 pnpm.cmd 可用。
运行时需额外安装：
@deepseek-ai/schemastery
以下依赖由 dsh 自带解析，无需单独安装：
cordis
dsh-settings
dsh-tools
dsh-system-prompt
dsh-typert-protocol
典型用法¶
-
打开设置，进入「角色扮演」，打开开关。
开关默认关闭。 -
选择一个角色。
默认角色是蓝色大肥鱼（鲸鱼娘）。也可以新建、导入，或让 Agent 帮你生成角色卡。 -
新建一个会话正常聊天。
下一轮对话起，Agent 就是该角色。 -
想切换角色时：
- 在设置页点「设为当前」；或
- 在对话里让 Agent 用cosplay_switch切换。 -
想恢复默认人格时，关闭「角色扮演」开关。
关闭后，下一轮对话恢复默认人格。
开发检查¶
如果只是做语法检查，可以运行：
npm run check
dsh-cosplay 是纯 JS ESM 项目，无构建步骤。修改 src/ 后，重启 dsh 即可生效。
适用场景与注意¶
适合：
- 你已经在用 DSH，希望给 Agent 加一个可全局开关的角色层；
- 你希望 Agent 在角色扮演时仍然保留写代码、查资料、读文件等能力；
- 你需要和 SillyTavern（酒馆）v2 角色卡导入/导出互通；
- 你想用自然语言让 Agent 搜索设定、整理角色卡并写入角色库。
注意：
- 许可证为 MIT；
- 角色化思考为概率触发，可能影响 Agent 任务能力，仅适用于 Deepseek v4；
- 角色扮演开关默认关闭；关闭后下一轮对话恢复默认人格；
- 安装依赖需要
pnpm在PATH中，Windows 上确保pnpm.cmd可用； - 插件以当前
dsh进程权限运行，安装前应检查源码与许可证。
链接¶
GitHub：https://github.com/ZelinW1/dsh-cosplay
目录页：DSH 社区目录（独立站点，非官方应用商店）。已核实资料未包含可验证的目录页 URL，本文不给出具体链接。
