前言¶
在 DSH（DeepSeek Harness）裏和 agent 長對話時，靈感、待跟進事項、臨時結論往往散落在聊天記錄裏，事後很難按主題或時間找回。單獨開筆記應用可以記，但和當前會話、模型上下文是割裂的；讓模型「記住」又多半隻活在當輪上下文裏。便籤牆類插件的思路，是在宿主界面裏常駐一面輕量便籤牆，數據落本機，同時暴露工具讓 agent 在對話裏增刪查。下面介紹社區插件 dsh-sticky-wall（維護者 bingomu，分類：記憶），它在 DSH 左側邊欄提供便籤入口，支持九色便籤、分類篩選、時間分區、歸檔與待辦，並通過 sticky_wall_* 工具供 agent 讀寫。
這是什麼¶
dsh-sticky-wall 是 DSH 的 Web 客戶端插件：左側邊欄圖標欄中有便籤圖標，點開後在主面板展示整面便籤牆。便籤可分類、篩選、置頂、歸檔，也可轉爲待辦清單；對話裏可以用自然語言讓 agent 讀寫這面牆。數據保存在本機單個 JSON 文件中，插件不發起網絡請求、不需要賬號。許可證爲 MIT，當前發佈版本 v1.0.0（見 GitHub release 與 package.json）。
核心功能¶
以下能力均來自項目 README，安裝成功後可逐項對照界面驗證。
入口與輸入
- 左側邊欄便籤圖標打開便籤牆。
- 頂部暖黃色輸入區寫內容，
⌘/Ctrl + Enter或「貼上牆」提交；九種紙色、可選分類。
待辦
- 輸入卡底部「待辦」開關可將新便籤設爲待辦；正文一行一條，可勾選並顯示進度。
- 編輯態可在「便籤 ⇄ 待辦」之間切換；勾選狀態用穩定條目 id 保存，插入、重排、改寫時儘量保留。
瀏覽與整理
- 分類 chips：全部、各分類、未分類，並顯示數量。
- 時間分區：今天 / 本週 / 更早（更早默認收起）；搜索或篩選時結果平鋪。
- 手動歸檔暫時不看的便籤，可隨時取出或刪除。
- 刪除後有約 6 秒撤銷，恢復時保留 id、勾選與歸檔狀態。
agent 工具
| 工具 | 作用 |
|---|---|
sticky_wall_add |
貼一張便籤（text，可選 color、category、kind: 'todo'） |
sticky_wall_list |
讀牆，可按 query / category 過濾、includeArchived 含歸檔、limit 限制 |
sticky_wall_remove |
按 id 撕掉一張便籤 |
在對話中說「記到便籤牆」「便籤牆上有什麼」等，模型可通過上述工具操作。
本地與界面
- 數據路徑：
~/.dsh/sticky-wall/notes.json（若設置了DSH_HOME則以其爲準）。 - 舊目錄
~/.dsh/notes在首次啓動時會自動複製到新目錄一次，舊文件保留作備份。 - JSON 損壞時會備份爲
notes.json.corrupt-<時間戳>後從空牆重新開始。 - 界面語言與亮暗主題跟隨 DSH 宿主（中文 / English）。
安裝與啓用¶
需要 DSH 0.2.1-rc.2 及以上；README 註明已在 0.2.1-rc.5 測試。插件通過 GitHub 發佈的 tarball 安裝，命令須使用資料中的 URL，不要自行拼接 github:owner/repo 形式。
dsh plugin --profile <你的 profile> add https://github.com/bingomu/dsh-sticky-wall/archive/refs/tags/v1.0.0.tar.gz
也可在 DSH 設置 → 插件 →「安裝」中填入同一 tarball URL。安裝後重啓 DSH 並刷新頁面；左側邊欄出現便籤圖標即表示啓用成功。
升級：將 URL 中的 tag 換成新版本 release 的 tarball 地址後重新安裝。卸載：
dsh plugin --profile <你的 profile> remove dsh-sticky-wall
卸載不會刪除 ~/.dsh/sticky-wall/notes.json；若要徹底清空便籤數據，需手動刪除該文件。
典型用法¶
- 點左側便籤圖標打開便籤牆。
- 在頂部便籤紙輸入內容，選紙色與分類，
⌘/Ctrl + Enter或點「貼上牆」。 - 點擊便籤正文就地編輯；底部操作可置頂、換色、歸檔、刪除。
- 需要待辦時：進入編輯態，在分類右側打開「待辦」；每行一條，勾選框記錄完成狀態。
- 用搜索框過濾正文與分類；用分類 chips 限定某一類；點「歸檔 N」查看已歸檔便籤。
- 在對話中讓 agent 寫入或列出便籤，例如說明「把剛纔的接口約定記到便籤牆，分類寫 API」，由模型調用
sticky_wall_add/sticky_wall_list。
備份或遷移：複製 notes.json 即可。
適用場景與注意¶
適合誰
- 希望在 DSH 同屏記錄會話旁的想法、鏈接式備忘、輕量待辦，且不想依賴雲端筆記賬號的開發者。
- 希望 agent 在任務執行過程中把結論寫入持久化便籤、或先查牆上已有條目再回答的用戶。
使用前請知悉
- DSH 生態採用「一切皆插件」思路；社區目錄站點（如 SkillHub 上的插件頁）與 DeepSeek / 幻方無官方從屬關係，安裝來源以 GitHub 與目錄頁說明爲準。
- 插件以當前 DSH 進程的權限讀寫本機 JSON；安裝前建議瀏覽倉庫源碼與 MIT 許可證，確認符合你的環境策略。
package.json要求 Node >=22，DSH 版本 >=0.2.1-rc.2 <0.3.0-0；與宿主 major 不匹配時需等作者更新兼容聲明後再升級。
結尾¶
dsh-sticky-wall 把「隨手貼、分類、歸檔、待辦」和「agent 工具讀寫」收進 DSH 側邊欄一面牆，數據只在本機 notes.json，適合作爲會話旁的輕量記憶層。更多說明與截圖見倉庫 README。
