> 先交代背景：我不会写代码。PHP 只认识这三个字母，CSS 在我眼里就是一串天书。
> 但我现在用着一个**自己从空文件夹开始做出来的 Z-BlogPHP 主题**——三栏布局、暖色纸质感、手绘黄昏横幅，后台还能像正经商业主题一样可视化配置。
> 整个过程，从第一行 theme.xml 到最后的设置页，全部是我对 WorkBuddy「说话」完成的。
> 这篇文章就是那份完整的施工记录：我怎么配置、怎么提需求、踩了哪些坑、最后长什么样。照着做，你也能来一遍。

---

## 一、我要做一件什么事

我经营着一个 Z-BlogPHP 1.7.5 的个人博客，写作环境是本地内网（Windows + EServer：nginx + PHP 7.4 + MySQL 8）。市面上的主题也试了不少，但总差点意思：我想要一个**三栏结构**——左边一列小工具、中间文章流、右边再来一列；想要**旧时光的配色**——米黄纸底、玫瑰红强调、宋体标题；最好首页还有一张像老连环画一样的横幅。

找了一圈没找到合心意的，于是冒出一个念头：**让 WorkBuddy 给我做一个。**

当时给自己定的「能用」标准很朴素：

1. 主题能在后台正常启用，网站不白屏、不报错；
2. 首页、文章页、评论、搜索、404 这些页面齐全；
3. 不用碰代码，在后台就能改横幅文案、配色、布局；
4. 手机上打开也不至于散架。

## 二、我的 WorkBuddy 配置（想复现的可以直接抄）

| 配置项 | 我用了什么 | 作用 |
|---|---|---|
| 技能 | 「Z-Blog PHP 主题与插件开发」 | 让 AI 预先掌握 Z-BlogPHP 的应用规范：theme.xml 结构、模板语法、插件钩子、命名约定这些硬规矩 |
| 连接器 | ZBlog MCP | 让 AI 直接操作我的站点内容：发布文章、修改文章内容，调试列表页和分页时用来造测试数据 |
| 环境 | EServer 本地建站环境（nginx + PHP 7.4 + MySQL 8） | 主题源码就在本机目录里，WorkBuddy 可以直接读写文件、执行命令、查数据库 |
| 工作方式 | 直接把主题源码目录作为工作目录交给它 | 改完文件刷新页面立刻能看到效果，形成「改一版 → 看一眼」的闭环 |

我的体会是：**主题开发本质上是「改文件 + 看效果」的循环**，所以关键是让 WorkBuddy 拿到文件读写和命令执行的权限；再配上 ZBlog MCP 操作文章数据，前台页面才有东西可看、可验证。

## 三、从 0 到 1：完整施工过程

### 第 1 步：把需求说成「人话」

开工前我最担心的就是「我不会写需求文档怎么办」。实践下来发现完全多虑——我不会写专业描述，就按大白话说：

> 帮我做一个 Z-BlogPHP 主题：三栏布局，左右各一条小工具栏，中间是文章列表；整体要怀旧、旧报纸那种米黄纸质感；标题用宋体；首页要有一张横幅，画个黄昏、电线杆、自行车，要有年代感；代码规范按 Z-Blog 的官方要求来。

它没有立刻动手写代码，而是先回了我一份**目录结构规划**：theme.xml（应用信息）、template.json（模板映射）、include.php（挂钩与配置）、style/style.css（样式）、template/（模板目录）、language/（语言包）。我确认「就这么办」，它才开始生成文件。

**这一点很重要：先让它出方案，你确认了再动手。** 方案阶段看不懂代码没关系，看懂「要生成哪些文件、分几步做」就够了。

### 第 2 步：骨架先行

最先落地的就是那四个基础文件。WorkBuddy 在这里反复向我强调一条 Z-BlogPHP 的铁律：**主题 ID 必须三处一致**——主题目录名、theme.xml 里的 `<id>`、数据库 `zbp_config` 表里的 `ZC_BLOG_THEME`，错一处网站就直接 500。当时我还没当回事，直到后面改名时被狠狠上了一课（见第 7 步）。

### 第 3 步：布局与配色

三栏布局用的是 CSS Grid：左栏 250px、右栏 290px、中间自适应。所有颜色都收进了 CSS 变量里：

```css
:root {
    --paper: #f5f3ee;   /* 米黄纸底 */
    --rose:  #b76e79;   /* 玫瑰红强调色 */
    --blue:  #7d9bd4;   /* 雾霾蓝链接色 */
    --serif: "Songti SC", "STSong", "SimSun", Georgia, serif;
}
```

定稿前它给了几组配色让我挑，我把色块截图发到手机上对着墙看了一会儿，最后选了这组暖调的。**这种「AI 出选项、人类拍板」的分工，是全程最舒服的部分。**

### 第 4 步：手绘一张横幅

![批注 2026-10-14 122109.png](https://developer.qcloudimg.com/http-save/yehe-12818841/e73c31ba5de2410de58f266e432aa87d.png)

### 第 5 步：后台可视化设置页（最惊喜的部分）

我本来以为「后台设置页」是要写插件的高级功能，结果 WorkBuddy 告诉我：Z-BlogPHP 主题**自带**设置页机制，只要把 `theme.xml` 里的 `<path>` 指向一个 `main.php` 就行。

最终做出来的设置页分五组、共 **18 个配置项**：

- **首页横幅**：开关、主/副标题、背景图地址、高度；
- **配色与外观**：强调色、链接色、页面底色（带取色器）、附加 CSS；
- **布局**：三栏 / 隐藏左栏 / 隐藏右栏、内容最大宽度；
- **文章列表**：摘要、阅读全文、标签、浏览量、置顶标记的显隐；
- **页脚**：自定义文字、返回顶部。

这里它主动做了几件我当时看不懂、后来直呼专业的事：

1. **默认值唯一数据源**：所有配置的默认值集中写在 `Defaults()` 函数里，数据库里没存的键自动回落到默认值——否则「装完主题没进过设置页」的话，前台会拿不到配置；
2. **安全过滤**：颜色只接受正则白名单、尺寸夹在区间里、URL 剔除引号和换行、文案统一转义，防止配置项被塞进恶意代码；
3. **恢复默认按钮**：一键还原，不怕我乱点。

### 第 6 步：踩坑实录（本文最有价值的部分）

顺利是主旋律，但坑是真踩了。这几个坑 WorkBuddy 都自己定位、自己修复，我只负责描述现象：

**坑 1：改了配置，页面毫无反应。**
现象是改完设置页前台纹丝不动。它的排查路径很清晰：先 `curl` 看页面状态码 → 查数据库确认配置写进去了没有 → 最后发现是浏览器和 nginx 缓存在作怪。顺带把主题静态资源的缓存策略也修了。

**坑 2：报「主题模板的编译文件不存在」。**
Z-BlogPHP 的模板编译后存在缓存目录里，而**前台不会自动重编译**，只有后台或调试模式才会触发。WorkBuddy 写了个临时 PHP 脚本调用框架的 `CheckTemplate()` 重建编译缓存，验证生成了全部编译文件后，把临时脚本删掉。事后它提醒我：这个坑要写进笔记，下次改模板必查。

**坑 3：模板里不能出现花括号。**
这是我印象最深的一个。CSS 变量覆盖那种内容天然全是 `{ }`，直接写进 Z-Blog 模板会被模板引擎吃掉。解法很漂亮：**在 PHP 侧把整段 `<style>` 拼成字符串，作为一个「派生字段」注入模板**，模板里只剩一个变量引用，花括号压根不经过模板引擎。

**坑 4：后台的设置入口「消失」了。**
按说主题有设置页，后台主题管理页会出现一个齿轮按钮，但我的站点上死活看不到。WorkBuddy 翻了框架源码，发现本机环境的预激活插件列表把那个齿轮按钮的显示条件挡住了。绕过方式也优雅：直接往**后台顶部菜单**注入一个「主题设置」入口，权限校验沿用框架自带的，无权限自动不显示。

### 第 7 步：改名「归隅」，被最深的坑咬了一口

主题测试期一直顶着一个临时名字，定稿时想改成「归隅」（取「归来有隅、万物归位」之意）。改个名能有多难？结果差点把整站送走。

Z-BlogPHP 的配置表里，字符串是以 `serialize()` 格式存储的，比如 `s:6:"guiyu";`——**前面那个数字是字符串的精确长度**。目录名、theme.xml、数据库三处都改完了，唯独数据库里这一处的长度没跟着改，`unserialize()` 直接返回 `false`，整站悄悄回退到默认主题：页面能打开，但样式全变了，一开始我甚至没反应过来发生了什么。

WorkBuddy 的复盘把改名流程整理成了一份六步清单：整目录备份 → 目录改名（目录被进程占用时改用「迁移法」）→ 改 theme.xml / template.json / include.php 里的全部旧 ID → 改数据库 `ZC_BLOG_THEME` 和侧栏缓存键名 → 清空模板指纹触发重编译 → 重建编译缓存。这份清单后来反复救了我自己。

### 第 8 步：用 ZBlog MCP 造数据、做验收

主题有了，页面上得有文章才看得出效果。这里轮到 **ZBlog MCP 连接器**上场：我让它直接发布、修改站点文章，造出一批带分类、带标签、带评论的测试内容，然后逐页验收——首页列表、分页、文章页、上一篇/下一篇、评论提交、搜索结果、404 页，每一页都过一遍。

![批注 2026-10-14 121642.png](https://developer.qcloudimg.com/http-save/yehe-12818841/b8144858cfe49c799a364a75de9e65f0.png)





## 四、产出物：一个真的能用的主题


从 2026 年 9 月底第一版跑通，到现在迭代到 **v1.3**：

- **45 个文件，约 2600 行代码**，主题体积不到 500KB；
- **26 个模板文件**：首页、文章页、独立页、搜索、404、评论、分页、侧栏模块一应俱全；
- **18 个后台配置项**，全程不用碰代码；
- **三份语言包**（简中/繁中/英文）；
- 经历了「两栏 → 三栏」「临时名 → 归隅」「无设置页 → 完整设置页」三轮大改。

最重要的是开头那四条「能用」的标准全部达成：后台正常启用、页面齐全、纯后台可视化配置、移动端自适应（Grid 断点响应式）。

## 五、纯小白的心得

1. **先要方案，再要代码。** 每个模块动手前让它先说清楚要改哪些文件、为什么，你确认了再动。方案能看懂，代码看不懂没关系。
2. **让它自己验证。** 别自己当测试员——改完让它 curl 看状态码、查数据库、重建缓存、逐项回归，验证报告贴给你看。
3. **小步快跑。** 一次只做一个模块：骨架 → 样式 → 模板 → 横幅 → 设置页。出问题容易定位，回退也方便。
4. **让坑沉淀下来。** 每踩一个坑就让它把排查过程记成笔记，后来这些笔记干脆沉淀成了一份「Z-Blog 站点维护手册」，改名、缓存、配置存储这些坑再也没咬过我第二次。
5. **备份是底线。** 每次大改之前先整目录备份，这是 WorkBuddy 主动坚持的原则，也是它唯一不听我「直接改吧」的地方。

## 六、下一步

v1.4 已经排上日程：修一个窄屏下搜索框略微溢出的小尾巴，再给侧栏补几个模块。对一个「纯小白」来说，做主题这件事最神奇的地方在于——**你负责想要什么，WorkBuddy 负责怎么实现**。

归隅，归来有隅。我的博客文章，从此有了自己盖的房子。

---

*本文为 WorkBuddy 频道首届征文活动投稿，内容为本人真实使用经历记录。*

先交代背景：我不会写代码。PHP 只认识这三个字母，CSS 在我眼里就是一串天书。 但我现在用着一个自己从空文件夹开始做出来的 Z-BlogPHP 主题——三栏布局、暖色纸质感、手绘黄昏横幅，后台还能像正经商业主题一样可视化配置。 整个过程，从第一行 theme.xml 到最后的设置页，全部是我对 WorkBuddy「说话」完成的。 这篇文章就是那份完整的施工记录：我怎么配置、怎么提需求、踩了哪些坑、最后长什么样。照着做，你也能来一遍。

【征文】从0到1，纯小白用WorkBuddy完成了一个可使用的zblog主题——「归隅」三栏博客怀旧主题

先交代背景：我不会写代码。PHP 只认识这三个字母，CSS 在我眼里就是一串天书。 但我现在用着一个自己从空文件夹开始做出来的 Z-BlogPHP 主题——三栏布局、暖色纸质感、手绘黄昏横幅，后台还能像正经商业主题一样可视化配置。 整个过程，从第一行 theme.xml 到最后的设置页，全部是我对 WorkBuddy「说话」完成的。 这篇文章就是那份完整的施工记录：我怎么配置、怎么提需求、踩了哪些

人工智能

不会写代码也能做Z-BlogPHP主题？本文记录我用WorkBuddy从零搭建三栏暖色系主题“归隅”的全过程，涵盖配置方法、后台可视化设置、缓存/改名等避坑指南，小白照做即可复现。

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

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

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

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

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

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

社区新版编辑器体验调研

【征文】从0到1，纯小白用WorkBuddy完成了一个可使用的zblog主题——「归隅」三栏博客怀旧主题-腾讯云开发者社区-腾讯云

【征文】从0到1，纯小白用WorkBuddy完成了一个可使用的zblog主题——「归隅」三栏博客怀旧主题

【征文】从0到1，纯小白用WorkBuddy完成了一个可使用的zblog主题——「归隅」三栏博客怀旧主题

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐