2.0 KiB
思维导图图片资源
解析任务、手工提交和保存图谱时,将支持的 Base64 位图转换为私有图片文件,Markdown 保存稳定的 /admin/api/workspace/.../ai_hub/assets/.../content 地址。历史图谱在再次保存时转换原稿和历史版本中的内联图片。
默认持久化目录为项目根目录 data/ai-hub-assets;可通过环境变量 AI_HUB_ASSET_DIR 指定。Web 与独立 Hub Worker 必须使用相同目录,多机部署需挂载共享存储。备份应同时包含现有数据库与此目录。增量发布不可覆盖该目录。
文件以工作空间、用户和内容哈希去重,旁路 JSON 保存归属、格式、大小和最后引用时间。无需数据库迁移。图片接口使用现有用户和工作空间鉴权,父页面通过二进制通信供导图预览使用,令牌不进入图片 URL。浏览器仅在当前页面内缓存图片,图片展示可点击放大,失败后可重试。
单图上限 20 MiB、4000 万像素;单次转换图片合计上限 100 MiB。支持 PNG、JPEG、GIF、WebP、BMP。图谱及其原稿、历史版本所引用的图片长期保留;运行中或待处理任务中的图片不会清理。其余资源最后引用七天后可清理,未保存的旧任务图片届时可能失效。
已有独立 Hub Worker 每运行 24 小时执行一次清理,不新增定时进程。手工核验可在原有 Web 环境中执行:
venv/bin/python scripts/ai_hub_ops.py cleanup-assets
venv/bin/python scripts/ai_hub_ops.py cleanup-assets --apply
首条命令只报告数量。清理范围仅限本模块资源目录,不涉及原文档、数据库记录、模型或解析服务文件。
含资源图片的 Markdown 下载为 ZIP,包含 document.md 和 images/;HTML、导图 SVG 导出会嵌入图片,以便离线打开。智能整理使用图片占位符;重复占位符只恢复一次,遗漏的图片自动补入“原文图片”部分,解析原稿始终保留。