前言¶
如果你在用 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→ MOODbutter→ PULSEming→ 沉思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 / 幻方無官方從屬關係。)