公众号发布助手 — 功能介绍

一、系统简介

公众号发布助手是一款面向内容创作者的桌面工具（PyQt5），把「写 Markdown → 配图上传 → 多平台排版 → AI 辅助写标题标签」串成一条流水线。

你在 Obsidian、VS Code 或任意编辑器里写好 .md 笔记后，打开本软件即可：

• 左侧编辑、中间实时预览公众号 / CSDN / 知乎排版效果

• 右侧 AI 助手完成图床上传、链接转换、一键复制各平台 HTML

• 用 AI 生成简介、标题、标签，减少重复劳动

• 用「图片任务」批量生成多比例封面图

软件本地运行，配置保存在 config.json；配图默认上传到 GitHub 公开仓库，通过 jsDelivr CDN 加速访问。

---

二、适用场景

| 场景 | 怎么用 |

|------|--------|

| 公众号长文 | 写 MD → 上传配图 → 复制公众号 HTML 粘贴到后台 |

| 一文多发 | 同一篇 MD 切换预览主题，分别复制公众号 / CSDN / 知乎格式 |

| Obsidian 工作流 | 支持 ![[图片.png]] 图链；上传时按文件名在图片目录里查找 |

| 封面 / 头图制作 | 配置多比例底图模块，叠加标题后导出，再插入文章上传 |

| GitHub 图床 | 本地图一键上传到自己的 Image 仓库，MD 自动换成 CDN 链接 |

| 发布前润色 | AI 根据正文生成简介、标题候选和标签，单独复制使用 |

---

三、功能概览

┌─────────────────────────────────────────────────────────────┐

│  菜单：打开/保存 MD · 最近文件 · 设置 · 关于 · 赞赏          │

├──────────────┬──────────────────────┬─────────────────────────┤

│  Markdown    │  多平台实时预览       │  AI 助手侧栏             │

│  编辑器      │  公众号/CSDN/知乎     │  · 上传图床 / 转链接     │

│              │                      │  · 复制各平台 HTML       │

│              │                      │  · AI 简介/标题/标签     │

│              │                      │  · 封面图任务            │

└──────────────┴──────────────────────┴─────────────────────────┘

核心能力一览：

1. Markdown 编辑：打开、保存、最近文件列表

2. 三端预览：公众号、CSDN、知乎样式实时渲染

3. 图床上传：扫描 MD 中的本地图，上传 GitHub 并替换为 jsDelivr 链接

4. 仅转链接：图已在仓库时，只替换链接、不上传

5. 多平台复制：一键复制对应平台的内联样式 HTML

6. AI 生成：可自定义提示词框架，生成简介、标题、标签

7. 图片任务：多模块、多比例封面合成与导出

8. 远程关于页：启动时拉取 manifest，更新二维码、说明与版本提示

---

四、界面与功能详解

4.1 主界面总览

主窗口采用三栏布局：

| 区域 | 作用 |

|------|------|

| 左侧 | Markdown 编辑器，支持标准语法与 Obsidian ![[...]] 图链 |

| 中间 | 预览区，顶部可切换公众号 / CSDN / 知乎主题 |

| 右侧 | AI 助手侧栏：发布操作、AI 生成、图片任务 |

顶部菜单提供文件操作、工具设置、关于与赞赏入口。

---

4.2 Markdown 编辑器

• 直接编辑文章内容，支持与预览区联动刷新

• 可打开本地 .md 文件，或从「最近打开」快速恢复

• Ctrl+S 保存到当前文件路径

• 文中图片可用 ![](path) 或 Obsidian 风格 ![[xxx.png]]

• 上传配图时：程序只从文件名识别图片，在侧栏指定的「图片搜索目录」里查找（不要求路径与 MD 相对位置一致）

---

4.3 AI 助手侧栏

侧栏分为三大块，对应发文流程的不同阶段。

发布操作

| 按钮 | 说明 |

|------|------|

| 目录 | 设置「图片搜索目录」。上传前必填；按文件名在该目录（含子目录）查找本地图 |

| ↑ 上传 MD 里的图片到 GitHub | 扫描 MD → 找图 → 上传图床 → 把文中链接换成 jsDelivr |

| ⇄ 仅转换链接（不上传） | 远程已有图时使用，只替换链接、不发起上传 |

| 复制公众号 / CSDN / 知乎格式 | 将当前 MD 转为对应平台 HTML 并复制到剪贴板，直接粘贴到各平台编辑器 |

上传说明：优先尝试 git 批量 push；若本机连不上 github.com:443，会自动回退 GitHub API 逐张上传。远程已有且内容相同的图会跳过，内容变化则会更新。

AI 生成

| 控件 | 说明 |

|------|------|

| 框架 | 选择 AI 提示词预设（可点「编辑」自定义） |

| ✦ AI 生成简介 & 标签 | 根据正文调用大模型，生成简介、标题、标签 |

| 复制简介 / 标题 / 标签 | 各字段旁一键复制，方便填到发布后台 |

需在「工具 → 设置」中配置 AI 服务商与 API Key。

图片任务

| 控件 | 说明 |

|------|------|

| 模块 | 切换封面模块（如 16:9、1:1 等多比例底图） |

| ＋ 新建模块 | 创建新的底图目录与输出配置 |

| 标题 | 要叠加到封面上的文字；侧栏实时预览效果 |

| 保存配置 | 将字体大小、对齐、Y 轴等写入 templates/image_modules.json |

| 生成图片 | 按配置渲染并保存到模块的 output_dir |

生成后的图片插入 MD，再走「上传」即可上图床。

---

4.4 多平台实时预览

同一篇 MD 可切换三种排版主题，发文前直观对比效果。

公众号预览

• 模拟微信公众号阅读样式：字号、行距、标题层级、引用与代码块

• 「复制公众号格式」输出的 HTML 与此预览一致

CSDN 预览

• 橙色左边框标题、链接色等贴近 CSDN 博文常见样式

知乎预览

• 适配知乎专栏阅读的排版风格

预览区修改主题后，复制按钮会对应输出该平台的 HTML。

---

4.5 文件菜单

| 菜单项 | 快捷键 | 说明 |

|--------|--------|------|

| 打开 MD 文件 | Ctrl+O | 选择本地 Markdown |

| 保存 | Ctrl+S | 保存到当前路径 |

| 最近打开 | — | 记录最近 10 个文件，点击即可打开 |

---

4.6 工具设置

AI 服务

• 服务商：DeepSeek（推荐）/ OpenAI / Anthropic

• API Key、模型选择

• 「测试 API Key」验证连通性

GitHub 图片仓库

• 用户名、仓库名、分支

• 图片目录前缀（如 images/，留空则上传到仓库根目录）

• GitHub Token（测试连接与上传均需要）

本地图片目录已移至侧栏「目录」按钮，与上传操作放在一起，避免重复配置。

---

4.7 AI 提示词框架

• 管理多套「框架」预设，控制 AI 如何提炼简介、标题和标签

• 可编辑系统提示词、字数上限、标签数量等

• 侧栏「框架」下拉框选择当前使用的预设

适合不同栏目（教程 / 随笔 / 资讯）使用不同文风与结构。

---

4.8 封面图模块设置

新建或编辑模块时配置：

• 模块名称与底图目录（source_dir）：放置各比例空白底图

• 输出目录（output_dir）：生成封面保存位置

• 扫描底图后，可为每张图单独调整字号、对齐方式、标题纵向位置

侧栏选中模块后，改标题即可实时预览叠加效果；满意后点「生成图片」批量导出。

---

4.9 关于与远程更新

• 展示软件版本、作者、公众号二维码与免责声明

• 启动时从远程 manifest（jsDelivr）拉取最新 about_info.json

• update_flags 递增时弹窗提示：二维码、说明文字或版本信息有更新

• 菜单「赞赏」跳转爱发电页面（自愿支持，不影响功能）

---

五、典型发文流程

1. 侧栏「目录」→ 指定图片搜索目录

2. 打开或编写 MD，中间预览确认排版

3. 「上传」→ 本地图上图床，链接自动替换

4. 「AI 生成」→ 复制简介 / 标题 / 标签

5. （可选）图片任务生成封面，插入 MD 后再上传

6. 「复制公众号格式」→ 粘贴到公众号后台发布

7. 切换预览为 CSDN / 知乎 → 分别复制，一文多发