前言¶
在 DeepSeek Harness（DSH）裏跑智能體、調插件、看會話時，靈感、待辦和臨時結論往往散落在對話裏，事後很難按「一塊塊小筆記」找回。系統自帶能力側重編排與工具調用，並不專門提供側欄裏的輕量便籤牆。社區插件 dsh-sticky-wall（便籤牆）由維護者 zanhoulll 發佈，靈感來自 DSH 官方視頻中的演示思路；它在 DSH Desktop 啓動的 Web GUI 左側欄增加「便籤牆」入口，打開即是一面可搜索、可編輯、自動保存的彩色便籤牆，無需單獨部署前端或執行構建。
這是什麼¶
dsh-sticky-wall 是掛在 DSH Cordis 插件體系上的便籤面板：Host 半負責本機 JSON 持久化與 HTTP 讀寫，瀏覽器半負責側欄入口、瀑布流佈局與交互。插件運行在 DSH Desktop 客戶端 通過 dsh web 提供的 Web GUI 內，依賴左側欄與主面板插槽，不是可脫離 DSH 單獨打開的網頁應用。當前版本 1.1.0（MIT 許可證），倉庫：https://github.com/zanhoulll/dsh-sticky-wall；社區目錄頁：https://www.skillhub.cn/plugins/zanhoulll/dsh-sticky-wall（獨立站點，與 DeepSeek / 幻方無官方從屬關係）。
核心功能¶
下面介紹 README 中已寫明、且與實現一致的能力。
側欄與快速記錄¶
- 左側欄注入便籤折角圖標，點擊打開獨立主面板。
- 頂部黃色輸入區支持 6 種馬卡龍色；
⌘/Ctrl + Enter或「+ 添加到牆上」快捷添加。
便籤牆與瀑布流¶
- 卡片輕微錯落旋轉，懸停扶正並露出比例、編輯、刪除控件。
- 瀑布流：每張便籤落到當前能放下它的最靠上位置；長文撐高或寬卡擠開鄰居後，後續便籤順次補位，寬卡讓出的空洞也會被補上。
- 每條便籤可獨立設置橫向佔格 1:1 / 2:1 / 3:1 / 4:1（佔 1～4 列）；添加時在輸入區選「出生」比例，卡片上也可切換，比例按便籤持久化。
編輯、搜索與語言¶
- 雙擊卡片文字就地編輯；
⌘/Ctrl + Enter保存，Esc取消；編輯框高度隨正文變化，與展示態一致。 - 頂部搜索框按內容實時過濾；右上角顯示便籤總數。
- UI 與展示元數據提供 zh / en 雙語。
持久化與兜底¶
- 變更即持久化：刷新、換端口、重啓不丟；斷網時仍有 localStorage 鏡像兜底。
- 主存儲文件：
~/.dsh/sticky-wall/notes.json（Host 半用 Node 內建fs原子寫入：臨時文件 +rename）。 - 瀏覽器半優先讀宿主路由，同時在
localStorage保留鏡像，保證首屏與宿主不可用時的回顯。
Host 暴露的同源 JSON 接口：
| 接口 | 說明 |
|---|---|
GET /sticky-wall/notes |
返回 { notes: StickyNote[] } |
POST /sticky-wall/notes |
請求體 { notes: StickyNote[] }，返回 { ok: true, count } |
單條便籤字段：{ id, text, color, ratio, createdAt, updatedAt }；ratio 爲橫向佔列數（1～4，缺省按 1）。宿主側限制包括：正文 ≤ 20000 字符、便籤數 ≤ 2000、請求體 ≤ 2MB 等。
前置要求¶
- DeepSeek Harness Web GUI：須由 DSH Desktop 啓動並在
dsh web實例中打開；插件依賴 Cordis 與側欄 / 主面板插槽。 - web profile：持久化路由需要宿主
webServer；在 headless 等無 Web 的 profile 中插件其餘部分仍可加載，但便籤不會落盤。 - 安裝方式：通過 DSH 內置
plugin_manager以本地目錄安裝，無需npm install或構建；Host 半僅用到 Node 內建fs。 - 瀏覽器：任意現代瀏覽器；數據保存在本機，不依賴外部網絡。
安裝與啓用¶
官方 README 給出的安裝方式是一次工具調用，以本插件目錄的絕對路徑爲安裝包目標，而不是憑倉庫名拼接 CLI 命令。
通過 DSH 插件管理器安裝：
- 工具：
plugin_manager action：install_bundletarget：本插件目錄絕對路徑，例如<本插件目錄絕對路徑>
說明：install_bundle 是工具動作名，下劃線是名稱的一部分，不是佔位符。
安裝後刷新頁面，左側欄出現「便籤牆」入口，點擊即可打開面板。
典型用法¶
- 打開 DSH Web GUI，從側欄進入「便籤牆」。
- 在頂部輸入區寫內容，選顏色與佔格比例（1:1～4:1），用
⌘/Ctrl + Enter或按鈕添加到牆上。 - 在牆上懸停卡片可改比例、編輯或刪除；雙擊文字進入編輯態。
- 用頂部搜索框過濾便籤；需要備份或遷移時，拷貝
~/.dsh/sticky-wall/notes.json即可。
開發與改 client.js 後，可在插件目錄跑渲染冒煙測試（無需真實瀏覽器）：
node test/smoke.mjs
或：
npm test
適用場景與注意¶
適合：在 DSH 會話旁長期保留靈感片段、調試備忘、鏈接與短結論；希望數據留在本機、側欄一點即達，且不想維護獨立筆記服務的使用者。
注意：
- 插件以當前 dsh 進程權限 運行，安裝前應閱讀源碼並確認 MIT 許可證與行爲是否符合預期。
- 無 Web 的 profile 下便籤不會寫入磁盤；需要落盤時請使用帶
webServer的 web profile。 - 項目無第三方 npm 依賴、無構建步驟；瀏覽器半通過
window.__ModuleLoader__懶加載，純 DOM + 內聯樣式。
結尾¶
dsh-sticky-wall 把「隨手貼靈感」收進 DSH 側欄：瀑布流、可調佔格、搜索編輯與雙端持久化（宿主 JSON + 本地鏡像）都在 Web GUI 內完成。進一步瞭解可查看社區目錄 https://www.skillhub.cn/plugins/zanhoulll/dsh-sticky-wall 與 GitHub 倉庫 https://github.com/zanhoulll/dsh-sticky-wall。
