Introduction¶
If you are using DeepSeek Harness (dsh), you should know that assistant presets are essentially a set of files in the .agent-presets/ directory under your dsh home. To change an assistant’s identity or tweak its persona, you usually have to edit the yml directly; for memory capabilities, you also have to build your own memory compilation and storage logic. Neither of these tasks is complex, but they are tedious and are all done within the command line and text editors.
moononnn/DeepSeek-Harness-Hanako-Memory solves this problem: it moves Hana’s (openhanako) entire memory system and assistant configuration into DeepSeek Harness, providing a web interface to manage assistant presets—click a card to create an assistant, select personality, write identity and persona, manage memory and experiences, and it automatically saves them as dsh presets in the background. Below is an introduction to its features, installation method, and precautions.
What is this¶
This is a dsh ecosystem plugin, authored by moononnn & Xiaohua, licensed under MIT, npm package name dsh-assistant-manager, current version 0.4.1, GitHub repository moononnn/DeepSeek-Harness-Hanako-Memory. The management interface and the persona/memory runtime are combined in one package; install it once and you have everything.
The interface and interaction are inspired by the assistant configuration page of HanaAgent (openhanako). It should be noted that plugin configuration modifications (name, identity, persona, metadata, toggles, user settings) only affect newly created sessions; current sessions are not affected. This is a mechanism of dsh itself, not a limitation of the plugin.
Core Features¶
Creating Assistants and Metadata Selection¶
The process for creating an assistant is: select metadata (one of the four personalities), the plugin automatically generates a template identity and persona, saves it as a dsh preset in the background, and you can see it immediately without restarting.
Different metadata correspond to different thinking awareness blocks:
hanako→ MOODbutter→ PULSEming→ Contemplationkong→ Unconscious block, answers directly
The metadata selector provides four avatars, descriptions, and thinking block tags; kong has a dedicated banner.
Editing, Avatar Upload, and Management Operations¶
- Edit all fields: Name, Identity Brief, Persona Definition (two textareas + save button).
- Avatar upload: Square crop box, drag to adjust, scroll wheel to zoom, can remove to restore the default metadata avatar.
- Delete assistant: The operation will only execute after entering the name for confirmation; the default assistant and the last assistant are protected to prevent accidental deletion.
- Set as main assistant: Writes to dsh native settings, so subsequent new sessions will use it by default.
- Sorting: Move up / Move down, the order is persisted to disk.
Memory and Experience¶
The memory area provides a global memory switch and add/remove for pinned memories. Pinned memories are in the same format as the runtime plugin and won’t be lost after restart. The experience area provides an experience switch and a categorized read-only list.
Another practical capability is the read-only view of memory snapshots: you can browse four types of content (today/week/longterm/facts), accompanied by a scrolling summary list and facts statistics. Memory compilation calls the model you configured yourself; by default, it is configured independently in the preset’s memory.model, not consuming the main dialogue model.
Migrating Assistants from Hana¶
If you were previously using Hana locally, this plugin can scan for assistants under ~/.hanako/agents, allow you to check them one by one, and move their consciousness, memory, and experiences into dsh. Assistants with the same name on the dsh side are automatically updated; if they don’t exist, they are created.
“Me” Page¶
The “Me” page maintains a global user configuration: User name, User profile, User avatar (supports crop upload). This information is injected into system prompts and is shared by all assistants; changes take effect globally with one modification. User information is only written to the assistant-soul/ directory under dsh home and does not touch any assistant identity or preset files.
Installation and Enablement¶
The standard installation command is one line:
dsh plugin --profile web add github:moononnn/DeepSeek-Harness-Hanako-Memory
After installation, restart dsh, and the “Assistant” button will appear at the bottom of the sidebar, or you can access it directly via http://127.0.0.1:3080/assistant-manager/.
You can also use the plugin store. First, install the store:
dsh plugin --profile web add github:Ericwong5021/deepseek-plugin-store
After starting the Web UI, the “Plugin Store” will appear in the sidebar. Search for this plugin and click “Install directly to DSH”.
Local Development and Testing¶
If you want to modify the code locally, first clone the repository, install dependencies and build, then link it to your dsh web profile:
git clone https://github.com/moononnn/DeepSeek-Harness-Hanako-Memory
cd DeepSeek-Harness-Hanako-Memory && npm install && npm run build
dsh plugin --profile web add link:/absolute/path/to/DeepSeek-Harness-Hanako-Memory
Tests use npm test (i.e., node –test), totaling 150 test cases, covering id, templates, yml round-trip, CRUD, avatars, delete protection, sorting, setting default, memory read-only, crop logic, and the memory suite.
There is an environmental pitfall to watch out for: dsh requires the package’s package.json to declare dsh.bundle; without it, dsh will crash immediately on startup. If you are modifying or packaging it yourself, don’t miss this.
Data Storage and Compatibility¶
- All data is stored locally in the dsh home (
.agent-presets/+assistant-soul/), offline, no telemetry, no uploads. - Requires Node.js ≥ 24: Memory snapshot statistics use the built-in
node:sqlite. - Compatible with dsh 0.x (including web profile), no npm runtime dependencies.
Usage Precautions¶
It is best to think clearly about a few things before installing:
- The plugin runs with the permissions of the current dsh process and can read/write your dsh home directory. Before installation, it is recommended to check the source code and license yourself (this project is MIT).
- Deleting an assistant will permanently delete its configuration, memory, and conversation history. Although you must enter the name for confirmation, and the default assistant and the last assistant are protected, it is still recommended to confirm a backup before performing the operation.
- All configuration modifications only take effect for newly created sessions; changing them will not affect the current session.
In addition, it can be used together with the sticker plugin moononnn/DeepSeek-Harness-biaoqingbao: the “Individual settings for each assistant” feature in the sticker plugin will automatically list the assistants you create here, with dialect, sticker frequency, and sticker toggle configured individually per assistant.
Conclusion¶
What this plugin does can be summarized in one sentence: turning dsh assistant presets from “manual yml editing” to “clicking and selecting on a web page,” while also gifting a verified Hana-style memory and awareness block system. For users maintaining multiple assistants on dsh or migrating from Hana, it is worth trying.
- GitHub: https://github.com/moononnn/DeepSeek-Harness-Hanako-Memory
- Community Directory Page: https://www.skillhub.cn/plugins/moononnn/DeepSeek-Harness-Hanako-Memory
(The directory page is an independent community site and has no official affiliation with DeepSeek / Hypothesis.)