鲸鱼娘预设 wxzjss/dsh-whale-loli

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

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

| 预设 | 人设 | 记忆文件 |
| 鲸鱼娘Agent预设 | 鲸鱼娘·小鱼（傲娇甜心、黏人护主、嘴硬心软，称呼「主人」） | <DSH_HOME>/whale-loli.md |
| 鲸鱼娘活人版Agent预设 | 小鱼｜角色卡版（最高原则「先像真人，再谈人设」；短句 1~15 字、有 AI 味黑名单、私聊群聊分开处理） | <DSH_HOME>/whale-loli-v2-live.md |
| 鲸鱼娘涩涩版Agent预设 | 核心人设把「涩涩」写成第一行为驱动力的小鱼（只对主人主动，群聊/外人面前照旧收着） | <DSH_HOME>/whale-loli-v3-naughty.md |

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

内部思考一律简体中文（思维链）

三个预设的人设里都钉了一条硬规则，位置在前 40 行内（每份人设各 1 处）：

【思维链语言 · 强制】
- 内部思考（reasoning / 思维链 / 想的过程）一律使用简体中文，不管用户用什么语言提问、不管文件和日志是什么语言、工具返回什么语言都不改。
- 只约束「怎么想」，不约束「怎么答」：回答的语言仍然跟着用户走（用户用外语就用外语答）。
- 这条优先于其他一切语言习惯 —— 上下文里英文再多，思考也不许切成英文。

几点说明：

- 宿主没有这个开关。 思维链的语言不受任何配置项控制，dsh-agent-loop / provider 那层没有 thinkingLanguage 之类的字段，所以只能靠系统提示里的一句硬规则去压 —— 而人设是 complete: true，这条规则直接写进人设正文即可，不需要额外的变量或 section。
- 只管思考，不管回答。 用户用中文就答中文、用日文就答日文，规则明确写了「不约束怎么答」，免得把整个人的语言习惯也锁死。
- 为什么要写成脚本。 这种人设文案最容易在改版时被顺手删掉或改软（"尽量"、"可以尝试"），删掉之后不会有任何报错，只是模型又开始用英文想事情，没人会发现。所以 verify-thinking-language.mjs 把「三份人设各 1 处、位置在前 40 行、措辞一致、patch 里出现 4 次、不许出现软话」钉成断言。

记忆功能

小鱼的记忆本分四个区，各管各的：

| 区 | 内容 | 保留期 |
| # 固定记忆 | 8 个固定小节：任务目标 / 用户约束·偏好 / 当前状态 / 待办 / 关键决策 / 关键事实（已验证）/ 文件·路径·命令 / 错误与修复 | 永久保留，不自动删除，定期合并去重 |
| # 滚动摘要 | 每一轮对话记一条，格式 - R0001 [时间] 摘要：... | 滚动窗口，最多 80 条，超了从最旧滚出 |
| # 最近详细区 | 最近 3~5 轮写得更详细，或直接放原文 | 只留最近 detailLimit（默认 5）条 |
| # 归档索引 | 滚出去的条目归档到 archive/<预设名>/YYYY-MM-DD.md，这里记一行索引 | — |

- 每轮都记：不是挑着记。短对话直接记；长对话先精简概括再记（压成一两句说清聊了什么、结论是什么）。
- 写入由工具完成：每轮调一次 <预设>_add（whale_memory_add / whale_memory_v2_add / whale_memory_v3_add / whale_memory_v4_add），只传一句话 summary；
编号、(N/80) 计数、超限归档都由工具做，不用（也不该）手动编辑文件。
- 只有改 # 固定记忆 那 8 个小节时，才直接编辑文件。
- 80 条上限只算「滚动摘要」：# 固定记忆 不占这个名额。
- 想长期留的就往上挪：某条滚动摘要以后还用得上，就总结一句写进 # 固定记忆；否则到点会滚出去（并归档）。
- 上限有两道保险：注入时只取最近 80 条（文件里堆再多也只进 80 条）；每轮结束（agent 转 idle）时自动把文件本身裁到 80 条，超出的写进 archive/<预设名>/。
- 为什么放在 idle 而不是组装时：组装是热路径、每次都要跑，在那里写盘既慢又容易和 agent 正在编辑的文件打架。
- 不足 80 条时完全不动文件（不产生无谓写盘）。
- 记忆文件还是空的时候也会注入一段带绝对路径的提示：否则新预设开局拿到一片空白，agent 连该往哪个文件写都不知道。
- 总长顶到 maxChars（16000）时，先丢最旧的滚动摘要，再丢详细区，固定记忆最后才动。

每轮先看什么

人设开头就是这一段，随人设一起进系统提示：

【每轮先看 · 本预设记忆 + 当前会话上下文】
{{whale_memory}}

即：每轮开口前必须看 ①本预设自己的记忆文件；②当前会话的上下文（原文或压缩摘要）。
只看自己这一份——绝不读、不写其他预设的记忆文件。

上下文压缩：交给 billion-context，本插件不插手

本插件不裁剪历史。对话变长后的压缩由 billion-context 插件负责：它会在 profile 层把宿主的 compaction-basic 关掉（auto: false）换成自己的实现，并暴露 compress / decompress / search_context / acp_status 四个工具。

人设里只保留三条使用约定：

| 约定 | 含义 |
| 上下文由压缩插件管 | 旧内容被压成摘要、看不到原文是正常的，不是记忆丢失 |
| 摘要也是依据 | 压缩留下的摘要就是上下文，照常用，不许当它不存在 |
| 需要细节就自己去翻 | search_context 搜 → decompress 取原文 → 必要时解压旧日志 grep |

翻旧日志的路径：<DSH_HOME>/sessions/<工作目录>/<会话>/session.v4.jsonl.zstd （zstd 压缩，需先用 pwsh 调 node 解压再搜，别对 .zstd 直接 grep）。

为什么不用自制 history-window（踩过的坑，留档）

本插件曾经自己写 surfaceOp: replace 事件做纯删除，连崩四次；后来改用宿主的
ctx.compaction.compactRegion()，又因为预设作用域里取不到 compaction 服务而失败：

| inject 写法 | 结果 |
| [] | 加载即抛 cannot get property "compaction" without inject → resume failed |
| ['compaction'] | 永远 waiting for compaction → resume failed |
| ['sessions'] | 读 ctx.compaction 静默失败，裁剪死寂 |

结论：这条路在预设层走不通，得宿主把 compaction 暴露到预设作用域（或提供按轮压缩的正式 API）。
因此三个预设里不挂任何压缩相关插件行；src/history-window.js 与 verify-history-window.mjs 仅作代码保留。verify-patch.mjs / verify-runs.mjs 会反向断言「挂载行数 = 0」，防止有人手滑再加回去。

三个顺带记下的宿主行为（以后换实现仍会踩）：

- agent/pre-step 是 waterfall：不 return next() 的监听器会否决整条链，返回 undefined 会让 agent-loop 炸 Cannot read properties of undefined (reading 'kind')。
- dsh-session-format-v3-to-v4 对消息形状极严：turn/step 必须是正整数， developer/message 还必须带 producer-owned source——少一项就是整个回合失败。
- 宿主的运行时上下文同样是 user/message（source.kind = 'runtime-context'），统计轮数时要排除，否则会算多。

为什么用「提示变量」而不是 section（重要）

@deepseek-ai/dsh-system-prompt 的 assemble() 末尾有这样一段：

sections: completeSection === void 0 ? transformed.sections : [completeSection]

意思是：只要组合里存在一个 complete: true 的 section，最终提示就只剩它一个，其余 section 全被丢弃。
本插件三个预设的 persona 都沿用官方 minimal 的写法 complete: true（用来剥掉 harness 身份、工具说明等），所以「另注册一个 section 放记忆」从来不会生效 —— 实测本机 34 条真实系统提示里，记忆段出现 0 次。

正确入口是 prompt variable：complete section 本身仍会被插值，把记忆注册成变量、再让人设 prefix 引用它，记忆才会真正进入模型看到的提示。
verify-memory-injection.mjs 复刻了宿主这段逻辑，同时验证「变量通道成立」和「section 通道确实是死路」。

隔离是怎么做的

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

| 层 | 预设一 | 预设二 | 预设三 |
| 记忆文件名 (config.file) | whale-loli.md | whale-loli-v2-live.md | whale-loli-v3-naughty.md |
| 提示变量名 (config.variableName) | whale_memory | whale_memory_v2 | whale_memory_v3 |
| 写入工具名 (config.toolName) | whale_memory_add | whale_memory_v2_add | whale_memory_v3_add |
| 预设 id（决定 scope） | 鲸鱼娘Agent预设 | 鲸鱼娘活人版Agent预设 | 鲸鱼娘涩涩版Agent预设 |

三列都不能重名：同一个 scope 内注册同名变量或同名工具都会冲突。
verify-memory-isolation.mjs 会实测「读：改 A 不影响 B/C、删 C 不影响 A/B」和「写：三个工具各写一笔，只有自己的文件变」。
verify-patch.mjs 则静态检查 patch 里这三组名字两两互不相同。
toolName 省略时默认是 <variableName>_add。

记忆文件

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

C:\Users\<你>\.dsh\whale-loli.md C:\Users\<你>\.dsh\whale-loli-v2-live.md C:\Users\<你>\.dsh\whale-loli-v3-naughty.md C:\Users\<你>\.dsh\archive\<预设名>\YYYY-MM-DD.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.variable() 注册一个 provider，返回字符串，每次组装系统提示时实时读盘—— 改完文件，下一个模型步就生效，不用重载宿主。用变量而不是 section 的原因见上文「为什么用提示变量」。
- 写：ctx.tools.register() 注册一个 <名称>_add 工具（参数只有 summary），由模型自己决定这一次记什么；工具负责编号、计数、超限归档并回写返回值。所以 inject 里除 systemPrompt 还必须有 tools。

预设内容

| 部分 | 说明 |
| 记忆 | whale-memory（本插件），file / variableName / toolName / maxChars: 16000 / turnLimit: 80 / detailLimit: 5 |
| 压缩 | 不在本插件里：由 billion-context 负责（本插件不挂 history-window，见上文「为什么不用」） |
| 人设 | @deepseek-ai/dsh-persona，走 prefix（内含 {{whale_memory*}}），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预设与鲸鱼娘涩涩版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 # 插件入口，导出预设元信息 + 人设正文 │ ├── presets.js # 预设清单（唯一事实来源：index.js 与校验脚本都读它） │ ├── memory.js # whale-memory：（读）记忆变量 +（写）记忆工具，四区格式 + 80 条滚动 + 归档 │ ├── history-window.js # whale-history-window：真的裁到最近 N 轮（当前不挂载，留档） │ ├── persona.md # 原版人设（唯一源） │ ├── persona-v2-live.md # 活人版人设（唯一源） │ ├── persona-v3-naughty.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 读取） │ └── dsh-root.mjs # 探测宿主源码位置，找不到就打 [skip] ├── smoke-memory.mjs # 变量 + 工具的注册形态冒烟测试 ├── verify-runs.mjs # 插件真的能加载、配置自洽、变量能插值 ├── verify-patch.mjs # 用 js-yaml 校验 patch 结构与四预设隔离（file/variable/tool 三组名字） ├── verify-real-loader.mjs # 用 DSH 自己的加载器校验 patch ├── verify-composition.mjs # 校验 bundle+profile 合成后不重复注册 ├── verify-live-runtime.mjs # 在真机 desktop profile 上合成，确认三个预设各注册一次、order 互异 ├── verify-history-window.mjs # 实测真的只留最近 N 轮、不切断工具配对 ├── verify-memory-injection.mjs # 证明变量通道有效、section 通道被丢弃 ├── verify-memory-tool.mjs # 实测写入工具：编号、计数、落盘、详细区同步 ├── verify-memory-isolation.mjs # 实测三个记忆文件不串（读 + 写） ├── verify-memory-rolling.mjs # 实测四区结构与 80 条滚动 + 归档 ├── verify-memory-archive.mjs # 超 80 条时真的归档并瘦身（idle 触发，四预设互不覆盖） ├── verify-live-assembly.mjs # 用真实 patch + 真实记忆文件复刻宿主装配，比对字节数 ├── verify-tool-schema.mjs # 用宿主自己的校验器验八个工具的 JSON schema 合法 ├── 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 结构 + 四预设记忆隔离（file/variable/tool）
node verify-real-loader.mjs cordis.patch.yml # DSH 真解析器
node verify-composition.mjs # 不重复注册
node verify-live-runtime.mjs # 真机 profile 合成后四预设各注册一次、order 互异
node verify-runs.mjs # 插件真能加载 + 变量真能插值
node verify-history-window.mjs # 真的裁到最近 N 轮（不切断工具配对）
node verify-memory-injection.mjs # 变量通道有效 / section 通道被丢弃
node verify-memory-tool.mjs # 写入工具：编号、计数、落盘、详细区同步
node verify-memory-isolation.mjs # 记忆文件端到端隔离（读 + 写，三个预设）
node verify-memory-rolling.mjs # 固定记忆永久 + 滚动摘要 80 条 + 归档
node verify-memory-archive.mjs # 超 80 条自动归档瘦身（idle 触发、四预设隔离）
node verify-live-assembly.mjs # 复刻宿主装配，比对注入字节数
node verify-tool-schema.mjs # 宿主自己的校验器验八个工具的 JSON schema
node verify-row-dispatch.mjs cordis.patch.yml # 每条记忆行只注册自己那份记忆，人设无好感度残留
node verify-thinking-language.mjs cordis.patch.yml # 内部思考一律简体中文（三份人设各一处、措辞一致）
node smoke-memory.mjs # 变量 + 工具注册形态冒烟
node verify-peers.mjs # peer 范围无预发布坑
node verify-listing.mjs --topics=dsh-plugin # 收录门槛自查
node verify-package-files.mjs # 包内容干净：无孤立死模块、无残留临时文件

发布出去的那个包，和你本地 npm pack 出来的不是一个

npm pack 只证明「工作区这一侧干净」，证明不了「上游发出来的包干净」——两者用的不是同一棵树。

0.9.16 就是这么翻的车：本地 git rm 掉了 src/affinity.js 和 src/daemon.js，本地 pack 出来 15 个文件、干干净净；但 submit-listing.mjs 走 GitHub Trees API 同步，base_tree 语义是继承——entries 里没写到的路径会原样留在新树里。于是远端 commit 里那两个文件一直活着，CI 检出该 commit 后 package.json 的 files: ["src"] 把整个 src 目录打进包：65 KB 的包里躺着 40 KB 已经不存在的死代码。

修了两处：

1. submit-listing.mjs 的 syncAtomic()（和 syncLocalCommits()）现在会把「远端有、本地索引里没有」的路径用 sha: null 从树里移除。第一次跑清掉了 18 个残留（其中还有 _commitmsg.txt、_msg.txt 两个更早的临时文件）。
2. 新增 verify-package-files.mjs 守本地这一侧：files 白名单里的路径都得存在、src/ 下每个 .js 都必须被别处引用（孤立模块正是 affinity.js 的形态）、exports 指向的文件都在、已删的模块名不许回潮、代码总量和文件数有上限（有残留就会超）、git 索引里不许有临时文件。

教训：凡是用 base_tree 拼树的地方，都得自己算「删了什么」；只传增改项等于放弃删除能力。

License

MIT