在 DeepSeek Harness (DSH) 的生态中，构建一个具备长期记忆、性格稳定且能进行复杂互动的智能体通常需要大量 Prompt 工程或多个插件组合。ajuwm/dsh-roleplay-plugin 插件针对这一需求，提供了一个以沉浸式角色扮演为核心、桌面悬浮宠物为附加功能的解决方案，专注于提升角色的真实感与交互连贯性。
这是什么¶
该插件由用户 ajuwm 维护，是一款以沉浸式角色扮演为主体、桌面悬浮宠物为附加功能的 DSH 插件。它主要解决智能体在长期对话中记忆管理混乱、人设容易崩塌以及缺乏生活互动感的问题。
核心功能¶
- 多角色与记忆管理：支持 SillyTavern 导入角色卡，具备独立记忆、日记、世界观、亲密度与养成数值，角色间完全隔离。支持角色卡库全局共享，跨对话与预设切换时保持状态。
- 开局引导与设计：提供分步引导，每步可回复「你定」，由 AI 现场设计角色名与设定。收集完生成人格档案并开演。
- 真实感增强：包含隐藏人格档案与底线三问，使角色具备独立判断与反对权（如傲娇怼、软钉子等）。
- 多角色房间：支持 1 玩家 + 2~3 角色的同台互动，各有各的记忆与关系。
- 生活与互动系统：包含心跳系统（7 档时段）、想念与纪念日提醒、看桌面（原生图片支持）。
- 叙述与剧本模式：提供小说、剧本、精简三种输出风格，以及剧本模式（用户定开头结尾，中间自由扮演）。
- 养成与亲密度：包含生命体征（饱食/健康/心情/生命）、金币商城、三轴亲密度系统（好感/信任/心动）及里程碑（m1-m8）。
- 剧情连续性：章节式剧情档案（
roleplay_story），支持跨会话恢复。 - 侧栏设置：全部设置集中在侧栏，无需开演即可编辑。
- 桌宠：桌面悬浮立绘窗口，支持拖动、触摸、双击对话与气泡嘀咕。
安装与启用¶
安装需要 DeepSeek Harness Web 版（DSH 0.1.1+）以及 pnpm 环境（DSH Desktop 自带，Web 版需自行安装）。
dsh plugin --profile web add github:ajuwm/dsh-roleplay-plugin
安装完成后重启 DSH。角色扮演预设会自动物化到指定目录，侧栏会自动挂载相关组件。
典型用法¶
- 启动与引导：重启 DSH 后，新建会话，说「开始」或「开演」即可开始引导流程。在引导中，每一步都可以回复「你定」，让 AI 现场设计角色名与设定。
- 桌宠素材：如果启用桌宠功能，需将立绘素材放入 DSH 工作区下的
pet目录（注意：素材需自行准备，不包含版权图片）。 - 多角色互动：在对话中输入「让 A 和 B 一起陪我」，或在侧栏选择「房间」模式即可开启多角色同台互动。
适用场景与注意¶
- 适用场景：适合希望在 DSH 中快速构建具备长期记忆、生活感和复杂情感关系的智能体用户。
- 环境要求：官方 DeepSeek 适配器原生支持图片，无需额外视觉插件。
- 桌宠说明：桌宠是可选附加功能，关闭桌宠不影响核心角色扮演功能。
- 安装注意：安装推荐使用官方插件命令，Web 版需要 pnpm。由于插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证。
总结¶
该插件通过系统化的数值管理、隐藏人格档案和剧情连续性存档，显著降低了构建高质量角色扮演智能体的门槛。更多细节请访问 插件目录页 或 GitHub 仓库。
