前言¶
在 DSH 里做 Obsidian 相关任务时，智能体往往需要知道 Obsidian Flavored Markdown、Bases、JSON Canvas 等格式，以及如何配合 CLI 操作库、从 HTML 抽正文、用模板渲染。这些内容分散在上游文档和独立 skill 仓库里，未必会出现在你当前 profile 的 skill 目录中。
dsh-obsidian-skills 由维护者 stevenjj33 以 DeepSeek Harness 插件包 的形式，把 kepano/obsidian-skills（MIT）中的六份 skill 原样纳入 DSH，安装后即可在 catalog 里选用。本仓库不修改 skill 正文，只负责落盘与注册；与 Obsidian 官方无隶属关系，社区目录页见 skillhub.cn。
这是什么¶
一句话：面向 Obsidian 工作流的 Agent skills 文档包，分类为客户端插件，当前 GitHub 星标为 0。
插件解决的是「skill 可发现、可挂载」：把上游六类能力登记到 ctx.skills，供 DSH 智能体按场景读取。包内 只含 skill 文本，不捆绑可执行工具；其中三条 skill 描述如何驱动命令行，对应 CLI 需由你在本机另行安装并运行。
核心功能：六份 skill¶
安装后 catalog 中会出现下表所列 skill（含义与上游 README 一致）：
| skill | 作用概要 |
|---|---|
obsidian-markdown |
Obsidian Flavored Markdown：wikilinks、embed、callout、属性、注释等 |
obsidian-bases |
.base 文件：视图、筛选、公式、汇总 |
json-canvas |
.canvas 文件：节点、边、分组（JSON Canvas 1.0） |
obsidian-cli |
对已运行的库驱动 Obsidian CLI |
defuddle |
通过 Defuddle CLI 从 HTML 清洗抽取 Markdown |
knap |
通过 Knap CLI 做模板渲染 |
其中 obsidian-markdown、obsidian-bases、json-canvas 为纯格式参考，无需额外安装。下列三类 skill 依赖本机 CLI（安装方式见上游 README）：
| Skill | 依赖 | 安装（资料原文） |
|---|---|---|
obsidian-cli |
obsidian CLI，且 Obsidian 正在运行 |
见 Obsidian CLI 文档 |
defuddle |
defuddle |
npm install -g defuddle |
knap |
knap（Node 20+） |
npm install -g knap |
skill 目录中还带有参考片段，例如 obsidian-markdown 的 references/{PROPERTIES,EMBEDS,CALLOUTS}.md，obsidian-bases 的 FUNCTIONS_REFERENCE.md，json-canvas 的 EXAMPLES.md。加载逻辑在 lib/index.js：扫描 skills/*/SKILL.md 并逐项注册。
包版本在 package.json 中为 0.1.0；skills/** 归上游 Steph Ango（MIT），本仓 lib/、scripts/ 等为维护者原创，同样 MIT。包内不含 vault 内容、Obsidian 许可证或凭据。
安装与启用¶
在指定 profile 下添加插件（命令来自仓库 README，勿自行拼接 github:owner/repo 形式）：
dsh plugin --profile <name> add dsh-obsidian-skills
若使用本地检出目录，可使用绝对路径：
dsh plugin --profile <name> add file:/absolute/path/to/dsh-obsidian-skills
完成后 重启 DSH；六份 skill 应出现在 catalog 中。
安装前建议浏览 GitHub 仓库 源码与 LICENSE、NOTICE，确认归因与许可符合你的合规要求。插件随当前 DSH 进程权限运行，启用即等同于信任该包中的 skill 文本与加载逻辑。
典型用法¶
本插件不自带「一键脚本」，典型路径是：安装 → 重启 → 在 DSH 中选中对应 skill，让智能体在编辑 .md、.base、.canvas 或调用 CLI 时遵循 skill 中的规范与步骤。
若你是 维护者、需要与上游 kepano/obsidian-skills 同步，仓库 README 给出的流程为：准备上游 clone（默认 /tmp/obsidian-skills-src，可通过 OBSIDIAN_SKILLS_SRC、OBSIDIAN_SKILLS_REF 调整），执行 npm run sync，再用 npm run sync:check 与 npm run verify 校验。该流程面向插件开发，普通使用者仅需 dsh plugin add 即可。
适用场景与注意¶
适合谁：用 DSH 驱动 Obsidian 相关自动化或答疑；需要智能体稳定掌握 OFM、Bases、Canvas 语法，或在已安装 Obsidian CLI / Defuddle / Knap 的前提下按文档操作。
注意：
- 文档包不等于已安装 CLI；三条 CLI 相关 skill 不会替你安装
obsidian、defuddle、knap。 - skill 正文与上游 逐字复制，功能更新依赖上游与本插件包的发布节奏；可自行
sync:check的只有克隆本仓库的维护者。 - 本包
engines.node为>=22.19，主要约束仓库内脚本；与 Knap 要求的 Node 20+ 是不同语境，勿混为一谈。
结尾¶
dsh-obsidian-skills 把 kepano 社区成熟的六份 Obsidian Agent skill 搬进 DSH catalog，降低格式与 CLI 用法的检索成本；边界也很清晰——只提供 skill 文本，CLI 与 Obsidian 本体仍由你本机管理。
