dsh-whale-soul

给 DeepSeek Harness 的「鲸鱼娘」Agent 模式，带一层会像梦一样慢慢沉淀的长期记忆。

English README

0.2.0。默认人格使用V2记忆API1.3与完整transfer v3，人格成长独立存储，数据保存在本地且可移植。从0.1.x升级前请先阅读0.2.0更新与升级说明。0.1.5迁移与真实Electron桌面短流程已通过；长期成长和完整可选身体旅程继续单独验收。

这是什么

dsh-whale-soul 会在 DSH 里新增一个叫 鲸鱼娘 的 Agent 模式（英文或其他语言界面显示 Whale Chan）。她会聊天、照常做 Agent 的活，也会安静地记住重要的事。对话仍然发生在 DSH；插件只负责人格和记忆。

特性

• 人格保持连续：普通聊天不能直接重写核心身份，宿主安全、隐私、权限和停止控制始终有效。
• 跟随当前语言：人格提示要求回复和可见说明跟随当前消息语言，模型实际表现另行验收。
• 有归属的长期记忆：筛选后的事实保留原话、修订和身份归属，同消息多项事实分别记录结果。
• 明确双方约定：窄对话桥接区分提议与双方接受。待办状态适配器可核验“将绑定待办标记为完成”这一明确约定；它不证明待办背后的工作产物已交付。
• 独立人格成长：人格补完与事实、核心分开保存，有经历依据并经过后续反思才可沉淀。核心升级会重审兼容成长，并保留个体身份、原文、历史和成熟度。
• 可调稳定性：多变、普通、顽固、自动四档控制成长门槛；默认自动随有效经历逐渐稳固，性格命令和反复自述不能刷成熟度。
• 独立管理入口：本地预览、导出、迁移和精确清除位于普通人格工具之外；直接改文件不会获得核心权威。
• 本地存储：插件数据保存在配置的记忆根，相关记忆可能随请求发送给所配置的模型提供方。
• 表情包，先征得同意：只保存你明确要求保留的图片，不会自动捕获。

要求

• DSH 0.2.1-rc.3（bundle 声明了该兼容性）。
• Node.js >=22.12.0。

安装

在 DSH 里安装

打开 DSH 的 Plugins，安装 dsh-whale-soul。如果 DSH 提示重启，按提示重启。

用命令行安装

dsh plugin --profile web add dsh-whale-soul

以上命令管理 Web profile。桌面端请在 DSH 桌面应用的 Plugins 中安装；标准 CLI 不能管理保留的 desktop profile。

以上仓库命令安装已发布版本。也可安装本地构建包：dsh plugin --profile web add /绝对路径/dsh-whale-soul-0.2.0.tgz。

仅注册 whale-soul 预设。历史会话若引用已移除的预设，恢复前需在宿主中改选当前预设；此变更不改写会话历史或已存记忆。

安装后新建会话，在 Agent 模式选择器里选 鲸鱼娘（英文界面显示 Whale Chan）。已有会话保持启动时的模式。

如果用过V1版本，请保全原记忆目录，先按V1迁移流程迁移到独立根，再用当前运行时接续这些数据。旧根会返回LEGACY_MIGRATION_REQUIRED，安装不会自动迁移。早期V2 API1.1/1.2根使用独立的存储升级流程。

使用

• 选择 鲸鱼娘（英文界面显示 Whale Chan），正常聊天即可。文件、shell、网页、定时、skills 这些 Agent 能力都还在。
• 在人格插件行配置individualKey可在同一记忆空间保留多个独立个体；省略或设置default继续原个体。会话切换与恢复见个体身份。
• 在dsh-whale-soul/persona插件行配置stabilityMode，四档及持久成熟度见稳定性规则。
• 输入/whale-context查看鲸鱼娘占当前留存上下文的估算比例，细分人格核心、人格补完、记忆/召回、运行提示和工具，同时显示占总上下文和占鲸鱼娘内部的百分比。本地指令无需模型调用，结果不进入模型上下文或记忆；沿用DSH估算方式，不是计费token。
• 旧记忆根升级至API1.3前，请阅读人格完整性与所有者升级：1.1未锚定的成长只保全为不可自动加载的历史；1.2源必须已有可信self锚，缺锚拒绝。writer门槛与冷藏边界见生命周期与更深回忆。
• 管理操作使用本地管理CLI。直接外改需明确审查；存储、正文纯净和可移植性见V2记忆设计。

记忆位置与基础配置

默认记忆根是~/.dsh/whale-soul/memory；设置DSH_HOME后为$DSH_HOME/whale-soul/memory，默认空间为owner。未另行配置时，Web与桌面profile使用同一根。

在dsh-whale-soul/persona插件行设置：

选项	默认值	用途
memoryRoot	上述默认根	选择记忆库，建议使用绝对路径或~/…。
memorySpaceId	owner	选择根目录下的记忆空间。
subjectId	owner	标识与该个体互动的人。
individualKey	default	接续指定个体，修改后新建会话。
stabilityMode	auto	variable多变、normal普通、stubborn顽固、auto自动。
autoDream	true	允许空闲人格反思，不会生成V2叙事梦日记。
autoMemoryMaintenance	false	开启自动物理记忆维护。
automaticCold	false	允许物理维护将符合条件的条目转入冷藏。

修改根或空间只是选择数据，不会搬迁原库。跨根接续同一个体请使用导出导入流程。如可选身体也使用自定义根或空间，其memoryRoot与memorySpaceId需与人格行一致。不要让独立的Web与桌面进程同时写同一根；物理维护只协调单个宿主进程。

隐私和安全

• 记忆文件存在本机配置的根目录；进入Agent请求的相关记忆会发送给配置的模型提供方。
• 人设是全年龄、非性化的；有害或色情请求会用鲸鱼娘的口吻拒绝。
• 不记录密码、令牌、银行卡、身份证等敏感信息。可明确要求新信息“不记”；移除已存条目使用本地管理流程，聊天中定点移除某个细节尚未实现。
• 只有你明确要求时才会保存图片；不会自动捕获。
• 管理入口支持导出、迁移和清除。人格工具不能自行取得管理权限或绕过受保护的宿主路径。
• 她不会声称自己是真人，也不会制造排他依赖。

了解更多

• 0.2.0更新与升级说明
• 记忆设计
• 角色契约
• 稳定性与成熟度
• 本地管理

许可

MIT，见 LICENSE。