- 摘要：
我用 SOLO 把一份原本只是内容笔记的 Hugging Face 讲稿，整理成了结构清晰、可直接预览和分享的课程网页。
这次重点不是"生成一堆花哨页面"，而是让 AI 帮我把内容重组、套入模板、完成编译，并顺手定位了字体混排问题，让最终成品更稳定可复用。
- 背景：
我平常会整理教学内容和技术讲稿，手上常有一些已经写好的 Markdown 或笔记，但这些内容通常只适合自己看，不适合直接拿去分享。
这次我的目标很明确：不是重写一篇长文，而是把一份现成讲稿快速转成网页，并确认模板能稳定生成、能预览、能继续迭代。
- 实践过程：
我先把任务拆成 4 步：
- 读取原始讲稿内容
- 按现有课程页模板改写成结构化 Markdown
- 生成课程专属配置并编译 HTML
- 检查实际页面效果，修掉显示问题
这次我主要用了 SOLO 做几件事：
- 先理解项目里现有的 Skill 和 build 流程
- 读取原始讲稿，判断它不符合模板要求的结构
- 自动生成新的课程目录、
content.md、config.yaml - 调用构建脚本产出网页和 OG 图
- 根据页面截图继续定位样式问题
关键操作思路是：
我没有让 AI 从零"自由发挥做网页"，而是先让它遵守项目已有模板，把内容转成模板能识别的章节、卡片、流程和总结区块。这样后续可维护性更高，也比较适合重复使用。
这次实际落地的过程里，有几个关键点：
- 先保留原始讲稿不动，另外建立
example/huggingface-course/ - 把原稿整理成更适合课程页展示的结构化内容
- 生成
index.html后启动本地预览，直接看真实渲染结果 - 发现标题里中文和英文大小看起来不一致后，再回头查模板
中间踩到的坑也很典型：
- 当前终端环境里
node不在 PATH，导致一开始 build 失败
解决方式：直接用 Node 的绝对路径执行构建脚本 - 项目目录当时不是标准 git repo，没有
origin，所以seo.url和seo.image没法自动推导
解决方式：先留空，不阻塞页面产出 - 页面标题出现"中英混排大小不一致"
最后定位到不是字号写错，而是模板里用了Noto Serif TC / Noto Sans TC，在简体中文场景下触发了字型 fallback，造成视觉比例不一致
解决方式：统一改成简体中文优先字型，并补上系统 fallback，同时同步调整网页模板和 OG 生成器，避免页面和分享图表现不一致
- 成果展示：
最终产出包括：
- 一份结构化课程内容：
example/huggingface-course/content.md - 一份课程配置：
example/huggingface-course/config.yaml - 一个可直接预览的课程网页：
example/huggingface-course/index.html - 一张自动生成的 OG 图：
example/huggingface-course/assets/og-image.jpg
这次成果的价值不只是"生成了一个网页"，而是把流程跑通了：
- 原始讲稿可以转成模板化课程页
- 模板问题可以继续通过 AI 协助定位
- 后续换别的讲稿，也能沿用同一套工作流继续产出
如果要对外展示，建议附上：
- 网页截图
- 课程页链接
- 仓库链接
- 对比图：原始 Markdown vs 最终网页
- 效果与总结：
这次最明显的提升，不是省了多少分钟，而是把"讲稿整理 + 页面生成 + 样式排查"变成一条连续流程。
以前这类工作很容易卡在中间：内容有了，但页面结构不统一；页面出来了，但细节不好改；改样式时又要重新找模板逻辑。现在 SOLO 帮我把这些环节接起来了。
我觉得这次最值得复用的方法有两点：
- 不要让 AI 直接自由生成最终页面，而是先让它对齐模板和内容结构
- 遇到渲染问题时，不只问"怎么改"，而是让 AI 先定位原因，再决定修模板还是修内容
如果用一句话总结：
SOLO 在这次流程里最有价值的地方，不是替我"写完所有内容"，而是帮我把已有内容快速变成一个可发布、可验证、可持续修改的成果。
