文档存储与照片自动化

每份 DS-160 表单都有两个文档槽位——一张申请照片和一份护照扫描件。你和你的客户都可以通过控制台或客户填表链接管理它们；当提交流程运行时，代理会自动将照片上传到美国国务院的照片提交系统。

1. 文档槽位

槽位	字段名	格式	大小上限	使用方
申请照片	`applicationPhoto`	JPEG	240 KB	代理将其上传至 DS-160
护照扫描件	`passportScan`	JPEG、PNG 或 PDF	10 MB	留存于你的档案中以供记录

每份表单的每个槽位最多保留一个有效文档。上传新文件会软删除旧版本——文件从对象存储中移除，元数据则保留用于审计追溯。

2. 客户在哪里上传

当你生成客户填表链接时，客户会在问卷旁看到一个文档步骤。他们可以：

拖放或选择文件到对应的槽位
在页面内即时查看校验结果（大小、格式、照片的基础生物识别检查）
替换或删除已上传的文件
在缺少文档时继续填写问卷——文档上传与表单的其他部分相互独立

客户永远看不到存储 URL 或任何机构凭证。身份验证仅限于其填表令牌；某一客户链接的上传操作无法触及其他表单上的文档。

3. 申请照片——我们检查什么

照片会经过与公开的美国签证照片检查器相同的校验器。硬性拒绝（上传失败）：

文件不是 JPEG，或大小不在 10 KB – 240 KB 范围内
像素尺寸不在 600×600 – 1200×1200 内，或长宽比不是正方形
图像不是 sRGB / 24 位色
JPEG 压缩比超过 20:1（过度压缩）
背景非以白色 / 米白色为主
未检测到人脸、检测到多张人脸、头部不在图像高度的 50–69% 范围内、闭眼，或为侧脸照（在启用人脸检测时）

提示性警告（上传成功，但客户会看到提醒）：

图像不是 300 DPI——仅对打印照片为必需（DS-260 移民签证、面对面面谈）；DS-160 数字上传不强制执行
图像若打印将不是 2×2 inches 大小——与 DPI 同样的语境
EXIF 元数据显示该照片可能超过六个月
图像保存为渐进式 JPEG
照片曝光不足或过曝，或对比度异常偏低
人脸未居中于画面内

警告文本会翻译为客户所选语言；你在审计日志中也会看到其语言版本的相同文本。

4. 护照扫描件——我们检查什么

校验器只检查文件外形：

检测到的 MIME 类型（通过魔术字节嗅探，而不仅是扩展名）为 JPEG、PNG 或 PDF
大小不超过 10 MB
文件不为空

不做 OCR，也不做生物识别检查。护照扫描件供你存档之用——我们不会读取或解析其内容。

5. 存储

文档在存储时已加密。

删除文档——或用新的上传替换它——会立即从存储中移除该文件。我们会保留一行元数据用于审计日志，但只要你确认删除，文件本身就已消失。

6. 自动化照片上传

当代理在带有申请照片的情况下运行提交时，它会端到端地驱动美国国务院的照片提交系统。你将在提交进度视图中看到两个新步骤：

上传照片 — 代理打开国务院的照片系统，发送 JPEG 并等待质量检查结果。
确认照片 — 代理返回到 DS-160 表单并越过 Confirm Photo 屏幕继续推进。

两者都会出现在步骤列表中，紧随表单各部分步骤之后、Review/Sign 阶段之前。它们的行为与其他步骤一致：成功 / 失败状态、时间戳，以及标准的失败重试流程。

步骤何时运行

只有当代理获取作业参数时表单已附加 applicationPhoto 文档，照片步骤才会被添加到当前的步骤列表中。没有照片的表单会跳过这两个步骤——代理提交表单其余部分，然后像以前一样停在 Photo 阶段。

如果你在提交已经开始之后再附加照片，已在运行的代理不会捕获到；请取消并重新提交以重新获取参数。

当国务院拒绝照片时

如果国务院的照片系统拒绝该次上传（其质量引擎偶尔会拒绝通过我们预校验的照片——我们在文件外形上更严格，在生物识别边缘情形上更宽松），代理会让 Upload Photo 步骤失败，并附带国务院的拒绝信息。你会在提交进度视图中看到失败，并看到国务院的原文用语，从而判断是该让客户重新拍照，还是校验器存在亚像素层面的问题。

7. 审计追溯

每次上传、替换和删除都会记录到字段审计日志中，包含：

涉及的槽位（applicationPhoto / passportScan）
来源（带有链接 JTI 的 client_link，或带有用户 ID 和邮箱的 authenticated_user）
时间戳
新文档的文件名和大小

打开 表单概览 → 审计日志 即可查看完整的修改序列——问卷字段与文档共享同一时间线。