DeepSeek Harness 动图只取首帧与 Android 附件上传失败：read_image 与附件排查

DeepSeek Harness（DSH）的图片与附件有两个特别容易误判的问题，而且方向恰好相反：一个是「信息被丢掉但没人说」——read_image 接受动图，却只把第一帧交给模型，结果里既不提帧数也不做说明，于是模型把动图当静帧描述；另一个是「环境前提不满足但报错很短」——在 Android 应用沙箱这类受限环境里，附件上传必失败**，报 EACCES: permission denied, open '/data/user/0'，因为附件持久化目录的同步会一路向上走到文件系统根，而上级目录对普通应用只有执行位、没有读位。** 前者要把它当契约 + 可观测性缺口来处理（「只取首帧」是文档写明了的，缺的是「告知」），后者要按路径边界去绕（换数据目录）或等修法（遇到权限错误就跳过）（#8793、#9247）。

DSH插件 动图只取首帧：丢帧是契约，不告知才是缺陷

一句话结论：read_image 通过文件头嗅探接受动图，但附件归一化会把它重编码成单张静态图，只保留第一帧——帧数在模型看到之前就已经丢了；而结果里既没有帧数也没有文本说明，所以模型把动图当成静帧使用。（#8793）

DSH插件 判据与口径：别把两件事混成一件

这一点很关键，因为它决定了你该反馈什么（#8793）：

所以正确的反馈口径是：结果里应当带上原始帧数并在工具描述里说明动图行为，而不是「为什么要丢帧」（#8793）。

DSH插件 三步确认与处置

1. 确认判据：让 agent 读一张明显有动作的动图，观察它描述为「一张静态图片」；同时检查工具返回里是否没有任何帧数或说明——两者同时成立即为本条（#8793）。
2. 用户侧规避（推荐，最省事）：自己先把动图抽帧并拼成一张联系表，再交给 read_image：

# 抽取若干关键帧并横向拼接成一张静态图（示意）
ffmpeg -i anim.gif -vf "fps=1,scale=320:-1,tile=4x3" -frames:v 1 contact-sheet.png

这样模型看到的是一帧里包含多帧信息的图，既保留了动作概览，也避开了「模型以为这是静帧」的误会（#8793）。

3. 上游修法（两点，都很小）：源文件帧数大于 1 时，在返回结果里带上帧数（例如 originalFrames: 3），并在工具描述里补一句动图行为（#8793）。
4. 验证：抽帧后重跑，确认模型能描述出多个动作阶段；若仍描述为静帧，检查拼图是否被压缩得看不出差异（#8793）。

DSH插件 Android 受限环境里附件必失败：同步一路走到文件系统根

一句话结论：附件模块为了保证落盘持久性，会从数据目录逐级向上同步直到文件系统根；而在 Android 应用沙箱里，上级目录（如 /data/user/0）对普通应用只有执行位、没有读位，于是以只读方式打开必失败——整个附件写入流程就此中止。 报错是 EACCES: permission denied, open '/data/user/0'，而纯文本会话完全正常（#9247）。

DSH插件 判据：两个对照能立刻定性

1. 「文本正常、只有附件失败」：说明附件模块这条路径上有额外前提，网络与凭据都正常（#9247）。
2. 报错路径是文件系统根或数据目录的上级，而不是你的工作区：这是本条的指纹——如果报错路径就在工作区里，那是另一类权限问题（#9247）。
3. 注意这不是 Android 专属：讨论里明确说明该行为在其它同类受限文件系统上也成立（只要上层目录对进程不可读），所以排查思路可以通用（#9247）。

DSH插件 三步处置

1. 换数据目录（用户侧规避）：把 DSH 的数据目录放到应用自身可读、可写的路径下，避免上级目录不可读的情况（#9247）。
2. 修法方向（讨论中给出并实测的补丁）：让同步步骤在遇到 EACCES / EPERM 时跳过而不是中止；前提是该目录不可写（这一点要保持——否则会削弱持久性保证）（#9247）。
3. 验证：重跑同一张图片的附加操作，预期不再报 EACCES，且后续读取附件正常（#9247）。
4. 顺带记住：测试期望里包含「哪些目录需要同步」的断言，改动时需同步更新（讨论里提到的连带工作量）（#9247）。

DSH插件 排查注意事项

这一族只有两条，但两条的排查方向完全不同：一条是「信息缺失」，一条是「环境前提」。先看报错有没有，再决定往哪边想。 七条要点：

1. 没有报错、只是描述不对 → 往「信息缺失」方向查（动图那条）（#8793）。
2. 有 EACCES 且路径在文件系统根 → 往「环境前提」方向查（#9247）。
3. 「文本正常、附件失败」是极强的范围限定，优先用它（#9247）。
4. 动图那条别反馈错方向：契约本身没问题，缺的是「告知」（#8793）。
5. 抽帧拼图是最实用的用户侧手段，比等修法快（#8793）。
6. 同步跳过的前提是「目录不可写」，不要为了绕过错误而放宽持久性保证（#9247）。
7. 修复状态如实：两条在讨论所指版本里都未修；动图那条是「契约内行为 + 可观测性缺口」，附件那条报告者给出的补丁未合入，因此当下只有换目录这类用户侧规避。

排查附件与图片问题时，「环境」这一层往往决定了结论——尤其数据目录放在哪。如果你想先把插件与日志这一层看清，与其在各处手敲命令，不如用 DSH Plugin Hub 这类可视化插件市场：已安装列表、装卸历史与系统日志集中在一个面板里。

来源：Discussion #8793、Discussion #9247。