前言¶

在 DSH 裏跑智能體時，「記憶」往往混在一堆上下文裏：該淡忘的佔字數，真正該每輪都帶着的反而沒有單獨入口。常見做法是整段歷史或大塊 RAG 一起塞進去，成本高，也難區分「本人認定必須記住」和「聊過就過」。dsh-pin 把「怎麼存、怎麼忘」裏較硬的一層拆出來：極少數事由用戶顯式釘住並每輪注入；工具、插件、資料類條目用完可刪，庫裏只留一句「它能解決什麼」，需要時再按關鍵詞查。

這是什麼¶

dsh-pin 是維護者 xiaole3349 發佈的 DSH 插件，社區目錄分類爲「記憶」。一句話定位：DSH 插件——釘住重要事，圖書館只留工具標籤。源碼與說明見 GitHub，目錄頁見 SkillHub。當前 package 版本爲 0.1.0，許可證 MIT。

釘與圖書館¶

README 把能力分成兩塊，職責不同。

釘（pin）
大部分記憶按時間淡忘；只有極少數、用戶認爲值得的，由本人顯式釘住，並在每輪對話裏注入提示詞。沒有釘內容時不注入，不佔字數。

圖書館（library）
看完就用的東西（工具、插件、資料）用完可以刪，持久層只保留一句「它能解決什麼」；要用時通過搜索按關鍵詞找回。

私聊才能改本體
羣會話裏對釘、圖書館以及人格/配置文件的寫操作一律拒絕，由 tools.guard 攔截。羣聊裏仍可讀、可搜，但不能通過工具改存儲。

核心功能¶

下面介紹插件在 DSH 裏實際提供的能力，均來自倉庫 README。

• 設置頁「釘」：兩個頁籤——「釘」與「圖書館」，可在 Web 端增刪改。
• 五個工具：pin_add、pin_list、pin_remove、library_add、library_search。
• HTTP 接口：/dsh-pin/{list,add,update,delete,candidates,lib/list,lib/add,lib/delete}。
• 每輪將釘住的內容注入提示詞；無釘則不注入。

數據落在本機純文本 JSON，可手改、可備份：

• ~/.dsh/jingjing/state/pins.json
• ~/.dsh/jingjing/state/library.json

安裝與啓用¶

先在 DSH 環境中取得插件目錄（例如從 GitHub release 或本地 bundle），再按官方方式安裝。不要憑插件名自行拼接未在文檔出現的安裝命令。

在 DSH 裏執行：

# 在 DSH 裏
plugin_manager install_bundle <本目錄>

或將下列片段放進 profile 的 cordis.patch.yml：

- insert:
    - id: pin
      name: dsh-pin

經過上面的步驟，bundle 會通過 cordis.patch.yml 掛進 Cordis；Web 客戶端按 package 配置注入 slots，React 爲 external 依賴。

典型用法¶

通過工具
在私聊會話中，讓智能體調用 pin_add 寫入需要每輪攜帶的條目，用 pin_list / pin_remove 維護；臨時用過的工具說明用 library_add 登記，用 library_search 按關鍵詞檢索。羣聊中寫操作會被 guard 拒絕。

通過設置頁
打開設置裏的「釘」頁籤，分別在「釘」「圖書館」裏編輯，與 JSON 文件內容一致，適合人工批量整理。

通過 HTTP
若你在同一 DSH 進程上集成了 HTTP 路由，可按 README 列出的路徑做 list/add/update/delete 以及 library 的 list/add/delete、candidates 等操作；具體請求體以實現爲準，以倉庫源碼爲準覈對。

直接改文件
備份後編輯 pins.json 或 library.json，重啓或按 DSH 狀態加載機制生效即可。

適用場景與注意¶

適合已經在用 DSH、希望把「必須每輪記住的幾件事」和「可檢索的工具摘要」從泛泛上下文裏拆出來的開發者。圖書館模型適合「用過就刪、只留一句用途」的插件與資料清單，而不是整份文檔倉庫。

安裝前請自行閱讀 倉庫源碼 與 MIT 許可證。插件以當前 DSH 進程的權限讀寫 ~/.dsh/jingjing/state/ 下的 JSON；羣聊寫保護降低誤改風險，但不替代你對會話渠道與備份策略的判斷。DSH 生態是「一切皆插件」；SkillHub 目錄爲社區站點，與 DeepSeek、幻方無官方從屬關係。

結尾¶

dsh-pin 把長期必記與可刪可搜的工具標籤分開管，並用私聊 guard 限制寫本體。需要試用或二次開發時，可從目錄頁 xiaole3349/dsh-pin 進入，或直接查看 GitHub 倉庫。