把 Obsidian 變成 dsh 的長期記憶:本地知識庫搭建實戰

讓 DeepSeek Harness 直接讀你的筆記庫、用你的文風寫新筆記——從 API 金鑰到交付驗收,7 步圖文全流程

最近更新: 2026-09-25

Obsidian vault showing a DeepSeek Harness introduction note beside the dsh chat panel attached to the Obsidian Vault workspace
左邊是 Obsidian 庫裡的介紹筆記,右邊 dsh 面板已掛載 Obsidian Vault 工作區

對話框裡的 AI 沒有記性,你的筆記卻有。把 Obsidian 庫接進 DeepSeek Harness 之後,agent 能直接讀庫裡的筆記、用你既有的文風寫新筆記、改完直接存回檔案——不必再在對話框裡複製貼上。

本攻略的 8 張截圖來自兩支 B 站實錄影片(已逐幀核對並裁除浮水印與人像氣泡):一支完整走過「裝 dsh → 設金鑰 → 接 Obsidian → 寫筆記」,另一支補上工作區骨架與交付驗收兩段。每張圖都能回跳原影片對應秒數。

結論速覽

  • ▸接入只要三步:申請 API 金鑰 → 把 Obsidian 庫新增為工作區 → 在 Obsidian 側邊欄裡直接對話
  • ▸先用 AGENTS.md 聲明「只要骨架、不寫內容」,agent 架目錄樹前會和你確認約束
  • ▸寫新筆記前它會先讀完整個庫,成品會模仿你庫裡的詞源考據、雙鏈和對照表習慣

七步圖文實操

第一步 · 把筆記庫接入 dsh

  1. 1

    申請 DeepSeek API 金鑰

    在 deepseek.com 開放平台的 API keys 頁新增金鑰,建立成功後立刻複製保存——彈窗關掉就再也看不到完整 key。dsh 的本地智慧代理靠這把鑰匙呼叫模型。

    deepseek.com → API keys → Create new API key
    API key created
    DeepSeek platform API keys page with the Create new API key dialog open and an "API key created" confirmation toast
    在 deepseek.com 平台新增 API key,彈窗裡一次性顯示、立刻複製保存回看影片 1:24
  2. 2

    把 Obsidian 庫新增為工作區

    啟動 dsh 後點開左下角的工作區選擇器,選「新增工作區」,把你的 Obsidian vault 資料夾(示範裡叫 demo-kb)掛進來。掛好之後,庫裡的所有 .md 筆記都在 agent 的可見範圍裡。

    demo-kb ▾ → 添加工作区…
    Obsidian Vault
    dsh new-session screen with the workspace picker open, showing demo-kb and the add-workspace entry for the Obsidian vault
    點開工作區選擇器,「新增工作區」把 demo-kb 庫掛進 dsh回看影片 1:15
  3. 3

    在 Obsidian 側邊欄裡直接對話

    在 Obsidian 的內嵌瀏覽器裡開啟 dsh 的本地位址,DeepSeek Harness 就住進了側邊欄:左邊是筆記,右邊是對話,workspace 顯示為 Obsidian Vault。寫筆記、問庫、改檔案都不必切視窗。

    Obsidian Vault · 标准模式
    Full access · DeepSeek-V4-Flash High
    DeepSeek Harness preview running inside an Obsidian side panel with Full access mode and the DeepSeek-V4-Flash High model selected
    在 Obsidian 內嵌面板裡開啟 dsh,邊看筆記邊對話回看影片 2:04

第二步 · 讓 agent 長在知識庫裡

  1. 4

    用 AGENTS.md 立好知識庫骨架

    下一句「幫我架知識庫」,agent 會先和你對齊規格:目錄只長出「寫作工作流/專案/資料」三類骨架、除 AGENTS.md 外零筆記內容,樹狀結構和約束合規表都確認後才動手。

    AGENTS.md(唯一文件,即"结构意图+约束"声明)
    写作工作流选题素材草稿成稿复盘 · 项目进行中已归档 · 资料文章书籍课程工具
    dsh session showing the final demo-kb folder skeleton beside an AGENTS.md master-control panel listing purpose, structure and constraints
    最終骨架樹與「我的知識庫 AGENTS(示意)」約束面板對照回看影片 1:45
  2. 5

    旁觀它讀庫的執行過程

    軌跡面板裡能看到它讀了哪些筆記:《DeepSeek Harness 介紹.md》《Harness.md》《Harness Engineering.md》……先讀再答,這是它「認識你的庫」的方式,也是你校正它理解的機會。

    Read · Harness.md
    Read · 视频分享/Harness Engineering.md
    dsh trajectory panel listing Read calls over vault notes including Harness.md and Harness Engineering.md before answering
    軌跡面板裡逐條 Read:先讀庫,再回答回看影片 2:36
  3. 6

    讓它用庫裡的文風寫新筆記

    讓它「幫我寫一篇 DeepSeek 介紹筆記」:它會先瀏覽全庫再動筆,成品連「模型是大腦,Harness 是身體」的比喻講法都在模仿你庫裡的詞源考據和雙鏈習慣,並與既有筆記保持一致。

    风格上模仿了你库里的特点:一句话引用开头、口语句、对比表格、[[双链]]关联笔记
    Read · Obsidian + DeepSeek Harness 打造本地知识库.md
    Obsidian note beside the dsh panel where the agent runs Bash checks and reads vault notes to write a requested introduction note
    「幫我寫一篇介紹筆記」:先跑 Bash 看目錄,再讀庫裡既有筆記回看影片 0:26
    a freshly written What is Harness note in Obsidian beside the dsh reply explaining it imitated the vault etymology and comparison-table style
    新筆記入庫:連「模型是大腦,Harness 是身體」的講法都在模仿庫內文風回看影片 2:51
  4. 7

    交付驗收:約束合規才算完成

    agent 交出交付物清單(AGENTS.md + 寫作工作流 + 專案 + 資料三層)並附約束合規表:目錄總數、零內容約束逐項打勾。你補一句「把資料再分文章/影片/客戶三層」,它先核對再執行——這就是可驗收的知識庫。

    把资料下面再分 文章/视频/客户 三层
    目录总数 10 ✓ · 零内容约束 仅 AGENTS.md ✓
    dsh session with the demo-kb deliverables tree and a constraints-compliance table where every folder rule is checked off
    交付物清單 + 約束合規表,逐項打勾才算驗收回看影片 2:43

讓知識庫一直長下去

  • ▸新筆記都讓 agent 用庫內文風寫,風格飄移它自己會先揪出來
  • ▸結構調整先改 AGENTS.md 的約束,再讓 agent 遷移目錄,像第 7 步那樣先核對再動手
  • ▸長任務交給背景執行,回來在軌跡面板裡回顧它讀了什麼、改了什麼
  • ▸敏感筆記單獨放一個不加進工作區的 vault——接入範圍就等於可見範圍

常見問題

關於 dsh 知識庫的四個高頻疑問

需要哪一版 dsh?收費嗎?

dsh 本體開源免費,模型呼叫按 DeepSeek API 計費。本頁畫面使用 0.1.5 預覽版錄製,其他版本的介面可能略有差異,「一切皆插件」的工作區機制不變。

一定要用 Obsidian 嗎?

不用。任何本機資料夾都能新增為工作區;Markdown 只是 Obsidian 的原生格式,雙鏈和屬性讓 agent 更容易「讀懂」你的庫,純 txt 資料夾同樣可以接入。

筆記會被上傳到雲端嗎?

不會。檔案讀寫都發生在你本機,dsh 只把對話內容和 agent 讀到的片段作為上下文傳給模型 API。不想入庫的筆記,放在工作區之外的 vault 即可。

和記憶插件(RAG)有什麼區別?

工作區是「直接讀寫檔案」:agent 用 Bash/Read 工具操作你的真實筆記,變更落盤。記憶/RAG 插件則是把文字切片做向量檢索,適合不想讓 AI 動檔案的情境,兩者可以共存。

相關攻略

把這條工作流接進你的日常

影片來源與致謝

本頁 8 張截圖取自以下兩支 B 站影片,已逐幀核對並裁除浮水印與人像氣泡;每張圖右下角可回跳原影片對應時間點。安裝步驟的完整解說另見 dsh 插件安裝全攻略

DSH Plugins 是獨立的 DeepSeek Harness 外掛市集,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。