前言¶
在 DSH 裏跑長任務時，想法和中間結論經常散落在對話裏：開頭記的一條需求，跑到一半忘了放在哪兒；想讓 AI 處理某條便籤，又要手工複製正文、指定目錄、再盯着結果。dsh-notes-qiange（籤格 · 智能便籤）就是爲了把這些事情收攏到一處：便籤板開在中間列或右側欄，便籤按項目文件夾分區，需要時拖進任務泳道交給 AI，也可以按日程定時跑。
下面介紹這個插件。它由 jxhsjxhs 維護，是 @zzerx/dsh-plugin-notes（MIT，作者 0x7A7A）的 Fork，基礎上增補了項目文件夾分區管理；社區目錄裏歸在工作流分類，當前 0 星標。安裝方式只有源碼構建一種，因爲還沒發佈到 npm。
這是什麼¶
一句話定位：DSH 的便籤插件，紙卡牆便籤板 + 項目文件夾 + Markdown 編輯器 + 任務泳道。與普通便籤工具的差別在於後半段——便籤可以變成任務，交給 AI 在指定工作區裏跑，也可以按日程定時觸發。
來源歸屬要說清楚：基礎版本是 @zzerx/dsh-plugin-notes 0.6.0（MIT），本分支新增了項目（文件夾）數據模型、文件夾條篩選、新建時區分便籤/項目、編輯器歸屬下拉、agent 項目工具，以及帶 projects 的 WebDAV v2 快照。原項目的 MIT 許可證與版權聲明保留在倉庫 LICENSE 中。
安裝與啓用¶
尚未發佈到 npm，因此先用源碼構建。下面的命令按 README 原文，--profile 後面替換成你自己的 profile 名：
git clone https://github.com/jxhsjxhs/dsh-notes-qiange.git
cd dsh-notes-qiange
npm install
npm run build
dsh plugin --profile <你的 profile 名> add "$(pwd)"
這一步是在本地編譯出插件產物並裝進指定 profile。裝好後側欄出現便籤字形（側欄摺疊時只留圖標），點它打開便籤板；板內右上角 ✕ 或 Esc 回到會話。
發佈到 npm 之後可以直接裝，命令也來自 README：
dsh plugin --profile <你的 profile 名> add dsh-notes-qiange
啓用後有四個入口，都可以在 dsh 設置 → 便籤 → 入口 裏單獨開關，默認全開：側欄頂部入口（點行開板，點 (＋) 只開快捷新建）、輸入框左下角的字形（三行菜單：新增便籤 / 便籤板 / 任務泳道）、每條助手回覆下方的「存成便籤」按鈕（把該條回答連同圖片帶進快捷新建浮層，預填標題與正文）、右側欄導引頁的便籤卡片。四者至少會留一個，全關掉時設置頁會鎖住最後一個開着的入口，因此不會出現沒有入口開不了板的死局。宿主沒裝右側欄時，「打開方式」選右側欄會自動回退中間列。
核心功能¶
一、項目文件夾分區。新建時可選「便籤」或「項目」，項目就是文件夾，便籤按項目歸堆。頂部文件夾條篩「全部 / 未分類 / 某個項目」，支持重命名、改色標、刪除；刪項目不會刪便籤，只把它們挪回「未分類」。停在某個項目裏新建便籤會自動落進該項目，編輯器裏隨時可以改歸屬。快捷新建浮層頂部同樣有「便籤 / 項目」兩個頁籤。
二、三種顯示模式。紙卡牆 / 看板 / 日曆隨時切換，選擇會被記住，項目篩選對三種視圖都生效。六色紙卡配色與 Win11 便籤一致，置頂優先，顏色可多選篩選；標題加正文實時搜索，歸檔便籤收進紙卡牆底部摺疊區，可恢復 / 編輯 / 刪除。
三、到期與日曆。看板卡片上點「截止」即選日期，逾期標紅。日曆按月排格，截止（藍點）、定時觸發（綠點，含未來重複）與執行歷史（橙點，成功/失敗）分色，點事項進編輯器。
四、Markdown 正文。工具欄覆蓋加粗 / 標題 / 列表 / 任務清單 / 引用 / 代碼 / 鏈接 / 表格 / 撤銷重做；任務清單 - [ ] 在紙卡上顯示完成度徽標（如 2/5，全勾變 ✓）。在編輯器裏 Ctrl+V 粘貼剪貼板圖片或普通文件，會存到本地 $DSH_HOME/notes-assets/，正文只留引用，不把 base64 塞進便籤 JSON；文件以「📎 文件名」chip 出現，右側常駐 👁（用本機系統默認應用打開）與 ⬇（下載回來）兩個按鈕。
五、便籤變任務。寫入泳道狀態即成爲任務，五列看板（待規劃 → 待辦 → 進行中 → 已完成 → 已失敗）拖拽換狀態，普通便籤不進看板。編輯器底部只留一行任務摘要（狀態 · 工作區 · 模型 · 預設），點「設置」會從紙條右側抽出一張附表，點「收起」塞回紙後。
六、交給 AI 執行。任務卡 hover「執行」，插件按該任務的工作區新開一個會話跑，便籤板所在會話不被佔用；完成後摘要回到卡片首行，全文進編輯器的「任務與結果」區。跑太久可以「重置爲待辦」。附表裏能選模型與 Agent 預設（留空即宿主默認），隻影響該任務派發出來的新會話。
七、定時執行。支持一次性 / 間隔 N 分鐘 / 每天 / 每週（可多選星期）/ 每月；卡片顯示「週期 · 下次時刻」，編輯器顯示「下次 / 上次」。宿主停機期間錯過的時點超 2 小時不補跑（循環型順延到下一週期，一次性停用並寫明原因），2 小時以內的補跑一次；上一輪未結束則本輪跳過。
八、編輯安全。編輯既有便籤時停頓約 1 秒自動落盤，頁腳有保存指示燈；X /「取消」/ Esc / 點彈窗外，只要還有未保存的改動就彈「便籤有改動」，保存並關閉、放棄改動、繼續編輯三選一。Ctrl+S 立即保存但不關彈窗，Ctrl+Enter 或「保存」按鈕等於保存並關閉。
典型用法¶
卡下流程是 README 裏「常用操作」一節直接給的，按順序走：
1、輸入框左下角那個字形 → 菜單「新增項目」，先建一個放代碼的目錄項目；或在便籤板文件夾條點「新建項目」。
2、同一菜單點「新增便籤」，或點側欄便籤字形裏的 (＋)，記一條「給定時任務把 README 裏的示例跑一遍」。寫的過程中可以用工具欄「任務清單」（或 Ctrl+Shift+9）插幾條 - [ ]，回車續行、Tab 縮進成子項。
3、把這條便籤變成任務：打開編輯器，在右側任務附表裏選工作區（絕對路徑，從下拉框選，候選是最近會話用過的目錄，只選不手填），寫入泳道狀態即成爲任務。文檔明確：沒有默認值也沒有兜底，沒選工作區就存不成任務，摘要行變紅、保存被擋下；泳道里沒設工作區的任務卡顯紅字「未設工作區」，「執行」按鈕也是禁用的。
4、把卡片拖到「進行中」，hover 點「執行」，插件會按這個工作區新開一個會話跑；跑完回來看卡片首行的摘要與編輯器裏的「任務與結果」區。
5、想做週期檢查就再設一條定時任務：bijvoorbeeld 每天一次，它會在卡片上顯示「週期 · 下次時刻」，並在日曆視圖裏以綠點標出。
備份走 WebDAV：在 dsh 設置 → 便籤 → 備份 裏填服務器地址、遠端目錄、賬號與應用密碼，按檢查間隔定時比對，只在便籤有變更時上傳快照，遠端只留最近保留份數份。要立刻驗證連通可以點「保存並立即備份」。注意圖片與附件不隨備份上傳，快照裏只有正文和 notes-asset: / notes-file: 引用，換機恢復只恢復文字與引用，本機沒有對應文件時便籤裏顯示「圖片已丟失」，附件鏈接點了會提示下載失敗。恢復前插件會先自動備份當前狀態，選中的那份整體覆蓋現有便籤。
適用場景與注意¶
適合在 DSH 裏維護長項目的人：需要把臨時想法、需求條目、AI 執行結果都掛在一個固定位置，並且希望「記下來 -> 變任務 -> AI 跑 -> 定時再跑」這條鏈路不靠手工複製粘貼。依賴少、幾乎不用改宿主配置，裝好開關即可；純 UI 宿主也能照常使用便籤板。
三點要注意。其一，插件以當前 dsh 進程的權限運行，能讀寫該進程能訪問的文件與目錄，安裝前應先通讀源碼與 LICENSE（MIT）再決定；它從源碼構建，npm install 會執行倉庫裏的腳本，覈對上游 Fork 來源（@zzerx/dsh-plugin-notes，0.6.0，作者 0x7A7A）是必要步驟。其二，任務執行要求顯式指定工作區，沒有默認值，順着下拉框選而不是手填路徑。其三，宿主裝配了 tools 服務時插件註冊 8 個 agent 工具（notes_list、notes_get、notes_list_projects、notes_create_project、notes_create、notes_update、notes_set_pinned、notes_delete、notes_task_set_status、notes_task_report 中的核心一套）；工具改或刪你手寫的便籤時會發起一次「同意 / 拒絕」，宿主沒有審批通道時 agent 只能刪它自己創建的便籤，任務工具只在「執行」授權的那次會話內可用。
同倉庫裏的開發命令：npm run typecheck（tsc –noEmit）、npm run build（產出 lib/index.js + lib/client.js + lib/types）、npm run watch（改 src 自動重建，host 側改動仍需重啓 dsh）。
結尾¶
dsh-notes-qiange 把「記一筆」到「讓 AI 去做」之間的距離縮短了：便籤按項目分區，任務和 AI 執行結果落回同一塊板子，備份也能走 WebDAV。想先看界面，目錄頁是 https://www.skillhub.cn/plugins/jxhsjxhs/dsh-notes-qiange，源碼與 README 在 https://github.com/jxhsjxhs/dsh-notes-qiange。
