DD Photos 相册站点生成

要解决的问题

当你已经按活动或项目把照片整理进文件夹，下一步通常是找一个相册系统。常规路线要么接入数据库后端，要么依赖图床或第三方相册应用，部署与运维成本都不低，导出结果也很难稳定放在自己的域名下。这个技能做的是另一件事：把现成的照片目录直接编译成静态相册站点，没有服务端、没有数据库，产物只是一组可以扔到任意静态托管上的文件。

它的工作方式

技能的核心是 ddphotos 工具，配合一份配置文件和源照片目录。典型流程是：

• 声明照片存放位置与必要的 DD Photos 配置；
• 运行 ./ddphotos run 启动本地预览，开发服务器监听 http://localhost:5173，可以先确认版式和移动端表现；
• 调用 photogen 生成静态产物。工具默认处于 dry-run 模式，不会真的写文件，只有显式带上 -doit 参数才会落盘，因此可以先检查输出再决定是否提交；
• 生成完成后，把静态文件上传到 S3 或任意 Web 服务器即可对外访问。

适用边界与注意点

它不是一套通用的图片管理系统。源目录的组织方式会直接影响生成结果，前期的照片挑选与排序仍然需要人工完成；配置文件需要手动维护，换一批照片或调整目录结构后可能需要重新生成。适合的场景是照片已经筛选完毕、只需要一个可分享的静态站点；如果需要搜索、鉴权、评论之类的交互能力，这个方案覆盖不到。