前言¶

在 DeepSeek Harness（DSH）裏和模型對話，有價值的內容往往散落在多輪消息裏：一段排查思路、一份接口約定、一次實驗結論。事後想整理成筆記，常見做法是複製到外部編輯器，或依賴帶數據庫的筆記服務。前者打斷工作流，後者又引入額外依賴。

下面介紹 dsh-md-notes，一個面向 DSH Web 用戶的第三方筆記插件。它把筆記存成本地 .md 文件，提供全屏管理器與編輯器，支持從對話一鍵摘錄，也可通過 @ 把筆記內容注入模型上下文；可選 Git 同步做備份與多端協作。維護者爲 XieZongChen，在 SkillHub 社區目錄中歸類爲「記憶」。

這是什麼¶

dsh-md-notes 是 DSH 的第三方 bundle 插件，當前版本 0.8.0（MIT 許可證）。它在 DSH Web 側欄提供筆記入口，在每個工作區的 .dsh-notes/ 目錄下以純 Markdown 文件保存內容，不依賴數據庫或雲端存儲。

適用對象：希望在 DSH 內完成「對話 → 筆記 → 再引用」閉環、並偏好文件化、可 Git 管理的開發者。

核心功能¶

筆記管理與編輯¶

側欄底部（Settings 上方）有筆記入口，點擊進入全屏筆記管理器。按工作區分組展示筆記列表，支持摺疊分組；可新建、編輯、預覽 Markdown、保存與刪除（頁內確認）。筆記文件位於各工作區目錄下的 .dsh-notes/，可用任意編輯器直接打開。

從對話摘錄¶

助手回覆旁（複製按鈕旁）有筆記圖標。點擊後選擇已有筆記或當場新建，即可將本輪對話（用戶問題 + 最終回答）追加到筆記，以「會話標題 – 時間戳」爲分節標題。文本直接從對話抓取，無需等待；推理過程不納入摘錄。分節標籤隨 DSH 語言本地化（中/英）。

在聊天中引用筆記（@）¶

在輸入框輸入 @ 可跨工作區選取筆記；發送時宿主將筆記內容注入模型上下文，模型可直接引用，無需額外要求讀文件。

Git 同步（可選）¶

通過配置開啓 Git 模式：

• shared：所有工作區共用一個遠程倉庫，按工作區分子目錄；
• own：每個工作區單獨配置 URL、分支與子路徑。

Push 爲鏡像同步（含刪除）；Update 爲拉取並在三方衝突時確認；打開筆記時可自動 pull。管理器內顯示 Git 同步卡片（「已同步」/「N 條未推送」及遠端有新提交提示）。克隆目錄位於 $DSH_HOME/md-notes-repos/。

其他能力¶

• 寫入互斥：同一條筆記在多會話間寫入時加鎖，側欄、選擇器與管理器保持同步直至寫完。
• 設置面板：DSH Settings → MD Notes，可配置模式、倉庫 URL/分支/子路徑、自動 pull、提交作者等。
• 主題與 i18n：跟隨 DSH 亮/暗主題與中英文界面；npm 有新版本時顯示黃色「有更新」標籤。

路線圖（見倉庫 docs/TODO.md）包括：可視化 Git 衝突處理、筆記搜索/目錄/wiki 鏈接、編輯器髒狀態提醒與快捷鍵等。

安裝與啓用¶

前提：已安裝 dsh CLI，目標 profile 爲 web。

從 npm 安裝（推薦）：

dsh plugin --profile web add dsh-md-notes

安裝或升級後需重啓 dsh web——bundle 層與客戶端包元數據會緩存在進程中，不重啓變更不會生效。

升級：

dsh plugin --profile web update dsh-md-notes

卸載：

dsh plugin --profile web remove dsh-md-notes

卸載不刪除已有筆記文件。插件以當前 dsh 進程權限運行，安裝前建議查閱 GitHub 倉庫 源碼與 MIT 許可證。

兼容性（據 README）：插件 0.8.0 已在 deepseek-harness 主線 0.1.1-rc.2 上驗證；運行時依賴從 dsh 安裝解析，未固定到特定主線 commit。

典型用法¶

1. 按上文命令安裝插件，重啓 dsh web。
2. 新建筆記：側欄點筆記入口 → 在工作區行點 +（生成「Untitled note \<日期>」標題）→ 編輯 → Save。
3. 摘錄對話：在任意助手回覆下點筆記圖標 → 選目標筆記或新建 → Write to note。
4. 引用筆記：聊天輸入框輸入 @ 選筆記，發送後內容進入模型上下文。

可選：在 profile 的 cordis.patch.yml 中覆蓋插件配置，例如：

- id: md-notes
  config:
    route: '/plugins/md-notes'   # HTTP API 前綴，默認即可
    gitMode: 'off'               # 'off' | 'shared' | 'own'
    gitAutoPull: true            # 打開筆記前是否 pull

插件無環境變量與密鑰類配置；網絡僅本機 loopback API，無外部請求與遙測。

適用場景與注意¶

適合：在 DSH Web 內做對話沉澱、按工作區組織技術筆記、用 Git 備份或跨機同步 Markdown 的開發者。

注意：

• 僅支持 web profile，需重啓後生效。
• 筆記綁定工作區；需先在側欄創建工作區，並保證 .dsh-notes 目錄可寫。
• Git 同步爲可選；默認 gitMode: 'off' 時筆記僅存本地。
• 安裝後若界面無變化，先重啓 dsh web；圖標異常可硬刷新頁面。
• 插件由社區維護，SkillHub 爲獨立社區目錄，與 DeepSeek / 幻方無官方從屬關係。

小結¶

dsh-md-notes 把 DSH 對話與本地 Markdown 筆記連在一起：管理編輯在插件內完成，摘錄與 @ 引用減少切換成本，Git 同步則便於備份與協作。當前 GitHub 約 13 stars，可在社區目錄與倉庫獲取安裝說明與更新。

• 社區目錄：https://www.skillhub.cn/plugins/XieZongChen/dsh-md-notes
• GitHub：https://github.com/XieZongChen/dsh-md-notes