# string.aiPlus 库模块帮助文档

[ai+ URL 协议规范](https://www.aardio.com/zh-cn/docs/specs/ai-plus-url-scheme.md)

## string.aiPlus 成员列表 <a id="string.aiPlus" href="#string.aiPlus">&#x23;</a>

ai+ 大模型配置分享编解码库。  

在 aardio 代码编辑器右键菜单点击`粘贴与更正`，  
可自动解码 ai+ 链接，并自动生成调用 API 的示例代码。

### string.aiPlus.decode(aiUrl) <a id="string.aiPlus.decode" href="#string.aiPlus.decode">&#x23;</a>
解码 ai+ 链接。  
成功返回 AI 配置表 (configItem) 以及原始 URL，  
失败（或参数不是字符串）返回 null, 错误信息。  

配置表结构：  
- url: 基础 API 地址  
- key: 密钥  
- model: 模型 ID  
- temperature: 采样温度 (数值)  
- reasoning: { effort = "推理强度" }  
- extraParameters: 附加参数 (Table)

### string.aiPlus.encode(configItem) <a id="string.aiPlus.encode" href="#string.aiPlus.encode">&#x23;</a>
编码配置表为 ai+ 链接。  
成功返回 ai+:// 协议编码字符串，失败返回 null, 错误信息。

### string.aiPlus.is(str) <a id="string.aiPlus.is" href="#string.aiPlus.is">&#x23;</a>
判断 @str 是否为合法的 ai+ 链接，返回布尔值。
