前言¶
DeepSeek Harness（DSH）的核心理念是「一切皆插件」。在長期對話中，模型會產出結論、解釋或想法，這些信息若不整理，很容易被淹沒或丟失。本插件提供了一個確定的流程，將 DSH 對話中值得長期保存的內容直接整理進 Obsidian 知識庫。
這是什麼¶
dsh-obsidian-inbox 是一個面向 DSH 的 SKILL.md 技能，由開發者 Leo3-7 維護。它定義了一套整理入庫的標準流程，旨在解決知識碎片化的問題，將對話中的高價值信息結構化地存入 Obsidian。
核心功能¶
插件運行時，會按照以下原則處理內容：
- 檢索優先於歸檔：在寫入知識庫前，先按文件名、aliases、鏈接、frontmatter 或 MOC 進行檢索。如果目標已存在，則進行合併。
- 合併優先於新建：只做局部編輯，僅更新
updated時間戳，不整篇覆蓋，也不生成副本。 - 只提煉長期價值：不保存完整的聊天記錄、密碼、令牌或臨時的噪音信息。
- 一個主歸屬：每個知識條目只進入一個主目錄，跨領域的關係通過鏈接和標籤表達。
- 兩級確定性校驗：校驗包含兩個層級。第一層是公式級，識別
$$或$的數學公式，拒絕非法字符；第二層是結構級，檢查 Wiki 鏈接（[[Link]]）的有效性、.obsidianJSON 配置的合法性以及同名歧義。校驗不通過時，不會宣佈「已入庫」。
安裝¶
插件已發佈至 npm，可以通過以下命令安裝：
dsh plugin --profile web add dsh-obsidian-inbox
如果你的 DSH 使用的是其他 profile，請將 --profile web 替換爲實際名稱。
配置¶
使用前需配置兩個關鍵項：
- Vault 路徑：由插件的
Config.defaultVault決定。默認爲空，需手動設置爲你的 Obsidian 庫路徑。在調用校驗工具時，也可以通過參數覆蓋。 - 主目錄分類：默認結構包含
00_收件箱 / 01_考研 / 02_AI與編程 / 03_智能製造 / 04_項目 / 05_想法 / 06_錯題 / 07_對話精華。請根據實際需求調整目錄結構。
校驗工具¶
插件暴露了一個模型工具 obsidian_validate_vault，用於在校驗前檢查知識庫的健康狀態。這並非 shell 腳本，而是在對話中直接調用的工具。
調用示例：
obsidian_validate_vault
obsidian_validate_vault (vault: "...")
工具會返回 { ok, noteCount, problems }。當 ok=false 時，會逐條列出公式、JSON、Wiki 鏈接或同名歧義問題。退出碼爲 0 表示通過，1 表示發現問題。
依賴與環境¶
- Node.js：版本需
>= 18。 - 目標環境：一個標準的 Obsidian vault，必須包含
.obsidian配置目錄。
總結¶
本插件通過 ctx.skills 註冊爲 bundled provider，將 DeepSeek Harness 與 Obsidian 的知識管理能力連接起來。它通過嚴格的校驗和合並邏輯，確保知識庫的整潔與一致性。
