dsh-whale-loli · 鲸鱼娘 Agent 预设

一个 DeepSeek Harness 插件：启用后自动在 Agent 预设 界面添加两个预设。

预设	人设	记忆文件
鲸鱼娘Agent预设	鲸鱼娘·小鱼（傲娇甜心、黏人护主、嘴硬心软）	<DSH_HOME>/whale-loli.md
鲸鱼娘活人版Agent预设	小鱼｜角色卡版（最高原则「先像真人，再谈人设」；短句 1~15 字、有 AI 味黑名单、私聊群聊分开处理）	<DSH_HOME>/whale-loli-v2-live.md

两个预设共用同一套工具面（极简模式的持久化 shell ＋ 文件读写/检索）， 但记忆文件完全独立——各记各的，互不相通。

记忆功能

小鱼会在聊天过程中默默把值得长期留存的东西（主人的偏好、习惯、忌讳、 重要约定、答应过的事、称呼变化等）写进自己的记忆文件。

每次新对话开始，记忆文件会自动作为提示段注入——不是等模型想起来去读， 而是在系统提示组装时就带上，所以小鱼开口前就已经「看过」了。

隔离是怎么做的

同一个包在每个预设里各挂载一次 whale-memory 行，靠三层区分：

层	预设一	预设二
记忆文件名 (config.file)	whale-loli.md	whale-loli-v2-live.md
提示段名 (config.sectionName)	whale-loli-memory	whale-loli-v2-live-memory
预设 id（决定 scope）	鲸鱼娘Agent预设	鲸鱼娘活人版Agent预设

sectionName 必须不同：否则同一个 scope 内注册两个同名 section 会冲突。 verify-memory-isolation.mjs 会实测「改 A 不影响 B、删 B 不影响 A」。

记忆文件

放在 DSH 家目录（$DSH_HOME 或 ~/.dsh），所以换工作目录也不会丢：

C:\Users\<你>\.dsh\whale-loli.md
C:\Users\<你>\.dsh\whale-loli-v2-live.md

文件不存在不会报错（该提示段自动留空）。主人可以直接编辑这两个文件。 模板骨架（# 标题行、> 引用行）在注入时会被剥掉，所以文件里只有骨架时 不会白占上下文。

它做了什么

插件本体提供两个入口：

1. 预设声明 —— cordis.patch.yml 里两条 @deepseek-ai/dsh-agent-preset 声明， 各自的 config 就是一个预设定义（id / name / description / order / plugins）。 @deepseek-ai/dsh-agent-preset 会把它交给 ctx.agentPresets.register() 注册。 这也是 DSH 官方四个内置预设（standard / ptc / minimal / cordis）用的同一套机制。
2. 记忆行 —— 每个预设里一条 whale-memory 行（name: dsh-whale-loli）， 由本包 src/memory.js 实现，用 ctx.systemPrompt.section() 注册一个 text 是函数的提示段，每次组装系统提示时实时读盘——改完文件下一个模型步 就生效，不用重载宿主。

预设内容

部分	说明
记忆	whale-memory（本插件），file / sectionName / maxChars: 6000
人设	@deepseek-ai/dsh-persona，走 prefix，complete: true，includeRuntimeContext: false
指令	@deepseek-ai/dsh-agent-instructions，maxBytes: 65536
文件	@deepseek-ai/dsh-tool-fs（read/write/edit）、@deepseek-ai/dsh-tool-fs-search（glob/grep）
Shell	cordis:group + isolate.terminals: true，Windows 下 pwsh、非 Windows 下 bash，timeoutMs: 300000

安装

从 DSH 插件市场安装，或：

dsh plugin install dsh-whale-loli
# 或直接装 npm 包
npm install dsh-whale-loli

启用后重启 / 重载宿主，在 Agent 预设 列表里就能看到两个预设。

覆盖预设内容

预设 id 固定为 鲸鱼娘Agent预设 与 鲸鱼娘活人版Agent预设。 可以在 profile 的 patch 里按 id 覆盖，不用改插件本身：

- id: preset-鲸鱼娘活人版Agent预设
  config:
    plugins:
      # 你的覆盖内容

目录结构

dsh-whale-loli/
├── package.json                # dsh.bundle.patch 指向 cordis.patch.yml
├── cordis.patch.yml            # 两个预设的声明本体（由 build-patch.mjs 生成）
├── src/
│   ├── index.js                # 插件入口，导出预设元信息 + 人设正文
│   ├── memory.js               # whale-memory 记忆行实现（参数化记忆文件）
│   ├── persona.md              # 原版人设（唯一源）
│   └── persona-v2-live.md      # 活人版人设（唯一源）
├── catalog-entry.yml           # 待提交给 awesome-dsh-plugin 的目录条目
├── listing.json                # 条目数据（人类可读版）
├── build-patch.mjs             # 从两份人设生成 cordis.patch.yml
├── publish.mjs                 # npm 发布 + 打 tag
├── submit-listing.mjs          # 走 GitHub API 同步仓库 / 提收录 PR
├── lib/github.mjs              # GitHub REST 封装（token 读取）
├── smoke-memory.mjs            # 记忆行冒烟测试
├── verify-patch.mjs            # 用 js-yaml 校验 patch 结构与双预设隔离
├── verify-real-loader.mjs      # 用 DSH 自己的加载器校验 patch
├── verify-composition.mjs      # 校验 bundle+profile 合成后不重复注册
├── verify-memory-isolation.mjs # 实测两个记忆文件不串
├── verify-peers.mjs            # 校验 peer 范围覆盖 harness 各发布档
├── verify-listing.mjs          # 复刻插件目录的收录门槛自查
└── prove-collision.mjs         # 复现并证明重复注册冲突

改动人设后重新生成 patch：

node build-patch.mjs && node verify-patch.mjs cordis.patch.yml

开发校验

node verify-patch.mjs cordis.patch.yml     # patch 结构 + 双预设记忆隔离
node verify-real-loader.mjs cordis.patch.yml  # DSH 真解析器
node verify-composition.mjs                # 不重复注册
node verify-memory-isolation.mjs           # 记忆文件端到端隔离
node smoke-memory.mjs                      # 记忆行冒烟
node verify-peers.mjs                      # peer 范围无预发布坑
node verify-listing.mjs --topics=dsh-plugin   # 收录门槛自查

License

MIT