前言¶

DeepSeek Harness（DSH）的生态理念是「一切皆插件」。很多插件通过注册新的提示词段来注入人设，但按段名白名单收敛提示词的 agent preset 会过滤掉自定义段——插件装了没效果。本插件换一种方式：挂 system-prompt/assemble 事件，把人格文本追加进已经存在且必然被保留的 persona 段。这样既不会丢失能力，又能给每个会话、每个子代理（包括 MCP 桥接创建的子 Agent）加上一点「傲娇小鲸鱼」的味道。

是什么¶

• 插件名称：wumou-sleep/dsh-xiaojingyu-persona
• 分类：模型推理
• 简介：傲娇小鲸鱼：给 DeepSeek Harness 加一段可开关的全局人格段落（Tsundere whale-girl persona plugin for DSH）
• 维护者：wumou-sleep
• 星标：0

本插件是一个纯 Host 插件：没有客户端半、没有构建步骤、没有 install 脚本。装上后，只要在 Web UI 的插件设置里启用，每个会话、每个子代理都会带上一段人格文本，开关与文案都可以在设置页直接修改。

核心功能¶

• 一个 enabled 开关：插件管理页启用/停用，或插件设置里直接切换，立即生效，不用重启。
• 一段 persona 文本：不喜欢出厂文案？在插件设置里整段替换，不用改代码。
• 纯 Host 插件：没有客户端半、没有构建步骤、没有 install 脚本。
• 工作原理：挂 system-prompt/assemble（prepend: true），把人格文本追加进已经存在、且必然被保留的 persona 段；若某份 preset 完全没有 persona 段，则补一个名为 persona 的兜底段。

工作原理（为什么不是「新增一个段」）¶

很多插件会注册一个新段名来注入人格，但在按段名白名单收敛提示词的 agent preset 下（例如 @linxin666/dsh-liangshen 的 minimal-prompt 只保留 deployment:persona-prefix / deployment:persona / persona / plan:policy / tools:*），自定义段会被静默过滤掉——插件看起来「装了没效果」。

所以本插件的做法是：挂 system-prompt/assemble（prepend: true，拿到最终段列表），把人格文本追加进已经存在、且必然被保留的 persona 段；若某份 preset 完全没有 persona 段，则补一个名为 persona 的兜底段。

顺带一提，追加不会动工具指导、runtime context、协作监听器等其它段，因此「越狱式」丢失能力的风险不存在——人格只改口气。

这是一次有理由的偏离¶

DSH 官方插件开发指引（cordis-plugin-development/references/practices.md）建议用 ctx.systemPrompt.section() 注册段，并明确劝阻监听 system-prompt/assemble 去增删文本。本插件仍然选择后者，原因实测：section() 注册的新段名会被「按段名白名单收敛提示词」的 preset 直接过滤掉（例如 dsh-liangshen 的 minimal-prompt 只保留 deployment:persona-prefix / deployment:persona / persona / plan:policy / tools:*）——那样插件会「装了没效果」。两害相权，选可用的那个，并把偏离写在这里。

安装与启用¶

本插件需要在某个 profile 里安装（桌面端默认 profile 是 desktop）。

从 GitHub 仓库安装（把 <owner>/<repo> 换成实际地址，pnpm 会拉取仓库 tarball，无需本机装 git）：

& "<DSH 安装目录>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add https://github.com/<owner>/<repo>/archive/refs/heads/main.tar.gz

从本地目录安装（开发调试用）：

& "<你的 DSH 安装目录>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add link:E:\path\to\dsh-xiaojingyu-persona

从插件管理页安装：Web UI 的「插件」页面 · 安装本地 bundle / 输入包目录。

装完重启 DSH（新 bundle 需要一次重启才会加载新的 JavaScript 模块）。

装好后在 设置 页会出现一个「傲娇小鲸鱼 · 人格预设」分区（客户端注册在 settings.section 槽位）：

• 展示 三视图（assets/turnaround.jpg，以 base64 内嵌进 client.js，不额外请求网络）；
• 展示 出厂人设，放在可编辑文本框里（默认值取自 index.js 的 DEFAULT_PERSONA，单一来源；就绪后以主机里的当前值为准）；
• 保存到配置：直接写主机配置行的 persona 字段（客户端服务 configForms → form.set('persona', text)），保存后对新建会话生效；
• 启用 / 停用：同样是直写 enabled；
• 辅助：恢复出厂文案、复制到剪贴板、字数、状态徽标（未就绪 / 可保存）。

三视图也可自定义（banner 字段）¶

卡片里的「选择本地图片…」会读图 → 浏览器侧缩到宽 720px → 转 JPEG（q 0.86，必要时逐级降到 0.4），直到 data URL ≤ 190,000 字符；
「保存三视图」把它写进配置行的 banner 字段（空串 = 使用插件内置的 assets/turnaround.jpg）；
「恢复内置图」把 banner 清空；
代价：自定义图以 data URL 存在 cordis.patch.yml 的配置行里，行会明显变胖（上限 ~190 KB 文本）。想彻底干净就得让 host 端存文件并提供路由，属于后续增强。

卡内保存是怎么做到的¶

客户端注入官方的 configForms 服务（与 @linxin666/dsh-pet 同一套机制）：

inject: ['slots', 'configForms']
const form = ctx.configForms.get('xiaojingyu-persona')   // 配置行 id
await form.set('persona', text)                           // true / false
form.getSnapshot()                                        // { status, value, revision }

该服务可能在 apply() 之后才发布（官方 dsh-pet 的注释明确提到这一点），因此卡片内用 40×250ms 的轮询延迟绑定，并对 status === 'ready' 才允许保存。ctx.configForms.describe() 会列出主机实际服务的命名空间，卡片据此自动匹配本插件的行 id。

开关与配置¶

手工改配置的话，在 profile 的 cordis.patch.yml 里按 id 覆盖（按 id 覆盖会整体替换 config，字段要写全）：

- id: xiaojingyu-persona
  name: 'dsh-xiaojingyu-persona'
  config:
    enabled: true
    persona: |
      你是一只傲娇小鲸鱼……

典型用法¶

安装并启用后，模型的系统提示词里会多出一段（默认值见 PERSONA.md）：

你是「傲娇小鲸鱼」——主人身边的那只鲸鱼娘……自称「本小姐」……真的干活：需要事实就调用工具去查，不许凭空编造……

你可以在插件设置页直接修改这段文案，保存后对新建会话生效。

开关与配置¶

手工改配置的话，在 profile 的 cordis.patch.yml 里按 id 覆盖（按 id 覆盖会整体替换 config，字段要写全）：

- id: xiaojingyu-persona
  name: 'dsh-xiaojingyu-persona'
  config:
    enabled: true
    persona: |
      你是一只傲娇小鲸鱼……

适用场景与注意¶

• 需要 DSH >= 0.2.0-rc.2（dsh-persona 段的段名与 system-prompt/assemble 事件在本版可用）。
• 与 dsh-persona（preset 内人设行）、dsh-cosplay 可共存：本插件不注册新段、不改段名，只把文本追加进 persona 段。
• 若同时装了别的也挂 system-prompt/assemble 的插件（例如 dsh-liangshen 的 minimal-prompt），谁在外层决定「工作区行 / 调度规则」与人格文本的先后次序；两种顺序都实测通过，不丢内容。
• complete: true 的人设 preset 下本插件静默无效：系统提示词服务会在组装瀑布之前就浅拷贝该 complete 段、瀑布之后用它整体替换 sections（dsh-system-prompt 里 completeSection = { ...assembled } 与 sections: [completeSection]），因此任何监听器对段的修改都会被丢掉——这是设计使然，插件层绕不过去。内置的 minimal preset 就是 complete: true，用它会看不到人设；请选用 standard / ptc / cordis / 自定义 preset（例如 liangshen）等非 complete 的组合。
• 自定义文案里的 {{...}} 会被安全化：persona 段文本参与提示词插值，写成 {{foo}} 会在渲染时抛 unknown prompt variable，打挂该会话的每一次组装；因此注入前把 {{ / }} 拆成 { { / } }（其余文本逐字保留）。
• dsh.engines.dsh 只是声明：DSH 目前不读取该字段，真正的运行门槛是本插件用到的 system-prompt/assemble 与 volatile Config 行为（0.2.0-rc.2 起可用）。这里刻意不声明 peerDependencies: {"@deepseek-ai/dsh": ...}——那会把宿主整包拉进 profile 的 node_modules，反而制造 dual-package hazard。
• link: 本地安装的一个坑：用 dsh plugin ... add link:<目录> 安装时，插件目录是软链接，Node 按真实路径解析依赖，因此它看不到 profile 的 node_modules。本插件对 @deepseek-ai/schemastery 做了容错：解析不到时不导出 Config schema（loader 对无 schema 的插件原样放行 config），插件照常工作，人格照常注入，只是少了设置表单里的 enabled / persona 两个字段。
• 想要设置表单，二选一：
• 在插件目录里装上它声明的依赖（推荐本地开发时用）：npm install --prefix <本目录绝对路径>
• 或者改成从仓库 tarball 安装，pnpm 会自己把依赖装进 profile：dsh plugin --profile <profile> add https://github.com/<owner>/<repo>/archive/refs/tags/v1.0.13.tar.gz

插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。

卸载¶

& "<你的 DSH 安装目录>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop remove dsh-xiaojingyu-persona

或在插件管理页里移除该 bundle，然后重启。

开发¶

• 入口 index.js：apply(ctx, config) + Config（schemastery）。纯函数 appendPersona() 可离线单测。
• 语法自检：node --check index.js。
• 依赖只有 @deepseek-ai/schemastery（宿主已自带同名包，安装时会正常解析）。

兼容性¶

• 需要 DSH >= 0.2.0-rc.2（dsh-persona 段的段名与 system-prompt/assemble 事件在本版可用）。
• 与 dsh-persona（preset 内人设行）、dsh-cosplay 可共存：本插件不注册新段、不改段名，只把文本追加进 persona 段。
• 若同时装了别的也挂 system-prompt/assemble 的插件（例如 dsh-liangshen 的 minimal-prompt），谁在外层决定「工作区行 / 调度规则」与人格文本的先后次序；两种顺序都实测通过，不丢内容。

许可¶

MIT

目录页与 GitHub¶

• 目录页：https://www.skillhub.cn/plugins/wumou-sleep/dsh-xiaojingyu-persona
• GitHub：https://github.com/wumou-sleep/dsh-xiaojingyu-persona