Skip to content

博客发布 0.1.0 · 首轮正式发布

Choose a tag to compare

@Wu-Wh0 Wu-Wh0 released this 10 Oct 02:15
16dd9ae

博客发布 0.1.0 · 首轮正式发布

在 Obsidian 桌面写作、本地预览,并由作者明确点击发布/更新,通过 WordPress 原生 HTTPS REST 发布到博客。安装后不需要外部 Node、Python、WSL、服务端自定义插件或浏览器二次批准。

安装

  1. 使用 Obsidian 桌面 1.11.4 或以上。
  2. 下载 wordpress-publisher.zip,将其中 main.js、manifest.json、styles.css 放入 <Vault>/.obsidian/plugins/wordpress-publisher/ 并启用插件;也可直接下载三个文件。
  3. 设置 WordPress HTTPS 站点和用户名,将该作者的应用程序密码存入 Obsidian 秘密存储,再选中对应引用。不要把密码写入笔记或聊天。
  4. 打开文章,使用「博客预览」,明确点击「发布文章」或「更新文章」。成功以服务器精确读回为准。

本次是 GitHub Release 手动安装版,不是 Obsidian 社区目录上架。内置预览提供博客式排版,不承诺与任意正式主题逐像素一致。

首版能力

  • 常用 Markdown、表格、代码、列表、引用图片与受限公式;正文排除笔记属性。
  • 普通美元价格保留文字,公式与 Markdown 链接边界正确区分。
  • 长代码、表格和块公式局部滚动,长文本换行,不靠截断正文解决溢出。
  • 只读取当前文章引用的本地图片;预览不上传内容或任意外联。
  • 同 ID 更新、远端冲突阻断、持久发布链接及未发布修改提示。
  • 发布公式使用原生 MathML;过滤导致正文损失时阻断,不静默发布。

已验证范围

  • Windows、WSL、本次 Hosted Windows/Ubuntu:各106/106测试及构建通过。
  • 原生隔离预览与局部滚动、合成附件解码通过;旧站图片迁移样例用明确的合成占位图,不代表找回原图。
  • 作者在最终候选上手动更新同一文章,服务器标题/正文/owner/status/链接精确读回,已确认媒体复用。
  • 冷启动后的同文关联与只读HTTPS连接通过;临时凭据已精确撤销,隔离运行时已关闭。
  • WordPress 7.1.3/Kadence 1.5.2的隔离站图片、五个公式、价格和页面宽度已检查;正式站当前纯保存过滤链对合成HTML字节保持一致。这不是所有WordPress版本、主题或插件组合的兼容性承诺。
  • 历史首次发布/更新/冷启动更新矩阵属于当时的候选;本次没有机械重复该整轮,也没有在正式博客发布测试文章。

已知限制

  • 未知 create/media 结果保持待核对,不自动重试、不自动认领;不要删除journal绕过。插件内恢复入口待 #15。
  • 重命名/移动笔记后的关联待 #16,自定义模板待 #17。
  • 旧站 /images/ 根路径须由作者定向迁移为实际Vault附件;不扫描整个Vault、猜路径或自动下载旧图。
  • 非图片笔记嵌入、动态查询、原始HTML、隐藏评论等不支持内容会阻断发布。
  • WordPress原生REST没有事务/幂等/原子CAS保证;媒体可能在文章发布前已有公开直链。

包内只有安装三文件。SHA-256校验见 SHA256SUMS.txt。本轮未安装主Vault,未改变正式博客文章、数据库或配置。