前言¶
用 DeepSeek Harness（DSH）做开发或日常问答时，手头往往还有一套 Obsidian 笔记：日记、项目记录、待办列表。对话默认工作目录通常不是笔记库，文件沙箱也会挡住直接改 Markdown。常见做法是手动切换目录、复制粘贴，或另开脚本桥接。
下面介绍社区插件 Obsidian 笔记（仓库 SuzukaWu/dsh-obsidian-notes）：由维护者 SuzukaWu 发布，分类为「记忆」。它在 Host 进程里直接读写笔记库内的 Markdown，注册六个 obsidian_* 工具；不依赖同步服务、数据库，也不为此联网。桌面端、网页端、微信端会话均可使用。
这是什么¶
插件让任意一个 DSH 对话读写本地 Obsidian 笔记库，无需把会话工作目录切到笔记库。笔记仍是你硬盘上的文件；路径限制在笔记库内，并跳过 .obsidian、.git、.trash、assets、node_modules 等目录。
核心功能¶
写日记与项目笔记¶
- 日记：向当天日记追加一条；按当前小时自动选「早上 / 下午 / 晚上」段（名称可配）。日记不存在时，按分段模板自动创建。
- 项目笔记：追加内容时可自动落在
#### 年/月/日小标题下；笔记或目录不存在时自动创建（可通过dateHeading关闭日期小标题）。
与手写习惯一致的标记¶
done: true写成- ~~已完成~~important: true写成- ==重点==
读取、搜索与任务勾选¶
- 按路径读笔记，或按日期读日记；支持
offset/maxLines分页。 - 整库全文搜索（不区分大小写），返回「文件:行号: 内容」。
- 按修改时间倒序列出笔记，可限定目录。
obsidian_mark_done按文字匹配已有列表项，划掉或取消划掉（默认在今天的日记里查找）。
只读与安全¶
开启 readOnly 后只注册读取类工具，不写入。所有操作限定在配置的笔记库根路径内。
安装与启用¶
从插件市场安装¶
在 DSH 插件市场搜索 Obsidian 笔记 安装。
从源码安装¶
克隆仓库后，在插件目录执行：
cd dsh-obsidian-notes
dsh plugin --profile desktop add .
也可在插件管理器中使用「安装 bundle」，目标填克隆后目录的绝对路径。新安装可热加载；未生效时重启一次应用。
运行环境要求（见 package.json）：Node >=20，DSH ^0.2.1-rc.1 || ^0.2.2-alpha.2。
配置¶
最省事的方式：打开 设置 → 笔记，点「选择文件夹…」选定笔记文件夹，保存后工具立刻切换到新路径。
细项在 设置 → 插件 → Obsidian 笔记 → 配置：
| 字段 | 默认值 | 含义 |
|---|---|---|
vault |
（空） | 笔记库根目录绝对路径；未填时读环境变量 OBSIDIAN_VAULT。 |
dailyFolder |
日记 |
日记子目录（相对根目录），留空表示根目录。 |
sections |
["早上","下午","晚上"] |
日记分段时间标题，按当前小时选择。 |
dateHeading |
true |
往普通笔记追加时自动加 #### 年/月/日 小标题。 |
readOnly |
false |
只注册读取类工具，永不写入。 |
工具一览¶
| 工具 | 作用 |
|---|---|
obsidian_append |
追加记录：写今天日记，或用 path 写指定笔记；支持 done、important、date、section、heading。 |
obsidian_read |
按 path 或 date 读笔记/日记；分页参数 offset、maxLines。 |
obsidian_search |
整库全文搜索。 |
obsidian_list |
按修改时间列出笔记，可限定目录。 |
obsidian_mark_done |
按文字匹配划掉/取消划掉列表项。 |
obsidian_info |
查看笔记库路径、笔记数、顶层目录、今天日记状态与当前配置。 |
典型用法¶
以下表述可直接在对话里使用（README 示例）：
- 「帮我把「读完《设计心理学》第 3 章」记到今天的日记里，标成完成」
- 「在 项目/读书笔记 里记一条：周四整理第三章」
- 「搜一下笔记里所有提到「番茄钟」的地方」
- 「把今天日记里「清理收件箱」划掉」
约定按中文个人笔记习惯设默认值，分段名、是否加日期小标题等均可改成适配你自己的库。
适用场景与注意¶
适合谁：已在用 Obsidian 做 PKM、日记或项目笔记，又希望 DSH 对话里用自然语言追加、搜索、勾选待办，而不想维护单独同步层。
权限与信任：插件以当前 DSH Host 进程权限读写本地文件。安装前请阅读源码与 MIT 许可证；敏感笔记库可先用 readOnly: true 试读。
生态说明：DSH 社区插件目录（如 SkillHub 上的条目页）由社区维护，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-obsidian-notes（当前 package 版本 0.2.0）把 Obsidian 笔记库接进 DSH 工具层：六类 obsidian_* 操作、可图形化选库、可只读。
目录页：https://www.skillhub.cn/plugins/SuzukaWu/dsh-obsidian-notes
源码与文档：https://github.com/SuzukaWu/dsh-obsidian-notes
