前言¶
在 DeepSeek Harness（DSH）里做日常 Agent 工作时，对话上下文会随轮次增长；若希望助手在多次会话之间保留「对你重要的事」，又不把人格设定和事实记忆混成一团，通常需要自己在 preset 与外部存储之间搭一层逻辑。社区插件 dsh-whale-soul（维护者 nilzx）在 DSH 中注册名为 Whale Chan（中文界面显示为 鲸鱼娘）的 Agent 模式：对话仍在 DSH 内进行，插件负责人格 preset 与本地长期记忆；默认使用 V2 memory API 1.3 与完整 transfer format 3（当前发布版本 0.2.0）。下文介绍其定位、能力与安装用法，事实均来自 GitHub 仓库 与 SkillHub 目录页。
这是什么¶
dsh-whale-soul 是 DSH 的 Agent preset 插件：新增 Whale Chan 模式，可在角色一致的前提下完成与普通 Agent 相同的工作（文件、Shell、网页、日程、技能等），并对选定事实做 scoped 长期记忆，辅以类似「梦境」 consolidation 的人格成长机制。分类上属于「记忆」类插件；仓库采用 MIT 许可证。
与普通单次会话不同，插件强调：连续人格（日常聊天不会改写核心身份，宿主的安全、隐私、权限与停止控制仍生效）、语言跟随（按当前消息语言回复与解释）、独立成长（人格增量与事实、核心分开存储，经证据与反思后才稳定）。
核心功能¶
以下能力均见于官方 README，可按需选用。
记忆与成长¶
- Scoped long-term memory：选定事实保留原始证据、修订与身份归属；同一条消息里的多条事实可分别处理。
- Explicit agreements：通过窄对话桥接区分「提议」与「双方接受」；可选 todo 状态适配器在存在明确协议时标记绑定 todo 完成（不证明 todo 背后工作已交付）。
- Independent growth：人格增量单独存放；Core upgrades 在升级核心时复核兼容成长并保留身份、文本、历史与成熟度。
- Adjustable stability：
stabilityMode支持variable、normal、stubborn与默认auto；auto会随合格经历变得更稳，聊天指令与重复自述不算合格经历。
管理与本地存储¶
- Owner management：本地预览、导出、迁移与精确清除在普通人格工具之外；直接改文件不会获得核心权限。
- Local storage：数据位于配置的 memory root；被选中的记忆可在 Agent 请求中发给所配置的模型提供商。
- Memes, with consent：仅在你明确要求保留时保存图片，不会自动抓取。
运行时辅助¶
- 会话内命令
/whale-context en：查看 Whale Soul 在当前保留上下文中占比的估计值（人格核心、成长、记忆/回忆、运行时提示与工具等），含全上下文与 Whale 内部占比；本地执行、不调用模型、不把输出写入模型上下文或记忆；计数基于 DSH 启发式，非计费 token。 - 本地管理 CLI：
dsh-whale-soul-manage（见 management 文档）用于 owner 操作；V2 设计见 MEMORY.md。
环境与依赖¶
安装前确认宿主版本与 Node 版本满足 bundle 声明：
- DSH 0.2.1-rc.3
- Node.js >= 22.12.0
安装与启用¶
DSH 生态采用「一切皆插件」；SkillHub 为社区目录站点，与 DeepSeek / 幻方无官方从属关系。
从 DSH 应用安装¶
打开 DSH 的 Plugins，安装 dsh-whale-soul；若提示则重启 DSH。
从 CLI 安装（web profile）¶
CLI 管理的是 web profile；桌面 reserved profile 需在 DSH 桌面应用的 Plugins 中安装，标准 CLI 无法管理桌面 profile。
dsh plugin --profile web add dsh-whale-soul
上述命令安装 registry 发布版。若需本地归档，可使用（路径改为你的绝对路径）：
dsh plugin --profile web add /absolute/dsh-whale-soul-0.2.0.tgz
安装后：新建会话，在 Agent 模式选择器中选择 Whale Chan（中文 DSH 下为 鲸鱼娘）。已有会话保持启动时的 preset。当前仅注册 whale-soul preset；引用已退役 preset 的会话需在宿主中改选当前 preset 后再继续（不会改写会话历史或已存记忆）。
若曾使用 V1 版本，需保留旧 memory 目录并按 V1 migration 迁移到独立 root；旧 root 会拒绝并返回 LEGACY_MIGRATION_REQUIRED，安装不会自动迁移。早期 V2 API 1.1/1.2 root 见 storage upgrade。
典型用法¶
- 选择 Whale Chan 后正常对话与派发 Agent 任务即可。
- 在
dsh-whale-soul/persona插件行配置individualKey：同一 memory space 内区分具名个体；省略或使用default保持原有个体；变更后应新开 Session（详见 individuals 文档）。 - 在同一插件行配置
stabilityMode（见 stability 文档）。 - 需要估算上下文占用时，在会话中执行
/whale-context en。 - 迁移或升级 memory root 到 API 1.3 前阅读 self-integrity；生命周期与深度回忆见 lifecycle。
记忆路径与配置项¶
默认 memory root 为 ~/.dsh/whale-soul/memory；若设置 DSH_HOME，则为 $DSH_HOME/whale-soul/memory。默认 space 为 owner。Web 与 desktop profile 默认共用该 root（除非另行配置）。
在 dsh-whale-soul/persona 插件行可设置：
| Option | Default | Purpose |
|---|---|---|
memoryRoot |
上述 root | 选择存储位置；建议使用绝对路径或 ~/… |
memorySpaceId |
owner |
root 内的 memory space |
subjectId |
owner |
与当前个体交互的主体归属 |
individualKey |
default |
恢复具名个体；变更后新开 Session |
stabilityMode |
auto |
variable / normal / stubborn / auto |
autoDream |
true |
允许空闲人格反思（不生成 V2 叙事型「梦日记」） |
autoMemoryMaintenance |
false |
是否自动做物理记忆维护 |
automaticCold |
false |
维护时是否将合格记录移入冷存储 |
更换 root 或 space 只是选择数据，不会移动旧 store；迁移个体请走 export/import。若使用可选 body 且自定义 root/space，需与 persona 行的 memoryRoot、memorySpaceId 对齐。不要让 web 与 desktop writer 同时对同一 root 写入；物理维护只协调单一宿主进程。
隐私、安全与适用注意¶
- 记忆默认保存在本地 root；纳入请求的相关内容会发给所配置的模型提供商。
- 人格设定为全年龄、非性向；有害或性化请求会在角色内拒绝。
- Agent 不记录密码、token、银行信息或证件号；若不想保留新信息需明确告知；精确删除已存记录走 owner 管理流程（对话式删除单条细节未实现）。
- 图片仅在你明确要求时保存。
- 插件以当前 DSH 进程权限运行；安装前应自行审阅 源码与 MIT 许可证，确认符合你的安全与合规要求。
适合需要在 DSH 内固定一个带长期记忆与人格成长边界的 companion preset、并愿意用本地 root 与 management CLI 自行备份迁移的开发者或高级用户。从 0.1.x 升级请先阅读 0.2.0 变更与升级指南。
结尾¶
dsh-whale-soul 把「鲸鱼娘」Agent 模式、分层长期记忆与可调稳定性收进一个 DSH 插件，对话与工具能力仍由 DSH 宿主承载。进一步了解：
