术语表
1AI 工具与任务
- WorkBuddy:装在你电脑上的 AI 助手软件(腾讯出品,官网)。你全程在它的对话框里用日常中文说话,AI 负责整理资料、生成网站、保存和发布。
- 任务:你在 WorkBuddy 里和 AI 的一次工作会话。卡片里说「在同一任务里告诉 AI」,就是继续在原来那个对话框里说,不要另开新的。
- 工作区:WorkBuddy 干活时打开的文件夹,本课程里就是你的网站模板文件夹。
- 加量包:WorkBuddy 单独购买的积分包(1,000 积分/50 元),只有付费会员能买,体验版不能买。
- 积分:WorkBuddy 的使用额度,像手机话费,AI 每做一次事扣一点。任务界面里能看到「预计消耗」和「已消耗」。体验版每月送 500 积分、当月清零,够不够用见费用与额度。
- 终端:电脑上输入命令的黑窗口。整个课程你都不需要打开它,所有事都在 WorkBuddy 对话框里说。
- 权限弹窗:WorkBuddy 要做敏感操作时弹出来问「允许 / 拒绝」的窗口。只看弹窗里的「当前命令」:是
tools/site_version.py 就选「允许写入」,是其他任何命令就选「拒绝」并停止任务(见卡 15)。
- 钥匙串(login.keychain):macOS 自带的「密码保险箱」。第一次登录 Gitee 成功后,密码存进这里,以后保存、发布都不用再输密码。
- 内容确认单:AI 整理完你的资料后生成的清单,让你逐条过目、提意见;里面标「请提供依据,否则删除」的条目,有材料就补,没有就同意删。照确认单写出的网站内容底稿叫《内容草稿》。
2云端仓库与版本
- 云端:服务商在互联网上替你保管文件的电脑,换台电脑登录也能拿到。和你自己电脑上的文件相对。
- Gitee:一个把文件存在云端的国内网站,本课程网站文件的「家」就放在这里。
- Git:一套按版本管理文件的技术,每次改动都会留一条记录,随时能查、能退回。Gitee 就是基于 Git 的网站。
- 仓库:云端存放网站文件和全部历史版本的文件夹,像网站的档案室。
- 私有仓库:只有你自己账号能看到的仓库。网站仓库必须选「私有」,否则文件任何人都能看到。为什么选私有:网站内容和版本记录不对外公开,只有你授权的平台能读取。
- 开源:Gitee 建仓库时「所有人可见」的那个选项,和「私有」相对。建网站仓库时不要选它。
- 个人空间地址:注册 Gitee 时填的英文用户名,它就是你的登录名,还会出现在仓库网址里。「姓名」只是显示用的,不是登录名。
- 登录名:登录 Gitee 用的账号,是个人空间地址,不是「姓名」;填错会连接失败。
- 同步:把你电脑上的改动传到云端仓库。同步失败时改动还在你电脑里,过一会儿再说「保存到云端」就行。
- 推送:把文件传到云端仓库的动作,卡片里和「同步」是一个意思。
- 草稿(draft):修改后保存、但还没发布的版本,只有你和本机预览、预览网址能看到,正式网站没变。WorkBuddy 输入框下方显示的 draft 就是当前分支名,不用管。为什么分草稿和正式两套:改完先在预览里自己确认,说「发布」才推到正式网站,错的内容不会被访客先看到。
- 分支:仓库里互不干扰的平行线。本课程里,修改先存在 draft(草稿)这条线上;正式网站用的是 main 这条线,发布就是把草稿的内容放到正式网站上。
- 版本:网站某一次保存下来的完整样子。每次修改、撤销都会留下一个版本,随时能查、能退回去。
- 提交(提交号、提交信息):一次记录在仓库里的保存。提交号是这条记录的编号,提交信息是 AI 写的版本说明——在部署列表里靠它对出哪条记录是哪一版。
3部署与发布
- 发布:把草稿变成正式网站。草稿里所有未发布的修改会一起上线,外面的访客马上看到新内容,所以只在确实要更新时才说「发布」。
- 部署:EdgeOne 把你仓库里的文件变成对外能打开的网站的过程,每次部署都留一条记录可查。为什么保存后要等一下:平台要重新生成网站文件并分发出去,所以列表里会先显示构建中、几秒到几十秒后变成功。
- 自动部署:一个开关,打开后每次保存草稿都会自动生成一条「预览」部署,不用你手动操作。预览环境的自动部署默认是关的,卡 8 里要手动打开。
- 预览环境:和草稿对应的一套网站,只有拿到预览网址的人能看,用来在发布前检查效果。
- 生产环境(生产):和正式网站对应的一套网站,访客在正式网址看到的就是它。
- 版本回滚:EdgeOne 控制台里的应急操作,让正式网站马上回到上一个版本,10 秒左右生效。只能退回最近 3 次成功发布;更早的记录显示「已失效」,要退那么远就用卡 11。
- EdgeOne:腾讯云的一个服务,负责把网站部署好、让外面的访客能打开。正式网址和预览网址都由它管。
- Makers:EdgeOne 里的项目列表,你的建站项目在这里创建和管理。
- webhook:授权时要保留勾选的一项,作用类似「捎个话」:仓库一有更新,Gitee 自动通知 EdgeOne 去部署,不用你盯着。
- 授权(同意授权):你允许 EdgeOne 去读你的 Gitee 仓库,类似把档案室的钥匙交给它。按卡 8 只保留「项目」和「webhook」,把「组织」「企业」「邮箱」取消勾选。
- 构建:EdgeOne 部署前把你的网站文件「加工」成成品的一步,日志里各阶段显示完成就说明成功。
- 构建命令(编译命令):告诉 EdgeOne 怎么加工文件的那条指令,按卡 8 原样填入。两个名字是同一项。
- 框架:构建设置里的一个选项,按卡 8 选 Other 就行,不用理解它。
- 根目录:告诉 EdgeOne 从仓库的哪一层开始加工,按卡 8 填
./(就是最外层)。
- 输出目录:加工好的成品网站放在哪个文件夹,按卡 8 填
网站。
- main:正式网站用的分支名。卡 8 里「生产分支」一栏就填 main,一个字母都不要差。
4域名与安全
- 域名:打开网站用的地址,比如 www.公司域名。买域名一般在阿里云这类服务商。
- 实名认证:国内买域名必须做的身份登记,免费,一般几个工作日审核;不做域名会被锁定、打不开。
- 子域名:在主域名前面加个前缀分出来的地址,比如 www.公司域名、preview.公司域名,可以分别指向不同的网站。
- 正式网址:访客看正式网站的地址。平台自带的
….edgeone.dev 地址在中国大陆打不开,所以要用卡 12 绑定自己的域名。
- 预览网址:看草稿效果的地址,绑好 preview 子域名后才有,可以发给同事在手机上看。
- DNS:互联网「电话簿」,把域名翻译成网站真正所在的服务器地址。DNS 没配好,域名就打不开网站。为什么改了记录要等生效:新记录需要一点时间同步到各地的「电话簿」,通常几分钟内。
- 云解析:阿里云管理 DNS 的控制台,卡 12 里的 TXT、CNAME 记录都在那里添加。
- DNS 记录:电话簿里的一行设置,写明某个域名指向哪里。卡片里的原则是只新增记录,不改、不删已有记录。
- 主机记录:添加 DNS 记录时填的「前缀」部分,正式域名填 www,预览域名填 preview。
- 记录值:添加 DNS 记录时填的「内容」部分。一定用复制按钮复制粘贴,并在确认弹窗里逐字核对,实际测试时手打和复制都漏过字母。
- TXT 记录:一种 DNS 记录,这里用来向 EdgeOne 证明这个域名归你所有。
- CNAME 记录:一种 DNS 记录,作用是把你的域名指向 EdgeOne 给的地址;加好并生效后,域名才能打开网站。
- 备案:网站放在中国大陆时国家要求的登记手续,需要时间。加速区域选「不含中国大陆」就不用备案。
- 加速区域:EdgeOne 里选网站面向全球哪些地方提供服务的选项,默认「含中国大陆」,必须改成「全球可用区(不含中国大陆)」。
- HTTPS:加密方式打开网站,地址以 https 开头,浏览器会显示一把锁,访客的信息更安全。没有证书时 https 打不开。
- 证书(边缘 HTTPS 证书):网站的「身份证」,证明 https 网站的身份。卡 12 里申请的是免费证书,会自动续签,不收费。
5邮箱与询盘表单
- 询盘:买家在网站表单里留下的联系消息,带姓名、邮箱、公司和留言,会发到你的客服邮箱。
- SMTP:邮箱的「寄信服务」。网站就是借你邮箱的 SMTP 把询盘寄给客服邮箱的。
- 授权码:邮箱生成的一串字符,代替登录密码让网站替你寄信。只填在 EdgeOne 控制台里,不截图、不写进文件、不发给任何人(包括 AI)。
- 环境变量:EdgeOne 项目里保存的一行行设置,卡 16 的三个发信设置就填在这里。改了要等下一次部署才生效。
- 掩码:控制台把设置值用「打码」方式显示,防止截图泄露授权码。看到掩码是正常的,不是没填进去。
6网站本身
- 网站模板:我们准备好的半成品文件夹,AI 在它里面填入你的内容、生成你的网站,不是从零开始做。
- 风格:一套预先设计好的网站外观(配色、按钮、版式的整体感觉),卡 4 里有 6 套可选。
- 主色:网站的主打颜色,比如按钮和标题用的那种颜色,可以直接说「用 Logo 的蓝色」。
- 本机预览:WorkBuddy 界面右侧直接显示的网站效果,只有你这台电脑能看到。本机预览里提交询盘表单没反应,属正常;要用预览网址或正式网址试。
相关卡:卡 0 开始前、卡 15 故障处理。