dsh-whale-soul
DeepSeek Harness 的灵魂：一个保持角色设定的 Whale Chan 代理预设，具备分层长期记忆和梦境般的记忆整合。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-whale-soul@0.3.1Whale Soul 以 dsh-whale-soul 发布，当前版本为 0.3.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
An in-character Whale Chan (鲸鱼娘) Agent mode for DeepSeek Harness, with long-term memory that settles like a dream.
0.3.1 — fixes Whale Chan startup on Windows and Linux by using DSH's official file permissions and platform sandbox. See the release notes.
0.3.0 — use
/whale-remember-sessionto retain useful memories from a selected conversation, with optional topic restrictions and automatic summary/detail selection. See the release notes and conversation memory guide.
0.2.3 — fixes memory writes and startup on Windows when directory synchronization is refused, and cleans failed lock candidates. See the 0.2.3 release notes. The 0.2.2 linked-directory fix is included.
0.2.1 — automatic memory repair. The default persona uses V2 memory API 1.3 and full transfer format 3, with independent personality growth and portable local data. Read the 0.2.1 upgrade guide before updating from 0.1.x. The 0.1.5 migration and Electron desktop smoke checks passed for 0.2.0. One focused Electron repair test with synthetic corruption has passed for 0.2.1. Broader corruption cases, long-term growth and optional body journeys remain separate validation scopes.
dsh-whale-soul adds a new Agent mode called Whale Chan (鲸鱼娘 in Chinese) to DSH. She chats, helps with normal Agent work, and quietly remembers the things that matter. The conversation stays in DSH; the plugin only owns the persona and the memory.
variable, normal, stubborn and default auto control growth thresholds. Auto becomes steadier with eligible experiences; chat commands and repeated self-descriptions do not qualify.0.2.1-rc.3 (the bundle declares this compatibility).>=22.12.0.Open Plugins in DSH and install dsh-whale-soul. Restart DSH if it asks you to.
dsh plugin --profile web add dsh-whale-soul
The command above manages the web profile. For desktop, install the plugin from Plugins in the DSH desktop app; the standard CLI cannot manage the reserved desktop profile.
These registry commands install the published release. To install a local 0.3.1 archive, use: dsh plugin --profile web add /absolute/dsh-whale-soul-0.3.1.tgz.
Only the whale-soul preset is registered. Sessions that reference a retired preset must select the current preset in the host before resuming. This change does not rewrite session history or stored memories.
After installation, start a new session and choose Whale Chan (shown as 鲸鱼娘 when DSH is in Chinese) in the Agent mode selector. Existing sessions keep the preset they started with.
Memory data errors are repaired automatically by an independent Agent against the current data specification. It handles damaged data as well as old layouts, preserves sources and rollback backups, validates the result, and resumes unfinished work automatically. Its tools operate on memory files only; plugin files cannot be modified. Ordinary V1 roots, including empty folders, have a fast local conversion path. Automatic repair explains this workflow; local management remains optional owner control. The explicit storage upgrade remains available for owner-managed recovery.
/whale-remember-session with a conversation ID or DSH session reference to import lasting memories. Name a topic to restrict the selection, or omit it for automatic selection. See examples and source rules.individualKey on the persona plugin row to keep separate named individuals in one memory space. Omit it or use default to continue the original individual. Individual identity explains Session switching and recovery.stabilityMode on the dsh-whale-soul/persona plugin row. Stability rules describe the four modes and persistent maturity./whale-context en to inspect Whale Soul's estimated share of the current retained context, split into persona core, growth, memory/recall, runtime hints and tools. Both whole-context and within-Whale percentages are shown. The local command makes no model call and does not add its output to model context or memory; counts use DSH's heuristic and are not billing tokens.The default memory root is ~/.dsh/whale-soul/memory, or $DSH_HOME/whale-soul/memory when DSH_HOME is set. The default space is owner. Web and desktop profiles use this same root unless configured differently.
Set these options on the dsh-whale-soul/persona plugin row:
| Option | Default | Purpose |
|---|---|---|
memoryRoot | the root above | Select the store; an absolute path or ~/… is recommended. |
memorySpaceId | owner | Select a memory space within the root. |
subjectId | owner | Attribute the person interacting with this individual. |
individualKey | default | Resume a named individual; use a new Session after changing it. |
stabilityMode | auto | Choose variable, normal, stubborn or auto. |
autoDream | true | Allow idle personality reflection; this does not create V2 narrative dream diaries. |
autoMemoryMaintenance | false | Opt in to automatic physical memory maintenance. |
automaticCold | false | Allow eligible records to move to cold storage during physical maintenance. |
Changing a root or space selects data; it does not move the previous store. Use the export/import workflow to preserve an individual when moving data. If you use the optional body with a custom root or space, keep its memoryRoot and memorySpaceId aligned with the persona row. Do not run independent web and desktop writers against the same root at the same time; physical maintenance coordinates one host process only.
MIT. See LICENSE.