前言¶

给 DSH 加一个插件时，常见需求是把手里的 Markdown 笔记按原习惯发到自己的博客：沿用原来的分类、草稿，本地图片和音视频直接进博客对象存储。DeepSeek Harness 的理念是「一切皆插件」，社区插件目录是独立站点，与 DeepSeek / 幻方没有官方从属关系，本文介绍的插件就挂在这个目录里。

下面介绍的 joeseesun/qiaomu-blog-publisher-dsh 是原版乔木博客发布器的 DeepSeek Harness 版本，维护者为 joeseesun，在社区目录中归入「工作流」，当前 1 个星标。它保留原版的发布弹窗、分类与设置页，适合已经在使用 Qiaomu Blog、想在 Harness 里继续发布的人。

这是什么¶

一句话定位：把 Markdown 笔记发布到自己的 Qiaomu Blog 的 DSH 插件，直接使用原 Obsidian 插件的发布弹窗、分类与设置页。仓库版本 0.1.3，针对 DeepSeek Harness 0.2.2-rc.1 做兼容更新，许可证 MIT。

它解决的问题是：不用复制笔记到别的目录、不必手工转存媒体、不丢失原插件的分类和草稿流程，在 Harness 侧栏里完成发布。

核心功能¶

• 标题自动从 frontmatter、一级标题、文件名依次提取，可在原发布窗口修改。
• 获取博客分类，选择草稿或直接发布；显示上传进度、成功数量、失败原因和重试入口。
• 标准 Markdown 图片与 Wiki 嵌入，自动上传本地图片、音频、视频到博客 R2，转存第三方图片并改写链接。
• Markdown 工作目录、文件导入、草稿恢复、保存冲突保护与外部修改同步。
• 原版连接设置、API Token 测试；Token 存入系统安全凭据库。

安装与启用¶

先看环境要求。README 写明要求 DeepSeek Harness 0.2.2-rc.1、Node.js 24.9 或更新；package.json 的 engines 列出的支持范围是 Node >=22、dsh 为 0.2.1-rc.3 ~ 0.2.1-rc.5 || 0.2.2-rc.1。

安装没有走命名拼接的快捷命令，而是从 Releases 下载 tgz 和 SHA256SUMS，校验后安装：

dsh plugin --profile desktop add /absolute/path/qiaomu-blog-publisher-dsh-0.1.3.tgz

路径需替换为实际下载位置。Releases 地址：https://github.com/joeseesun/qiaomu-blog-publisher-dsh/releases。

启用后打开侧栏的「乔木博客发布」，导入 Markdown，在设置里填写自己的博客地址和 API Token，点击「发布到博客」。默认创建草稿；选择「直接发布」会公开文章。

典型用法¶

1、导入。支持 Markdown、媒体和原博客插件的 data.json。媒体放在 attachments，Markdown 中保持相应路径；完整目录可以直接配置为 notesDir。

2、配置目录。默认笔记目录为：

$DSH_HOME/qiaomu/qiaomu-blog-publisher-dsh/notes

未设置 DSH_HOME 时为 ~/.dsh。插件配置项 notesDir 指向明确选择的笔记目录，dataDir 指定插件状态目录，均使用绝对路径。单篇 Markdown 上限 2 MB，附件上限 32 MB，不跟随工作目录内软链接。

3、迁移旧配置。导入旧配置会把 Token 迁入 macOS Keychain、Windows DPAPI 或 Linux Secret Service；新的状态 JSON 不保存 Token，原配置不会删除。Linux 需要 secret-tool 和 Secret Service。

4、发布。默认草稿，需要公开时在发布窗口选择「直接发布」。媒体上传失败时沿用原版行为：文章可以创建，插件会报告失败数量，之后需要检查文章中的媒体链接。

适用场景与注意¶

适合已经在用 Qiaomu Blog、且博客支持原 Qiaomu Blog API 的用户。如果只是偶尔发文章，手工拖拽可能比搭插件更直接。

需要留意的几点：

• 仓库自述测试只发送给本机 fixture，没有提交到真实博客或 R2；Windows / Linux 凭据没有对应系统实机验收，具体边界见仓库的迁移记录与兼容验证记录。
• 插件以当前 DSH 进程权限运行，安装前应检查源码和许可证（MIT）。原版冻结来源为 5d41358f707320c2f56016bf62327eb60d8668b8，打包依赖见仓库 THIRD_PARTY_NOTICES。
• 仓库发布的是校验后的 tgz，不直接提供 dsh plugin add github:owner/repo 形式的安装命令，不要用名称自行拼接。

结尾¶

这套插件的价值在于把原发布流程原样搬进 Harness，分类、草稿、媒体转存和凭据安全沿用原版行为，适合长期以 Markdown 为工作稿、以 Qiaomu Blog 为发布站点的场景。

目录页：https://www.skillhub.cn/plugins/joeseesun/qiaomu-blog-publisher-dsh
仓库：https://github.com/joeseesun/qiaomu-blog-publisher-dsh

需要我先核对某个功能细节，或调整哪部分篇幅？