本文是一份完整操作教程:从打开 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测试站部署与预览" 启动 `
助手会先确认两件事,照实回答即可:
工作区位置——即第 3 步选定的目录。
是否添加主题测试内容——建议选「不添加」。因为本教程的顺序是先部署、再装主题、最后用 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 步:后台应用中心下载并切换主题
浏览器打开「管理登录」地址,用
admin和随机密码登录后台。进入「应用中心」。
浏览并下载喜欢的主题,下载后返回「主题管理」点「启用」。
回到前台刷新首页,即可看到新主题效果。
如果主题是本地的
.zba/.zip包,也可以直接把包交给对话,说「把这个主题装到测试站」,助手会用技能的应用安装流程处理,装完按提示到主题管理里启用。第 7 步:通过 MCP 添加测试内容
装好主题后,灌入一批带配图的测试文章,用来检查主题的列表页、封面图、长短标题以及正文的小标题、列表、引用、表格排版。
对助手说「给测试站添加测试内容」,它会:
启用站点内置的
zblogMcp插件并生成 ApiKey;把 MCP 接入信息写进
~/.workbuddy/mcp.json,形如:`"zbp-test": { "url": "http://127.0.0.1:<PORT>/zb_users/plugin/zblogMcp/mcp.php", "headers": { "Authorization": "Bearer <ApiKey>" } } `提示你到连接器管理页点「Trust」信任这个新连接(只需一次);
灌入内容:5 个分类、每类 3 篇、共 15 篇文章,每篇配一张图。
配图来源二选一:
现成测试数据(推荐):技能自带配图包,约 2.4 MB,不额外消耗积分。
自己生成:按提示词生成 15 张真实场景图,单张约 5–10 点,合计约 75–150 积分。
填充完成后,前台首页和文章页就能看到完整的图文效果。同名分类与文章会自动跳过,可反复运行不会重复。
若手工用 MCP 工具写文章,务必显式传
status: 0(公开)。插件默认是「审核中」,不传前台看不到。第 8 步:发布到 CNB —— 新建仓库并推送
本地确认效果满意后,把它发布到公网。
打开 https://cnb.cool ,进入控制台,新建一个仓库(例如
zblog1118),记下仓库地址,形如https://cnb.cool/<你的组织>/<仓库名>。回到 WorkBuddy 对话,告诉助手:
`把测试站提交到 https://cnb.cool/<你的组织>/<仓库名>
助手会复用你已登录的 CNB 连接器凭证推送(无需再建访问令牌),完成后给出仓库地址。
推送内容包括:站点本体(含配置 c_option.php 和 SQLite 数据库)、云端启动脚本 .ide/serve.sh、流水线配置 .cnb.yml。本地产物目录 .runtime/ 不会推送。
推送采用以本地为准的覆盖方式。后续本地改了内容,重新执行一次推送即可同步到仓库。
第 9 步:云原生开发与在线预览
- 进入刚才的 CNB 仓库页面,点击「云原生开发」。
- 进入服务环节后启动服务——仓库里的
.ide/serve.sh会自动用 PHP 内置服务器把站点拉起来(默认 8080 端口,占用时自动顺延)。 - 启动完成后,界面会给出在线预览地址,点开即可在公网访问你的 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 小时到期后点一下「云原生开发」就能续上。
