帮助 · 媒体安全

把图片安全地加入 OpenWiki 文档

一张看起来普通的照片,可能带着 GPS、设备信息或编辑软件记录;一张截图则可能把 token 直接露在像素里。安全导入要同时处理元数据、可见内容和使用权。

更新于 2026 年 8 月 3 日产品文档

先导入源图,不要直接拖进包

media import 会建立可追踪的处理路径。保留原始来源记录,同时只把经过检查的输出用于发布。

ow media import ./source-photo.jpg --output ./artifact/assets/overview.webp

把图片冻结为包内资产

发布作品不能依赖某个会失效的临时 URL。将最终字节纳入包,记录 digest 和媒体类型。

ow a2ui draft media --help

替代文本要写信息,不写装饰

alt 应告诉无法看到图片的读者:这张图传达了什么。caption 解释它为何出现在这里,credit 则说明来源与权利。

最后检查整份包

  1. 确认元数据报告没有硬错误。
  2. 人工查看像素里是否有秘密或个人信息。
  3. 检查移动端比例与加载。
  4. 跑 check、build 与 digest。
ow a2ui draft check ./artifact
ow a2ui draft build ./artifact

常见问题

常见问题

清掉 EXIF 就等于图片安全了吗?

不等于。token、邮箱、地址等可能直接出现在像素里,仍需人工检查。

可以只引用外部图片 URL 吗?

正式包应使用带来源记录的 package-local 资产,避免外链失效或内容被替换。

使用真实工作流

把 Agent 创作的作品发表出来。

让每份报告、文档或计划拥有面向读者的页面;批注、评审决定和正式版本都从这里回到 Agent。