Python 工具

图像生成、文档处理与视觉 API 调用

agnes-draw.py

Agnes AI 中国站直连的图像生成工具。支持多种画面比例，内置自检与质量门禁。

用法

# 基本用法
python python/agnes-draw.py "一只白鹭在雾中飞翔" --ratio 3:4 --out output.png

# 自检：检查密钥 / 模型 / 网络 / 输出目录
python python/agnes-draw.py --diagnose

参数

参数	说明	默认
`prompt`	图像描述，必填	—
`--ratio`	比例：1:1 / 3:4 / 4:3 / 16:9 / 9:16 / 2:3	1:1
`--out`	输出文件路径	自动生成
`--diagnose`	运行自检后退出	false

密钥

按优先级读取：环境变量 AGNES_API_KEY → provider-catalog.json 中 agnes provider 的 api_key。

pdf-pipeline.py

PDF 批量处理管线，支持合并、拆分、水印、加密。

# 合并
python python/pdf-pipeline.py merge --input a.pdf b.pdf --output merged.pdf

# 添加水印
python python/pdf-pipeline.py watermark --input doc.pdf --watermark w.pdf

cover-text.py

封面文字合成工具。用 PIL 精确渲染中文标题，规避 AI 生图把文字画错的问题。

python python/cover-text.py --image background.png --title "项目名称" --output cover.png

# 主副标题
python python/cover-text.py --image bg.png --title "主标题" --subtitle "副标题" --output r.png

其他

文件	用途
`draw-router.py`	多通道生图统一入口（择优 + 自动降级 + 质量门禁）
`cf-ai-draw.py`	Cloudflare Workers AI 生图（flux / SDXL / dreamshaper）
`cf-worker.py`	Cloudflare Workers 部署与验证（--diagnose / --status / --deploy / --verify / --logs）
`cf-image-proxy.py`	CF Workers AI 生图的本机代理（OpenAI 兼容 /v1/images/generations）
`wanx-draw.py`	阿里 DashScope 生图直连
`gbif-dist.py`	GBIF 物种分布点抓取与制图（CSV + 分布图，支持中国省界 / 贵州县界）
`pubscholar-search.py`	PubScholar 中文文献检索（含中英学名联动、RIS 导出、Obsidian 落库）
`rotate-dashscope-key.py`	DashScope key 轮换工具
`treblo-music.py`	Treblo / Melodia AI 音乐生成客户端
`apply_pattern.py`	图案应用工具
`generate_diagrams.py`	示意图批量生成
`call_zhipu.py`	智谱视觉 API 调用，读 `ZHIPU_API_KEY` / `ZHIPU_MODEL_ID`
`call_zhipu_nossl.py`	跳过 SSL 验证的变体，含本机路径，按需自改

更新于 2026-09 · Python 3.8+