Hugo 博客（曲奇的技术笔记）

线上：https://youxianquqi.github.io/
仓库：https://github.com/youxianquqi/youxianquqi.github.io

Book 侧栏布局；首页为技术关键词云（汇总文章/视频的 tags，重复标 ×N）。内容用 Markdown，无数据库；push main 后由 GitHub Actions 用 Hugo 构建并发布到 Pages。

路径	内容
/	关键词云首页
/posts/	文章
/videos/	视频列表（标题直跳 B 站）
/ai-exam/	AI 编程合格考试（static/ai-exam/）

快速启动

cd d:/PCCodes/blog/hugo-site
./bin/hugo.exe server -D -p 1313

浏览器打开 http://localhost:1313

常用命令

命令	说明
./bin/hugo.exe server -D -p 1313	本地预览
./bin/hugo.exe new posts/title.md	新建文章
./bin/hugo.exe new videos/title.md	新建视频
./bin/hugo.exe --gc --minify	生产构建（与 CI 一致）

目录结构

hugo-site/          ← git 根目录
├── config.toml
├── content/
│   ├── posts/
│   └── videos/
├── layouts/
├── static/
│   ├── css/style.css
│   ├── images/
│   └── ai-exam/
├── site/           ← 次元热度静态站存档（当前不作为 Pages 根）
├── AGENTS.md
└── bin/hugo.exe

完整约定见 AGENTS.md。