moononnn/DeepSeek-Harness-Hanako-Memory

🧠 小花记忆（DeepSeek Harness）

把 Hana 的记忆系统与助手配置整个搬进 DeepSeek Harness，用网页管理你的助手预设。

作者：moononnn & 小花

⚠️ 先看这里

- 本插件是 dsh 生态插件，需要 DeepSeek Harness（dsh）环境。管理界面与人格/记忆运行时已合成一个包（soul 为内置子模块），装一次全都有。
- 会读写你 dsh home 下的 .agent-presets/ 与 assistant-soul/ 目录：新建、编辑、删除助手预设；assistant-soul/user.yaml 与 user-avatar.png 是你的全局用户信息（「我」页面）。
- 删除助手会永久删除它的配置、记忆和对话记录（删除前必须输入助手名字确认，默认助手和最后一个助手会被保护）。
- 配置修改（名字/身份/人格/元/开关/用户配置）只影响此后新建的会话，当前会话不受影响，这是 dsh 的机制。

这是干什么的？

我很喜欢openhanako「下文有该项目的github链接哈」的记忆系统啥的，所以她搬了过来！

她有好多功能！记忆系统只是其中之一，

让你像设置自家助手一样配置 dsh 预设**——点卡片新建助手、选性格「元」、写身份和人格、换头像、管记忆和经验，后台自动落成 dsh 预设，即插即用！

而且！新建的助手自带思考意识块（就是那种说话前先冒一段内心小剧场的模块），选不同性格会有不同的腔调，比如：

- hanako → MOOD（Vibe / Sparks / Reflections / Will）
- butter → PULSE（Vibe / Echo / Read / Will）
- ming → 沉思（Premise / Conduct / Reflection / Act）
- kong → 没有意识块，直接回答

嗯，具体是什么感觉，你自己开个新会话试试就知道了，我不剧透太多 ✿

它能做什么

- ✨ 新建助手：选元（四性格）+ 自动模板身份/人格，后台落成预设，即建即见（不用重启）
- 🧬 元选择器：四头像 + 描述 + 思考块标签 + kong 专属横幅
- ✏️ 编辑全字段：名字、身份简介、人格定义（双 textarea + 保存）
- 🧠 记忆区：记忆总开关 + 置顶记忆增删（与运行时插件同格式，重启不丢）
- 📚 经验区：经验开关 + 分类只读列表
- ⇄ 从 Hana 转移助手：一键扫描本机 Hana（~/.hanako/agents）的助手，逐个勾选把「意识（人格全文+头像）/ 记忆（四件套+置顶）/ 经验」搬进 dsh；dsh 侧同名助手自动更新、无则新建（yuan 元属性跟随源）
- 🖼️ 头像上传 + 裁剪：正方形裁剪框、拖动调整、滚轮缩放、确认上传；可移除恢复元默认头像
- 🗑️ 删除助手：输名字确认，默认/最后一个助手有保护
- 👑 设为主助手：写 dsh 原生 settings，新会话默认用它
- 🔼🔽 排序：上移/下移，顺序落盘持久
- 📖 记忆快照只读查看：today/week/longterm/facts + 滚动摘要列表 + facts 统计
- 🙋 「我」页面（Hana 同款）：全局用户名字 + 用户档案 + 用户头像（裁剪上传，SVG 占位）。名字与档案注入系统提示词（用户档案排在助手身份/意识之前），所有助手共享一份，一次修改全局生效

想让 Ta 更活泼一点？

配上 表情包插件，你的助手开心时会发猫猫图、委屈时会发抱抱图，还能每个助手各挑各的方言口音——表情包的「每位助手单独设置」会自动列出你在这里建的助手，方言、配图频率、配图开关各配各的，互不干扰。

装了这个，你的小花会更有趣哦 ✿

安装

dsh 插件标准姿势，一行命令（推荐从 GitHub 装，发布到 npm 后也可用 npm 包名）：

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」即可。

本地开发时：

1. 克隆仓库
$ git clone https://github.com/moononnn/DeepSeek-Harness-Hanako-Memory

2. 安装依赖并构建
$ cd DeepSeek-Harness-Hanako-Memory && npm install && npm run build

3. link 进你的 dsh profile（如 profiles/web/package.json）
$ dsh plugin --profile web add link:/绝对路径/DeepSeek-Harness-Hanako-Memory

如果安装不生效，检查包的 package.json 是否有 dsh.bundle 声明——没有它 dsh 启动会直接崩，这是 dsh 的硬性要求。

隐私

- 所有数据都存在本地 dsh home（.agent-presets/ + assistant-soul/），不联网、无遥测、不上传任何东西。
- 「我」页面的用户信息（名字/档案/头像）只写 assistant-soul/user.yaml 与 assistant-soul/user-avatar.png，不触碰任何助手的身份/预设文件。
- 记忆编译调用的是你自己配置的模型（默认独立配置在预设的 memory.model，不吃主对话模型）。

兼容性

- Node.js ≥ 24（记忆快照统计用了内置 node:sqlite，零外部依赖）
- dsh 0.x（含 web profile）
- 无 npm 运行时依赖，纯原生实现

开发

npm test    # node --test，150 个用例（id/模板/yml 往返/CRUD/头像/删除保护/排序/设默认/记忆只读/裁剪逻辑/记忆六件套）

- 类型检查 + 构建：npm run build（tsc）
- 代码纪律：全命名导出（dsh 插件禁 export default）、写文件一律原子写、预设 yml 保持插件行列表结构

致谢

- 界面与交互灵感来自 HanaAgent（openhanako） 的助手配置页，UI 规格照抄原版，力求同款体验
- 感谢 DeepSeek Harness 官方包提供的机制（agent-presets / settings / home-paths），让我能站在巨人肩膀上
- 测试与实机验证由「审查伙伴」协助完成

许可

MIT