## 一、背景

我手上维护着几个基于 zblogphp 的站点，日常最大的一块工作量是内容更新。

写文章本身不难，难的是文章写完之后的那些零碎动作：找配图、下载、检查图片是不是真的图片、上传到站内附件库、把图片居中、加版权说明、起一个 SEO 友好的标题、想三个长尾标签、写 80–150 字摘要、选对分类、发布、再回前台看有没有串版。

单篇看都是小事，一天五篇就是一件大事。

但真正拦路的，并不是「我不会做这些动作」，而是**「把这些动作交给 AI，它不知道我的规矩」**。这些规矩对我来说是肌肉记忆，手一动就到位；可对 AI 来说，每一条都得先被告知：

- 图片必须落进 `/zb_users/upload/`，一张外链图都不能有；
- 每张图下方必须跟一行小字版权说明，且不能统一堆在文末；
- 发布失败就停，绝不能自动重试——否则后台会平白多出一篇重复文章。

换句话说，我要的不是「一个会写文章的 AI」，而是「一个知道我的站点长什么样的 AI」。这些规矩如果每次都在对话框里口头交代一遍，效率比手动还低。所以我决定把它做成一个**我自己的 Skill**。

## 二、输入材料

| 类别 | 具体内容 | 是否脱敏 |
|---|---|---|
| 站点 | 自建 Z-Blog PHP 站点（下文以 `song.cm` 为例），已在后台开启 API | 自有站点 |
| 内容素材 A | 一篇我自己写好的正文（Markdown / 纯文本，约 1000–2000 字） | 无个人信息 |
| 内容素材 B | 只有一个标题或方向，例如「写一篇关于本地小吃的文章」 | 无 |
| 站点约束（交给 AI 执行） | 分类白名单、标签规范、图片必须站内化、摘要字数区间 | 以技能文件固化 |
| 存放位置 | 技能包统一放在 WorkBuddy 技能目录| — |

我把「素材」和「规矩」分开放：素材每次不同，规矩永远不变——规矩写进技能文件，素材在对话里给。

## 三、WorkBuddy 配置

### 3.1 用到的能力层级

- **Skill（核心）**：自建技能包《Z-Blog 文章发布》，技能名 `zblog-article-publisher`。它不是一份说明书，而是一个**路由器 + 两个子技能 + 两个脚本 + 一份私有配置**的完整技能包。
- **本地文件**：技能目录下的 3 个 Markdown 与 2 个 Python 脚本，WorkBuddy 按需读取，不需要我每次粘贴。
- **连接器 / MCP**：`agent-browser`。标题任务里用它联网找配图素材，发布后用它打开前台文章页做验收。
- **权限设置方式**：只把技能目录和站点配置放在本地；站点密码写在**私有配置文件**里，不进对话、不进技能正文、不进任何会被公开分享的文件。技能包里所有代码都不写死站点和账号，统一从配置读取。

### 3.2 技能包结构

```
zblog-article-publisher/
├── SKILL.md                  # 总路由：任务判定 + 全局配置 + API 技术手册
├── biaotirenwu-SKILL.md      # 子技能：标题任务（原创写作）
├── yi-duanwenzhang-SKILL.md  # 子技能：一段文章任务（编辑后发布）
├── publish.py                # 统一发布脚本（登录/分类/发布/自检一条龙）
├── upload_image.py           # 统一上传脚本（预处理 + auto_rename）
└── config.local.md           # 私有配置（含密码，勿外传）
```

这里我做了两个刻意的设计，后来证明是最有价值的部分：

**第一，技能被拆成「路由器 + 子技能」，而不是一份大而全的文档。** `SKILL.md` 只负责判断：用户给的是**标题**，还是**一段现成正文**？判断完只加载对应的那一个子技能文件，另一条分支不进上下文。这么做的好处很直接——处理「把这段发上去」时，AI 不会被「怎么写原创文章」的流程干扰；处理原创标题时，也不会被「不要改原意」的约束捆住手脚。

**第二，所有规则单点定义。** 站点地址、账号、发布格式只在 `config.local.md` 一处；API 技术规范（登录、上传、分类、发布、失败处理）只在总路由一处。换站点、改密码，只动一个文件。

### 3.3 全局配置

首次使用时，技能会检测配置缺失并**一次性**问我要四样东西，不猜、不用示例值：

```markdown
| 配置项 | 变量名 | 值 |
|---|---|---|
| 站点地址 | SITE | https://<我的站点> |
| 用户名 | USERNAME | <后台账号> |
| 密码 | PASSWORD | <后台密码> |
| 发布格式 | POST_FORMAT | md |
```

`POST_FORMAT` 是 `html` 或 `md`。我选了 `md`，因为我站点装了 Markdown 解析插件；如果你站点没有，就保持默认 `html`，否则前台会把 `##` 当源码直接显示出来。

![image.png](https://developer.qcloudimg.com/http-save/yehe-12010127/c253ae1c83310eaa769fd4b225164d26.png)

### 3.4 公开的提示词与命令

技能对外只暴露两个「入口命令」，其余全部自动化：

```powershell
# 发布（登录、分页查分类、发布、前台自检，脚本一条龙完成）
python publish.py --title "文章标题" --content-file body.md --cate "分类名" --tags "标签1,标签2" --intro "摘要"

# 上传图片（宽度 >600 自动等比缩小、统一转 WebP 质量 80、auto_rename 重命名）
python upload_image.py 图1.jpg 图2.png
```

对话里我要说的，其实只有一句：

```
写一篇关于 XX 的文章发布        ← 标题任务
把下面这段发到网站：……         ← 一段文章任务
```

![《Z-Blog 文章发布》技能工作流：路由分流 → 两条独立子流程 → 统一发布 → 前台验收](https://developer.qcloudimg.com/http-save/yehe-12010127/407a94f321589f11a8911aed7196f19c.png)

## 四、操作步骤

### 第 1 步：站点准备

后台确认两件事：一是「设置 → API」已开启，否则所有接口都会鉴权失败；二是确认 Markdown 插件状态，和 `POST_FORMAT` 保持一致。

### 第 2 步：下达任务，技能自动分流

我在对话框里说「把下面这段发到网站：……」。技能先做**任务分流**，判定为「一段文章任务」，然后**只读取** `yi-duanwenzhang-SKILL.md`，严格按这条分支执行。

### 第 3 步：一段文章任务的执行链

```
原文保存 → 错字修正 → 分段 → 去 AI 味 → 标题/标签/摘要 → 排版 → 收尾
```

这条分支的规矩是**不扩写、不改原意**。它只做错字修正、合理分段、把机械措辞理顺，然后把标题、3 个 SEO 长尾标签、80–150 字摘要一起生成出来。

### 第 4 步：标题任务的执行链

当我说的是「写一篇关于 XX 的文章发布」，走的是另一条链：

```
联网搜索 → 写文章 → 去 AI 味 → 标题/标签/摘要 → 配图 → 排版 → 收尾
```

配图这一步规则最细：先用 agent-browser 打开图片搜索引擎，每个引擎下载 5–10 张候选；用文件头校验是不是真实图片；再逐张看图确认画面和段落对得上；最后统一上传到站内附件库。**宁可少配图，也不用不相关的图**——这条是硬约束。

### 第 5 步：发布前的分类查询

技能不硬编码分类 ID。我给了分类名，它就去分页拉取分类列表做匹配；匹配不上就报错并把现有分类全列给我，而不是随便塞一个。这一步看似啰嗦，但省掉了我事后手动改分类的功夫。

### 第 6 步：前台验证才算完成

`publish.py` 发出请求只是第一步。技能会随后用 agent-browser 打开刚生成的文章链接，逐项核对：`document.title` 是否包含文章标题、正文有没有核心关键词、**正文所有 `<img>` 的 src 是否全部是站内 `/zb_users/upload/` 地址**（有任何一条外链就算失败）、图片是否居中、版权说明是否紧跟在每张图下方。全部通过，才回复我「发布成功」。

### 第 7 步：自动清理

每次任务独立建临时子目录，收尾时只清本次产生的临时图片、临时正文、临时脚本。它有一条明确红线：**不得清空整个工作区、不得删除无法确认归属的文件**。

## 五、中途踩的坑和我的调整

技能不是一次成型的。下面每一个坑，都是我在真实发布里撞到之后，回写到技能文件里的。

| 现象 | 根因 | 我做的调整 |
|---|---|---|
| 登录后请求接口返回 **419 非法访问** | 鉴权 token 放在了 URL 参数里 | 规定除分类查询外，token 一律放 POST body，代码模板固化 |
| 后台附件列表里，图片「类型」这一栏是空的 | 上传时用了两元组，requests 不会自动补 Content-Type | 改为显式三元组 `(文件名, 文件对象, 'image/jpeg')`，并写进技能 |
| 同月内重复上传同名图片，报 500「文件已存在」 | 客户端自定义了文件名 | 强制 `auto_rename=on`，交给站点自动重命名 |
| 文章前台把 `##` 原样显示出来了 | 站点未装 Markdown 插件，但 `POST_FORMAT` 设成了 `md` | 把「格式与插件必须匹配」写成发布前的检查项 |
| 想批量改已发布文章时，正文出现双重编码 | 接口返回的是 HTML 实体编码 | 规定取回后必须先 `html.unescape()` 再处理 |
| 网络抖动导致发布失败后差点发出两篇重复文章 | 早期逻辑有自动重试 | 改成**失败即停、绝不自动重试**，报错给我、由我决定是否重发 |

最后一条我认为是整份技能里最重要的一行字。自动化最怕的不是失败，是**不确定的失败**——你不知道它到底发出去没有。宁可停下来问我一句。

## 六、产出物

一次完整的任务，落到我手上的东西是这些：

1. **一篇已发布、可直接访问的文章**（前台链接），标题、标签、摘要、分类、正文格式全部就位；
2. **正文内已站内化的图片**，统一走附件库，宽度压到 600px 以内、转为 WebP，页面体积明显下降；
3. **一份验证结论**：标题匹配、关键词命中、无外链图片、图片居中、版权说明就位；
4. **一个干净的本地目录**：临时文件已按规则清理，不留垃圾。

从「素材躺在对话框里」到「拿到可验收的文章链接」，中间我只做了两件事：把素材粘进去、确认分类。

## 七、可复现要点

想把同样的流程复用到自己的站点，我认为关键不在写代码，而在**先把规则写清楚**：

- 站点侧：开启 API，确认 Markdown 插件状态与发布格式一致；
- 技能侧：把「站点地址 / 账号 / 发布格式」抽到一个私有配置里，其余文件不碰这些值；
- 流程侧：明确区分「我给的正文不许改意思」和「只给我标题你来写」两条分支，不要混用；
- 安全侧：发布失败不自动重试；图片必须是站内地址；临时文件只清理自己产生的。

做完这四步，AI 就不再是「帮我写点东西」，而是**按我的站点规则、稳定交付可验收结果**的那个角色。对我来说，这才是 WorkBuddy 在实际工作里真正省时间的地方——它省掉的不是写字的时间，是那些每天都得重复、又每次都可能出错的碎动作。

写文章本身不难，难的是文章写完之后的那些零碎动作：找配图、下载、检查图片是不是真的图片、上传到站内附件库、把图片居中、加版权说明、起一个 SEO 友好的标题、想三个长尾标签、写 80–150 字摘要、选对分类、发布、再回前台看有没有串版。

用 WorkBuddy 自建「Z-Blog 文章发布」技能，把一篇内容的落地从二十分钟压到两分钟

zblog文章发布，把一个重复了无数遍的「发文」动作，固化成一个可复用、可验收的 Skill，让 AI 按我的站点规则干活，而不是我按它的通用方式干活。

开发工具

我基于ZBlogPHP构建了自动化文章发布技能包，通过路由器分流标题任务与文章编辑任务，实现图片站内化、SEO优化、分类匹配和前台验收全流程。技能包封装了统一发布脚本、私有配置和失败即停机制，解决了重复操作、外链图片和重复发文等痛点，确保每篇文章从素材到可验收链接的稳定交付。

代码解释

路由器

WorkBuddy 

路由

Python

2026上云采购 | AI焕新·智启新局

workbuddy

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

用 WorkBuddy 自建「Z-Blog 文章发布」技能，把一篇内容的落地从二十分钟压到两分钟-腾讯云开发者社区-腾讯云

用 WorkBuddy 自建「Z-Blog 文章发布」技能，把一篇内容的落地从二十分钟压到两分钟

用 WorkBuddy 自建「Z-Blog 文章发布」技能，把一篇内容的落地从二十分钟压到两分钟

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐