最近看到不少人用 WorkBuddy 做“个人工作台”：有人记每日任务和习惯，有人管理内容账号和素材，也有人把睡眠、运动、学习进度都放进一个页面。
让 WorkBuddy 把页面做出来并不难，麻烦通常出在下一步。只要本机预览一关，手机和其他电脑就打不开；换台电脑，原来的数据和项目也可能找不到。
下面这套做法不要求新手自己敲命令。WorkBuddy 建项目、跑构建、查错误和部署；你来选页面方案、登录自己的 Cloudflare 账号，再打开正式网址检查结果。
国内访问限制： Cloudflare 的免费全球网络不等于中国大陆节点，
workers.dev在大陆的速度和可用性没有保证。拿它做个人项目、预览站或全球访问很方便；如果主要给国内用户长期使用，文末还有几种国内部署方案。
为什么要上线
如果页面只在自己的电脑里运行，它仍然是一份开发中的文件。部署以后才有一个固定网址，也不再依赖 WorkBuddy 一直开着。
| 本机预览 | 部署以后 |
|---|---|
| WorkBuddy 或开发服务器关闭后就打不开 | Cloudflare 独立运行，WorkBuddy 关闭后仍可访问 |
| 只能从当前电脑打开 | 手机、平板和其他电脑都能打开网址 |
| 只能自己看 | 可以把网址发给家人或同事试用 |
| 换电脑后容易找不到原项目 | 配合 GitHub 保存代码和版本 |
| 修改后只能在本机看到 | 重新部署后线上网址立即更新 |
页面能在手机上打开，不代表手机和电脑会自动共享数据。如果第一版使用 localStorage 或 IndexedDB，数据只保存在当前浏览器里。想让两台设备看到同一份任务和记录，还得接 Cloudflare D1、KV 或其他数据库。后面会单独说明。
需要亲自处理的五件事
1. 告诉 WorkBuddy 想做什么
2. 从几套 UI 原型里选一套
3. 查看本地预览并确认功能
4. 打开 Cloudflare 认领链接并登录
5. 打开正式网址完成验收依赖安装、构建配置、Wrangler 命令和报错都可以留给 WorkBuddy。账号密码、验证码、服务条款和项目归属，则不要交给任何人代办。
第一步：做出能用的第一版
打开 WorkBuddy，新建一个工作空间。第一轮先把范围卡住，否则它很容易顺手加上登录、天气、动画等暂时用不到的东西。下面这段可以直接发给它：
请帮我做一个个人工作台网页。
第一版功能：
1. 显示日期、问候语和今日概览；
2. 管理待办事项与今日主任务；
3. 记录习惯、运动或学习进度；
4. 保存简单笔记和快速记录；
5. 优先适配手机，同时支持电脑访问。
数据第一版保存在当前浏览器，刷新页面不能丢失。请明确告诉我：这种方式不能跨设备同步。
先整理数据结构，再生成三套不同的手机端 UI 原型。不要把三套方案拼在一起，也不要自行加入登录、社交、支付、天气和复杂动画。启动本地预览，让我选择方案；现在不要部署。看到三套原型后，选一套最接近自己使用习惯的，再让 WorkBuddy 往下做：
选择方案 B。请按选定方向完成正式页面，不混入另外两套方案。
请自动安装依赖、运行项目并检查主要功能。所有命令由你执行，不要让我打开终端。完成后给我本地预览，并说明实际修改了哪些文件。需要调整时，每轮只说一两件事，比如“把今日主任务放到最上面”或者“手机上的按钮太小”。一次塞进十几条意见，往往会把已经满意的部分也改掉。
第二步：检查项目有没有依赖本机
页面看起来没问题后，先别急着部署。把下面这段发给 WorkBuddy，让它把构建、本地依赖和敏感信息一起查一遍：
请对当前项目做上线前检查，不要增加新功能。
请自动完成：
1. 检查项目能否正常构建；
2. 测试主要按钮、录入和删除操作；
3. 检查刷新页面后数据是否保留；
4. 分别检查手机和电脑宽度；
5. 检查控制台与构建日志中的错误；
6. 检查代码中是否写入密码、Token、Cookie 或个人资料；
7. 查看项目是否读取本地文件或依赖本地服务，判断能否部署到 Cloudflare；
8. 修复发现的问题并重新测试。
最后告诉我：它是纯静态应用、Worker 应用，还是仍然依赖本地环境；是否可以部署。第 7 项最容易出问题。本机页面如果直接读取 ~/WorkBuddyData/data、SQLite 文件或 localhost 接口，上传后不会自动工作。这类项目要么改用浏览器本地存储，要么先把后端迁移到 D1、KV、R2 等 Cloudflare 服务。
第三步：先发一个临时地址
Cloudflare 提供一套叫 Claim deployments 的临时部署流程。WorkBuddy 可以先把网站传上去，等你看过页面，再登录自己的账号认领项目。整个过程不需要把账号密码发给 WorkBuddy，也不用提前创建 API Token。
这套流程要求 Wrangler 4.102.0 或更高版本。当前环境还不能处于 Cloudflare 登录状态，也不能预先设置 OAuth、API Token 或 Global API Key。
请把当前项目部署到 Cloudflare。
我是新手，构建、配置、命令、排错和部署工作由你完成。
要求：
1. 检查并更新 Wrangler，版本必须不低于 4.102.0；
2. 检查当前环境没有 Cloudflare 登录状态或 API Token；
3. 自动识别项目框架，生成需要的 Cloudflare Workers Static Assets 配置；
4. 先运行构建和 Wrangler dry-run；
5. 检查通过后运行：npx wrangler deploy --temporary；
6. 如果出现错误，读取完整日志，修复后重新检查；
7. 部署成功后，只把临时访问网址和认领链接发给我；
8. 不要索取我的 Cloudflare 密码、验证码或支付信息；
9. 不要把临时凭据、认领链接或 Token 写入项目、Git 仓库或公开日志；
10. 完成后停下来，等我认领。部署成功后，WorkBuddy 会返回两个地址：
- 临时访问网址：用于打开和测试网站；
- 认领链接：用于把临时账号和部署转入你的 Cloudflare 账号。
临时部署和认领链接默认只保留 60 分钟。在截止时间前打开链接还不够，必须完成登录和认领；如果已经过期，让 WorkBuddy 重新部署一次。具体规则见 Cloudflare 官方说明。
第四步：自己登录并认领项目
登录和认领不要交给 WorkBuddy，按下面几步自己完成：
- 打开 WorkBuddy 返回的认领链接；
- 阅读并确认 Cloudflare 的条款与隐私政策；
- 登录 Cloudflare；没有账号就按页面注册；
- 按页面提示完成认领；
- 保存认领后的正式
workers.dev地址。
不要公开截图、转发认领链接，也不要把它写进教程。拿到链接的人可能抢先认领项目。
如果 60 分钟内没有完成，Cloudflare 会删除临时账号及其资源。完成认领后，Worker 和支持的资源会转到你的账号中继续保留。
第五步：用正式网址再测一次
认领完成后，把正式网址交回 WorkBuddy：
我已经完成 Cloudflare 认领。
正式网址是：
【把网址粘贴到这里】
请继续帮我：
1. 打开正式网址；
2. 测试主要功能；
3. 检查手机和电脑页面；
4. 检查刷新后数据是否保留；
5. 明确说明数据是否能跨设备同步；
6. 检查页面是否泄露密钥、内部路径或调试信息；
7. 发现问题时先在本地修复和构建，再说明重新部署需要的授权。
最后告诉我是否已经正式上线。至少要确认三件事：主要功能能用，手机页面没有错位，刷新或换设备后的数据表现和预期一致。
以后更新网站怎么办
认领只是把临时项目接到你的 Cloudflare 账号下，并没有给 WorkBuddy 永久部署权限。以后更新网站，可以选下面一种授权方式：
- 让 WorkBuddy 运行
wrangler login，它打开 Cloudflare OAuth 页面，你在浏览器中确认； - 创建最小权限 Cloudflare API Token，通过运行环境安全传给 Wrangler；
- 把代码提交到 GitHub，再连接 Cloudflare Workers Builds，让
main分支自动发布。
不熟悉 Token 权限的话，用 OAuth 或 GitHub 自动构建更省事。Token 不要贴进聊天内容、源码、.env.example 或 Git 提交。
以后改页面时，可以直接发这段：
请继续修改已经上线的个人工作台。
本次只修改：
【填写内容】
先读取现有项目，不改无关功能。修改后运行检查和生产构建，展示变更范围；确认没有密钥和无关文件后，部署到原来的 Cloudflare 项目，并打开正式网址复查。先把“上线”和“同步”分开
临时部署只会把网页和代码放到 Cloudflare。浏览器里的本地数据不会因此变成云数据库。
| 需求 | 数据方式 | 结果 |
|---|---|---|
| 只在一台手机使用 | localStorage / IndexedDB |
最简单，清理浏览器数据可能丢失 |
| 手机和电脑同步 | Cloudflare D1 + Worker API | 登录后访问同一份任务和记录 |
| 保存图片或附件 | R2 + 数据库记录 | 文件和记录分开保存 |
| 轻量配置或会话 | KV | 适合少量键值数据，不替代关系数据库 |
只在一台手机上用，浏览器本地存储已经够了。一旦要跨设备同步，就让 WorkBuddy 先设计登录、数据表和访问规则。先拿假数据测试不同账号能否互相看到记录，确认隔离正常后，再导入日记、收支或健康数据。
临时账号可以使用 D1、KV、R2 等部分资源，但容量和权限有限。例如 Workers Static Assets 最多 1,000 个文件，每个文件不超过 5 MiB。项目比较复杂时，先看 临时账号支持范围，不支持的资源留到正式账号授权后再部署。
临时部署没成功，先查这些
不要只截最后一行报错，把完整日志交给 WorkBuddy：
临时部署失败了。请读取完整错误并按顺序检查：
1. Wrangler 是否为 4.102.0 或更高版本；
2. 当前是否已经登录 Cloudflare，或设置了 OAuth / API Token；
3. 项目是否能完成生产构建和 dry-run；
4. 静态资源数量和单文件大小是否超过临时账号限制；
5. 项目使用的 Cloudflare 资源是否支持临时账号；
6. 是否遇到临时账号创建频率限制。
一次修复一个根因，修复后重新检查。仍不能使用临时部署时，再让我通过 OAuth 登录，或指导我创建最小权限 API Token。不要索取账号密码，不要把 Token 写入项目。--temporary 只在未认证状态工作。如果 WorkBuddy 已经能读取 Cloudflare 登录信息，就应该直接走正式部署，不要反复添加这个参数。
主要给国内用户用，平台要换吗
Cloudflare 上手快，也不要求提前备案，但免费 Workers / Pages 没有中国大陆节点，国内网络不一定稳定。Cloudflare China Network 是 Enterprise 附加服务，还需要 ICP 和内容审核。具体要求见 Cloudflare China Network。
网站主要给国内用户长期使用时，可以让 WorkBuddy 改用下面的平台：
| 服务 | 让 WorkBuddy 怎么部署 | 注意事项 |
|---|---|---|
| EdgeOne Pages | 导入 GitHub 仓库，填写构建命令与输出目录，绑定自定义域名 | 覆盖大陆节点的正式域名需要 ICP；系统链接只是短期预览 |
| CloudBase 静态托管 | 上传构建产物，或连接 Git 仓库自动构建 | 可继续接身份认证、数据库、文件；正式域名需要备案 |
| CloudBase Webify | 导入 GitHub、GitLab 或 Gitee，推送代码自动构建 | 适合静态、SPA 与小型动态应用 |
| 阿里云 ESA Pages | 导入 GitHub，配置构建参数或 esa.jsonc |
中国内地或全球加速区域需要 ICP，并要先有可用 ESA 站点 |
| 国内轻量服务器 | 使用应用镜像或 Docker 部署，配置 HTTPS 与备份 | 自由度最高，也要自己维护系统、安全组和数据库 |
EdgeOne 与阿里云 ESA 不是要求每个部署文件都去备案。需要备案的是覆盖中国大陆节点的正式自定义域名。域名还没备案时，可以先用 Cloudflare 做预览或全球入口，但国内偶尔能打开不代表长期可用。
发布前再过一遍
关掉 WorkBuddy，换一台设备打开正式网址，然后按这份清单检查：
- WorkBuddy 已完成生产构建与 dry-run；
- 临时网址能够打开并通过主要功能测试；
- 已在 60 分钟内完成 Cloudflare 认领；
- 正式网址在手机和电脑上都能使用；
- 已确认数据是单设备保存还是跨设备同步；
- 认领链接、Token、密码和个人数据没有进入代码仓库；
- 已为后续更新配置 OAuth、最小权限 Token 或 GitHub 自动部署。
整个流程可以概括为：
告诉 WorkBuddy 需求
→ 选择 UI 并查看本地预览
→ AI 完成检查和临时部署
→ 你登录 Cloudflare 完成认领
→ AI 检查正式网址
→ 通过 OAuth 或 GitHub 继续自动更新账号登录和项目认领要自己完成，密钥别发给 Agent。页面能打开以后，还要单独确认数据有没有同步。