# autos.tools.handlers 库模块帮助文档

## autos.tools.handlers 成员列表 <a id="autos.tools.handlers" href="#autos.tools.handlers">&#x23;</a>

AA（aardio autos）的 AI 工具实现。  
除 analyze_image 以外的函数仅供 AI 自动调用。其他细节请查看库源码

### autos.tools.handlers.analyze_image(选项表) <a id="autos.tools.handlers.analyze_image" href="#autos.tools.handlers.analyze_image">&#x23;</a>
可在执行代码时直接调用 AA（aardio autos） 的视觉工具。  
如果 AA 配置中未找到启用视觉能力的模型，则可能尝试 DeepSeek OCR，再回退到 dotNet.ocr 本地识别；指定 useDotNetOcr=true 可禁止第三方上传。  
参数 @1 必须指定一个表，表可指定以下字段：  
- imageUrlOrPath: 图像路径、HTTP(S) URL、Data URL、"clipboard"、"attachment" 或 gdip.bitmap 对象；省略则使用上次 capture_screenshot 的路径  
- useDotNetOcr: 仅使用 dotNet.ocr 本地识别图像  
- prompt: 调用 AI 接口的用户提示词，可选  
- system: 调用 AI 接口的系统提示词，可选  
- excludeModels: 要排除的模型 ID 或接口地址数组，可选。明确不支持图像的配置会在本轮会话自动禁用  
返回表统一包含 succeeded 字段；成功时 text 字段为识别结果；失败时 error 字段为错误信息，model、url、attempts 字段标识失败的视觉配置与尝试次数。