前言¶
DeepSeek Harness(DSH)本身只會自動加載 AGENTS.md/CLAUDE.md,沒有任何界面;記憶要靠第三方插件,而它們的面板是獨立入口。這個插件把兩件事收進同一個頁面。
這是什麼¶
dsh-personal-settings 是給 DeepSeek Harness 加一個「個性化」設置頁:一個地方管長期指令和長期記憶。
- 維護者:XEsx630
- 分類:記憶
- 當前版本:0.1.1
- License:MIT
它解決的問題是:改全局指令需要自己找文件、自己編輯;看有哪些記憶需要翻 ~/.dsh/memory;自動提煉記憶需要改 YAML 後重啓。
核心功能¶
指令管理¶
直接編輯 $DSH_HOME/AGENTS.md,也就是每個新會話自動注入的那份。
保存後:
- 新會話第一步就帶上
- 當前會話在下一次文件操作後由內置的 dsh-agent-instructions 重新讀取
右下角的字節數是按文件估算的,參考預算是 65,536 字節;超過 80% 進度條轉琥珀色。
記憶管理¶
瀏覽、搜索、新建、編輯、刪除 dsh-auto-memory 存下的記憶,外加一個自動提煉開關。
列表按「固定優先 → 更新時間」排序,支持按關鍵詞和全局/工作區篩選。點一行進入獨立編輯頁:
- 名稱只能是
a-z0-9-,創建後不可改(它就是文件名) - 描述必填,會進
MEMORY.md索引 - 類型決定列表裏的色點:用戶 / 反饋 / 項目 / 參考
- 「固定」的記憶在注入預算緊張時優先保留
自動記憶¶
頁面頂部的開關控制 dsh-auto-memory 的 autoSummarize:
- 打開後,會話結束時後臺用當前模型從對話裏提煉值得長期保留的事實,最多 5 條
- 開關寫的是 profile 的
cordis.patch.yml,然後調用 cordis loader 只重啓auto-memory這一個條目,不用重啓整個 DSH - 加載器不可用時會退回「重啓後生效」,配置本身已經落盤,不會丟
數據位置¶
| 內容 | 路徑 |
|---|---|
| 全局指令 | $DSH_HOME/AGENTS.md |
| 記憶文件 | $DSH_HOME/memory/_user/*.md、$DSH_HOME/memory/--<項目>--/*.md |
| 記憶索引 | 同目錄 MEMORY.md |
| 注入審計 | $DSH_HOME/memory/audit.jsonl |
全是普通 Markdown,能手改、能進 git。
安裝與啓用¶
需要 DSH 0.2.x。記憶部分依賴 dsh-auto-memory,先裝它:
dsh plugin --profile desktop add dsh-auto-memory
dsh plugin --profile desktop add "github:XEsx630/dsh-personal-settings"
或者用本地目錄:
dsh plugin --profile desktop add "file:/path/to/dsh-personal-settings"
裝完重啓 DSH,設置裏會出現「個性化」。
去掉 dsh-auto-memory 自帶的側邊欄入口(可選)¶
dsh-auto-memory 會掛一個自己的「記憶」側邊欄面板,和本插件的記憶標籤重複。想合併成一個入口,用倉庫裏的腳本做一份只保留宿主的副本:
node scripts/headless-memory.mjs desktop
它會複製已安裝的包、刪掉 lib/client.js 和 package.json 裏的 dsh.client,然後打印兩條替換安裝的命令。宿主能力(索引注入、memory_* 工具、/api/auto-memory/*、自動提煉)全部保留。
典型用法¶
修改全局指令¶
在設置頁的「指令」標籤,直接編輯 $DSH_HOME/AGENTS.md。保存後,新會話會自動帶上這份指令。
管理記憶¶
在設置頁的「記憶」標籤:
- 搜索或篩選記憶(支持關鍵詞、全局/工作區)
- 點擊某條記憶進入編輯頁
- 填寫名稱(
a-z0-9-)、描述、類型 - 勾選「固定」以在預算緊張時優先保留
啓用自動提煉¶
在設置頁的「記憶」標籤頂部,打開「自動提煉」開關。會話結束時,後臺會從對話中提煉最多 5 條值得長期保留的事實。
適用場景與注意¶
適合需要統一管理全局指令和長期記憶的 DSH 用戶,尤其是經常需要調整 agent 行爲、維護大量上下文信息的場景。
務必以當前 DSH 進程權限運行,安裝前應檢查源碼與許可證。
限制與已知問題¶
- 記憶標籤依賴
dsh-auto-memory的宿主接口。只裝本插件時,記憶相關功能會顯示「讀取失敗」,指令標籤不受影響 - 自動提煉在 agent 被釋放時觸發(切會話、關會話、退出應用),不是每輪都跑;只讀對話裏的 user / assistant 文本,不讀工具調用與輸出
- 客戶端的文案目前只有中文
- 開關的熱重載依賴 cordis loader 的運行時更新接口,屬於內部 API,DSH 大版本升級時可能需要跟着調整
短結尾¶
dsh-personal-settings 把全局指令和長期記憶收進同一個設置頁,減少切換成本,適合需要統一管理上下文和長期記憶的 DSH 用戶。
- 目錄頁:https://www.skillhub.cn/plugins/XEsx630/dsh-personal-settings
- GitHub:https://github.com/XEsx630/dsh-personal-settings