superImage

superImage 是一个面向 HarmonyOS NEXT 的双摄记忆应用。它把相机拍摄、位置记录、地图沉淀、公开相册、隐私保险箱，以及火山引擎 ARK 的内容解析、美文生成和图生视频能力串成了一条完整链路，让“拍下当下”这件事可以继续沉淀、整理和再次加工。

当前已跑通的主流程

1. 双摄拍摄 优先尝试前后摄并发拍摄；设备不支持并发时，自动回退为顺序双拍。
2. 本地落盘 拍到的照片会保存到应用沙箱目录，保证无网时也能完成采集和浏览。
3. 离线首版图解 新拍内容会立即生成一版本地 AI 图解和视频提示词，不依赖 ARK API Key 也能使用。
4. 地图记忆 拍摄时绑定定位信息，地图页会按真实记录聚合成记忆点。
5. 旧地感知与去年今日 回到曾经拍摄过的地点附近时，会自动推荐对应旧地记忆；若命中同月同日的历史公开照片，会直接弹出“去年今日”提醒。
6. 隐私保险箱 公开相册和私密内容分层管理，私密内容需要生物认证后查看。
7. 在线 ARK 能力 支持保存 API Key、清除本地 Key、发起在线内容解析与美文生成、创建视频任务、刷新任务状态，并在下次启动时恢复未完成任务。
8. 导出到系统相册 支持通过系统创建对话框把当前记录中的照片导出到系统相册，无需额外写图库权限。
9. 视频结果转存 ARK 视频任务成功后，支持复制临时视频链接，也支持先下载到应用沙箱再导出到系统相册。
10. 系统分享 公开相册、保险箱照片和生成视频都支持直接拉起系统分享面板，发送到目标应用或设备。
11. 碰一碰 / 隔空分享 支持设备上会自动注册碰一碰与隔空传送监听，当前公开照片可以直接发送到附近 HarmonyOS 设备，不支持时自动回退到系统分享。

开发环境

• DevEco Studio 6.1+
• HarmonyOS SDK 6.1.0(23)
• 建议使用真机调试，相机并发能力请以真机 getCameraConcurrentInfos 返回结果为准

构建命令

& 'C:\Program Files\Huawei\DevEco Studio\tools\hvigor\bin\hvigorw.bat' assembleHap -m module -p product=default -p module=entry -p debuggable=true --no-daemon

构建产物默认位于：

entry/build/default/outputs/default/entry-default-signed.hap

发布前逐项验收可直接参考 doc/发布前真机验收清单.md。

体验顺序

1. 安装应用并授予 CAMERA、LOCATION、ACCESS_BIOMETRIC、INTERNET 权限。
2. 进入相机页，完成一次双拍或顺序双拍。
3. 到相册页查看自动生成的本地图解。
4. 如需在线能力，在相册页录入 ARK API Key。
5. 选中一条公开记忆后，可继续发起在线图解分析、视频任务或导出到系统相册。
6. 到地图页验证拍摄点是否已沉淀为真实记忆点。
7. 视频任务成功后，可复制临时链接，或直接把生成视频保存到系统相册。
8. 对公开相册、保险箱照片和生成视频分别点一遍“系统分享”，确认目标应用/设备面板能正常拉起。
9. 回到曾经拍摄过的地点附近，验证地图页是否自动弹出“去年今日”提醒，并能一键跳到对应公开照片。
10. 如设备支持，进入相册页后触发一次“碰一碰 / 隔空分享”，确认当前公开照片能发到附近设备；不支持时确认普通系统分享仍可用。
11. 把内容移入保险箱后，通过人脸认证解锁查看，也可以从保险箱继续导出到系统相册或恢复到公开相册。

ARK 说明

• ARK API Key 通过应用内输入并保存在本地首选项中。
• 当前远程图解走 data URL 上传，单张图片需要控制在 10 MB 以内。
• 为了提高远程 AI 成功率，当前拍照质量已调整为 QUALITY_LEVEL_MEDIUM。
• 视频任务返回的 video_url 有效期为 24 小时，任务状态和结果会持久化到本地，方便二次打开应用后继续刷新。
• 当用户执行“保存视频到系统相册”时，应用会先把远程 MP4 下载到本地缓存，再走系统授权弹窗完成导出。
• 当用户执行“系统分享”时，应用会直接分享本地沙箱文件；若是生成视频，会先确保 MP4 已缓存到本地。
• 应用内已增加可见的隐私说明：只有用户主动点击在线图解或视频任务时，照片才会发送到 ARK；清除本地 Key 后将只保留离线能力。

关键文件

• entry/src/main/ets/pages/Index.ets 应用主页面，包含相机、相册、地图、保险箱的完整体验。
• entry/src/main/ets/services/GalleryRecordService.ets 相册记录持久化与本地图解生成。
• entry/src/main/ets/services/VolcengineArkService.ets ARK 配置保存、图解分析、视频任务创建与轮询。
• doc/发布前真机验收清单.md 真机验收步骤、通过标准与发布前回归项。
• doc/ 项目说明、设计草图和视觉参考。

当前仍需真机验收的部分

• 相机前后摄并发能力因设备差异较大，需要在目标真机上最终确认。
• ARK 在线图解和视频生成依赖真实网络、有效的 API Key，以及服务端模型可用性。
• 系统相册导出会拉起系统确认对话框，最终交互体验需要在真机上点一遍验收。