dsh-math-memory：面向數學筆記的 DeepSeek Harness 記憶助手

前言¶

DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在數學學習場景中，記號習慣、理論偏好、未完成的證明、技巧和反例都需要長期積累並不斷打磨，形成連貫的系統。通用聊天 AI 往往將每次對話視爲孤立的問答，無法承接歷史上下文。

dsh-math-memory 是一個面向數學筆記的 DSH 助手，駐留在 Obsidian 右側欄。它爲智能體提供了跨會話的分層記憶、統一的檢索協議以及備忘錄的維護策略，確保每次新會話都能從上一次的狀態繼續。

插件概覽¶

名稱：dsh-math-memory
維護者：maple110011
分類：記憶
許可證：MIT
定位：面向數學筆記的 DeepSeek Harness 助手，駐留在 Obsidian 右側欄。

核心功能¶

分層記憶系統¶

插件構建了五層記憶結構：
1. 畫像：語義層，用於定義上下文。
2. 主題：導航層，用於快速定位。
3. 記錄：原子化卡片層，帶有 hook: 檢索塊和驗證級別（✅⚖️❓）。
4. 原始證據：追加式記錄，保存對話原始證據。
5. 收件箱：備忘錄層，用於捕獲想法，隨後可打磨爲正式記錄。

統一檢索與驗證¶

統一搜索：使用 note_recall 協議，在一次 BM25 排序中同時檢索筆記和所有記憶層（鉤子卡片、備忘錄、主題、定理/證據索引）。
讀取驗證協議：系統會將查詢蒸餾爲挑戰，讀取前 2-3 個命中項進行人工判斷。如果結果爲空或較弱，會重新表述查詢一次，隨後承認“不在 vault 中”而非編造內容。

符號系統與維護¶

符號系統維護：維護 memory/notation.md，包含採用/候選/被拒絕的表格和修訂歷史，防止記號漂移。
每日審計：自動掃描強/弱/未使用/重複候選/未驗證卡片，並檢查結構完整性（缺失來源/斷鏈/缺失索引行）。
備忘錄提醒：針對過時（收件箱 > 7 天，打磨 > 3 天）或當前相關的備忘錄提供打磨提醒。

跨會話上下文與回覆協議¶

跨會話上下文：將歷史 DSH 會話（zstd JSONL）蒸餾爲有界的問答提示，供當前會話使用。
回覆質量協議：在形式化之前先給出直覺，將新材料錨定在現有筆記上，進行蘇格拉底式糾正，並檢查低頻問題。

控制面板與反饋¶

Obsidian 內存面板：顯示狀態條（各層狀態 + 上次審計時間）、需審覈卡片列表（支持 ✅/❌/stale/archive 操作）、證據時間線以及中文審計摘要。
反饋循環：回覆中包含 依據的記憶：<card title> — [✅ 這條對] [❌ 這張卡有錯] 鏈接，通過後端 /feedback 端點糾正記憶卡片。

獨立性¶

默認不掛載 @linxin666 UI 插件（如 Skin Center、Task Board 等），避免依賴衝突。Skin Center 可在設置中手動啓用。

安裝與啓用¶

使用官方 CLI 安裝：

dsh-math-memory install

前置要求：
* DeepSeek Harness >= 0.1.7-rc.2
* Node.js >= 22.5

典型用法¶

搜索與讀取：使用 note_recall 搜索筆記和記憶，根據覆蓋度指標判斷信號強度。
策略處理：使用 note_strategy 處理證明或構造問題。
創建筆記：使用 note_create 創建新筆記（拒絕覆蓋）。
糾正記憶：在回覆中點擊反饋鏈接糾正記憶卡片。
審覈歸檔：在內存面板中審覈卡片並歸檔。

適用場景與注意事項¶

適用場景：需要長期維護數學知識體系、希望 AI 記住上下文細節、習慣使用 Obsidian 進行筆記管理的用戶。
版本說明：當前版本（0.7.x）爲原型，缺少主動教學循環和調用系統，1.0 版本才包含完整的教學與調用功能。
依賴說明：默認不掛載 UI 插件，如需使用 Skin Center 需額外安裝。note_search 功能已廢棄。
生態說明：該插件遵循 DSH “一切皆插件” 的生態理念，社區目錄（如 SkillHub）與 DeepSeek 官方無官方從屬關係。安裝前請檢查源碼與許可證。

總結¶

dsh-math-memory 通過分層記憶和統一檢索，解決了數學筆記在跨會話中的上下文斷層問題。它提供了一個可審計、可糾正的記憶底座，適合需要深度沉澱知識體系的技術用戶。項目地址：GitHub | 社區目錄。