SuperAPI AI 工具集

image-alt-title-filler

写作与研究

查看项目

更新于 10-16 08:38

技能介绍

用途:为文档中的图片批量补齐语义化 alt/title。脚本负责查找与替换,模型只负责读图生成描述,适合大量 Markdown 或 HTML 图片的文档处理。

主要能力:分批处理图片;图片读取失败时降级为上下文推断并标记 FALLBACK_CONTEXT;生成完整变更账本;执行前必须预览,执行时自动创建带时间戳备份。硬性规则包括不删除图片引用、不修改 src 路径、不重命名文件,每张图片须出现在账本中。

使用方式:采用 3-file 模式(task_plan.md、notes.md、image_ledger.md)。步骤 A:python scripts/01_extract_manifest.py --target_md <文档.md> --out_dir .;步骤 B:python scripts/02_make_batch_prompts.py --manifest manifest.json --out_dir batches --batch_size 8;步骤 C 在 IDE 中逐批打开图片生成描述并保存为 results/*.results.json;步骤 D 先执行带 --dry-run 的 03_apply_patch.py 预览,确认后再正式执行,输出 patched.md 与 image_ledger.md。

主要参数:update_policy(always/smart/empty_only)、title_policy(same_as_alt/keep/update)、max_len_alt、max_len_title、ledger_format(table/detailed)、--no-backup、--auto-cleanup-backup。建议每批 5-10 张图。

限制:必须先预览再执行;图片打不开时只能基于上下文推断;其余平台支持与收费信息暂未提供。