dsh-whale-letter: An Offline Handwritten Letter Experience in DeepSeek Harness
yanmoren/dsh-whale-letter
Whale Letter is a DeepSeek Harness plugin: write a letter on its own page, get a desktop reminder 2–8 hours later, and open an envelope whose handwritten reply is generated fully offline by a bundled local 4B model.
dsh-whale-letter is a DSH plugin for DeepSeek Harness that turns sending, waiting for, and opening a letter into a slow local ritual. It targets users who want to correspond with an AI gradually without a network connection or extra runtimes: replies are written locally by a bundled quantized 4B model, fully offline. After sending, a random 2 to 8 hour wait follows, then a desktop reminder appears; opening it reveals an envelope, and unsealing it shows a clear handwritten long letter on cream patterned paper, with hard constraints on persona and reply length.
How to Install
dsh plugin --profile <your-profile> add github:yanmoren/dsh-whale-letterReplace --profile with the profile name you actually run (see ls ~/.dsh/profiles/): usually web in the browser UI, desktop or desktop-NNN in the desktop app.
- Category
- Entertainment
- Platform
- DSH Plugin
- Author
- yanmoren
- Distribution
- Plugin
dsh-whale-letter Key Features
dsh-whale-letter Repo Summary
What Does It Do?
Whale Letter is a DSH plugin for DeepSeek Harness that turns sending a letter into a slow, offline ritual inside the harness. It solves the problem of wanting to correspond with an AI without a network connection or extra runtimes: replies are written by a bundled local 4B model, fully offline, with no Ollama, Python, or additional runtime required. After you send a letter, it waits a random 2 to 8 hours before a desktop reminder appears; opening it reveals an envelope, and opening that reveals a clear handwritten long letter on cream patterned paper.
Core Features
- Offline local generation: ships a quantized 4B model plus CPU inference binaries, and Node starts and stops on demand instead of staying resident, so replies work without a network.
- Random delayed delivery: the wait is drawn randomly between 2 and 8 hours, independent of hardware or letter content; generation happens in the background during the wait and is only delivered when the time comes.
- Unsealing ritual and paper texture: a desktop reminder card opens a standalone borderless window where the envelope flap turns, the sheet slides out, and ink appears paragraph by paragraph, on cream paper with double fretwork borders and a pale round seal.
- Persona and hard reply constraints: a blue-haired whale-girl voice, replies padded to at least 500 Chinese characters and 6 paragraphs, Markdown, code blocks, and emoji stripped, and 1 to 2 small questions about meals, blankets, or weather appended.
- Topic avoidance: when a letter mentions work, the reply gently steers toward windowsills, plain rice, or the weather without repeating or judging, and rewrites the whole letter if a hard check fails.
- No lost letters: letters sit in a local queue file, so closing DSH mid-wait does not lose them, and overdue letters are delivered after restart.
How to Use This Plugin?
After enabling it in DSH, open the standalone letter page, write your letter, and click to seal and send it; the page tells you it will arrive sometime in the next 2 to 8 hours. The letter is queued and the local model starts writing the reply in the background. When the time comes, a reminder card appears in the bottom-right corner of the desktop; click to open it, then click the envelope to unseal and read. DSH must be running at delivery time for the reminder to appear. To see the effect immediately, use the quick-acceptance button on the letter page, which skips the wait and generates from local material for visual checking only. A Whale Letter panel appears in settings for status, entry points, and the same quick check.
How to Troubleshoot This Plugin?
If the model is missing, the plugin falls back to generating replies from a material library, so functionality continues but the writing becomes more templated; restore it by following the official instructions to fetch the runtime. If no reminder appears, confirm DSH was running at delivery time; letters are not lost and overdue ones are delivered after restart. If the letter page will not open, the port may not be the default one; the plugin auto-detects the webServer port, and the port can also be changed in the local config.
This page is an independent rewrite of the plugin's official README — for authoritative documentation and the latest changes, refer to the source: yanmoren/dsh-whale-letter. The plugin is third-party code that runs on your machine once installed; inclusion does not imply endorsement — please review the source before installing.
DSH Plugin FAQ
