前言¶
DeepSeek Harness（DSH）的插件生態強調“一切皆插件”。在長期的項目開發或複雜的智能體調試中，對話記錄往往散落在聊天窗口中，難以管理和複用。dsh-noteboard 插件提供了一種解決方案：在會話視圖中提供一個工作區級的無限畫布，將對話內容提取爲結構化的 Markdown 便籤，並支持通過引用氣泡將便籤發回給 AI 進行處理。
安裝與啓用¶
本插件依賴 DSH 環境。在安裝前，請確保你的環境滿足要求：
- DSH 版本：>=0.2.0-rc.2
- Node.js 版本：>=22.19.0
通過官方插件目錄安裝：
dsh plugin --profile web add dsh-noteboard
dsh web
npm 安裝的是預構建產物，無需在本地執行構建腳本，也不會觸發 pnpm 的構建授權確認。
核心功能¶
無限畫布與便籤管理¶
插件提供無限畫布，支持平移、縮放、網格吸附以及多畫布佈局的切換。便籤以 Markdown 文件形式存儲，每個文件包含 frontmatter 元數據，支持七種顏色和亮暗雙主題。
從對話採集¶
在對話視圖中，選中一段文字，會出現採集工具欄。你可以選擇將原文直接“存入畫布”，或者選擇“AI 提煉”生成精簡的便籤。
來源回鏈¶
每張便籤都會記錄其來源會話。點擊便籤上的“打開對話”按鈕，可以直接跳轉回原文位置，並高亮顯示對應的文字片段。
發回給 AI¶
便籤可以拖拽至輸入框，以引用氣泡的形式發送給 AI。系統會對引用內容進行長度校驗，累計超過 32,000 字符的引用氣泡會阻止發送。
整理與工具¶
支持通過標籤膠囊進行聚焦過濾、搜索標題/正文/標籤，以及找回離板便籤。插件註冊了 12 個模型工具和 5 個內置工作流，用於自動化處理便籤數據。
典型用法¶
-
採集與提煉
在對話中框選關鍵內容，選擇“AI 提煉”。插件會根據配置的提煉要求（標題、標籤、正文長度）生成便籤。 -
批量提取
使用noteboard-extract工作流，可以按條件從會話中篩選內容並保存爲便籤。 -
引用與跳轉
點擊便籤的“來源”或“打開對話”跳轉至原文；處理完畢後，將便籤拖回輸入框，AI 可以基於這些結構化引用進行後續操作。
AI 工具與工作流¶
插件提供了豐富的 AI 工具集：
12 個模型工具：
- canvas_add_note：創建便籤
- noteboard_query：搜索或讀取便籤全文
- noteboard_create：批量創建便籤（最多 200 張）
- noteboard_update：修改便籤，支持按顏色分組批量着色
- noteboard_layout：按標籤重排、對齊或分佈便籤
- noteboard_sessions：查找來源會話
- noteboard_read_session：讀取會話原文
- noteboard_add / noteboard_remove：便籤增刪操作
- noteboard_save_as：保存畫布佈局
- noteboard_history / noteboard_restore：歷史記錄與恢復
5 個內置工作流：
- noteboard-extract：按條件篩選並提取便籤
- noteboard-organize：按主題歸類、加標籤、重排
- noteboard-compare：比較方案、權衡優缺點
- noteboard-actions：將想法拆解爲行動項
- noteboard-synthesize：合併重複便籤或綜合結論
注意事項與限制¶
- 文件格式：畫布文件採用 JSON Canvas 1.0 格式，內容與佈局分離，可由文本編輯器管理。
- 單用戶：插件假設單用戶環境，不支持跨進程文件鎖和實時協同。
- 無 UI 邊緣/組：目前不提供連接線和成組的 UI，但文件格式已預留位置。
- 操作機制：不監聽文件變更，每次 RPC 操作前整體重讀。
- 歷史記錄：默認保留最近 50 條操作記錄。
- 配置變更：舊的 prompt 配置不再生效，請使用“額外提煉要求”。
結語¶
dsh-noteboard 將 DSH 的對話流與結構化知識管理結合，通過便籤和畫布實現了信息的沉澱與複用，適合需要在長期會話中整理思路、追蹤決策的開發者。
