前言¶

在 DSH 裏寫 Composer 草稿時，常會有一段文字暫時用不上、又捨不得刪掉——切到外部筆記應用會打斷上下文，留在輸入框裏又佔視線。DeepSeek Harness 的插件模型允許把這類能力做成獨立模塊：dsh-quicknote 由社區維護者 dsh-kit 發佈，歸類爲客戶端插件，把「從當前草稿捕獲一條筆記、挪開視線、集中查看與處理」做成 Composer 工具欄、側邊頁和 Agent 工具三條入口。下面按安裝、用法和數據存放說明可覈對的事實；社區目錄見 SkillHub 插件頁，源碼與 README 見 GitHub。

這是什麼¶

dsh-quicknote（npm 包名 dsh-quicknote，當前發佈版本 0.1.1，MIT 許可證）的定位是：從 DSH Composer 捕獲筆記，不擋當前寫作，並在單獨一頁裏搜索、篩選和管理列表。官方簡介爲：Capture a note from the DSH composer, keep it out of the way, and manage the list on one page.

插件面向 DSH Web 客戶端（dsh.client.platform: web），要求 DSH 引擎 >=0.2.1-rc.5。更完整的說明見項目文檔：https://dsh-kit.github.io/dsh-quicknote/。

核心功能¶

Composer 工具欄¶

在 Composer 工具欄點擊 Quick Note。卡片會帶上當前草稿內容；你可以只保存爲筆記，或保存並顯式清空草稿，把輸入框騰出來繼續寫。

側邊頁¶

從側邊欄進入筆記頁，可以搜索、按 All / Open / Done 篩選，複製內容、插入到當前活躍草稿，以及標記完成或刪除。

Agent 工具¶

智能體可通過以下工具名操作同一套數據（具體參數以插件文檔與 AGENTS.md 爲準）：

• quicknote_add
• quicknote_list
• quicknote_done
• quicknote_delete

存儲與 HTTP API¶

筆記保存在本機文件 ~/.dsh/quicknote/notes.json：本地存儲、文件模式 0600、原子寫入；README 寫明無遙測。

Host 側提供四條 JSON 路由（供客戶端與集成方對照）：

• GET /api/quicknote/notes
• POST /api/quicknote/notes/create， body { text }
• POST /api/quicknote/notes/update， body { id, done }
• POST /api/quicknote/notes/delete， body { id }

安裝與啓用¶

DSH 生態裏常見做法是：CLI/Web 用 profile 安裝插件，桌面端用應用內插件頁（desktop profile 由應用管理）。以下命令均來自倉庫 README，不要自行改成 github:owner/repo 形式。

已發佈版本（安裝到 CLI/Web profile）：

dsh plugin --profile web add dsh-quicknote

本地開發（把當前工作目錄 link 進 profile）：

dsh plugin --profile web add link:$PWD

桌面端請在 DSH 桌面應用的插件頁面安裝；desktop profile 不由上述命令管理。

安裝後可用下面命令確認插件是否出現在配置裏：

dsh --profile web --dump-config | grep -A2 "id: dsh-quicknote"

典型用法¶

1. 在 Web 端啓用 web profile 並安裝 dsh-quicknote。
2. 在 Composer 寫草稿時，點 Quick Note，在卡片裏保存當前內容（按需選擇是否清空草稿）。
3. 打開側邊欄筆記頁，用搜索和 Open/Done 篩選處理待辦式筆記；需要回填時複製或插入到當前草稿。
4. 若在 Agent 會話裏維護筆記，調用 quicknote_add / quicknote_list / quicknote_done / quicknote_delete，與 UI 共用 notes.json。

開發插件本身時，倉庫要求 Node >=24，可用 pnpm install 與 pnpm verify（或 npm install && npm run verify）跑格式、lint、類型檢查、測試與打包檢查。

適用場景與注意¶

適合需要在 DSH 寫作流裏「先存一句、稍後統一處理」的用戶，以及希望 Agent 與 UI 共享同一份本地筆記列表的場景。

插件以當前 DSH 進程的權限讀寫 ~/.dsh/quicknote/notes.json；安裝前應閱讀 源碼倉庫 與 MIT 許可證，自行判斷是否滿足安全與合規要求。SkillHub 等社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，安裝來源以你信任的 registry 或 link 路徑爲準。

結尾¶

dsh-quicknote 把 Composer 草稿、側邊列表和 Agent 工具接到同一本地存儲，減少在 DSH 內外來回切換筆記應用的成本。查閱條目與分類：SkillHub — dsh-quicknote；源碼、安裝說明與 API：github.com/dsh-kit/dsh-quicknote。