前言¶

如果你在用 DeepSeek Harness（dsh），应该知道助手预设本质上是 dsh home 下 .agent-presets/ 目录里的一组文件。想给助手改个身份、调一下人格，通常得直接编辑 yml；想要记忆能力，还得自己搭一套记忆的编译与存储逻辑。这两件事都不复杂，但琐碎，而且全在命令行和文本编辑器里完成。

moononnn/DeepSeek-Harness-Hanako-Memory 解决的就是这个问题：它把 Hana（openhanako）的记忆系统与助手配置整个搬进 DeepSeek Harness，提供一个网页界面来管理助手预设——点卡片新建助手、选性格、写身份人格、管记忆和经验，后台自动落成 dsh 预设。下面介绍它的功能、安装方式和注意事项。

这是什么¶

这是一个 dsh 生态插件，作者署名 moononnn & 小花，许可证为 MIT，npm 包名 dsh-assistant-manager，当前版本 0.4.1，GitHub 仓库为 moononnn/DeepSeek-Harness-Hanako-Memory。管理界面与人格、记忆运行时合在一个包里，装一次全都有。

界面与交互灵感来自 HanaAgent（openhanako）的助手配置页。需要说明的是，插件的配置修改（名字、身份、人格、元、开关、用户配置）只影响此后新建的会话，当前会话不受影响——这是 dsh 本身的机制，不是插件的限制。

核心功能¶

新建助手与元选择¶

新建助手的流程是：选元（四性格之一），插件自动生成模板身份和人格，后台落成 dsh 预设，即建即见，不用重启。

不同的元对应不同的思考意识块：

• hanako → MOOD
• butter → PULSE
• ming → 沉思
• kong → 无意识块，直接回答

元选择器提供四头像、描述、思考块标签，kong 有专属横幅。

编辑、头像与管理操作¶

• 编辑全字段：名字、身份简介、人格定义（双 textarea + 保存）。
• 头像上传：正方形裁剪框，拖动调整、滚轮缩放，可移除恢复元默认头像。
• 删除助手：输入名字确认才会执行；默认助手与最后一个助手有保护，防止误删。
• 设为主助手：写入 dsh 原生 settings，此后新会话默认使用它。
• 排序：上移/下移，顺序落盘持久。

记忆与经验¶

记忆区提供记忆总开关和置顶记忆的增删，置顶记忆与运行时插件同格式，重启不丢。经验区提供经验开关和分类只读列表。

另一个实用能力是记忆快照只读查看：可以浏览 today/week/longterm/facts 四类内容，附带滚动摘要列表和 facts 统计。记忆编译调用的是你自己配置的模型，默认独立配置在预设的 memory.model，不吃主对话模型。

从 Hana 转移助手¶

如果你之前在用本机的 Hana，这个插件可以扫描 ~/.hanako/agents 下的助手，逐个勾选，把意识、记忆、经验搬进 dsh。dsh 侧同名助手自动更新，没有则新建。

「我」页面¶

「我」页面维护一份全局用户配置：用户名字、用户档案、用户头像（支持裁剪上传）。这份信息会注入系统提示词，所有助手共享，一次修改全局生效。用户信息只写在 dsh home 下的 assistant-soul/ 目录，不触碰任何助手的身份和预设文件。

安装与启用¶

标准安装命令一行：

dsh plugin --profile web add github:moononnn/DeepSeek-Harness-Hanako-Memory

装完重启 dsh，侧栏底部出现「助手」按钮，或者直接访问 http://127.0.0.1:3080/assistant-manager/。

也可以走插件商店的路子。先装商店：

dsh plugin --profile web add github:Ericwong5021/deepseek-plugin-store

启动 Web UI 后，侧栏出现「插件商店」，搜到本插件点「直接安装到 DSH」即可。

本地开发与测试¶

想在本地改代码的话，先克隆仓库，安装依赖并构建，再以 link 方式挂进你的 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:/绝对路径/DeepSeek-Harness-Hanako-Memory

测试用 npm test（即 node –test），共 150 个用例，覆盖 id、模板、yml 往返、CRUD、头像、删除保护、排序、设默认、记忆只读、裁剪逻辑和记忆六件套。

有一个环境层面的坑要注意：dsh 要求包的 package.json 里有 dsh.bundle 声明，没有它 dsh 启动会直接崩。如果你是自己改造或打包，别漏掉这一项。

数据存储与兼容性¶

• 所有数据存在本地 dsh home（.agent-presets/ + assistant-soul/），不联网、无遥测、不上传。
• 需要 Node.js ≥ 24：记忆快照统计用了内置的 node:sqlite。
• 兼容 dsh 0.x（含 web profile），无 npm 运行时依赖。

使用注意¶

几件事在装之前最好想清楚：

1、插件以当前 dsh 进程的权限运行，能读写你的 dsh home 目录。安装前建议自行检查源码与许可证（本项目为 MIT）。
2、删除助手会永久删除它的配置、记忆和对话记录。虽然要输入名字确认，且默认助手和最后一个助手有保护，但操作前仍建议确认备份。
3、所有配置修改只对新建会话生效，改完当前会话不会变。

另外，它可以搭配表情包插件 moononnn/DeepSeek-Harness-biaoqingbao 使用：表情包插件的「每位助手单独设置」会自动列出你在这里建的助手，方言、配图频率、配图开关各配各的。

结尾¶

这个插件做的事可以概括为一句话：把 dsh 助手预设从「手改 yml」变成「网页上点点选选」，同时附赠一套经过验证的 Hana 式记忆与意识块系统。对于在 dsh 上维护多个助手、或从 Hana 迁移过来的用户，值得试一试。

• GitHub：https://github.com/moononnn/DeepSeek-Harness-Hanako-Memory
• 社区目录页：https://www.skillhub.cn/plugins/moononnn/DeepSeek-Harness-Hanako-Memory

（目录页为社区独立站点，与 DeepSeek / 幻方无官方从属关系。）