内容中心

从零到上线:用 WorkBuddy 搭建 Z-BlogPHP 测试站并获取在线预览地址

本文是一份完整操作教程:从打开 WorkBuddy 开始,安装部署技能,选工作区、选技能、对话启动,在本地与局域网访问测试站;再进入后台切换主题、通过 MCP 灌入测试内容;最后把站点推送到 CNB 仓库,用「云原生开发」拿到可在公网访问的在线预览地址。全程不需要自己装 PHP、配数据库或写配置文件。

一、整体流程

打开 WorkBuddy → 安装技能 → 选择工作区 → 选择技能并对话 → 等待服务启动 → 本地/局域网访问 → 后台切换主题 → MCP 添加测试内容 → 推送到仓库 → 云原生开发 → 获取在线预览地址(到期可再次点击)。

二、前置条件

  • 一台安装了 WorkBuddy 的电脑(Windows / macOS 均可)。
  • 一个 CNB 账号( https://cnb.cool ),用于最后的在线发布。
  • 若需要局域网访问,电脑与访问设备处于同一网络。

说明:PHP、Z-BlogPHP 程序包、SQLite 数据库、FTP 服务全部由技能自动准备,无需预先安装。

三、操作步骤

第 1 步:打开 WorkBuddy

启动 WorkBuddy 客户端,进入对话界面。后续所有操作都在这一个对话里完成,不需要切换工具。

第 2 步:安装技能

在对话框输入:

安装技能 zbp-site-deploy
`</pre>

助手会通过技能市场搜索并安装,技能中文名为「**Z-BlogPHP测试站部署与预览**」。安装完成后,技能即可在当前对话中调用。

> 如果想确认是否装好,可以说「列出已安装的技能」,看到 `zbp-site-deploy` 即表示就绪。

### 第 3 步:选择工作区

工作区是站点文件和运行环境的存放位置。技能会在工作区里生成两个目录:

<table>
<thead>
<tr>
<th>目录</th>
<th>作用</th>
</tr>
</thead>
<tbody><tr>
<td>`.runtime/`</td>
<td>便携 PHP、工具包、下载缓存、日志(本地产物,不推送到仓库)</td>
</tr>
<tr>
<td>`zbp-site-deploy/`</td>
<td>站点本体,将来整个目录推送到 CNB</td>
</tr>
</tbody></table>

两种方式:
  • 新建空目录:专门建一个空文件夹作为工作区,与现有内容隔离(推荐)。

  • 用现有目录:直接指定一个已有目录,站点会作为子目录放进去。

    在对话里告诉助手工作区路径即可,例如「用 D:/yanshi/web 作为工作区」。

    注意:工作区里要跑便携 PHP 和整套运行环境,路径不要包含中文或空格。虽然技能已自动修复中文路径下的验证码裂图问题,但部分 PHP 扩展和命令行工具在中文路径下仍可能出异常。建议用纯英文、无空格的目录名,例如 D:/zbp-test。

    第 4 步:选择技能并发起对话

    在输入框输入 @ 调出技能列表,选择「Z-BlogPHP测试站部署与预览」,或直接输入:

    `@skill:"Z-BlogPHP测试站部署与预览" 启动
    `

    助手会先确认两件事,照实回答即可:

  1. 工作区位置——即第 3 步选定的目录。

  2. 是否添加主题测试内容——建议选「不添加」。因为本教程的顺序是先部署、再装主题、最后用 MCP 按主题需要灌内容,一开始就填通用数据反而要返工。

    确认后助手开始部署,你会看到它依次准备工具包、便携 PHP、下载 Z-BlogPHP、执行 CLI 安装、打验证码补丁、启动服务。

    第 5 步:等待服务启动,本地与局域网访问

    服务启动后,助手会返回一份部署信息,形如:

    项目 示例值
    站点首页 `http://127.0.0.1:8080/`
    局域网地址 `http://192.168.0.100:8080/`
    管理登录 `http://127.0.0.1:8080/zb_system/cmd.php?act=login`
    管理后台 `http://127.0.0.1:8080/zb_system/admin/index.php`
    管理员账号 `admin`
    管理员密码 随机生成(见输出或复查文件)
  • 本地访问:浏览器打开「站点首页」即可看到站点。

  • 局域网访问:同一网络下的其他设备,用「局域网地址」访问;若打不开,检查防火墙是否放行 8080 端口。

  • 端口说明:默认 8080,被占用时自动顺延,以实际输出为准。

    同时还会启动一个独立 FTP 服务,方便局域网传主题/插件包:

    项目 示例值
    FTP 地址 `ftp://192.168.0.100:2121/`
    账号 / 密码 `ftpuser` / 随机密码(复查文件 `.runtime/cli/.ftp-password`)
    被动端口 30000–30100
    根目录 站点目录

    FTP 账号与后台 admin 完全独立,旧管理员密码无法登录 FTP。

    第 6 步:后台应用中心下载并切换主题

  1. 浏览器打开「管理登录」地址,用 admin 和随机密码登录后台。

  2. 进入「应用中心」。

  3. 浏览并下载喜欢的主题,下载后返回「主题管理」点「启用」。

  4. 回到前台刷新首页,即可看到新主题效果。

    如果主题是本地的 .zba / .zip 包,也可以直接把包交给对话,说「把这个主题装到测试站」,助手会用技能的应用安装流程处理,装完按提示到主题管理里启用。

    第 7 步:通过 MCP 添加测试内容

    装好主题后,灌入一批带配图的测试文章,用来检查主题的列表页、封面图、长短标题以及正文的小标题、列表、引用、表格排版。

    对助手说「给测试站添加测试内容」,它会:

  5. 启用站点内置的 zblogMcp 插件并生成 ApiKey;

  6. 把 MCP 接入信息写进 ~/.workbuddy/mcp.json,形如:

    `"zbp-test": {
      "url": "http://127.0.0.1:<PORT>/zb_users/plugin/zblogMcp/mcp.php",
      "headers": { "Authorization": "Bearer <ApiKey>" }
    }
    `
  7. 提示你到连接器管理页点「Trust」信任这个新连接(只需一次);

  8. 灌入内容:5 个分类、每类 3 篇、共 15 篇文章,每篇配一张图。

    配图来源二选一:

  • 现成测试数据(推荐):技能自带配图包,约 2.4 MB,不额外消耗积分。

  • 自己生成:按提示词生成 15 张真实场景图,单张约 5–10 点,合计约 75–150 积分。

    填充完成后,前台首页和文章页就能看到完整的图文效果。同名分类与文章会自动跳过,可反复运行不会重复。

    若手工用 MCP 工具写文章,务必显式传 status: 0(公开)。插件默认是「审核中」,不传前台看不到。

    第 8 步:发布到 CNB —— 新建仓库并推送

    本地确认效果满意后,把它发布到公网。

  1. 打开 https://cnb.cool ,进入控制台,新建一个仓库(例如 zblog1118),记下仓库地址,形如 https://cnb.cool/&lt;你的组织&gt;/&lt;仓库名&gt;。

  2. 回到 WorkBuddy 对话,告诉助手:

    `把测试站提交到 https://cnb.cool/<你的组织>/<仓库名>
    
  3. 助手会复用你已登录的 CNB 连接器凭证推送(无需再建访问令牌),完成后给出仓库地址。

推送内容包括:站点本体(含配置 c_option.php 和 SQLite 数据库)、云端启动脚本 .ide/serve.sh、流水线配置 .cnb.yml。本地产物目录 .runtime/ 不会推送。

推送采用以本地为准的覆盖方式。后续本地改了内容,重新执行一次推送即可同步到仓库。

第 9 步:云原生开发与在线预览

  1. 进入刚才的 CNB 仓库页面,点击「云原生开发」。
  2. 进入服务环节后启动服务——仓库里的 .ide/serve.sh 会自动用 PHP 内置服务器把站点拉起来(默认 8080 端口,占用时自动顺延)。
  3. 启动完成后,界面会给出在线预览地址,点开即可在公网访问你的 Z-BlogPHP 站点。

关于预览地址的有效期:每次启动给出的在线地址一次支持 18 小时。到期后无需重新配置或推送,回到仓库再次点击「云原生开发」,重新启动服务,就会获得新的在线预览地址。

四、常见问题

问题 处理
端口不是 8080 端口被占用会自动顺延,一律以助手输出的实际地址为准
局域网打不开 确认同一网络,防火墙放行 8080(及 FTP 的 2121、30000–30100)
忘记管理员密码 查看工作区 `.runtime/cli/.admin-password`,或 `.runtime/cli/.env` 的 `ZBP_ADMIN_PASSWORD`
后台验证码不显示 技能已自动打中文路径补丁;若仍异常,让助手重跑一次验证码补丁
文章前台看不到 用 MCP 写文章时必须传 `status: 0`,否则是「审核中」状态
在线地址过期 18 小时后回到 CNB 仓库再次点击「云原生开发」重新启动即可

五、小结

整个流程可以概括为:WorkBuddy 装技能 → 选工作区 → 对话启动 → 本地/局域网访问 → 后台换主题 → MCP 填内容 → 推到 CNB → 云原生开发拿在线地址。本地环境和云端仓库互不影响,本地那份随时可改、可重复推送;云端地址 18 小时到期后点一下「云原生开发」就能续上。