博客优化 TODO

P0：定位与基础体验

• 明确博客定位为“AI Agent、LLM 工具链与开发效率实践”。
• 将首页占位标题替换为博客定位、目标读者和一句简短介绍。
• 统一站点语言：将 About、Archives、Categories、Tags、Read More 等改为中文。
• 修正站点标题 Liu Yiyi ' s Blog 的拼写与空格。
• 将基础字号从 14px 调整为 16–17px，正文行高调整为 1.75–1.9。
• 使用适合中文的系统字体栈，如 system-ui, "PingFang SC", "Microsoft YaHei", sans-serif。
• 将文章正文最大宽度限制在 720–780px，改善长文阅读体验。
• 缩小首页 Banner：桌面端约 360–440px，移动端约 220–280px。
• 为 Banner 增加稳定的暗色遮罩。
• 将 Banner 图片压缩为 WebP/AVIF。

P1：内容体系

• 将一级分类控制在 4–6 个：AI Agent、Claude Code、LLM 应用开发、开发环境、教程与踩坑、项目案例。
• 使用标签描述具体技术，如 LangGraph、LiteLLM、WSL、Neovim。
• 建立专题系列，用于组织相关主题文章。
• 为系列文章增加系列目录、上一篇和下一篇入口。
• 统一技术文章发布结构：问题、适用场景、最终效果、操作步骤、常见错误、总结，并提供 _templates/post.md 模板。
• 在文章开头注明运行环境、软件版本和最后更新时间。
• 清理 _posts/ 中的图片、INI、Notebook、测试文件和不规范命名文章，分别移至 assets/、草稿或示例目录。
• 重写“关于”页面，突出个人方向、代表项目、实践成果和联系方式。

P1：首页与文章页设计

• 将首页重构为“作者简介 + 精选文章 + 最新文章 + 专题入口”。
• 优化文章列表层级：突出标题，弱化元信息，摘要限制为 2–3 行。
• 统一日期、阅读时间、分类和标签的展示方式。
• 将所有文章都显示的 NEW 改为仅最近 30 天发布的文章显示。
• 为标题、卡片和按钮补充统一的悬停与键盘焦点反馈。
• 文章页增加发布日期、更新时间、阅读时长和目录。
• 为文章增加所属专题信息。
• 为代码块增加语言标识、复制按钮和一致的明暗主题。

P2：视觉系统与细节

• 确定一个主强调色，减少默认橙色、黑色和多种灰色混用。
• 统一标签、按钮、引用块和代码块的圆角、边框、阴影与间距。
• 建立统一的标题字号、段落间距和页面留白规则。
• 提高浅灰文字与背景的颜色对比度。
• 为所有有信息意义的图片补充准确的 alt 文本。

验收

以下验收工作按当前要求跳过，不计入实施进度：

• 运行 bundle exec jekyll build。
• 本地检查首页、文章页、分类、标签、归档和关于页面。
• 使用键盘完成主要导航，并检查移动端和深色模式。
• 检查深色模式下正文、链接、代码块、表格和目录的可读性。
• 在桌面和移动端检查导航、长标题、宽表格、代码块及大图。
• 保留修改前后截图进行对比和评审。

后续：Chatbot 安全改造

• 将 Chatbot 定位调整为“问这篇文章”，统一中文文案和博客视觉。
• 在不依赖后端时提供文章概览、目录、关键词检索和相关文章功能。
• 决定保留浏览器直连 DashScope 方案：Key 随页面公开（_config.yml 的 chatbot_api_key），靠阿里云侧限流和额度控制风险，不部署 Worker 代理。若未来要隐藏 Key，再引入代理即可。

进行中：内容质量

• 下线没有正文的空文章，移入草稿目录。
• 删除医疗 Agent 文章尾部的重复和残缺内容。
• 修正 Claude Code 配置文章的病句、口语化说明和示例一致性。
• 统一旧文章的标题、术语、摘要和章节结构。
• 核对技术文章中的外部链接、命令和版本时效性。
• 为核心文章补充“结果验证”和“常见错误”章节。