DSH 数学笔记助手（dsh-math-memory）

English · 简体中文

住在 Obsidian 右侧栏里的数学笔记助手，会记住你上次做到哪里。

普通对话助手聊完就忘。这个插件把笔记和长期记忆都放在你自己的 vault 里，新会话能接着上次继续。所有数据都在本机。

它做什么

跨会话记得住。 它把画像、记忆卡、想法备忘录和对话原文都存进 .deepseek/，全是可读可改的 Markdown。
一次搜索就找得到。 note_recall 同时搜笔记和所有记忆层，先读最相关的几条再回答。
看得见、改得动。 记忆面板列出它记住的东西，每张卡可以确认、标错或归档，回复里也会标出引用了哪张卡。
不越界。 笔记留在你的 vault，服务只监听本机，助手没有 shell、不能上网、也没有删除工具。

现在到哪一步

版本 0.8.3，还是试做型。「记住、找到、改得动」这条线已经能完整跑通。还差更难的一半：帮你建立数学理解——知道你卡在哪、下一步该练什么、怎么复用你自己的技巧。那才是 1.0。当前状态和待办放在 docs/README.md。

安装

A. 从 Obsidian 装（推荐）。 设置 → 第三方插件 → 浏览，搜索 DSH Math Notes Assistant，安装并启用。首次运行时插件会找到 DeepSeek Harness、装好配置和 vault 模板，并启动服务。

B. 命令行安装。

npm install -g dsh-math-memory
dsh-math-memory install --vault "<你的 vault 路径>"
dsh --profile notes-assistant --port 3180

C. 手动安装。 从最新 Release 下载 main.js、manifest.json 和 styles.css，放进 <vault>/.obsidian/plugins/dsh-math-assistant/。

环境要求

Obsidian 桌面版，Node.js 22.5 或更新。
DeepSeek Harness（@deepseek-ai/dsh，要求 ≥ 0.1.7-rc.2），并配好 DeepSeek 模型。
默认端口 3180。普通 dsh web 用 3080，两者可以同时运行。

vault 里放什么

vault/
  AGENTS.md                     工作约定，自动加载
  .deepseek/
    memory/profile.md           你是谁、习惯怎么工作
    memory/notation.md          记号表
    memory/records/             记忆卡片
    memory/episodes/            对话原文证据
    memory/topics/              主题索引
    inbox/                      想法备忘录
    capture-policy.md           哪些内容会自动记住

装好之后

打开右侧栏开始聊天。每次会话开始时，助手会读 AGENTS.md 和记忆索引。想看或改它记住了什么，打开记忆面板；想改自动记忆的范围，用面板里的捕获策略一行或插件设置。

项目与开发

当前状态与待办：docs/README.md
两个组件怎么配合：ARCHITECTURE.md
安装与发布细节：docs/installation.md、docs/release.md
为什么这样改：docs/changelog.md
改记忆或检索之前：docs/memory/README.md
助手的工具：四个笔记工具（note_recall、note_strategy、note_create、note_links），外加文件读写与搜索。

开发命令：

npm test          # 语法 + 478 项零 token 回归 + 路由回归（69 项路由断言） + 侧栏认证握手回归（8 项，对真实 dsh）+ 侧栏反代回归（24 项）+ 安装器 e2e（漂移检测）
npm run qa        # 引擎探针（不花 API 钱）
node scripts/build-obsidian.mjs   # 改共享文件后重建 main.js

版本：0.8.3

隐私

全部在本机运行：服务只监听 127.0.0.1，记忆是 vault 里的 Markdown，会话索引不出本机。

License

MIT

dsh-math-memory

Install

Source

Tags

Creators

Readme