博客仓库工作约定

处理本仓库的文章、配图或发布任务前，先阅读 agent.md，遵循其中的完整维护指南。以下配图规则是用户明确要求的默认流程，适用于新文章、未发布草稿和后续补图。

博客配图必须归档到 OSS

• 新增博客封面和正文配图时，生成或选定图片并验图后，必须按 agent.md 第十节上传到已配置的 OSS。文章仍在草稿阶段不构成跳过归档的理由；不要把“已生成并保存到本地”当作配图完成。
• 上传后验证公开 HTTPS 地址返回成功、Content-Type 正确、文件内容摘要与原图一致，并检查携带博客 Referer 的访问。全部通过后，博客 Markdown 才引用该 OSS 地址。
• 原图、生成提示词、图片版本和上传记录保存在仓库外的 ~/.local/share/tongchen-blog/oss/<文章 slug>/。凭据只从 ~/.config/tongchen-blog/.oss 读取，不写入仓库、文章、命令参数或日志。
• 对象名包含内容摘要，禁止覆盖；已有同内容素材先核对并复用。OSS 和本机归档均确认完整、正文引用已替换后，可以移除本次工作新增的仓库内重复图片，不清理无关或历史素材。
• OSS 配置缺失、上传失败或验证失败时，保留已有成果并明确说明归档尚未完成；不要悄悄改用 images/、临时路径或工具生成目录作为最终方案。只有用户明确要求使用本地素材时，才采用本地引用的例外流程。既有主题图标和历史文章不在此次规则的批量迁移范围内。
• 配图归档不等于发布文章。博客提交、推送、上线及微信公众号同步，仍按用户分别授权的范围执行。