前言¶
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 | 社区目录。
