UnisKB/scripts/README_ai_hub_assets.md

21 lines
2.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# 思维导图图片资源
解析任务、手工提交和保存图谱时,将支持的 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 环境中执行:
```sh
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 导出会嵌入图片,以便离线打开。智能整理使用图片占位符;重复占位符只恢复一次,遗漏的图片自动补入“原文图片”部分,解析原稿始终保留。