← 返回栏目

从能访问到愿意写:我与 AI 一起完善个人网站的一天

今天,我继续完善自己的个人网站 Ethan Cloud,也叫“Ethan 智控”。

今天,我继续完善自己的个人网站 Ethan Cloud,也叫“Ethan 智控”。

网站已经能访问了,但真正开始发布文章后,我发现:把网站部署上线,只完成了建站的一部分。接下来更实际的问题是——我以后怎么写、怎么改、怎么把内容放上去?

这一天,我和 AI 助手围绕这些问题反复讨论、操作、测试,也遇到了报错和判断失误。网站就在这些来回中,从一个可以访问的页面,慢慢变成了一个我能自己使用的写作空间。

网站上线以后,我首先需要的是方便

最初,我关注的是网站有没有部署成功、域名能不能打开、页面显示是否正常。

等这些基本问题解决后,我很快有了新的要求:

“我以后要怎么编辑后台,增加内容,要方便的方法。”

我不希望每发布一篇文章,都要重新学习文件放在哪里、标题怎么填、如何上传,以及提交之后还要点什么。

对开发者来说,这些步骤可能很熟悉。但作为网站的使用者,我更在意的是:能不能把精力放在文章本身,而不是每次都处理一遍发布手续。

于是,我们开始完善内容草稿助手。

它的作用是把文章整理成网站能够识别的 Markdown 文件,并协助提交到 GitHub。文章仍然保存在代码仓库里,修改有记录,也可以回看历史版本。

第一篇文章,让我看到了实际使用中的问题

我先尝试发布了一篇记录自己如何建设个人网站的文章。

从上传文件、创建 Pull Request,到合并修改,我跟着页面一步一步操作。这个过程让我理解了网站内容是怎样进入仓库,再经过构建部署显示出来的。

但我也发现,流程虽然能走通,操作仍然有些繁琐。

于是,我又提出了一个更直接的想法:

“我能一键发布到 Git 吗?在助手里自动提交,包括自动填写一些内容,我要一项一项填写太麻烦。”

这句话也让后续完善的方向变得清楚:让助手多处理一些重复工作,让我少填写一些可以从文章中提取的信息。

例如,从第一行提取标题,从正文首段建议摘要,自动补上日期和文件名,再由我核对。

这些自动填写的内容是建议,不能替我判断文章中的事实。尤其涉及实验结果、软件功能或资源许可时,仍然需要自己确认。

为了自动提交,我们接上了独立发布服务

为了让草稿助手能够连接 GitHub、提交文章,我们配置了一个独立的 Cloudflare Worker,并创建、安装了对应的 GitHub App。

这部分并没有一次成功。

我遇到了 GitHub 授权页面返回 404,也遇到了授权后返回报错。后来页面给出了更明确的提示:

“GitHub 拒绝客户端凭证,请核对 Client ID 与 Client Secret 是否属于同一个 App。”

配置过程中,我还分不清“客户端密钥”和“密钥对”应该选哪一个。

这些名称看起来相近,实际用途却不同。对第一次操作的人来说,仅仅说一句“把密钥配置好”,远远不够。需要明确指出在哪个页面、选哪个项目、填写到什么位置。

经过排查和调整,助手终于显示:

“已连接 GitHub:paowsun。”

随后,我提交了一篇简短的测试草稿,仓库中成功出现了对应的 Pull Request。

到这一步,自动提交的流程才算有了实际验证。

这里也有一个需要记住的区别:提交到 GitHub,不等于文章已经公开。 当前助手会创建新分支和 Pull Request,后续还需要检查、合并及部署;文章如果保留草稿状态,也不会出现在网站上。

功能通了,界面也要让我愿意用

测试成功后,我又发现了另一个问题:

“内容草稿界面有点难看。”

这并不是一个无关紧要的问题。写作工具是以后要反复打开的地方,如果标题过大、提示框占满屏幕、按钮样式不统一,即使功能齐全,也会让人觉得费劲。

我们接着调整了界面:

  • 电脑端左侧写作,右侧核对与提交;
  • 手机端按上下顺序排列;
  • 缩小标题和提示文字,统一输入框与按钮;
  • 把较长的操作说明放进折叠区域。

这次调整没有改变文章的存储方式和提交流程,主要是让操作顺序更清楚。

我希望打开助手时,首先看到的是可以开始写作的地方,而不是一大页需要先读完的说明。

一个短网址,也值得认真做好

新版助手部署后,它的地址很长,是一串带有 workers.dev 的网址。

我觉得记不住,于是提出:

“草稿助手的网址太长了,记不住,像 https://ethancloud.cn/write/ 这个好记。”

这个需求很小,却关系到以后是否方便使用。

第一次调整后,AI 助手根据部署成功的结果,告诉我短入口已经可以使用。但我打开后,看到的仍然是旧版草稿页面。

于是,我把两个页面的截图发了回去:

“不对。”

这一次,截图提供了比“部署成功”更直接的证据:新版助手存在,但短入口没有把我带过去。

随后,我们补上了页面跳转和手动入口,并增加了浏览器测试。再次部署后,我实际打开确认,才回复:

“可以打开。”

这件事让我印象很深。构建成功、部署成功和用户实际使用成功,是不同层面的结果。前面的检查很必要,但最后仍然要回到真实的访问和操作。

我和 AI 的分工,也在今天变得更清楚

今天的合作,并不是我一次说清所有要求,AI 就把整个网站完成了。

更多时候,是我先使用,再表达感受:

“太麻烦。”
“有点难看。”
“网址太长。”
“不对。”

这些话不算技术规格,却是真实的使用反馈。

AI 助手负责把反馈转成具体修改:调整界面、补充跳转、检查代码、运行测试、整理说明。我则负责表达需求、操作账号配置,以及确认最终结果是否符合自己的预期。

这个过程让我感受到,和 AI 一起做网站,需要持续沟通,也需要自己参与判断。尤其是涉及账号授权、文章事实和实际使用效果时,不能只看一句“已经完成”。

留下说明,才能在以后继续使用

我还反复提出了一个要求:

“保留记录 Markdown,一定要给我说明文件,要不我不会。”

我希望网站的建设过程能够留下来。过一段时间再回来,我仍然知道怎样新增文章、修改内容、检查发布结果,以及遇到问题时应该从哪里开始看。

所以,操作手册和连续记录也是今天建设的一部分。

一个工具只有在我离开对话后仍然会用,才真正帮到了我。

接下来,把注意力逐渐放回内容

今天,我们完成了一些具体的事情:测试文章提交、排查 GitHub 登录、改善写作界面,并让一个好记的入口能够打开新版助手。

以后,我可以从这里开始:

https://ethancloud.cn/write/

网站还会继续完善。但接下来,我更想把时间逐渐放回内容:记录技术实践、阅读中的思考,以及自己的想法如何一步步发生变化。

这篇文章,就是今天的一次记录。

我希望以后回看它时,能记得 Ethan Cloud 是怎样在一次次提问、尝试、报错和确认中,慢慢变成自己能够持续使用的网站的。