ai卡皮巴拉插件需通过.jsx脚本部署于illustrator：一、从官网下载对应版本.jsx文件并校验哈希；二、复制至presets/scripts目录或三、用“其他脚本”加载自定义路径；四、首次运行输入api密钥，自动加密存入.aikapibara_config；五、执行“快速测试”验证生成能力。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在设计软件中集成AI卡皮巴拉的智能生成功能，但尚未完成插件部署，则可能是由于插件未正确放置或软件未识别脚本路径。以下是完成AI卡皮巴拉插件安装与启用的具体步骤：
一、确认插件文件类型与来源
AI卡皮巴拉当前不提供独立图形界面插件（如.aip、.zxp格式），其核心能力通过Python SDK调用，但可封装为脚本插件供Illustrator等软件调用。需确保获取的是适配您软件版本的.jsx脚本文件，且该文件由可信渠道导出，内含对
1、访问AI卡皮巴拉官方开发者文档页面，定位“Script Plugin for Adobe”下载入口。
2、根据您的Adobe Illustrator版本（如2022、2024或2025），选择对应后缀为.jsx的插件脚本文件。
3、下载完成后，校验文件哈希值（官方提供SHA256摘要），确保未被篡改。
二、手动复制至Illustrator脚本目录
该方法绕过插件管理器，直接将脚本注入软件可识别路径，适用于所有支持.jsx扩展的Illustrator版本，且无需管理员权限即可完成基础部署。
1、关闭正在运行的Adobe Illustrator进程。
2、打开文件资源管理器，导航至默认脚本目录：C:\Program Files\Adobe\Adobe Illustrator [版本]\Presets\Scripts（Windows）或/Applications/Adobe Illustrator [版本]/Presets/Scripts（macOS）。
3、将下载的AI卡皮巴拉.jsx文件复制粘贴至该目录；若提示替换同名文件，选择“替换”。
4、检查文件属性，确认.jsx文件未被系统标记为“来自互联网”，否则右键→属性→勾选“解除锁定”。
三、使用自定义脚本路径加载（免安装模式）
该方式不修改软件原生目录，将脚本存于用户可控位置，便于版本切换与权限隔离，适合多项目并行或受限账户环境。
1、在用户文档目录下新建文件夹：C:\Users\[用户名]\Documents\AI_Kapibara_Scripts（Windows）或/Users/[用户名]/Documents/AI_Kapibara_Scripts（macOS）。
2、将.jsx脚本移入该文件夹。
3、启动Illustrator，执行菜单操作：文件 → 脚本 → 其他脚本…。
4、在弹出窗口中定位并选中该.jsx文件，点击“打开”即刻加载运行。
四、配置API密钥与初始化连接
脚本运行前必须注入有效凭证，否则所有生成请求将返回401错误；密钥不得硬编码在.jsx中，应通过安全弹窗或本地加密配置文件读取。
1、首次运行脚本时，将自动弹出输入框，提示输入Secret Key与API Endpoint（二者均来自AI卡皮巴拉控制台“API管理”页）。
2、输入后点击确认，脚本会将加密后的凭证写入当前用户目录下的.aikapibara_config隐藏文件（路径：C:\Users\[用户名]\AppData\Roaming\.aikapibara_config）。
3、后续运行不再重复提示，脚本自动读取该文件并构建KapibaraClient实例。
五、验证插件功能与文本生成调用
完成部署与认证后，可通过内置测试命令触发最小可行调用，验证端到端链路是否畅通，避免因网络策略或模型服务异常导致静默失败。
1、在Illustrator中新建空白文档，确保画布处于激活状态。
2、执行菜单：文件 → 脚本 → AI卡皮巴拉.jsx（或从脚本面板双击）。
3、在弹出的UI中选择“快速测试”模式，输入提示词：“生成一个蓝色圆形矢量图标，带阴影效果”。
4、点击“执行”，脚本将调用client.image.generate()接口，生成图像URL后自动下载SVG数据并插入当前图层。
