AI 服务商

在设置「AI」页的「服务商」一节管理内置 AI 使用的连接与模型。当前提供配置页面和内部执行接口，尚无聊天或对话流界面；保存配置不会自动发起模型请求。

本机设备连接（CLI 分支）#

设置上方的本机 MCP 改为设备一次授权：启动 gandi connect，首次打开本机授权页并明确允许作品读写/运行、扩展代码与脚本联网。以后同一设备的本机作品页自动连接，不填写配对码或端口，不再逐次弹扩展/联网审批。设置提供「授权此设备」「自动连接」「断开」「撤销设备授权」。撤销会关闭活跃连接；协作账号权限与作品版本/session/generation检查始终保留。

多个作品同时在线时，CLI 使用 gandi editors / gandi use EDITOR_ID 选择，再 gandi bind 绑定；并行智能体用不同 GANDI_CLI_PROFILE 隔离选择与绑定。该方案只支持可信本机编辑器，正常连接使用 http://127.0.0.1；授权不是公网远程控制，也不会自动授权内置 AI 调用。

配置服务商与模型#

点击顶栏「设置」→「AI」，在「服务商」一节点击「添加服务商」，填写名称、API 地址和密钥。地址应为兼容 OpenAI Chat Completions 的 API 根，例如 https://example.com/v1，不包含 /chat/completions。

服务商列表显示协议、模型数量和当前模型标记。选中后直接展示模型列表；同页的「连接设置」可折叠，展开后编辑地址与密钥。模型默认显示摘要，点击展开编辑。添加服务商、导入、添加模型及获取模型列表均使用图标按钮，悬停可查看名称。

列表项悬停或键盘聚焦时出现删除、导出操作；触屏设备常显。模型展开后可点击「获取模型上下文」图标，联网查询当前服务商的 /models，只更新对应模型。接口未提供该模型上下文时明确提示并保留原值；它不是网页搜索，不会猜测模型能力。

同页切换服务商会保留草稿。页面底部显示保存操作，修改后显示「有未保存的修改」；「保存 AI 配置」应用全部草稿，「放弃修改」恢复已保存配置。移除服务商或模型需确认，保存后才生效。离开「AI」页前请先保存，草稿不会持久化。

「添加模型」可手动填写模型 ID、显示名称和上下文长度（tokens）。点击「设为当前模型」，再「保存 AI 配置」应用。留空的上下文长度表示未知，不会自动猜测。

「获取模型列表」访问当前地址下的 /models。仅在服务返回 context_length 或 context_window 数值时自动补齐未知的上下文长度；保留已手填数值。部分服务只返回模型 ID，因此仍需手填上下文长度。该请求由浏览器发起，服务需允许跨域访问；本机 HTTP 可用，远程地址需 HTTPS。

导入与导出#

支持 Gandi2 服务商配置 {version:1, exportedAt, agent}，也接受裸服务商对象和旧单模型配置。导入是添加，不覆盖现有服务商；导入后需保存。

在服务商列表项上点击「导出配置」图标，展开导出选项后点击「下载配置」导出当前服务商草稿（不自动保存）。默认不含密钥；手动勾选「导出时包含 API 密钥」后会导出明文密钥，界面会提示风险。这是连接配置迁移，不是智能体分享。切换、新建或导入服务商会重置该勾选。

目前调用支持 OpenAI-compatible 类型（openai、custom、deepseek、zhipu）。其它 Gandi2 协议配置可以保留和导出，但不支持获取列表或执行请求，不能将格式兼容理解为协议全部兼容。

密钥与数据#

服务商和模型偏好保存在本机浏览器，密钥只保留在当前页面内存，刷新后需重新输入。配置不随作品保存；主动勾选密钥导出的 JSON 文件除外。不要在含不可信扩展的页面输入高权限密钥，同源脚本之间没有密钥隔离保证。

未来任务调用会将用户输入以及工具读取的项目内容发送给当前服务商。配置页不会自动执行创作任务。内部循环默认只读，明确允许写入后才开放文件写入；停止不撤销已经生效的修改。

上下文检查采用保守字节估算，不是精确 tokenizer，可能提前达到预算；未知上下文不会伪造上限。本机模拟请求及浏览器配置验收已完成，但未使用用户真实密钥验证商业服务。