[G6-12] 为首批四条核心故事交付可公开的运行证据包

[NongHua123]

P1 · Marketing / Release

问题

证据系统只有真正产出可公开材料才有价值。首批应围绕用户最关心的四件事，而不是用一张概念 hero 覆盖全部产品主张。

交付与验收

• 分别交付“可信目录与安装”“账号/API 接入”“Change Plan 与 Undo”“FyAgent/Agent 来源判断”四套证据包。
• 每套包含一张主运行截图、2–4 张关键步骤图、60 秒真实讲解视频、30/90 秒脚本和 claim/evidence 映射。
• 证据绑定正式或明确标注的 preview 版本；任何未跑通步骤在文案中准确降级。
• AI hero 和机制图只作为品牌/解释层，与四套运行证据并列但不互相替代。

[NongHua123]

补充：四套证据包共用一份可追溯 manifest

四套证据包最好共用一份 manifest，避免 README、官网和视频各自讲了不同版本。每套记录 packageId/storyId、FyAgent release/version/SHA、preview 标识、平台、Agent/Provider/version；claims 中保存 claimId、原文、精确 scope、qualifier、status；evidence 中保存 evidenceId、type、源文件 hash、capturedAt、captureProfileId、覆盖步骤、适用 claim、reviewer、expiry 和 invalidation reason。证据类型至少分成 runtime_screenshot、runtime_sequence、runtime_video、trace/log、build attestation、mechanism_diagram、ai_concept。只有与目标版本和范围一致的真实运行材料可以满足功能 claim；机制图只负责解释，AI hero 标为 concept_only、evidenceWeight=0。

公开包还要把 accessibility 做成必填字段。W3C 要求信息型图片的替代文本传达关键信息，复杂图提供完整文本等价物；视频字幕应覆盖语音和必要的非语音声音，描述性 transcript 还要写出关键视觉状态。因而每张主图和步骤图应有 alt，图组另有逐步长描述；视频至少交付 captions、descriptive transcript，纯视觉变化还要有音频描述或等价文本，不能只把旁白转成字。

验收建议锁四道门：每条公开 claim 都能映射到仍有效的 runtime evidence；演示从干净状态走到明确成功或失败终点，跳步和加速均有标记，未跑通就降低文案；原始与发布文件都有 hash；概念层和运行层在目录、页面标签及导出物中保持分开。GitHub artifact attestation 可以证明构建来自哪个仓库、workflow 和 commit，但官方也明确说它不保证产物安全，更不能替代功能运行证据。Apple 对其 App Store 渠道要求截图展示 app in use、预览使用 app 本身的录屏，可作为相关 Apple 渠道的硬门槛，不扩大成所有渠道的法律规则。

官方资料：

• https://www.w3.org/WAI/tutorials/images/
• https://www.w3.org/WAI/media/av/
• https://docs.github.com/en/actions/concepts/security/artifact-attestations
• https://developer.apple.com/app-store/review/guidelines/

复核日期：2026-08-12