AiConsole · wordpress 智能控制台

先交个底：这个版本不是重写的，是把 Z-Blog 版的骨架整个拆下来，换了一套 WordPress 的肉。所以功能看着一模一样，实际上中间有几个地方差点把我劝退。

为什么要做 WordPress 版

很简单，我手上两个站，一个 Z-Blog 一个 WordPress。Z-Blog 那版做出来用得挺顺手，每次回 WordPress 站就得切回老流程——开 SSH、翻文件、改完清缓存，落差太明显。

最直接的痛点是主题排查。WordPress 主题目录结构比 Z-Blog 松得多，一个功能可能散在 functions.php、inc 目录、模板文件三处，出问题你得靠 grep 猜。有次一个区块死活不显示，我翻了四十分钟，最后发现是 functions.php 里一个 remove_action 把它摘了。这种活在对话框里问一句就能定位。

移植时踩的几个坑

看着是同一套工具，底层全得换。说三个最折腾的。

第一，文件和 CMS 是两套东西

读文件、写文件这部分几乎能直接复用，反正就是路径加内容。但一到内容操作就完全不一样了：Z-Blog 里文章是 Post 对象，WordPress 里是 WP_Post，取摘要的方式、发文章走 wp_insert_post() 还是走对象保存，全得另写。

我一开始想着「类名替换一下就行」，结果光是分类和标签的处理方式就返工了两遍。WordPress 的标签是独立的 taxonomy，不是文章里的一个字段。

第二，权限系统和 Z-Blog 完全不同

Z-Blog 那版我卡的是「只有站长能用」，判断很简单。WordPress 这边角色多，administrator、editor、author 各有权重，又不能简单粗暴给个 manage_options 就完事——有些内容操作 editor 也该能用。

现在的做法是分两层：进控制台要管理权限，进到对话里再按具体工具判断当前用户能不能做。这块还在打磨，如果你用的时候发现某个操作莫名其妙被拒，大概率是这里判断漏了，评论区告诉我。

第三，缓存更玄学

WordPress 的缓存不只是一个模板编译缓存。可能有对象缓存、页面缓存插件、CDN，还有主题自己的 transient。改完模板发现没生效，八成不是没保存，是某个缓存层还拿着旧版。

所以这个版本里，改完文件之后我加了一步主动清缓存的工具调用，能清的都清一遍。但如果你装了那种很重的缓存插件，还是建议手动点一下再刷新。

它能干的事，跟你想的一样

四类，跟 Z-Blog 版一致，我拣重点说。

• 查：主题文件结构、模板里某段输出在哪、插件加载顺序、PHP 报错日志、某个钩子挂了几个人。这块用得最多，也最安全。
• 改：改模板、改 CSS、加自定义函数片段、删废弃文件。需要手动打开写入权限，默认是关的。
• 写：发文章、发页面、建分类、改分类、批量加标签、处理待审评论。
• 调：站点名称、时区、评论设置、启用停用插件、侧栏小工具、伪静态。

另外附件那块也能管：从公网拉图进媒体库、搜已有附件、替换正文里的图片链接。做内容站的话这个挺省事。

用它的姿势很重要

同样一句话，说法不同效果差很远。我举几个我自己常用的说法：

❌ 帮我优化一下主题
✅ 首页卡片在 375px 宽度下右溢出 12px，找出原因并改掉

❌ 首页白屏了，修一下
✅ 首页白屏，先读错误日志找出报错文件和行号，先别改

❌ 把这段代码改好看点
✅ 这个函数重复调了三次 get_option，合并成一次

核心就一句：给它能验证的目标。它干活其实挺利索，卡住的时候通常是我自己没说清楚要什么。

装和配

PHP 8.0 以上，WordPress 6.x 都能跑。

1. 下载 zip，后台「插件 → 安装插件 → 上传插件」，装上启用
2. 左侧菜单会出现 AiConsole，点进去
3. 填 OpenAI 兼容接口的地址和 Key，选一个模型
4. 先问一句「你是谁」验证通不通

写入权限默认关闭。要用的时候在面板里打开，用完建议关掉——这不是形式主义，手滑一次的成本挺高。

得说清楚的问题

• 它不会帮你想清楚要做什么。 指令模糊它就会自由发挥，改出来的东西可能你不想要。
• 它偶尔会编 WordPress 函数。 尤其是一些不常用的钩子名。所以改完一定看前台，重要的改动先备份整站。
• 文件备份只覆盖它自己改的文件。 每次改之前存 .aicbak.时间戳，但如果你自己又动了别的地方，回滚不会全恢复。
• 它在 WordPress 生态里的兼容性没 Z-Blog 那版打磨得久。 遇到跟某个插件打架，欢迎报给我，我修得还算快。

最后

它解决的不是「我不懂技术」的问题，是「我懂但我懒」。真要我手写那两行 CSS 也就两分钟，问题是每次都得点开五六个页面。现在一句话的事。

出问题、想加功能、或者单纯觉得哪里别扭，评论区说，我基本都回。