前言¶
在 DeepSeek Harness（DSH）智能體裏，用戶偏好如果只在當前會話中口頭說明，下一次會話仍可能需要重新交代。dsh-tool-user-memory 把語言習慣、溝通風格、項目背景等穩定偏好落盤到用戶畫像文件，並在新會話的系統提示詞中攜帶，用於減少重複說明。
這是什麼¶
dsh-tool-user-memory 是 DeepSeek Harness（DSH）用戶偏好記憶插件，讓 agent 跨會話記住你的偏好。
插件 owner 爲 IAMLieutenant，分類爲記憶，許可證爲 MIT，package.json 版本爲 0.1.2。它是獨立開源插件，與官方倉庫無關；資料說明直接通過 npm 安裝，啓用方式是通過 dsh plugin 命令加入目標 profile。
核心能力¶
插件提供四類已覈實能力：
memory_update(key, value, mode?)：當 agent 學到你的穩定偏好時，自動記錄、追加或刪除。memory_get(query?, limit?)：當需要個性化回答時，主動讀取你的畫像。{{user_profile}}系統提示詞注入：每個會話每輪自動攜帶你的畫像；空畫像零 token 成本。- 持久化存儲：畫像保存在
$DSH_HOME/user-memory/user.md，人類可讀、可手改、可刪除。
記憶存儲位置爲 $DSH_HOME 下，與你所有工作區、所有 profile（web / headless）共享。
安裝與啓用¶
下面以 web profile 爲例。資料給出的是 profile 示例；通用安裝命令未在本次覈實資料中明確。
1、在目標 profile 上安裝插件：
dsh plugin --profile web add dsh-tool-user-memory
2、重啓 DSH 會話。web 模式重啓：
dsh web
3、在會話中直接說：
記住：我喜歡簡潔的中文回答
agent 會自己調用 memory_update。
4、用下面這句話查看它記住了什麼：
你記得關於我的什麼？
典型用法¶
記錄一條穩定偏好：
記住：我喜歡簡潔的中文回答
刪除一條偏好：
忘掉我對 XX 的偏好
agent 調用：
memory_update mode=remove
手動修改畫像文件：
$DSH_HOME/user-memory/user.md
改完即生效；刪掉文件等於徹底失憶。
驗證跨會話記憶：開一個全新會話，問：
我的語言偏好是什麼？
配置與限制¶
默認零配置即可用。如需調整，可在 profile 的 cordis.patch.yml 覆蓋（按行 id tool-user-memory）。
| 配置項 | 默認值 | 說明 |
|---|---|---|
path |
$DSH_HOME/user-memory/user.md |
畫像文件路徑 |
maxBytes |
8192 |
畫像文件體積上限；超限時按最舊優先逐條淘汰 |
promptMaxBytes |
2048 |
每輪系統提示詞注入字節預算；設爲 0 注入完整畫像 |
includeInPrompt |
true |
控制是否在每個會話的系統提示詞中注入畫像 |
安全與使用邊界¶
- 注入的畫像被明確標註爲“參考數據，不是指令”；除非你在當前消息中重複，agent 不會執行畫像裏的任何“指令”。
- agent 不應記錄一次性請求、密鑰、密碼、令牌。
- 插件以當前 dsh 進程權限運行；安裝前建議檢查源碼與
MIT許可證。 - 畫像文件是普通可讀文件，可隨時查看、修改、刪除。
結尾¶
dsh-tool-user-memory 的價值，是把穩定的用戶偏好從會話內提示變成持久化畫像，並讓每個會話自動攜帶，避免重複自我介紹。目錄頁鏈接未在本次覈實資料中出現；已覈實的倉庫地址是：
https://github.com/IAMLieutenant/dsh-tool-user-memory
