前言¶
在 DeepSeek Harness（DSH）裏做智能體或長會話開發時，對話內容往往分散在多輪消息裏；若再用外部雲筆記或單獨開一個編輯器，庫路徑、來源會話和 Agent 可檢索的上下文容易脫節。下面介紹社區插件 dsh-note（維護者 SivanCola）：在 Harness Web UI 內提供三欄筆記庫、雙欄實時預覽，並把會話沉澱、回答保存與 note_* Agent 工具接到同一套本地 Markdown 文件上。數據落在本機目錄，不依賴第三方筆記雲服務。
這是什麼¶
dsh-note 是 DSH 的「記憶」類插件：本地 Markdown 三欄筆記庫（導航 / 列表 / 編輯器）、雙欄實時預覽、標籤與待辦聚合，以及「把當前會話一鍵沉澱爲筆記」。界面佈局參考有道雲筆記桌面端，但筆記文件在你自己的文件夾裏，可用任意編輯器、git 或 Obsidian 直接打開。
- 目錄頁：https://www.skillhub.cn/plugins/SivanCola/dsh-note
- 源碼與說明：https://github.com/SivanCola/dsh-note
- npm 包名：
@sivancola/dsh-note，當前版本 0.1.0，許可證 MIT
社區目錄站點與 DeepSeek / 幻方無官方從屬關係；DSH 生態的理念是「一切皆插件」，按需從目錄或 GitHub 安裝即可。
核心功能¶
筆記庫與編輯¶
- 目錄式筆記庫：窄導航、文件夾樹、正文三欄；支持搜索、在當前文件夾內新建筆記與子文件夾、按標題或更新時間排序；目錄樹支持鍵盤導航，工具欄可切換摘要列表。
- 篩選狀態保持：從最近、收藏、標籤或搜索進入筆記時保留篩選；待辦來源跳轉保留待辦頁與關鍵詞。
- 收藏與置頂：星標與圖釘獨立保存；「最近」取最近 15 篇（按更新時間，不受置頂影響）。
- Markdown 編輯 + 實時預覽：編輯 / 分欄 / 預覽三種模式；工具欄覆蓋常用語法；輸入約 650ms 防抖自動保存，狀態欄顯示保存時間。
- 標籤與全文搜索：每篇可加標籤，標籤頁按出現次數聚合；
⌘K聚焦搜索，標題與正文即時過濾。
待辦中心¶
從所有筆記中抽取 - [ ] 待辦集中展示，可按任務文字、來源標題或標籤搜索；勾選後回寫原文件並同步當前編輯區與預覽。已完成項列在下方；筆記變更導致行失效時會刷新並提示重新勾選。
與 Harness 會話聯動¶
- 會話沉澱：會話標題欄「存爲筆記」，將當前用戶/助手對話整理爲帶日期的筆記，並打「會話沉澱」標籤。
- 筆記加入對話：可將整篇快照或選中片段加入現有對話或新開工作區對話；經 Harness 原生輸入接口寫入草稿，不自動發送；單次最多 12000 個 Unicode 字符，超出會提示截斷。
- 保存回答到筆記：從回答操作欄新建或追加筆記，保存前可預覽；僅持久助手消息文字，不去保存思考或工具調用；同來源重複保存會去重。
- 來源雙向跳轉：frontmatter 中的
dsh_sources記錄會話與筆記關聯；可從筆記回到來源會話，或從會話「關聯筆記」打開筆記。
Agent 讀寫¶
插件註冊四個工具：note_list、note_search、note_read、note_write。在對話裏用自然語言檢索、閱讀或寫入筆記庫中的 Markdown，例如按關鍵詞在本地 vault 中查找接口或活動文檔。
設置¶
「設置 → 筆記」顯示當前庫路徑與統計，可修改筆記庫目錄（保存後插件自動重載）；支持字號切換（小 / 標準 / 大 / 特大），並提供打開筆記面板入口與快捷鍵說明。
數據存在哪裏¶
默認庫目錄：配置項 rootDir 留空時爲「Harness 默認工作目錄 / notes」，也可用環境變量 DSH_NOTES_DIR。改目錄推薦走 設置 → 筆記 → 筆記庫目錄（寫入 profile 覆蓋層）；或修改 cordis.patch.yml 的 config.rootDir 後重裝 bundle。
單篇筆記即一個 .md 文件，示例 frontmatter：
---
title: 雙十一廣告轉盤活動 · 接口評審
tags: [活動, 接口]
created: 2026-11-09T03:34:19.511Z
updated: 2026-11-09T03:35:23.241Z
pinned: false
starred: false
---
## 背景
...
筆記 id 爲相對庫路徑（去掉 .md），例如 工作/2026/接口評審。改標題不會重命名文件；目錄樹對應磁盤子文件夾，不讀取符號鏈接。界面偏好（字號、排序、默認閱讀模式等）存在本機 localStorage，鍵前綴 dsh-note:，不隨 vault 同步。
Host 側提供 POST /api/dsh-note（list / get / create / save / search / todo / deposit 等 action）；路由僅接受本機迴環請求並做同源校驗。插件依賴 Harness 的 tools、webServer，無第三方 npm 依賴，零構建。
安裝與啓用¶
從 GitHub 安裝（以 README 原文爲準）：
dsh plugin add github:SivanCola/dsh-note
本地開發可在 DSH 裏用 plugin_manager 將倉庫目錄裝成 bundle（install_bundle）；改代碼後可在插件頁停用再啓用「筆記」以重載，必要時刷新頁面。
安裝前建議在 GitHub 瀏覽源碼與 MIT 許可證；插件以當前 dsh 進程權限讀寫本機筆記目錄，庫路徑與 API 僅面向本機，但仍需你信任維護者與倉庫內容。
典型用法¶
- 安裝並啓用插件後，在設置中確認或修改筆記庫目錄。
- 在三欄界面中創建文件夾與筆記，用分欄模式編寫 Markdown，用標籤與搜索管理規模稍大的庫。
- 長會話結束後，在會話標題欄使用「存爲筆記」做一次性沉澱；對單條有用回答用「保存回答到筆記」追加到指定篇目。
- 需要將筆記上下文帶入下一輪對話時，用「加入對話」插入草稿，再在 Harness 裏編輯後發送。
- 讓 Agent 使用
note_search/note_read等工具在本地庫中查找 material，再用note_write按你的指令更新筆記（注意 Agent 具備寫盤能力，應對重要目錄做備份或版本管理）。
倉庫內可用 npm run check 做語法檢查、npm test 跑 22 個測試；CI 在 Node 22 / 24 上執行相同檢查。
適用場景與注意¶
適合：希望在 DSH 同一界面內管理本地 Markdown、把會話與筆記來源互相可追溯、並讓 Agent 直接讀寫筆記文件的開發者。
尚未實現（README 列出的方向）：雙鏈 [[ ]]、知識庫、文件夾移動/重命名、網頁剪藏、AI 摘要與續寫、有道雲同步、每日日記模板等。
注意：來源跳轉到會話後，Harness 暫無公開的消息滾動定位 API，插件不會自動滾動聊天時間線。刪除原始會話、移動筆記文件或更換庫目錄後，部分來源鏈接可能失效，界面會報錯。外部同時修改同一文件時，保存衝突會保留本地內容，需你明確選擇「重新載入」才放棄未保存修改。
結尾¶
dsh-note 把本地優先的 Markdown 筆記庫、待辦與標籤、會話沉澱和 Agent 四工具收進 DSH Web UI，適合把對話產物和長期資料放在同一工作區、同一目錄樹下維護。安裝與詳情見社區目錄 https://www.skillhub.cn/plugins/SivanCola/dsh-note，源碼與完整能力列表見 https://github.com/SivanCola/dsh-note。
