前言¶
用 DeepSeek Harness（DSH）写代码、调智能体时，上下文往往散落在会话里；若笔记在 Obsidian 或其它目录里，要在浏览器对话和本地文件之间来回切换，引用路径和段落也不方便。DSH 生态里已有偏大纲、反向链接的 Obsidian 类插件；dsh-obsidian-notes 走的是另一条路线：在 Web 右栏提供 Obsidian 风格的本地 vault 树、高保真预览与编辑，并把整篇笔记或选中段落交给对话区，笔记始终留在本机目录，不导入、不离开机器。
下面介绍该插件的定位、能力与安装用法。事实以 GitHub 仓库 README 与 package.json 为准；社区目录页：skillhub.cn/plugins/revive123456/dsh-obsidian-notes。DSH 社区插件目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
dsh-obsidian-notes（npm 包名 dsh-obsidian-notes，当前 release 0.5.2，MIT）由维护者 revive123456 发布，在 SkillHub 分类为「记忆」。它面向 DeepSeek Harness 0.2.1+ 的 Web UI（或桌面端），在侧栏注入 Notes 面板：指向本机某一文件夹中的 Markdown，在同一界面里浏览、搜索、编辑，并引用到聊天输入框。
README 明确说明不做的事：无反向链接、无大纲面板、无图谱、无数学 / Mermaid / 嵌入块渲染；若这些优先，应使用真实 Obsidian vault 或生态内 DedsecLemon/dsh-obsidian。
核心功能¶
Vault 侧栏与编辑¶
- 懒加载目录树；单击打开笔记，可新建、重命名、删除笔记与文件夹；按标题与正文搜索；显示实时笔记数量。
- 带行号的 Obsidian 式预览：表格对齐、带 info string 的围栏代码、嵌套列表与任务列表、各级标题、setext 标题、分隔线；可点击
[[wikilinks]]（含别名与#section）。 - Callout：支持 13 种 canonical 类型（如
note、warning、tip等）及 15 种 Obsidian 别名（如summary、tldr、important等），> [!type] title语法。 - 编辑保存：行号源码视图；按钮或 Ctrl/Cmd+S 保存。YAML frontmatter 不在编辑器中展示，保存时原样拼回；外部对 YAML 的修改会保留。
截图粘贴与附件¶
编辑时 Ctrl/Cmd+V 粘贴图片：写入配置的附件目录，并插入 Obsidian 原生 ![[Pasted image <timestamp>.png]]（单张上限 20 MB），在真实 Obsidian 中仍可用。附件目录支持四种位置模式（vault 根、固定文件夹、与笔记同目录、笔记下子目录）；可隐藏仅含图片的文件夹、可选清理孤儿文件；更改目录时会移动已有截图并重写 vault 内所有嵌入。
与对话联动¶
- ⤴ Cite to chat：在 composer 插入
@/abs/path/to/note.md（无法触达 composer 时回退到剪贴板）。 - 在预览或编辑器中选中文字：出现 Ask / Explain 条，提示词包含绝对路径、行号范围、引用片段（最多 1500 字符）与你的问题。
会话与工作区整理¶
侧栏可对 session 重命名、归档或永久删除；可批量选择 session（归档/删除）或 workspace（删除注册及其 session 日志）。README 在此段后截断，具体 UI 行为以仓库文档为准。
安装与启用¶
环境要求：
- DeepSeek Harness 0.2.1 或更新（Web 或桌面）。
- CLI 安装还需 pnpm（
npm i -g pnpm或corepack enable）以及 Node.js^22.19 || >=24（与package.json的engines一致）。 - 带 bundle 层的插件在启动时组装，安装后必须重启 DSH 宿主（桌面端需退出再打开）；仅刷新页面不够。
桌面端（npm 已发布后）¶
- 打开 Settings → Plugins。
- 搜索
dsh-obsidian-notes并安装。 - 重启 DeepSeek Harness。
若搜索无结果，改用 CLI 或源码路径安装。
CLI（npm 已发布后）¶
npm i -g pnpm
dsh plugin --profile web add dsh-obsidian-notes
# 重启宿主后再启动，例如：
dsh web
dsh plugin add 会把包记入 $DSH_HOME/profiles/web/package.json，profile patch 在下次启动时生效。
从源码安装（npm 未发布或需本地构建时）¶
README 建议不要用 bare github: spec 安装：pnpm ≥ 10 默认会阻止 lifecycle（prepare），从而跳过生成 lib/client.js 的构建。应 clone 后本地 npm i 再安装路径：
git clone https://github.com/revive123456/dsh-obsidian-notes.git
cd dsh-obsidian-notes
npm i
dsh plugin --profile web add "$(pwd)"
# 重启 dsh web
卸载：
dsh plugin --profile web remove dsh-obsidian-notes
然后重启宿主。若曾用手动 cordis.patch.yml 方式安装，见仓库 docs/legacy-install.md。
典型用法¶
首次指定 vault¶
打开侧栏底部的 Notes 行。若尚未配置 vault：
- 📂 打开目录选择器；
- 📋 粘贴绝对路径。
默认 vault 为 $DSH_WORKSPACE/obsidian_vault；若无该变量，则为启动 dsh web 时工作目录下的 ./obsidian_vault。
写笔记并交给对话¶
- 在树中打开或新建
.md，在带行号编辑器中修改，保存。 - 需要模型读整篇时，用 Cite to chat 把
@路径写入 composer。 - 只需某段时，在预览或编辑器中选中文字，用 Ask 或 Explain，确认提示词中含路径、行号与引用后再发送。
粘贴截图¶
在编辑器中粘贴剪贴板图片，插件写入附件目录并插入 ![[Pasted image …]]；之后在 Obsidian 中打开同一 vault 仍一致。
适用场景与注意¶
适合： 已在用或打算用本地 Markdown vault、希望在 DSH Web 侧栏高保真预览 callout 与表格、并频繁把笔记或段落塞进同一窗口对话的开发者。
注意：
- 插件以当前 DSH 进程权限 读写你配置的目录；安装前请查看源码与 MIT 许可证，并只指向可信路径。
- 与
dsh-obsidian的能力边界不同：本插件强调渲染保真、截图嵌入、note-to-chat，而非反向链接与大纲。 - 重启宿主是启用 bundle 的必要步骤；Node 与 DSH 版本需满足 README 与
package.json要求。
结尾¶
dsh-obsidian-notes 把 Obsidian 风格的本地笔记面板放进 DSH Web 右栏：vault 树、行号预览/编辑、callout 与表格、截图粘贴、引用到聊天，以及 session/workspace 批量整理。需要细节与截图时，见 GitHub README（含 中文版 README.zh.md）与 SkillHub 目录页。
