前言¶

在 DeepSeek Harness（DSH）裏做智能體或長對話時，靈感、待辦和零散句子往往落在對話歷史或剪貼板裏，需要時再找成本高。常見做法是用外部筆記或本地 Markdown，但和「繼續跟 AI 聊下去」之間還要自己複製粘貼、自己整理標題和分類。dsh-note（倉庫名 dsh-stickynote，維護者 AIcivilization，分類：記憶）是 DSH 的 web 側插件：側欄一點或快捷鍵打開捕獲浮層，文字或語音記下後落本地 Markdown；保存後由對話當前模型異步整理標題、歸類、補要點、抽待辦；再一鍵投遞到當前對話或新開對話。定位是分流入口，不是又一本需要自建文件夾結構的筆記庫。

這是什麼¶

npm 包名爲 dsh-note（與生態裏已有的 dsh-sticky-note 區分，避免 npm 相似名衝突）。它是 DeepSeek Harness 插件，要求 DSH >=0.2.1-rc.5，硬依賴 webServer；當前包版本爲 0.1.3，許可證 MIT。設計思路寫在倉庫 DESIGN.md；社區目錄頁見 SkillHub 條目，源碼與說明見 GitHub。

核心能力¶

捕獲與整理¶

• 側欄按鍵、對話頂部按鈕打開主界面；Alt+Space 打開捕獲浮層，⌘↵ 保存，Esc 取消。
• 捕獲浮層支持語音：插件自帶採集（getUserMedia → WAV），識別走宿主 speechController（需 voice-input-bundle 且 provider 就緒）。
• 保存後 AI 異步整理：起標題、三層歸類（規則 → 模型 → 用戶）、補要點、抽待辦、認時間線索；跑過 AI 的條目帶 +AI 角標，原文改過會標「舊」。
• 無 llm 服務時便籤保持「素貼」，沒有 +AI；AI 整理跟隨對話當前模型，插件不單獨配置模型。

瀏覽、搜索與數據形態¶

• 三區面板：軟分類樹、卡片流、詳情；支持搜索原文、標題、標籤、類別。
• 回收站爲軟刪除、無 TTL，可恢復；歸檔默認從主視圖排除，可在歸檔視圖查看或取消歸檔。
• 批量多選：歸檔、取消歸檔、移入回收站，單條失敗不影響其餘；超過 120 條用虛擬滾動，官方說明 5000 條仍可流暢瀏覽。
• 數據目錄 ~/.dsh/stickynote/：一條一文件 Markdown + frontmatter，圖片在 media/；卸載插件數據不丟，只是沒有界面。可 git、可 grep、可外掛 Obsidian。

與對話的銜接¶

• 一鍵投遞到當前對話或新開對話併發送（真建會話並把內容作爲第一條消息，不是留草稿）；投遞前會處理空草稿、發送中、已有內容等幾種情況，默認「追加」。
• 新開對話前可列出相關思路作爲投遞候選，多選一起帶走。
• 分類決定主按鈕：想法/工作「聊這張」、待辦「設個提醒」、參考「找相關」、生活「看看」。「聊這張」可綁卡片爲主題，輸入框上方顯示主題條。
• 聊完後可通過 agent 工具 stickynote_update 把結論追加回卡片（只追加不覆蓋）。
• 待辦側認出「明天下午」等時間線索時可交給 schedule 建提醒；無 schedule 則不顯示「設個提醒」。模糊時間詞（如「有空」「改天」）故意不解析。

模型工具與其它¶

插件向模型暴露 4 個工具：stickynote_capture、stickynote_search、stickynote_get、stickynote_promote。設置頁可查看數據目錄、條數、AI 開關、隊列，開關四類提示、增刪類別；支持導出全部爲單個 .md，設置頁導入 .md / .txt（永遠新建不覆蓋）。捕獲浮層可粘貼或拖入截圖，圖片存本地，默認不發給模型（隱私優先；看圖需 attachment 服務）。多標籤同步用 SSE，輪詢兜底。

安裝與啓用¶

從 npm 安裝（推薦）：

dsh plugin --profile web add dsh-note

本地開發改代碼時：

dsh plugin --profile web add /path/to/dsh-stickynote

然後在 profile 的 package.json 裏把 dsh-note 加入 dsh.profile.bundles，重啓 dsh，瀏覽器硬刷新（Ctrl+Shift+R）。前端 bundle 帶 immutable 緩存頭，不硬刷可能繼續用舊 manifest。

可選依賴缺失時的行爲（摘自 README）：

典型用法¶

1. 工作或對話中按下 Alt+Space，輸入或語音記下片段，⌘↵ 保存。
2. 稍後在側欄打開三區面板，在分類樹或搜索裏找到條目，查看 AI 生成的標題與要點。
3. 需要繼續深挖時，點「聊這張」開新對話並綁定主題；或把卡片內容投遞到當前對話。
4. 對話得出結論後，讓 agent 調用 stickynote_update 把結論寫回卡片。
5. 待辦類條目若識別出確定時間，用「設個提醒」交給 schedule（到點推送依賴通知類插件，如 dsh-notify-me）。

保存時若發現與已有條目相似，會 T1 提示，只提示不自動合併。

適用場景與注意¶

適合需要在 DSH 內快速收錄碎片、又希望少維護文件夾、且希望內容和後續對話打通的開發者與用戶。卡片按「展示 / 深入 / 執行 / 參考」等路徑分流，強調記下來之後能立刻進對話或執行，而不是長期堆在收件箱裏。

安裝前建議自行查看 GitHub 倉庫 源碼與 MIT 許可證。DSH 插件在 dsh 進程權限下運行，數據寫在用戶目錄 ~/.dsh/stickynote/，語音與圖片涉及本機能力與本地文件，按需評估環境。社區目錄 SkillHub 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；星標數會隨時間變化，以 GitHub 頁面爲準。

已知邊界包括：語音轉寫一次性返回、不做流式邊聽邊出字；圖片默認不參與模型閱讀；懸浮球與部分提示功能在 README 中標註尚未完成。

結尾¶

dsh-note 把「秒記」和「AI 整理 + 投遞對話」收進同一套本地 Markdown 數據裏，適合作爲 DSH 工作流裏的記憶與分流入口。目錄與安裝說明：SkillHub · dsh-stickynote；倉庫與完整能力列表：github.com/AIcivilization/dsh-stickynote。