前言¶
在 DeepSeek Harness（DSH）裏做智能體或長對話時，上下文往往散在聊天記錄裏，難以沉澱、檢索，也很難讓模型在明確邊界內讀寫你的長期知識。單獨開一個 Obsidian 可以記筆記，但和 DSH 界面、對話裏的工具鏈是兩套系統。Note Keeper（dsh-note-keeper）把 Obsidian 兼容的 Markdown 庫嵌進 DSH Web 側欄，並提供 notes_* 工具，讓同一進程裏的模型在護欄內搜索、讀寫筆記，同時筆記仍以磁盤上的普通 .md 文件存在，便於與 Obsidian 或其它同步方式對齊。
這是什麼¶
Note Keeper 是 DSH Web GUI 的插件：在左側欄增加「Notes」入口，打開後爲全屏面板中的本地優先筆記應用。默認把筆記存放在可配置的目錄（默認 ~/NoteKeeper），格式與 Obsidian vault 一致。維護者爲 Loukas “Luca” Tzekos（GitHub：lucagiftzek），許可證 MIT。npm 包版本爲 0.3.0，要求 Node >=22.5，DSH 引擎 >=0.1.1-rc.1。
社區目錄頁：https://www.skillhub.cn/plugins/lucagiftzek/dsh-note-keeper
源碼與文檔：https://github.com/lucagiftzek/dsh-note-keeper
SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；DSH 生態遵循「一切皆插件」的思路，安裝來源以 README 與目錄頁爲準。
核心功能¶
下面按 README 已說明的能力歸納，不展開未在資料中出現的配置默認值以外的細節。
側欄與 vault 佈局¶
- 註冊在
sidebar.panellist槽位，在主欄 keyed 槽位以全頁面板打開。 - Wikilink（
[[Note]]）、嵌入（![[Note]]）、#tags（含嵌套如project/alpha）、YAML frontmatter、callout（> [!warning]）、.trash可回收刪除，佈局與 Obsidian 一致。 - 重命名或移動筆記時，會改寫其它筆記中指向它的 wikilink / embed，行爲與 Obsidian 類似。
索引、搜索與視圖¶
- fsnotify 監聽目錄變更（本應用寫入、本機 Obsidian、同步客戶端等），通過 Server-Sent Events 刷新各瀏覽器標籤；另有約 5 分鐘一次的全量掃描兜底。
- 全文搜索：希臘文與拉丁字母可無重音匹配，輸入時支持末詞前綴，
"引號短語"精確匹配；可按標籤（含嵌套）或文件夾過濾。 - 標籤瀏覽（含計數）、反向鏈接、標題大綱、本地關係圖（含未解析鏈接的 ghost 節點）。
.capture 與模板¶
- 快捷方式：向
Inbox.md追加帶時間戳的列表項或- [ ]任務；或打開/創建Daily/YYYY-MM-DD.md，若存在Templates/Daily.md則展開模板。 Templates/下任意筆記可作新建模板，支持{{title}}、{{date}}、{{time}}佔位符。
編輯、附件與衝突¶
- CodeMirror 6 實時預覽（鏈接、wikilink、標籤可點擊），支持源碼、分欄、閱讀模式。
- 自動保存：末次按鍵約 1.2 s 後寫入；標籤隱藏或關閉時立即 flush。
- 保存攜帶讀取時的 mtime；併發編輯會顯示衝突條，可選加載磁盤版、保留雙方或覆蓋本地編輯。
- 附件支持上傳、粘貼、拖拽（圖、音、視頻、PDF 等），大圖 inline 預覽；HTML、SVG、JS 等風險類型強制下載。超過 64 MiB 的分片上傳（
begin/chunk/finish），組裝上限maxAttachBytes爲 1 GiB。
語音、繪圖、OCR¶
- 語音筆記：
MediaRecorder錄音，調用dsh-voice插件的/api/voice/stt（希臘語、英語爲一等公民，另有多種語言與auto），可選潤色後存爲帶nk-type: audiofrontmatter 的 Markdown，並嵌入音頻。 - 復古畫板：鉛筆、筆刷、橡皮、噴槍等，柵格 + 矢量層；保存爲 PNG、矢量 JSON，可選 OCR 文本寫入一條 drawing 筆記。
- OCR：默認 Tesseract
eng+ell，用於粘貼/附件圖片及畫板內容（手寫爲盡力而爲）。
加密、同步與導入¶
- 客戶端零知識加密：加密後的筆記/附件/文件夾對服務端、同步工具與 AI 工具 opaque，僅知道密碼的瀏覽器可讀（詳見倉庫 Security model）。
- Connect：Obsidian 專用 Sync 插件（一次性配對碼、簽名請求）、WebDAV、經 rclone 的雙向雲鏡像（Google Drive、OneDrive、Dropbox、iCloud Drive、S3 等），協議見
docs/SYNC-PROTOCOL.md。 - 導入：Obsidian / Bear / Logseq / Joplin Markdown、HTML、Evernote
.enex、Google Keep Takeout、Notion 導出 zip 等。
AI 側能力¶
- AI Enhance：用 DSH 默認或設置中選定的模型做校對、排版與內鏈，以 diff 預覽後再應用。
- 12 個
notes_*工具：供同一會話中的模型在明確護欄下讀取、搜索、寫入用戶筆記（具體名稱與參數見 README 的 AI tools 表）。
安裝與啓用¶
Linux x64 上，npm 包內帶預編譯的 bin/notekeeperd，一條命令即可（安裝後需重啓 dsh web）：
dsh plugin --profile web add @lucagiftzek/dsh-note-keeper
資料明確說明：單獨執行 dsh plugin add github:lucagiftzek/dsh-note-keeper 不會構建 daemon，不能替代完整安裝流程。
非 Linux x64，或需要從源碼安裝時，在本機構建 Go daemon 與瀏覽器 bundle（Go ≥ 1.22，Node ≥ 22.5），再 link 到 web profile：
git clone https://github.com/lucagiftzek/dsh-note-keeper.git
cd dsh-note-keeper
npm ci
npm run build
dsh plugin --profile web add link:$PWD
OCR 可選依賴（Debian/Ubuntu 示例）：
sudo apt install tesseract-ocr tesseract-ocr-ell
也可在 ~/.dsh/profiles/web/package.json 的 dependencies 中手動添加 "@lucagiftzek/dsh-note-keeper": "link:/path/to/dsh-note-keeper" 後重啓 dsh web（與 README Install 節一致）。
典型用法¶
- 安裝並重啓
dsh web後，在側欄打開 Notes，確認 vault 路徑（默認可改爲配置項vault指向的目錄）。 - 用 Inbox 快捷捕獲或 Daily 模板建立日常流；在筆記裏用
[[wikilink]]與#tag組織知識，在圖視圖或全文搜索中導航。 - 若已安裝
dsh-voice，可錄語音筆記走 STT 落盤；需要手繪時打開畫板，保存後可選 OCR 進正文。 - 在 DSH 對話中，由模型調用
notes_*工具檢索或追加筆記前，應理解加密筆記對服務端與工具不可見；非加密內容仍受衝突檢測與權限約束。 - 要與手機或其它桌面 Obsidian 對齊，按 README 配置 Connect / WebDAV / rclone 之一，並閱讀
docs/SYNC-PROTOCOL.md。
適用場景與注意¶
適合：已在用或打算用 Obsidian 式 Markdown 庫、又希望筆記與 DSH Web 側欄、語音 STT、AI Enhance 及 notes_* 工具同一套界面協作的開發者與用戶。
注意：
- 插件以當前 DSH 進程權限 運行，可讀寫 vault 目錄及插件實現的 API；安裝前應審閱源碼與 MIT 許可證，並自行評估 vault 路徑與備份策略。
- 零知識加密一旦啓用，丟失密碼無法由服務端恢復；AI 工具無法讀取加密內容，這是設計行爲而非缺陷。
- 大附件與分片上傳受
maxAttachBytes（1 GiB）與邊緣網關限制（單請求 64 MiB 分片策略）約束，部署在 Cloudflare 等環境時需心裏有數。 - 語音轉寫依賴
dsh-voice插件提供的/api/voice/stt，未安裝時相關流程無法完成。
結尾¶
Note Keeper 把 Obsidian 兼容的本地 Markdown vault 搬進 DSH 側欄，補齊搜索、圖譜、語音、畫板、OCR、衝突處理與可選端到端加密，並通過 notes_* 把筆記納入智能體工具鏈。若要在 Linux x64 上快速試用，從 npm 安裝即可；其它平臺或需改 daemon 時按倉庫構建說明 link 安裝。
- 目錄頁：https://www.skillhub.cn/plugins/lucagiftzek/dsh-note-keeper
- GitHub：https://github.com/lucagiftzek/dsh-note-keeper
