DeepSeek Harness (DSH) 採用插件化架構，支持通過配置擴展能力。在多會話開發或長時間任務中，開發者需要在所有後續會話中保持某些長期約定，比如“回答使用中文”、“不要修改 main 分支”等。dsh-plugin-pinboard 插件通過將便籤注入系統提示來解決這一問題，實現一次置頂，全局生效。
這是一個跨會話置頂便籤插件，支持將便籤注入所有會話的系統提示，並內置標籤管理與事實庫。
安裝與啓用¶
安裝需要執行以下步驟：
1、使用官方命令安裝插件包：
dsh plugin --profile web add github:121212165/dsh-plugin-pinboard
2、將倉庫根目錄的 cordis.patch.yml 內容合併到 $DSH_HOME/profiles/web/cordis.patch.yml。該文件默認爲空數組，建議整份替換或合併數組，不要直接追加，否則會導致 YAML 解析錯誤。
3、重啓 DSH。配置層與客戶端均需重啓才生效。
核心功能¶
插件主要提供以下能力：
- 跨會話注入：在任何會話通過
/pin置頂便籤，該便籤會進入之後所有會話的系統提示。 - 標籤元數據：支持爲便籤添加標籤，標籤僅用於列表與檢索，不進入注入正文。
- 內置事實庫：通過
/facts命令與fact_search工具管理事實，事實存儲在同一個文件中，但不佔用注入預算。 - 模型自主調用：模型可自主調用
pin_add工具進行置頂。
常用命令¶
插件提供以下命令與工具：
- 置頂便籤：
/pin <一句話> [#標籤...]
重複內容不會重複入庫。
- 取消置頂：
/unpin <id>
- 列出便籤：
/pins
輸出中 `●` 表示會注入，`○` 表示因超出預算被擠出。
- 事實庫管理：
/facts save|find|list|rm|import
其中 `import` 爲只讀操作，不會修改源文件。
- 模型工具：
pin_add：模型自主置頂。fact_search：模型自查事實庫，按標籤/正文命中打分。
配置與注意事項¶
便籤與事實存儲在 ~/.dsh/pinboard/pins.jsonl。注入受限於 limit（默認 12）和 maxChars（默認 1200）。
- 便籤按
at時間戳倒序注入，最新優先。單條便籤超長時會截斷，保證最新一條一定到達。 - 配置錯誤（如
limit: -1）會導致啓動失敗並點名 pinboard，不會拖垮 Harness。 /facts import爲只讀操作，源文件字節不變。- 重複內容不重複入庫。
總結¶
該插件通過注入機制解決了跨會話上下文丟失的問題，適合需要長期固定指令的場景。插件維護者：121212165，許可證：MIT。
