Agent Old Photo Workflow：面向智能体的老照片修复自动化工作流

一个专为 AI 智能体设计的本地老照片修复工作流，支持照片提取、校正、修复和上色，兼容 CodeFormer、GFPGAN、Real-ESRGAN 和 DDColor 等主流模型。

• 原作者/维护者：gaofeng21cn
• 来源平台：github
• 原始标题：agent-old-photo-workflow
• 原始链接：https://github.com/gaofeng21cn/agent-old-photo-workflow
• 来源发布时间/更新时间：2026-06-09T00:46:04Z

原作者与来源

• 原作者/维护者：gaofeng21cn
• 来源平台：github
• 原始标题：agent-old-photo-workflow
• 原始链接：https://github.com/gaofeng21cn/agent-old-photo-workflow
• 来源发布时间/更新时间：2026-06-09T00:46:04Z 原作者与来源\n\n- 原作者/维护者: gaofeng21cn\n- 来源平台: GitHub\n- 原始标题: agent-old-photo-workflow\n- 原始链接: https://github.com/gaofeng21cn/agent-old-photo-workflow\n- 发布时间: 2026-06-09\n\n项目背景与设计理念\n\n在 AI 技术快速发展的今天，老照片修复已经从专业工作室的专属服务变成了普通用户可以触及的技术。然而，现有的解决方案往往存在两个极端：要么是功能单一的工具脚本，需要用户手动串联多个步骤；要么是复杂的图形界面软件，难以与自动化流程集成。Agent Old Photo Workflow 的诞生正是为了填补这一空白——它提供了一个专为 AI 智能体设计的、端到端的本地自动化工作流。\n\n这个项目的核心理念是"Agent-first"，即从设计之初就考虑到 AI 代理的操作需求。它不是一个面向普通用户的图形界面工具，而是一个脚本化的、可编程的管道，让智能体能够通过简单的命令调用复杂的图像处理流程。这种设计哲学与当前 AI 代理生态系统的发展趋势高度契合，为自动化照片处理提供了理想的基础设施。\n\n工作流程与技术架构\n\n四阶段处理管道\n\nAgent Old Photo Workflow 将老照片修复过程分解为四个连贯的阶段：\n\n提取与校正（Rectification）: 对于用手机拍摄的纸质老照片，第一步是检测照片边界并进行几何校正，消除透视变形。系统会自动识别照片中的矩形区域，将其矫正为标准的正面视角。\n\n清理（Cleanup）: 在校正后的图像基础上，系统会去除纸张边缘、背景杂物以及拍摄过程中引入的高光反射等干扰因素。项目提供了保守和强力两种清理配置文件，用户可以根据照片状况选择合适的强度。\n\n修复（Restoration）: 这是核心的图像增强阶段，系统集成了多种业界领先的修复模型：\n- CodeFormer: 专注于人脸修复和细节重建\n- GFPGAN: 针对真实人脸照片的高质量复原\n- Real-ESRGAN: 通用的超分辨率重建模型\n\n上色（Colorization）: 对于黑白照片，可选的 DDColor 模型可以自动为其添加自然的色彩。系统支持多种 DDColor 变体，包括针对印刷品优化的轻量级模型。\n\n运行时架构设计\n\n项目采用了清晰的分层架构，将代码仓库与运行时数据分离。重型资源如上游代码库、模型权重、输入输出文件都存储在用户数据目录而非 Git 仓库中：\n\n- macOS: ~/Library/Application Support/agent-old-photo-workflow\n- Linux: ${XDG_DATA_HOME:-~/.local/share}/agent-old-photo-workflow\n- Windows: %APPDATA%/agent-old-photo-workflow\n\n这种设计带来了几个显著优势：首先，Git 仓库保持轻量，只包含编排逻辑；其次，用户可以轻松管理多个工作区，通过环境变量 OLD_PHOTO_HOME 切换不同的项目；最后，私有照片和大型模型文件不会意外进入版本控制，保护了用户隐私。\n\n使用方式与接口设计\n\n命令行接口\n\n项目提供了简洁的 shell 脚本作为入口点，支持单张处理和批量处理两种模式：\n\nbash\n提取并修复单张照片\nbash run_extract_restore.sh "/path/to/photo.jpg" ./output codeformer\n\n提取、修复并上色\nbash run_extract_restore_colorize.sh "/path/to/photo.jpg" ./output codeformer\n\n批量处理整个目录\nbash run_extract_restore_colorize.sh ./input ./output codeformer\n\n\n环境配置与模型管理\n\n项目通过环境变量提供灵活的配置控制：\n\n清理强度控制: EXTRACT_CLEANUP_PROFILE=strong 可以启用更强的清理效果，适用于污渍较重的照片。\n\n模型切换: DDCOLOR_MODEL=ddcolor_paper_tiny 允许用户选择不同的上色模型。如果切换到尚未预下载的模型，只需重新运行 setup_env.sh 即可自动获取。\n\n调试支持: BATCH_EXPORT_INTERMEDIATES=1 会在批量处理时导出中间产物，方便用户检查提取和清理阶段的效果。\n\n智能体操作规范\n\n项目文档中特别强调了针对 AI 智能体的操作规范：优先使用根目录的脚本而非直接修改上游代码；将私有照片和输出放在被忽略的目录中；当行为变更时更新测试用例。这些规范确保了智能体能够以可预测、可复现的方式操作工作流。\n\n技术依赖与许可说明\n\nAgent Old Photo Workflow 本身是一个轻量的编排层，其能力来自于整合多个优秀的开源项目。这种模块化设计让用户可以受益于各个领域的最新进展，同时保持接口的稳定性。\n\n需要注意的是，CodeFormer 采用了非商业许可协议，这意味着基于该项目构建的解决方案在商业使用时需要特别注意合规性。项目文档中的 THIRD_PARTY.md 详细列出了所有依赖组件的许可信息，为用户的合规评估提供了便利。\n\n适用场景与用户价值\n\n个人用户的数字化记忆\n\n对于希望将家庭老照片数字化的个人用户，这个工作流提供了一条从拍摄到成品的完整路径。用户只需用手机拍摄纸质照片，剩下的校正、修复、上色都可以自动完成。\n\n档案馆与博物馆\n\n文化机构通常拥有大量的历史照片需要数字化处理。这个工作流的批量处理能力和可配置性使其适合集成到机构的工作流程中，同时本地运行的特性保护了敏感历史资料的隐私。\n\nAI 代理集成\n\n作为"Agent-first"设计的项目，它天然适合作为 AI 代理的工具链组件。代理可以通过简单的命令调用复杂的图像处理流程，无需理解底层的模型细节。\n\n项目现状与未来展望\n\n目前项目已在 macOS Apple Silicon 和 Python 3.10 环境下完成验证，这是当前 AI 开发者的主流配置。项目结构清晰，文档完善，包含贡献指南和智能体操作契约，显示出良好的治理水平。\n\n随着多模态 AI 技术的发展，老照片修复领域将持续演进。Agent Old Photo Workflow 的模块化架构使其能够相对容易地集成新的模型和技术，保持与前沿进展的同步。对于希望构建照片处理自动化流程的开发者来说，这是一个值得关注的开源项目。