前言¶

在 DeepSeek Harness 裏和 AI 協作時，常有還沒成項目、卻值得先記下來的想法。若單獨爲每條靈感建會話或項目，成本高；若只寫在對話框裏，又難回看、也難和已有筆記體系對齊。Obsidian 側已有本地 Markdown 倉庫，但切到獨立應用再記一筆，會打斷工作流。

dsh-obsidian-memo 由社區維護者 cavenzhong 開發，是 DeepSeek Harness 的客戶端插件：在 Harness 左側欄提供便籤入口，把你在 Obsidian 裏選定的文件夾攤開成淡色便籤牆。筆記仍是倉庫裏的普通 .md，圖片留在倉庫附件中；需要反饋時用 Harness 默認模型評論，需要推進時用「開檔」生成結構化項目文檔。下面介紹它是什麼、能做什麼，以及安裝與典型用法。

這是什麼¶

dsh-obsidian-memo 是 DeepSeek Harness 的 Obsidian 便籤插件，當前版本 0.14.2，以 MIT 許可開源。它不另建筆記庫，不把內容鎖在插件內：便籤即所選 Obsidian 目錄中的 Markdown 文件，歸檔即移動文件。

插件要求 DeepSeek Harness >=0.2.2-rc.1 <0.3.0（engines.dsh；開發與驗證於 0.2.2-rc.1）。運行環境爲 DSH 桌面版或 Web GUI；無需在 Obsidian 裏安裝配套社區插件，也無需單獨配置 API Key——AI 複用 Harness 當前默認模型。

• 目錄頁：SkillHub - dsh-obsidian-memo
• 源碼與說明：GitHub - cavenzhong/dsh-obsidian-memo

核心功能¶

便籤牆與記錄¶

左側欄進入後，所選文件夾中的筆記以卡片形式展示。子文件夾自動分色；可按日期篩選，按創建時間、最近修改或文件名排序；跟隨 DSH 淺色與深色主題。首屏加載 50 張，滾到底自動補批。

底部輸入欄用於快速記錄：標題即 Markdown 文件名，在標題框按 Enter 創建便籤；按 Tab 展開正文，用 ⌘ / Ctrl + Enter 提交。圖片可粘貼、拖入或多選（最多 8 張），默認壓縮爲 WebP（質量 70、最大邊長 2048px，可在設置中調整或關閉）。新建時會沿用 Obsidian 爲當前文件夾配置的 Default Template 的 frontmatter。

閱讀、編輯與整理¶

單擊卡片在右側打開閱讀面板；雙擊標題或正文進入編輯，⌘ / Ctrl + Enter 保存。閱讀模式可直接勾選任務，寫回原 Markdown 的 [ ] / [x]。點圖釘可把面板固定在右側，與便籤牆並排對照。頂欄可切換是否包含子文件夾、日期範圍與排序方式。

四種 AI 視角¶

點卡片上的 emoji，針對當前便籤調用默認模型生成反饋；提示詞、callout 樣式與生成預算可在設置中自定義。反饋以 Obsidian callout 追加到原文件末尾，在 Obsidian 中仍可正常閱讀。

開檔、歸檔與跳轉到 Obsidian¶

• 開檔：在開檔目錄生成 <項目名>/<項目名>.md，整理訴求與下一步等結構，並把項目鏈接寫回源便籤的 PROJECTS frontmatter。
• 歸檔：將文件移動到所選歸檔目錄；頂部浮窗 6 秒內可撤銷。
• 在 Obsidian 打開：通過 obsidian://open?path=<便籤絕對路徑> 由系統打開器喚起 Obsidian（需本機已安裝並註冊協議）。

安裝與啓用¶

插件無需構建，無運行時依賴，不需要 Node、pnpm 或單獨 API Key。安裝前建議在 GitHub 瀏覽源碼與 LICENSE，確認許可與行爲；插件以當前 DSH 進程權限讀寫你指定的倉庫路徑。

1、準備源碼¶

從倉庫獲取源碼並記下目錄的絕對路徑。README 支持克隆倉庫，或下載 ZIP 解壓：

git clone https://github.com/cavenzhong/dsh-obsidian-memo.git

2、在 Harness 中安裝 bundle¶

在 Harness 對話中讓 agent 調用 plugin_manager，將 target 換成你的本地路徑（link: 引用目錄，安裝後請保留該目錄）：

action: install_bundle
target: link:/absolute/path/to/dsh-obsidian-memo

若曾安裝舊包名 dsh-sticky-notes，應先移除舊包再安裝本包。裝好後在左側欄打開便籤入口；若無入口，可重啓或刷新 DSH。

3、配置目錄¶

點右上角齒輪，至少設置「倉庫根目錄」與「便籤目錄」並保存。

更新時可 git pull 後重新執行安裝命令，或在插件頁停用再啓用；卸載不會刪除 Obsidian 中的筆記與附件。

典型用法¶

工作間隙在底部輸入欄寫一句標題並回車，便籤即寫入便籤目錄。需要配圖時直接粘貼或拖入，不必先整理附件路徑。想稍展開時按 Tab 寫正文，再用 ⌘ / Ctrl + Enter 提交。

回看時在牆上點卡片，右側讀全文；需要改筆誤時雙擊進入編輯。若希望 AI 換視角，點卡片上對應 emoji；同一視角已有評論時會詢問是否再生成一條。

想法成形後可用「開檔」生成項目文檔並鏈回便籤；暫時不需要跟進的條目可選歸檔目錄移走。要在 Obsidian 裏用雙向鏈接或社區插件繼續整理時，用「在 Obsidian 打開」即可。

常用快捷鍵摘錄：

適用場景與注意¶

適合：筆記已在 Obsidian、希望在 Harness 工作時隨手記錄；不想爲每條靈感單獨建項目，但希望必要時一鍵開檔；願意讓 AI 參與討論且堅持本地 Markdown。

不適合：用它替代 Obsidian 全文搜索、雙向鏈接與插件生態；在手機上完整操作便籤牆（當前側重桌面）。插件不提供全文搜索、拖拽排序、批量操作與文件實時監聽（以外部修改約 4–30 秒輪詢感知爲主）。

數據與隱私方面：筆記與圖片只在你選定的倉庫內讀寫；設置保存在插件目錄的 data/settings.json，不寫入 DSH profile。除你主動觸發 AI 評論或開檔外，模型調用會把當前便籤相關內容發往所配置的模型服務；插件自述無遙測上報。

Windows / Linux 的路徑與「在 Obsidian 打開」邏輯已實現但 README 標明 macOS 已驗證，其他系統可自行試跑併到 Issues 反饋。

結尾¶

dsh-obsidian-memo 把 Harness 側欄、本地 Obsidian Markdown 與默認模型串成一條短鏈路：記下 → 回看 → 獲得反饋 → 開檔或歸檔。筆記所有權始終在 vault 裏，插件只是讀寫你指定的目錄。

• 插件目錄：https://www.skillhub.cn/plugins/cavenzhong/dsh-obsidian-memo
• 倉庫與完整 FAQ：https://github.com/cavenzhong/dsh-obsidian-memo