dsh-client-ui-obsidian-memory

dsh plugin --profile web add dsh-client-ui-obsidian-memory

dsh-client-ui-obsidian-memory

🧠 DeepSeek Harness 的 Obsidian Memory 插件 — 基于本地 Markdown 的持久记忆

一个 DSH 插件，让你的 AI 助手拥有持久记忆，记忆内容存储在本地 Obsidian（或普通 Markdown）知识库中。插件注册 5 个文件系统工具（obsidian_memory_*），并在侧边栏显示 vault 状态和工具说明。

灵感来自 @Saccc_c 的 Codex 记忆技巧。

---

功能

• 5 个记忆工具 — AI 可以读取、列出、搜索、写入、追加本地 vault 文件
• 侧边栏面板 — 在 DSH 左侧边栏 sidebar.obsidian-memory 插槽中显示工具说明
• 无需外部服务器 — 直接通过 DSH 的 host 运行时读写文件系统
• 兼容 Codex 结构 — 支持社区推荐的 Codex/ 目录结构

可用工具

工具 · 功能

obsidian_memory_read · 读取 Markdown 或文本文件

obsidian_memory_list · 列出文件和目录

obsidian_memory_search · 全文搜索 .md 和 .txt 文件

obsidian_memory_write · 写入或覆盖文件

obsidian_memory_append · 追加内容到文件末尾

---

快速开始

1. 准备 vault

在你的机器上创建一个 Codex/ 文件夹（例如放在 Obsidian vault 里）：

~/Documents/Obsidian Vault/
└── Codex/
    ├── AGENTS.md      ← AI 操作说明书
    ├── TODO.md        ← 待办事项 / 未收尾的工作
    ├── people/
    ├── projects/
    ├── notes/
    └── daily/

2. 安装插件

一条命令即可，在任意目录执行：

dsh plugin add dsh-client-ui-obsidian-memory        # npm 发布版（推荐）
# 或直接从源码安装：
dsh plugin add detongz/dsh-client-ui-obsidian-memory

插件自带 dsh.bundle 清单，dsh plugin add 会同时安装并激活插件

（内置的 cordis.patch.yml 会自动插入 ui-obsidian-memory 条目），

无需手动编辑 cordis.patch.yml。

3. 配置 vault 路径

让插件指向你的 Codex/ 文件夹。在 profile 的 cordis.patch.yml 中：

- id: ui-obsidian-memory
  config:
    vaultPath: /Users/你的用户名/Documents/Obsidian Vault/Codex

将 vaultPath 替换为你的 Codex/ 文件夹的绝对路径，

也可以改用环境变量 OBSIDIAN_VAULT_PATH。

4. 重启 DSH

dsh web   # 或你平时启动 DSH 的方式

重启后：

• 侧边栏面板 会出现在左侧（🧠 Obsidian Memory）
• 5 个工具 在配置了 vaultPath 后可供 AI 使用

---

配置

选项 · 类型 · 默认值 · 说明

vaultPath · string · — · Codex/ vault 目录的绝对路径

环境变量兜底（可选）：

export OBSIDIAN_VAULT_PATH=/Users/你的用户名/Documents/Obsidian Vault/Codex

如果配置和 env var 都没有设置，插件会记录警告并跳过工具注册。

---

架构

┌─────────────────────────────────────────┐
│ DSH Web（浏览器端）                      │
│  ┌─────────────────────────────────┐    │
│  │ sidebar.obsidian-memory          │    │
│  │  ┌─────────────────────────┐    │    │
│  │  │ 🧠 Obsidian Memory      │    │    │
│  │  │  — 工具说明              │    │    │
│  │  │  — vault 结构            │    │    │
│  │  └─────────────────────────┘    │    │
│  └─────────────────────────────────┘    │
└─────────────────────────────────────────┘
                    │
┌───────────────────▼─────────────────────┐
│ DSH Host（Node.js）                     │
│  • 读写本地文件                         │
│  • 注册 5 个 obsidian_memory_* 工具     │
└─────────────────────────────────────────┘
                    │
┌───────────────────▼─────────────────────┐
│ 本地文件系统                            │
│  ~/Documents/Obsidian Vault/Codex/      │
└─────────────────────────────────────────┘

组件 · 职责

Host (lib/index.js) · Node 端：注册工具、读写 vault 文件

Client (lib/client.js) · 浏览器端：侧边栏面板，显示工具说明

Vault · 数据源：本地 Markdown 文件

---

故障排查

现象 · 原因 · 解决

Settings → Plugins 里看不到插件 · dsh plugin add 装的是 0.3.2 之前的旧版（被当作普通依赖安装，从未激活） · 重装：dsh plugin add dsh-client-ui-obsidian-memory@latest

AI 无法使用工具 · vaultPath 未配置 · 在 cordis.patch.yml 或环境变量中设置 vaultPath

侧边栏面板不显示 · DSH 版本缺少 sidebar.obsidian-memory 插槽 · 升级 DSH 到 ≥ 0.1.0-rc.5（或带该插槽的构建）

"Path traversal detected" 报错 · AI 试图访问 vault 外文件 · 所有路径都被沙盒限制在 vaultPath 内

---

开发

git clone https://github.com/detongz/dsh-client-ui-obsidian-memory.git
cd dsh-client-ui-obsidian-memory
npm install
npm run build        # 输出 lib/index.js + lib/client.js
npm run watch        # 开发模式自动重建

构建产物说明：

• lib/index.js — host 入口（工具注册 + 文件读写）
• lib/client.js — browser bundle（DSH closure-factory 格式，CSS 内联）

---

许可证

MIT