前言¶

在 DeepSeek Harness（DSH）里做 IM 桥接时，常见做法是接入渠道、把工作区与模型绑到机器人上，但回复语气往往仍像「通用助手」。若希望同一套 DSH 能力在不同聊天里呈现不同角色——例如固定性格、语气与补充要求，且不影响 / 命令与审批流程——就需要在消息进入模型前做可控的人设注入。

dsh-im-persona 是社区维护者 GASNOOVA 发布的个人定制版 IM 机器人插件：在保留微信、QQ 双渠道的前提下，基于 @xmanrui/dsh-im v5.10.0 独立改造（MIT，不追上游、不做合并），并新增每机器人级人设能力。插件在 SkillHub 目录归类为「趣味换装」，当前 GitHub 星标为 0；适合希望在 IM 里玩角色设定、又需要完整 DSH 任务闭环的开发者自行部署。

插件定位¶

dsh-im-persona 把微信与QQ接入 DSH，并为每个机器人单独配置角色人设（角色名、性格语气、自定义提示词）。人设会注入该机器人的每条普通用户消息；命令、审批与问题回答不注入。

仓库地址：https://github.com/GASNOOVA/dsh-im-persona
目录页：https://www.skillhub.cn/plugins/GASNOOVA/dsh-im-persona

核心能力¶

双渠道接入¶

同一渠道可挂多个机器人：凭据、连接状态、工作区、模型、Agent Preset、会话绑定彼此独立。

人设（Persona）¶

每个机器人可选一份人设，内置两条来自 dsh-persona-dafeiyu 的大肥鱼（私聊版）与大肥鱼（群聊版）；也可导入自定义人设：

• 在机器人卡片 → 人设 中从人设库选择、粘贴或导入本地 .md / .markdown / .txt（正文 ≤64,000 字符，名字 ≤60 字符）。
• 不选人设库时，可直接填写角色名、性格语气、补充要求。
• 可在插件 config 中用 personaFile 指定外部人设文件（只读，作为人设库 config 条目）。

保存后从下一条消息起生效；/new 后仍保留。数据持久化在 $DSH_HOME/integrations/dsh-im/。

与其它能力的关系（节选）¶

README 中还记载了闲时启用（高峰时段不调用模型、只回固定提示以省 API 成本）、实验性群聊大脑（小群主动接话、群记忆与成员画像）、QQ 群消息记录、访问模式与白名单、主动投递与延迟交付等。微信个人号群聊可通过可选的 agent-wechat 桥接（非官方协议，实验性）。下文安装与日常使用以双渠道 + 人设为主线；进阶项见仓库 docs/。

环境与前置¶

• Node.js >= 22.19
• DeepSeek Harness >= 0.2.1-rc.2（开发验证基线：0.2.2-rc.1，Web profile）
• 安装前需在插件源码目录执行 npm install 并 npm run build（lib/ 不提交仓库，必须构建后才能安装）

插件以当前 DSH 进程权限运行；安装前请阅读源码与 MIT 许可证，确认渠道凭据仅保存在本机 Host。

安装与启用¶

在已克隆或解压的插件目录中构建，再任选一种方式注册到 DSH（路径请换成你的实际目录）：

cd /mnt/volume/dsh/dsh-im-persona
npm install
npm run build

# 方式 A：本地链接（开发期推荐）
dsh plugin --profile web add -w link:/mnt/volume/dsh/dsh-im-persona

# 方式 B：个人版安装器
node bin/dsh-im-persona.mjs install --source .

# 方式 C：从 GitHub 添加（构建产物已就绪时）
dsh plugin --profile web add -w github:GASNOOVA/dsh-im-persona

安装后重启 dsh web，刷新浏览器，打开「设置 → IM机器人（个人版）」。

卸载：

dsh plugin --profile web remove dsh-im-persona

典型用法¶

1. 左侧主界面进入 IM机器人（也可在「设置 → IM机器人」打开）；不需要常驻入口时，可在「通用设置 → 通用 → 侧边栏入口」调整。
2. 面板仅显示 微信、QQ；点击「扫码接入」或「手动接入」创建机器人。
3. 在机器人卡片上配置工作区、模型 / 推理等级 / Agent Preset，并打开 人设 页签选择大肥鱼或导入自定义人设后保存。
4. 在微信或 QQ 中向机器人发普通消息即可开始；人设随每条用户消息注入，发 /help 等命令不受人设覆盖。

常用命令（微信与 QQ 均支持，细节略有差异）包括 /new、/workspace、/models、/preset、/history 等，完整列表见 README 第 6 节。

适用场景与注意¶

适合谁：已在用 DSH Web profile、希望用微信私聊或 QQ（含群 @）驱动智能体，并想给不同机器人固定角色语气或导入人设 Markdown 的开发者。

注意：

• 插件依赖构建产物，勿在未 npm run build 的情况下假定 lib/ 存在。
• 官方微信机器人无法进群；微信群能力依赖可选 agent-wechat，存在账号风控风险，宜使用专用小号。
• 闲时启用、群聊大脑、语音回复（feiyu / voice-hub，需外部 GPU）等为可选能力，未部署相关服务时应保持关闭。
• SkillHub 为社区插件目录，与 DeepSeek / 幻方无官方从属关系；版本以 package.json 为准（资料中记录为 5.10.0-personal.17）。

结尾¶

dsh-im-persona 在双渠道 IM 桥接之上补齐「每机器人人设」这一层：内置大肥鱼人设库、支持导入自定义角色，并与 DSH 工作区、模型、会话命令体系并存。若你要在聊天里固定角色而不是每次手写 system 提示，可按上文构建安装，从「人设」页签选库或导入文件即可。

• 目录页：https://www.skillhub.cn/plugins/GASNOOVA/dsh-im-persona
• GitHub：https://github.com/GASNOOVA/dsh-im-persona