用途:为智能教科书章节补充高质量、可自由许可的地图与照片,适合文字偏多、涉及地理/科学/视觉主题的章节,通常在章节内容生成后、正式发布前使用。
主要能力:按优先级检索图像来源。第一梯队为美国政府公共领域作品,如 USDA、EPA、USGS、USFWS、US Forest Service、NOAA、NASA、NPS、Library of Congress;第二梯队为 Wikimedia Commons 的 CC BY、CC BY-SA、CC0 图像;第三梯队为州政府与大学来源,需逐一核查使用条款。仅采用与 CC BY-NC-SA 4.0 兼容的许可,避免 CC BY-ND、CC BY-NC-ND 与 All Rights Reserved。
使用方式:先阅读章节 index.md,识别 3-6 个最佳插入点;再查找图像,Wikimedia 需通过 API 获取真实下载 URL 并带 User-Agent;下载到 docs/img/chapters/XX-chapter-name/,用 Python urllib 并顺序下载以规避 429;用 Pillow 压缩,目标宽度 1200px、照片小于 500KB、地图小于 600KB、图表小于 300KB;随后以 Markdown 语法插入,附 alt 文本、斜体图注与来源署名,并在章节末尾添加 Image Credits 区块;最后运行 mkdocs build 验证路径与渲染。
限制与注意:Wikimedia 下载 URL 须用 API 获取,不可猜测哈希路径;州政府图像不自动属于公共领域;每张图必须有描述性 alt 文本;提交前须调整尺寸。付款、价格、平台与具体效果信息暂未提供。