dsh-notes: DeepSeek Harness 筆記工作區插件

前言¶

DeepSeek Harness (DSH) 的設計理念是“一切皆插件”。在智能體開發或對話過程中，我們需要一塊獨立的區域來記錄筆記，且要求與中央對話區域互不干擾。dsh-notes 插件在 DSH 界面右側欄提供了一個獨立的“筆記”工作區，旨在解決左側欄/右欄重複、筆記樹失真以及 Agent 與筆記割裂的問題。

它是什麼¶

dsh-notes 是 DeepSeek Harness 的筆記工作區插件。

定位: 右側欄獨立筆記區域 + CodeMirror 6 實時預覽編輯器。
維護者: DynaMyhome
許可證: MIT
核心價值: 筆記即普通 Markdown 文件，按工作區組織，擁有類似 Typora/Obsidian 的編輯手感。

安裝與啓用¶

插件需要構建產物並安裝到當前 profile。請使用 plugin_manager 工具，不要手動編輯 profile 配置文件。

# 1) 構建客戶端產物
cd "<你克隆 dsh-notes 的目錄>"
npm run setup && npm run build

# 2) 裝進當前 profile
#    action: install_bundle, target: <本目錄絕對路徑>

安裝完成後，右側欄會出現「筆記」入口。

核心功能¶

1. 右側欄獨立筆記區域¶

右側欄被劃分爲兩部分：左側是可收起的筆記樹，右側是 Markdown 編輯器。這是與左側“會話/工作區”和中央“DSH 對話”的明確區分。
- 筆記樹: 顯示當前工作區的筆記索引。
- 編輯器: 基於 CodeMirror 6，支持預覽/源碼切換。

2. 編輯器能力¶

預覽模式: 標記默認隱藏，文字直接編輯。標題分級、列表、引用、雙鏈、真表格都在原位渲染，光標進入才展開源碼。
公式支持: 行內公式 $...$ 和行間公式 $$...$$，使用 MathML 渲染，零字體依賴。
真表格: 表格單元格支持就地編輯，不撐列、不挪位。
代碼卡片: 代碼塊渲染爲圓角卡片，帶語言名、語法着色和複製按鈕。
自動保存: 默認 800ms 自動保存，切換模式或關閉標籤頁前會自動提交未保存內容。

3. 筆記樹與組織¶

按工作區: 一個工作區對應一棵樹。筆記本質是普通 .md 文件，需在 frontmatter 中包含 dsh-note-id。
納入管理: 工作區內的未標記文件會自動歸入「未歸類」，可在此面板進行批量納入或忽略操作。
分類右鍵: 支持重命名和刪除分類。刪除分類僅改變樹歸屬，不觸碰磁盤文件。

4. Agent 原生集成¶

插件爲 Agent 增加了一個 knowledge 工具。Agent 可以通過此工具管理筆記（登記、註銷、歸類、重掃），內容操作繼續沿用既有文件工具。

5. 大綱與快速打開¶

大綱: 切換到“大綱”視圖可查看標題樹，支持拖拽重排。
快速打開: 在編輯器區域按下 Ctrl/Cmd+P（或 Ctrl/Cmd+K）可快速打開筆記。

6. 回收站¶

右鍵刪除筆記會將其移入工作區內的 .dsh-notes/.trash/ 目錄。只有點擊“徹底刪除”纔會真正 unlink 磁盤文件。

典型用法¶

創建筆記¶

在筆記樹或分類右鍵菜單中選擇“新建”。筆記本質是普通 Markdown 文件，建議添加 dsh-note-id: "uuid" 前言。

Agent 操作¶

在 Agent 對話中，使用新增的 knowledge 工具。例如：
- knowledge register <note-id>: 將筆記登記爲知識。
- knowledge unfiled: 查看未歸類列表。

文件管理¶

刪除: 右鍵點擊分類或筆記 -> Delete -> 移入回收站。
恢復: 在樹工具欄點擊 🗑 圖標進入回收站，選擇恢復或徹底刪除。

數據存放與配置¶

存儲位置¶

插件數據（分類樹、忽略規則、回收站）默認跟隨工作區，存儲在 <工作區>/.dsh-notes/ 目錄下。
- 索引文件: index.json，包含樹結構、歸屬關係等。
- 回收站: .trash/，存放被刪除的文件。

關鍵配置項¶

鍵	默認值	含義
`notesDir`	`notes`	筆記根目錄（相對於工作區根）
`storeScope`	`workspace`	數據存放範圍：`workspace` 跟隨工作區，`home` 放 `$DSH_HOME/knowledge`
`autosaveMs`	800	自動保存靜默時長，0 表示關閉
`watch`	true	文件監視，用於檢測改名/刪除

切換行爲¶

不重載: 切走右側欄的標籤或收起整欄，組件不卸載，切回來時內容保留，不會重新拉取。
換機器: 只需拷貝工作區目錄，.dsh-notes 裏的索引和回收站會自動跟隨。

注意事項¶

圖標來源: 插件的圖標與標題元數據不來自插件代碼，而是由 DSH 啓動時通過 dsh-app-boot 讀取 package.json 中的配置。
權限: 插件以當前 DSH 進程權限運行，安裝前請檢查源碼與許可證。
徹底刪除: 只有在回收站中點擊“徹底刪除”纔會真正從磁盤移除文件。