# AI 个人博客建站任务书 这是可独立使用的执行文件。请先检查工作目录、现有项目、工具和权限，然后主导完成个人博客。普通技术选择、文件操作、命令、排错与验证由执行 AI 负责；不要把已经能够完成的工作拆成逐步操作题交还用户。交付应包括实际可用的结果、验证记录与后续维护方法。 ## 一、默认目标与权限 默认建立中文阅读博客，先完成首页、文章列表、第一篇文章和手机阅读，后续按真实需求扩展。已有项目先读取适用的项目约定、真实代码和数据位置，保留用户及其他维护者的改动，延续已有技术栈；不覆盖原有服务配置、端口、域名、文章链接或运行时数据。 新建且要求免费、无本地开发环境时，默认使用 GitHub Free 公开仓库、GitHub Pages 分支发布、Jekyll 与 Minima 主题，以及用户自带的 github.io 地址。公开仓库中的源文件也会公开。 能操作文件、浏览器或 GitHub 的工具，按用户已授权范围执行。常规技术问题由你检查实际环境与官方资料后决定，只有必要的账号信息、素材、公开范围或真实权限无法确定时才提问。账号注册、邮箱验证与必须的本人登录由用户完成。若没有 GitHub 操作能力，先完成文件、预览与可执行的交付包，再明确指出尚缺的授权或本人操作；不要把只有本地文件称为已经上线。 不要求购买服务器、域名或 AI 订阅。AI 免费额度及外部服务条件随平台变化，不承诺无限使用。用户选择数据库后台、付费服务或自定义域名时，重新说明部署条件与费用范围。 ## 二、免费起步文件：可以直接创建 以下为三个文本文件，不需要读者安装 Ruby、Node 或命令行工具。日期示例是已过去的日期，用于让第一篇文章出现在列表里。 ### _config.yml ```yaml title: 我的博客 author: 你的昵称 description: 这里记录想法、学习和生活。 theme: minima lang: zh-CN timezone: Asia/Shanghai show_excerpts: true minima: date_format: "%Y-%m-%d" plugins: - jekyll-feed ``` ### index.md ```markdown --- layout: home title: 首页 list_title: 最新文章 --- 欢迎来到我的博客。 这是起步示例。先打开下面的第一篇文章，再把这里换成自己的介绍。 ``` ### _posts/2026-01-01-hello-world.md ```markdown --- layout: post title: "第一篇文章（示例）" --- 这是博客的第一篇示例文章。能看到这段文字，说明文章页面已经生成。 ## 接下来写什么 可以写一次学习记录、一本书的想法，或者一件刚完成的小事。 编辑这份文件，保留最上面的文章信息，把下面的正文换成自己的内容即可。 ``` 压缩包顶层应直接是 _config.yml、index.md 与 _posts 文件夹。不要多套父目录，不把 ZIP 本身当作网站文件上传。可在用户提供内容后替换明确标出的示例文字。 ## 三、发布路径：由执行 AI 操作 1. 用户登录 GitHub 并验证邮箱，确认真实用户名。 2. 新建公开仓库，命名为 用户名.github.io，仓库名使用小写，初始化 README。若该仓库已存在，先检查已有内容，避免覆盖原站。 3. 通过 Add file → Upload files 上传三个文件，保留 _posts 目录结构，提交到默认分支。 4. Settings → Pages → Source 选择 Deploy from a branch；选择实际默认分支（常见为 main）和 /(root)，保存。 5. 查看 Actions 中本次 Pages 构建与部署结果，使用 Pages 页面显示的地址检查首页和第一篇文章。 6. 补齐实际站点 URL，确认订阅中的文章链接指向正确地址。向用户说明怎样改博客名和发布第二篇文章。 如果借助 CI 提交，请注意 GitHub 官方说明：使用 GITHUB_TOKEN 的工作流推送不会触发分支模式的 Pages 构建。按实际权限选择合适的发布方式，不能因为推送成功就认定网站已经更新。 ## 四、原型、规则与实现 1. 使用真实长度的中文标题、段落、图片、列表和代码块做首页与文章页原型。简单布局可使用 HTML，涉及框架时直接使用项目预览。不要只交一张无法操作的截图。 2. 检查阅读顺序、视觉层级和交互状态；允许用户用具体反馈调整。没有额外视觉要求时，由你选定适合阅读的默认样式并继续完成。 3. 把实际确认的配色、字体、正文宽度、间距、组件状态和手机规则写入 design.md；记录对应组件，避免不同页面各写一套。 4. 将实际目录入口、内容字段、环境与版本、启动命令、发布方式、数据位置和已知问题记录到项目说明。自动读取规则文件的名称以所用工具及现有项目约定为准。不要复制未经核实的通用模板，也不要覆盖现有规则。 5. 后续按一项完整功能推进，每项说明数据来源、执行位置、状态、更新与清理方法。搜索需考虑空输入、加载、无结果、失败和过期请求；页面切换需检查重复监听与计时器清理。 6. 文章先显示正文；播放器、3D、背景视频等额外资源按需加载，切页后停用不必要的绘图任务。手机端与减少动态效果偏好有轻量表现；仅用 CSS 隐藏不能作为没有资源开销的证据。 ## 五、需要更复杂的博客时 - 写作与作品展示优先采用简单内容模型。静态生成方案可评估 Astro 等工具，按实际文档检查环境和命令。 - 需要网页后台或多人编辑时评估成熟 CMS，同时说明应用服务、数据库和媒体保存方式。不要把需要动态后端的项目直接交给静态托管运行。 - 评论、账号、搜索和动画按需求加入。每项功能写明数据来源、执行位置、状态、更新时机和清理方式。 - 接手旧项目先分析实际结构，不直接重建，不把新建模板配置覆盖进已有项目。 ## 六、执行顺序 1. 检查现有项目、工具、授权与发布条件，确定用途和最小范围。需要时先准备本任务书中的默认文件，不强制替换已有路线。 2. 使用实际兼容版本启动预览，记录环境；做可浏览的首页与文章原型，检查电脑与手机。 3. 将已经采用的视觉与工程规则写入说明，再把原型接入正式组件；保持代码、内容与运行数据的边界。 4. 按明确需求实现功能，每次只推进可验证的改动。检查首次操作、刷新、换页返回和错误状态。 5. 执行对应的类型检查、构建和浏览器验证；对数据、权限和复杂状态补充行为测试，修复失败，不通过忽略报错来宣布成功。 6. 按已有授权发布；缺少权限时交付可继续的文件与具体点击步骤，不空等，不虚报上线。 7. 记录实际检查、未验证项、内容和数据位置、发布及恢复方式，教用户更新下一篇文章。 ## 七、最少验收 - 首页与文章能打开；中文标题和正文正常，图片与内部链接有效。 - 新增和修改文章后，列表与正文更新，启用的订阅、搜索和站点地图符合公开规则。 - 手机阅读不出现整页横向溢出，菜单可操作，控件有可理解名称。 - 检查宽屏和至少一种窄屏；必要时补查 320px 宽度。代码块可以在自身区域横向滚动，不应撑宽整页。 - 非必要资源不会阻塞正文；隐藏和暂停的功能分别核对请求、计时与绘图开销，保留用户主动开启的必要行为。 - 草稿和其他私有内容不误入公开入口；公开 GitHub 仓库不承担私有草稿的保密存储。 - 按修改范围运行必要的静态检查、构建或浏览器检查。普通外观变化不堆砌镜像测试。 - 有运行时数据的站点，分别保存代码、内容、媒体和数据库；需要时在隔离环境验证恢复。 - 所有通过结论有实际动作、输出或页面证据；未执行的项目标为未测。 ## 八、交付给用户与下一个 AI 交付网站地址或准确的本地位置、生成的文件包，以及一份简短说明：怎样写文章、放图片和发布。详细执行步骤、失败输出和恢复命令写入项目文档，供后续 AI 接手，不在交付消息中堆砌逐次命令记录。 交付记录至少包含：当前版本、实际访问地址、内容与数据位置、发布命令或工作流、保留约定、已执行检查、未验证项、回退与恢复方法。代码回退不等同于数据库恢复；数据变更应另行验证。 版本记录、环境或权限问题由执行 AI 处理；只有必要的真实账号信息、素材或公开范围无法确定时，才向用户提出具体问题。 修改既有配置时，先读取当前文件；如果只有聊天能力，要求用户粘贴原文，不能假定已经看见仓库。返回完整文件内容或清楚标明的改动，说明复制范围。指导用户在仓库顶层创建新文章路径，避免把 _posts 再嵌套一次。 ## 官方资料 - GitHub Pages 条件与默认地址：https://docs.github.com/en/pages/getting-started-with-github-pages/what-is-github-pages - 配置发布来源：https://docs.github.com/en/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site - 上传文件与文件夹：https://docs.github.com/en/repositories/working-with-files/managing-files/adding-a-file-to-a-repository - 支持的主题：https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/adding-a-theme-to-your-github-pages-site-using-jekyll - Jekyll 文章规则：https://jekyllrb.com/docs/posts/ 整理与规则核对日期：2026-10-16。实际上线以执行时账号权限、服务规则和本次构建结果为准。