前言¶
在 DeepSeek Harness（DSH）裏跑智能體或調試會話時，經常需要臨時記下 API 路徑、待辦或一段草稿，卻不想切到系統記事本或外部筆記應用。瀏覽器標籤頁一多，上下文也容易丟。社區插件 dsh-plugin-scratchpad（維護者 wake2008dingtalk-sys，目錄分類爲「記憶」）在 Harness 客戶端左側欄增加一個 Scratchpad（中文界面爲「隨手便籤」）入口，點擊後在主欄打開多行便籤，內容只寫入當前瀏覽器的 localStorage，不上傳服務器。下面介紹它的定位、能力與安裝方式。
這是什麼¶
dsh-plugin-scratchpad 是一個 DSH bundle 插件：通過 cordis.patch.yml 向宿主註冊插件行，客戶端在全局側欄面板列表（sidebar.panellist，id scratchpad，order 20）增加一項圖標，與內置插件、日程等入口並列；點擊後由宿主 ctx.layout.selectPanel() 選中中央面板（main，key scratchpad）。宿主側 index.js 僅導出空的 apply()，界面與交互在純 JavaScript 的 client.js 中實現，不依賴 Harness Client 包導入，經瀏覽器模塊加載器註冊。
源碼與說明見 GitHub：wake2008dingtalk-sys/dsh-plugin-scratchpad。社區目錄頁：SkillHub 插件條目。許可證爲 MIT。
核心功能¶
側欄與主面板¶
- 左側欄增加 Scratchpad 圖標；側欄負責按鈕樣式，選中邏輯走 Harness 佈局 API。
- 主欄提供多行便籤輸入區，帶實時字符計數和 Clear（清空）操作。
本地持久化¶
便籤通過瀏覽器 localStorage 保存，數據不離開本機。換瀏覽器或清站點數據會丟失內容，需自行備份重要筆記。
國際化與主題¶
界面文案經 dsh Client 的 locale 服務路由，提供 locale/en.json 與 locale/zh.json，側欄標籤與面板隨當前語言切換。樣式僅使用 dsh 主題 token（--dsw-alias-*），與客戶端主題一致。
安裝與啓用¶
本倉庫是 DSH bundle 包：package.json 聲明 dsh.bundle.patch 與 dsh.client web 模塊。安裝前請將倉庫下載或解壓到本機某一目錄（README 允許 clone 或 download；勿在文檔中把 clone 當作唯一方式，但安裝命令指向的是該目錄的絕對路徑）。
在 DSH 會話中，用插件管理器指向該目錄安裝：
plugin_manager install_bundle target=<absolute path to this repository>
插件管理器會把包鏈入當前 profile、選中 bundle 並應用。全新安裝可通過 HMR 激活，一般無需重啓進程。安裝完成後，左側欄會出現 Scratchpad 圖標，點擊即可打開便籤面板。
卸載：
plugin_manager remove_bundle @local/sidebar-scratchpad
npm 包名爲 @local/sidebar-scratchpad（package.json 版本 1.0.0）。
典型用法¶
- 按上文命令完成
install_bundle。 - 在 Harness Web 客戶端左側欄找到 Scratchpad / 隨手便籤圖標並點擊。
- 在中央面板輸入臨時筆記；關閉頁面或刷新後，同一瀏覽器下內容仍從
localStorage恢復。 - 需要清空當前便籤時使用面板上的 Clear。
無額外配置文件或環境變量；行爲以 README 與 client.js 爲準。
適用場景與注意¶
適合：在同一 DSH Web 會話中快速記調試信息、命令片段、會話要點，且希望數據留在本機、不經過插件服務端。
兼容說明：README 標明在 DeepSeek Harness 0.2.1-rc.5（developer preview）上構建驗證；所依賴的 client slot 契約可能在後續版本變化，升級 Harness 後若側欄或面板異常，需對照上游變更與插件倉庫 Issue。
安全與信任：插件以當前 DSH 進程及瀏覽器上下文運行；安裝前應閱讀 index.js、client.js、cordis.patch.yml 與許可證。本插件僅使用 localStorage，不涉及遠程上報，但仍屬社區第三方 bundle，非 DeepSeek / 幻方官方組件。SkillHub 等社區目錄爲獨立站點，與官方無從屬關係。
結尾¶
dsh-plugin-scratchpad 把「隨手記」收進 Harness 左側欄與主欄，用本地存儲完成記憶類需求，實現路徑清晰、卸載命令明確。需要詳情或提 Issue 時，可訪問 GitHub 倉庫 與 SkillHub 目錄頁。
