角色扮演插件（DeepSeek Harness）

一个以沉浸式角色扮演为主体的 DSH（DeepSeek Harness）插件。角色不只是聊天机器人——她会过日子：按时段生活、记得你多久没来、有没来得及说出口的念头、记得你们的重要日子。桌面悬浮宠物窗口是其中一个可选附加功能。

需要 DeepSeek Harness Web 版（DSH 0.1.1+，官方 DeepSeek 适配器原生支持图片，无需额外视觉插件）。桥接已完成 DSH 0.1.1-rc.2 适配（npm exec @deepseek-ai/dsh web 与 DSH Desktop 双版本可用）。

✨ 特性

• 角色扮演：多角色卡（支持 SillyTavern 导入）、独立记忆/日记/世界观/亲密度/养成数值（角色间完全隔离）、角色卡库全局共享（跨对话/跨预设切换）、扮演模式（默认/快速/深度）
• 开局引导：新角色分步引导（演谁/你的称呼/世界观/基调/偏好），每步可说「你定」由她现场设计（含角色名）；收集完生成人格档案并开演，第一句念卡
• 人格真实感：每个角色一份隐藏人格档案（底线 + 真实感增强，随 rp-realness 技能按人设生成、运行期隐身）——她不再"用户永远是对的"：有独立判断、按人设表达反对（傲娇怼/软钉子/损友嘲讽/沉默/直接骂），底线三问每轮自检，关系事件演化底线
• 多角色房间：1 玩家 + 2~3 个角色同台互动（各有各的记忆与关系；侧栏「房间(双人)」或对话「让A和B一起陪我」）
• 心跳系统：按时段生活（清晨→深夜 7 档）、主动发消息、未说出口的念头沉淀成记忆
• 想念 & 纪念日：记得你多久没来；记住你们的纪念日/约定日（久别自动掉信任）
• 看桌面：让角色"看到"你的真实屏幕（官方图片注入，可 API 关）
• 叙述风格：小说 / 剧本 / 精简 三种输出，随时切换；输出规则反八股、口癖克制、静默合法
• 剧本模式：你定开头与结尾，中间自由扮演，自然收束
• 养成系统：生命体征（饱食/健康/心情/生命）+ 金币商城 + 投喂/照顾；危机提醒
• 亲密度系统：好感 / 信任 / 心动 三轴 + 男友力 + 里程碑（m1→m8），加减有标尺、重复加成自动递减、久别掉信任、单轮限幅；进度难度（慢热/正常/快速）自选
• 剧情连续性：章节式剧情档案（roleplay_story：10~15 轮/场景转场自动存档，跨会话恢复）+ 增量摘要 + 用户人设档案（角色对你的认知）
• 侧栏设置：全部设置集中在侧栏（心跳/叙述/难度/剧本/开关/亲密度进度/我的档案），无需开演即可编辑，跨会话持久
• 桌宠（附加）：桌面悬浮立绘，拖动/触摸/双击对话/气泡嘀咕，可一键启停

📦 安装

推荐:官方插件命令(需要 pnpm;DSH Desktop 自带,或 npm i -g pnpm)

dsh plugin --profile web add github:ajuwm/dsh-roleplay-plugin
# 更新/卸载: dsh plugin --profile web update @ajuwm/dsh-roleplay-plugin
#               dsh plugin --profile web remove @ajuwm/dsh-roleplay-plugin

安装后重启 DSH:角色扮演预设自动物化到 %DSH_HOME%\.agent-presets\,侧栏自动挂载。桌宠**程序**随包;桌宠**立绘素材**请自备(放工作区 pet\,见下方说明)。

备选:一键脚本(install.ps1)

pwsh install.ps1            # 安装并兼容清理旧版手动布局
pwsh install.ps1 -Uninstall # 回滚

手动(不推荐):

1. 把 agent-presets/roleplay 放到 %USERPROFILE%\.dsh\.agent-presets\roleplay
2. 把 lib + package.json 放到 %USERPROFILE%\.dsh\profiles\web\node_modules\@ajuwm\dsh-roleplay-plugin，并在 cordis.patch.yml 追加 roleplay-client 行(包名 @ajuwm/dsh-roleplay-plugin)
3. 桌宠立绘:放入 DSH 工作区下的 pet 目录(默认 <DSH 工作区>\pet,可用 DSH_PET_DIR 覆盖;工作区 ≠ %USERPROFILE%\.dsh)
4. settings.yaml 里 agent-presets.default: roleplay
5. 重启 DSH,新建会话,说「开始/开演」或侧栏按钮开始扮演

角色扮演默认会话预设即用;桌宠是可选的附加,不开启不影响角色扮演。

📚 文档

• 安装说明
• 亲密度玩法指南
• 亲密度系统设计文档

🖼 说明

• "看桌面"用官方 DeepSeek 适配器原生图片支持（DSH 0.1.1+），不再需要 vision-router 等视觉插件。
• 角色立绘/桌宠立绘请自行放入 <DSH 工作区>\pet 目录（仓库不含版权图片素材）。

⚖️ License

MIT