我的站叫"童梦故事会",讲童话。最初配套的主题叫 uglyduck——丑小鸭。名字应景,却随手起的:ID 无品牌前缀,名称是个童话角色,作者栏只有 ELARA,网站栏空着。它同时是目录名、配置键、缓存键,越拖越难改。
我请 WorkBuddy 的「Z-Blog PHP 主题与插件开发」技能把脉。它给出惯例:ID 为品牌加下划线加主体名。四套方案里我选了 tongmeng_cream / Cream——tongmeng 取自仓库品牌,cream 是视觉本体:温润奶油色、三栏包裹感。作者改为 TONGMENG,补上站点地址。
改名不是改字符串。include.php 40 处、main.php 79 处引用要跟着走:函数前缀、Hook 名、配置键、菜单 id、template.json。整目录复制再全局替换,繁体包的"醜小鴨"、英文包的 Uglyduck 是漏项,单独改。数据库用临时脚本走 HTTP:配置值拷到新键、切换主题、清掉旧侧栏缓存。意外收获是新 ID 没有旧缓存,theme.xml 里写了却从未生效的侧栏预设,第一次真正落地。
内容交给 ZblogMCP 连接器:建分类、发文章变成几条指令,八个分类、二十余篇童话一夜就位。
配置从 8 项扩到 26 项、分四组,通过覆盖 CSS 变量生效。本机没有 PHP CLI,验证就把 main.php 复制成临时入口、伪造管理员身份,curl 渲染真实表单,带 cookie 取 csrfToken 提交一次确认保存跑通,测完恢复默认值、删净临时文件。三语 113 键一致、35 个模板配平,用的都是技能自带脚本。
最后加了两套可选模板 list-fables 与 single-fables。冷知识:Z-Blog 分类有两个模板位,分别管列表页与该分类文章页;模板须在 template 子目录并写 Template Type 头注释,否则后台下拉里不出现。两个文件由 index.php、single.php 复制而来,除首行外逐字节相同,原始文件没动。
全程进 git,推送到 TONGMENG 仓库。踩过本机特有的坑:git 写入的远程跟踪引用会被静默吞掉,状态时而超前、时而丢失,只能直接写引用文件;判断同步,只看仓库端实际指向的提交。
从随手起的丑小鸭,到 ID、名称、配置、模板成体系的 Cream,没有炫技,只是把该规范的规范了。技能负责"怎么做才对",连接器负责"快",而叫不叫 Cream、留不留某个分类,仍由我拍板。



原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。