前言¶
在 DeepSeek Harness 里和 AI 协作时，常有还没成项目、却值得先记下来的想法。若单独为每条灵感建会话或项目，成本高；若只写在对话框里，又难回看、也难和已有笔记体系对齐。Obsidian 侧已有本地 Markdown 仓库，但切到独立应用再记一笔，会打断工作流。
dsh-obsidian-memo 由社区维护者 cavenzhong 开发，是 DeepSeek Harness 的客户端插件：在 Harness 左侧栏提供便签入口，把你在 Obsidian 里选定的文件夹摊开成淡色便签墙。笔记仍是仓库里的普通 .md，图片留在仓库附件中；需要反馈时用 Harness 默认模型评论，需要推进时用「开档」生成结构化项目文档。下面介绍它是什么、能做什么，以及安装与典型用法。
这是什么¶
dsh-obsidian-memo 是 DeepSeek Harness 的 Obsidian 便签插件，当前版本 0.14.2，以 MIT 许可开源。它不另建笔记库，不把内容锁在插件内：便签即所选 Obsidian 目录中的 Markdown 文件，归档即移动文件。
插件要求 DeepSeek Harness >=0.2.2-rc.1 <0.3.0（engines.dsh；开发与验证于 0.2.2-rc.1）。运行环境为 DSH 桌面版或 Web GUI；无需在 Obsidian 里安装配套社区插件，也无需单独配置 API Key——AI 复用 Harness 当前默认模型。
核心功能¶
便签墙与记录¶
左侧栏进入后，所选文件夹中的笔记以卡片形式展示。子文件夹自动分色；可按日期筛选，按创建时间、最近修改或文件名排序；跟随 DSH 浅色与深色主题。首屏加载 50 张，滚到底自动补批。
底部输入栏用于快速记录：标题即 Markdown 文件名，在标题框按 Enter 创建便签；按 Tab 展开正文，用 ⌘ / Ctrl + Enter 提交。图片可粘贴、拖入或多选（最多 8 张），默认压缩为 WebP（质量 70、最大边长 2048px，可在设置中调整或关闭）。新建时会沿用 Obsidian 为当前文件夹配置的 Default Template 的 frontmatter。
阅读、编辑与整理¶
单击卡片在右侧打开阅读面板；双击标题或正文进入编辑，⌘ / Ctrl + Enter 保存。阅读模式可直接勾选任务，写回原 Markdown 的 [ ] / [x]。点图钉可把面板固定在右侧，与便签墙并排对照。顶栏可切换是否包含子文件夹、日期范围与排序方式。
四种 AI 视角¶
点卡片上的 emoji，针对当前便签调用默认模型生成反馈；提示词、callout 样式与生成预算可在设置中自定义。反馈以 Obsidian callout 追加到原文件末尾，在 Obsidian 中仍可正常阅读。
| 视角 | 作用 |
|---|---|
| 毒舌 | 戳破自我说服，给一句清醒反馈 |
| 另一面 | 换角度重新审视 |
| 落地 | 判断、依据与较省力的下一步 |
| 真心话 | 承接当下状态，轻量鼓励 |
开档、归档与跳转到 Obsidian¶
- 开档：在开档目录生成
<项目名>/<项目名>.md，整理诉求与下一步等结构，并把项目链接写回源便签的PROJECTSfrontmatter。 - 归档：将文件移动到所选归档目录；顶部浮窗 6 秒内可撤销。
- 在 Obsidian 打开：通过
obsidian://open?path=<便签绝对路径>由系统打开器唤起 Obsidian（需本机已安装并注册协议）。
安装与启用¶
插件无需构建，无运行时依赖，不需要 Node、pnpm 或单独 API Key。安装前建议在 GitHub 浏览源码与 LICENSE，确认许可与行为；插件以当前 DSH 进程权限读写你指定的仓库路径。
1、准备源码¶
从仓库获取源码并记下目录的绝对路径。README 支持克隆仓库，或下载 ZIP 解压：
git clone https://github.com/cavenzhong/dsh-obsidian-memo.git
2、在 Harness 中安装 bundle¶
在 Harness 对话中让 agent 调用 plugin_manager，将 target 换成你的本地路径（link: 引用目录，安装后请保留该目录）：
action: install_bundle
target: link:/absolute/path/to/dsh-obsidian-memo
若曾安装旧包名 dsh-sticky-notes，应先移除旧包再安装本包。装好后在左侧栏打开便签入口；若无入口，可重启或刷新 DSH。
3、配置目录¶
点右上角齿轮，至少设置「仓库根目录」与「便签目录」并保存。
| 设置 | 必填 | 说明 |
|---|---|---|
| 仓库根目录 | 是 | Obsidian vault，例如 ~/Documents/MyVault |
| 便签目录 | 是 | 仓库内常回看的文件夹，例如 Inbox |
| 开档目录 | 开档时 | 存放项目文档的位置 |
| 归档目录 | 否 | 可多个，归档时选择目标 |
| 图片文件夹 | 否 | 默认使用便签目录下 _attachments/ |
| 图片处理 / AI 预设与预算 | 否 | WebP 压缩与四种评论角色等 |
更新时可 git pull 后重新执行安装命令，或在插件页停用再启用；卸载不会删除 Obsidian 中的笔记与附件。
典型用法¶
工作间隙在底部输入栏写一句标题并回车，便签即写入便签目录。需要配图时直接粘贴或拖入，不必先整理附件路径。想稍展开时按 Tab 写正文，再用 ⌘ / Ctrl + Enter 提交。
回看时在墙上点卡片，右侧读全文；需要改笔误时双击进入编辑。若希望 AI 换视角，点卡片上对应 emoji；同一视角已有评论时会询问是否再生成一条。
想法成形后可用「开档」生成项目文档并链回便签；暂时不需要跟进的条目可选归档目录移走。要在 Obsidian 里用双向链接或社区插件继续整理时，用「在 Obsidian 打开」即可。
常用快捷键摘录：
| 操作 | 快捷键 |
|---|---|
| 新建便签 | 标题框内 Enter |
| 展开 / 收起正文 | Tab / Esc |
| 提交便签 | ⌘ / Ctrl + Enter |
| 保存编辑 | ⌘ / Ctrl + S |
适用场景与注意¶
适合：笔记已在 Obsidian、希望在 Harness 工作时随手记录；不想为每条灵感单独建项目，但希望必要时一键开档；愿意让 AI 参与讨论且坚持本地 Markdown。
不适合：用它替代 Obsidian 全文搜索、双向链接与插件生态；在手机上完整操作便签墙（当前侧重桌面）。插件不提供全文搜索、拖拽排序、批量操作与文件实时监听（以外部修改约 4–30 秒轮询感知为主）。
数据与隐私方面：笔记与图片只在你选定的仓库内读写；设置保存在插件目录的 data/settings.json，不写入 DSH profile。除你主动触发 AI 评论或开档外，模型调用会把当前便签相关内容发往所配置的模型服务；插件自述无遥测上报。
Windows / Linux 的路径与「在 Obsidian 打开」逻辑已实现但 README 标明 macOS 已验证，其他系统可自行试跑并到 Issues 反馈。
结尾¶
dsh-obsidian-memo 把 Harness 侧栏、本地 Obsidian Markdown 与默认模型串成一条短链路：记下 → 回看 → 获得反馈 → 开档或归档。笔记所有权始终在 vault 里，插件只是读写你指定的目录。
