dsh-obsidian-notes

dsh plugin --profile web add dsh-obsidian-notes

Obsidian Notes for DeepSeek Harness

DeepSeek Harness Web 的本地 Obsidian 风格笔记面板。 指向一个 Markdown 文件夹，就能在对话旁边浏览、编辑、搜索、引用笔记 —— 不用装 Obsidian、不用导入，笔记也不会离开这台机器。



English | 中文

---

为什么是这一个

DSH 生态里已经有一个 Obsidian 方向的插件

（DedsecLemon/dsh-obsidian），

它适合需要大纲、反链和高亮的人。本插件押的是另外三件事 —— 如果你习惯「一边写笔记、一边和模型讨论」，这三件更重要：

1. 渲染细节本身就是功能。 预览带行号，并保留 Obsidian 的渲染细节：13 种 callout 类型 + 15 个别名、表格对齐、带语言标签的围栏代码、任务列表、setext 标题；frontmatter 不进编辑器，保存时按原文拼回。

2. 粘贴的截图不会丢。 编辑时粘贴图片，host 落盘为 Obsidian 原生引用 ![[Pasted image …]]；以后迁移附件目录，全库笔记里的引用会一并改写。

3. 笔记能接进对话。 整篇引用为 @绝对路径；选中一段再提问，注入的内容带文件路径、行号区间和原文。

它不做什么： 没有反链、没有大纲面板、没有关系图，也不渲染数学公式 / mermaid / transclusion。这些是你的刚需就用真 Obsidian（或上面那个插件）。对比在[下方](#对比)写清楚。

截图

侧边栏笔记树 + 右侧预览 · Callout、行号、类型徽标

!侧边栏笔记树与右侧预览 · !彩色 Obsidian callout，一行源码对应一行渲染

真表格与围栏代码 · 带行号的源码编辑视图

!带列对齐的表格与 TypeScript 代码块 · !带行号的编辑器与保存按钮

安装

前置要求： DeepSeek Harness 0.2.1 或更新（Web UI / 桌面版）。CLI 安装还需要 pnpm（npm i -g pnpm 或 corepack enable）；从源码跑需要 Node.js ^22.19 || >=24。

带 bundle 的插件只在启动时装配，所以安装后必须重启 DSH host（桌面版：退出再打开）。只刷新页面不够。

1. 桌面版（npm 发布后）

1. 打开 Settings → Plugins；

2. 搜索 dsh-obsidian-notes 并安装；

3. 重启 DeepSeek Harness。

这条路径要求 npm 上已有该包（当前版本 0.5.2）。搜不到时用下面两种方式。

2. CLI（npm 发布后）

npm i -g pnpm                                   # `dsh plugin` 会转发给 pnpm
dsh plugin --profile web add dsh-obsidian-notes
# 重启 host 后再启动
dsh web

3. 从源码安装（npm 发布前也能用）

git clone https://github.com/revive123456/dsh-obsidian-notes.git
cd dsh-obsidian-notes
npm i                     # 通过 prepare 跑 build.mjs → 生成 lib/client.js
dsh plugin --profile web add "$(pwd)"            # PowerShell 用 "$PWD"
# 重启 `dsh web`

dsh plugin add 会把这个包记为 profile 的 bundle，写进

$DSH_HOME/profiles/web/package.json，下次启动时生效。

不建议直接用 github: 形式安装本仓库：pnpm ≥ 10 默认拦截生命周期

(prepare) 脚本，生成 lib/client.js 的构建步骤会被跳过。请用

clone + npm i + 安装本地路径。

卸载： dsh plugin --profile web remove dsh-obsidian-notes，然后重启。若当年是手工改

cordis.patch.yml 装的，见 docs/legacy-install.md。

首次使用

点侧边栏底部的 📚 笔记。没有配置 Vault 时先选目录：

• 📂 打开目录选择器；
• 📋 接受一个粘贴的绝对路径。

默认 Vault 为 $DSH_WORKSPACE/obsidian_vault，缺省回落到启动 dsh web 目录下的

./obsidian_vault。

功能

• Vault 侧边栏：按需加载的目录树；单击打开笔记，新建 / 重命名 / 删除笔记与文件夹，按标题和正文搜索，显示笔记数徽标。
• 带行号的 Obsidian 预览：一行源码对应一行渲染并带行号。真表格（支持 :--- / :---: / ---: 对齐）、带语言标签的围栏代码、嵌套列表与任务列表、#～###### 标题、setext 标题、分隔线、可点击的 [[双链]]（含别名与 #章节）。
• Callout：> [!type] 标题 按类型渲染颜色、图标与徽标。13 种规范类型（note、abstract、info、todo、tip、success、question、warning、failure、danger、bug、example、quote）+ 15 个 Obsidian 别名（summary、tldr、hint、important、check、done、help、faq、caution、attention、fail、missing、error、cite、none）。
• 编辑与保存：带行号的源码编辑器，点 保存 或按 <kbd>Ctrl/Cmd+S</kbd>。YAML frontmatter 不进编辑器，保存时原样拼回；外部对 YAML 的改动不会被覆盖。
• 粘贴截图：编辑时 <kbd>Ctrl/Cmd+V</kbd> 把剪贴板图片写入附件目录，并在光标处插入 Obsidian 原生写法 ![[Pasted image <时间戳>.png]]（单张上限 20 MB），写进 .md 的内容可被真实 Obsidian 识别。
• 附件目录管理：四种位置模式（Vault 根 / 固定目录 / 与笔记同目录 / 笔记目录下子目录）、目录树隐藏纯图片目录、可选孤儿附件清理。修改目录会移动已有截图并改写全库笔记引用。
• 引用与提问：⤴ 引用到对话 把 @绝对路径 注入输入框（注入不了时复制到剪贴板）；在预览或编辑器中选中文字会出现 💬 提问 / ⚡ 解释 浮动条，注入内容包含绝对路径、行号区间、原文（≤1500 字符）和你的问题。
• 会话与工作区整理：重命名 / 归档 / 彻底删除会话；批量勾选会话（归档、彻底删除）或工作区（删除注册项及其会话日志）；日志已不存在的行会被隐藏而不是复活。运行中的会话拒绝删除；删除工作区不碰目录和文件。
• 可停靠面板：预览面板可拖动、可调宽，宽度会被记住；预览每 3 秒探测文件 mtime，磁盘上的改动会自动刷新。

界面中英双语，使用 DSH 主题变量，跟随应用的浅色 / 深色主题。

对比

· 本插件 · DedsecLemon/dsh-obsidian

Vault 目录树、搜索 · ✅ 目录树 + 标题/正文搜索 · ✅ 目录树 + 全库命中行搜索

Obsidian callout · ✅ 13 种类型 + 15 别名，逐行渲染 · ✅ 渲染，保留折叠状态

表格、围栏代码、setext 标题 · ✅ · ✅

frontmatter · ✅ 保存时原样拼回 · ✅ 以属性区展示

粘贴截图 + 附件目录迁移 · ✅ · —

整篇引用 / 选中片段提问 · ✅ · —

会话与工作区整理 · ✅ · —

反链 · ❌ · ✅

大纲面板 · ❌ · ✅

==高亮== · ❌ · ✅

比的不是「功能多少」，而是取舍：需要大纲和反链，用另一个插件（或真 Obsidian）；想要忠实的 Obsidian 阅读/编辑体验、并顺手把笔记递进对话，这个插件就是为此写的。

配置

所有配置都在笔记面板里完成，不用手改 YAML。

Vault 根目录

笔记工具栏的 📂（选目录）或 📋（粘贴绝对路径）。目录必须存在且是目录；切换 Vault 会清空当前打开的笔记。

附件

目录树里的 📎 Attachment location 行控制粘贴图片的落盘位置：

模式 · 行为

Vault 根 · 图片落在 Vault 根目录。

固定目录 · 图片落在配置的目录（默认 attachments）。

与笔记同目录 · 图片落在被粘贴笔记所在目录。

笔记目录下子目录 · 图片落在 <笔记目录>/<子目录>。

默认值：固定目录 attachments、目录树隐藏纯图片目录、自动清理孤儿附件关闭（不会隐式删文件）。打开自动清理后，只有「这次保存移除了引用」且「没有其它笔记引用」的附件才会被删。

设置持久化在 $DSH_HOME/dsh-obsidian-vault.json（$DSH_HOME 缺省 ~/.dsh）。

快捷键

• <kbd>Ctrl/Cmd+S</kbd>：保存正在编辑的笔记。
• <kbd>Esc</kbd>：关闭搜索框或提问浮层。

安全与隐私

• 纯本地、无遥测。 所有能力都由 DSH host 自己的 /obsidian/* 路由提供；插件不发起任何外网请求，也不含统计埋点。（笔记里点链接是普通链接；插件不会去抓取。）
• **在 DSH 鉴

…(truncated)