卡 15 故障处理
(通用规则:只对 AI 说日常中文,不打开终端,不改文件夹里的文件;账号密码只在系统弹窗或网页里输入,不发给 AI;把要做的事说具体,不只说「继续」「好的」。)
1保存或同步出问题时
| 现象 | 怎么办 |
|---|---|
| AI 回复"没能同步到云端,修改已保存在这台电脑上" | 到云端的网络临时失败,不用重做。过一会儿在 WorkBuddy 里说「保存到云端」 |
| 保存后 EdgeOne 没有出现预览部署 | 两种原因:预览环境的「自动部署」默认关闭,按卡 8 在腾讯云 EdgeOne 控制台打开;或者是第一次推送草稿(新建分支)不触发部署,属正常,下次保存起会有 |
| WorkBuddy 输入框下方显示 draft | draft 就是草稿,WorkBuddy 显示的是当前分支名,不用管 |
2网站内容不对时
| 现象 | 怎么办 |
|---|---|
| 联系页是空的 | 确认单里联系方式写了「先空着」,网站上就不会出现。补上邮箱、电话后在 WorkBuddy 里说「更新联系方式」 |
| AI 回复里说"另外清掉了……",做了没让它做的修改 | 看清它多改了什么;不需要的在 WorkBuddy 里说「撤销刚才的修改」。v0.16 起 AI 会先把生成时的提示列出来问你,需要处理就直接说,例如「关于页那一行删掉吧,网址先不用管」 |
| 想回的旧版本在部署列表里显示「已失效」,「更多」里没有「版本回滚」 | 生产环境只保留最近 3 条成功部署。改用卡 11:在 WorkBuddy 里对 AI 说「回到某天那版」,再说「发布」。腾讯云 EdgeOne 控制台回滚只用于切回最近几次发布 |
| 点「确定」回滚后弹窗没关,或点「版本回滚」后没出弹窗 | 腾讯云 EdgeOne 控制台界面偶发。先看正式网址是否已经变了;弹窗没关就点 ×,不要再点「确定」;没出弹窗就再点一次「版本回滚」 |

图里这条是「已失效」的旧部署,菜单里只有「重新部署」「删除」,没有回滚——遇到这种情况不要再找控制台,直接回 WorkBuddy 用卡 11。
3说错了话、AI 会错意时
| 现象 | 怎么办 |
|---|---|
| 只说「继续」,AI 列出几个选项让选(其中有「发布上线」) | 说法太笼统,AI 会先读记录和版本状态再来确认(实际测试时未改任何文件)。不确定时在 WorkBuddy 里不要点选项,点 ✕ 关掉问题框,直接说清楚要做什么;不想上线时不要选含「发布」的选项 |
| 把课程卡里的操作说明原文一起粘贴给 AI,AI 自己扮演客户写了回复 | 只发送你自己的回复。发现 AI 代写时在 WorkBuddy 里说「作废,以我的回复为准」 |
| 确认单里有很多"请提供依据,否则删除" | 资料里有"领先"、疗效数字、合作背书这类说法。有证明材料就放进资料文件夹并说明,没有就在 WorkBuddy 里同意删除 |

图里就是笼统说法换来的结果:AI 不敢直接动手,列出几个可能的动作让你挑,其中一条含「发布上线」。挑错就会把没确认的内容推上正式网站,所以更好的做法是关掉这个框,把要做的事说具体。
4弹出权限确认时
WorkBuddy 弹出"写入文件命中询问规则,需要确认"、要写的文件是钥匙串时,有两种情况:首次登录成功后模板脚本保存凭据(正常),或者登录失败后 AI 自行想办法保存账号密码(异常)。判断只看弹窗里的「当前命令」:
- 是
tools/site_version.py:选「允许写入」(只本次)。 - 是其他任何命令:选「拒绝」,停止任务并联系服务方。

红框里是「当前命令」,这一条是模板脚本在保存凭据,属正常情况,选「允许写入」,之后保存就不会再弹。

这一条的「当前命令」不是 tools/site_version.py,是登录失败后 AI 自己临时想出的办法,选「拒绝」并停止任务、联系服务方。(这是全套卡片里唯一需要停下来找服务方的情况;v0.11 起实际测试时 AI 未再自行处理。)
5连接云端和账号出问题时
| 现象 | 怎么办 |
|---|---|
| 登录框里填了昵称,连接失败 | Gitee 页面多处显示"姓名",但登录名是个人空间地址。v0.11 起登录名已预填,直接点「确定」;失败后只按 AI 转告的提示核对登录名和密码,再在 WorkBuddy 里说「保存到云端」,不要按 AI 临时想出的其他办法操作 |
| 授权后仓库列表里出现很多不认识的仓库 | 账号下的仓库都会列出来。在腾讯云 EdgeOne 控制台认准网站仓库名(带「私有」标签),不要选错 |
| Gitee 授权页勾选了很多权限项 | 位置:Gitee 网页。在「EO Pages 客户端」授权页取消勾选「组织」「企业」「邮箱」,只保留「项目」和「webhook」,再点「同意授权」(见卡 8) |
6发布设置和域名出问题时
| 现象 | 怎么办 |
|---|---|
| 一处叫"构建命令"、一处叫"编译命令" | 是同一项,只是叫法不同(卡片统一用控制台叫法「构建命令」)。在腾讯云 EdgeOne 控制台按卡 8 给的值填进去 |
| 创建项目时加速区域默认「含中国大陆」 | 在腾讯云 EdgeOne 控制台改成「全球可用区(不含中国大陆)」,否则需要备案 |
| 创建项目页显示的提交号和仓库里的不一致 | 腾讯云 EdgeOne 控制台显示差异(原因不明)。以部署记录里的提交号为准 |
| DNS 主机记录或记录值少一个字母 | 手打或复制时没选全(实际测试时遇到两次)。用腾讯云 EdgeOne 控制台的复制按钮复制;在阿里云云解析 DNS 控制台「解析变更确认」里逐字核对后再确定,见卡 12 |
| 证书页没改就保存,https 打不开 | 证书配置默认「不配置」。在腾讯云 EdgeOne 控制台改选「申请免费证书」再保存 |
| 域名删除后重新添加,https 打不开 | 证书配置随域名一起被删了。在腾讯云 EdgeOne 控制台重新「申请免费证书」,几分钟恢复;DNS 记录不用重做 |
7询盘表单出问题时
| 现象 | 怎么办 |
|---|---|
| 提交后跳到 "Message not sent" 页面 | 邮箱发信失败(发信设置错、授权码失效、改过邮箱密码等)。页面会给出公司邮箱,买家仍可直接邮件联系;按卡 16 在腾讯云 EdgeOne 控制台检查三个设置、在 QQ 邮箱网页版检查授权码,重新生成授权码后要更新设置并重新部署 |
| 在本机双击打开的预览里提交表单没反应 | 本机预览提交不了,属正常。用你电脑的浏览器打开预览网址或正式网址试,见卡 16 |
8资料里出现敏感信息时
| 现象 | 怎么办 |
|---|---|
| 资料里出现能识别到具体个人的敏感信息 | 放资料前把敏感信息删除或打码,未处理的敏感资料不放入资料文件夹(见卡 1) |
这张卡是查阅用的,遇到新现象会持续补进来;条目里没有的情况,把提示原文发给 AI 是最快的出路。相关卡:卡 11 看历史与撤销、卡 16 询盘表单收件。