本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-client-ui-obsidian-memory

— 源: plugin_wiki.wiki_content

安装与验证

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

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

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

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后 Settings → Plugins 里看不到这个插件怎么办？

多半是因为装到了 0.3.2 之前的版本（dsh plugin add 把它当成普通依赖安装了，没有激活）。重装指定 0.3.2 或更新版本：dsh plugin --profile web add dsh-client-ui-obsidian-memory@latest。

安装后 AI 还是看不到 obsidian_memory_ 工具怎么办？*

工具注册的前提是 vaultPath 已配置。在 profile 的 cordis.patch.yml 里给 ui-obsidian-memory 加 config.vaultPath，或导出环境变量 OBSIDIAN_VAULT_PATH；两者都没设置时插件只会写一条警告日志并跳过注册。

侧边栏没有出现「🧠 Obsidian Memory」面板怎么办？

需要 DSH 版本带 sidebar.obsidian-memory 插槽（≥ 0.1.0-rc.5），低版本 DSH 客户端没有该插槽，面板就无家可归。

数据存在哪里？迁移 / 重装 DSH 会丢吗？

全部数据就是你自己本地的 Markdown 文件，路径由 vaultPath 决定；插件不写额外索引或缓存（仅 localStorage 记一次最近选过的路径），重装、迁移主机都只是把原文件夹指给新配置。

写入安全吗？AI 会不会读到 vault 外的文件？

所有路径会被 resolveVaultPath 解析后用 relative 校验，越界（.. 或空相对路径）会抛 Path traversal detected，AI 的读写被强制沙箱在 vaultPath 内。

搜索能覆盖哪些文件？

全文搜索只看 .md 和 .txt，并跳过 .git、.obsidian、node_modules 三个目录；其他后缀（如 .json、.csv）和被忽略目录里的内容不会被索引。

和官方 DSH 记忆功能是什么关系？

这是一个第三方插件，不依赖也不替代 DSH 自带的记忆能力；它把 vault 文件以独立工具暴露给模型，模型可以选择在 prompt 上下文里读 / 写这些 Markdown 笔记。

如何卸载？

在 profile 目录移除 ui-obsidian-memory 条目（必要时删除 OBSIDIAN_VAULT_PATH 环境变量），然后 dsh plugin --profile web remove dsh-client-ui-obsidian-memory，重启 DSH 即可，vault 文件不会被删除。

— 源: plugin_wiki.faq_json

兼容性

• DSH: >=0.1.0-rc.5（peerDependencies 全部声明 >=0.1.0-rc.5，sidebar 插槽需要 ≥0.1.0-rc.5）
• Node: 未声明（package.json 无 engines 字段；tsconfig target=ES2024，建议 Node ≥22）

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则