Agnes 免费模型接入 Liustar214/dsh-llm-agnes

Agnes AI 一键接入（dsh-llm-agnes）

免费模型 · 一键对接 —— 把 Agnes AI 免费大模型一键接入 DeepSeek Harness，装上即用。

Agnes AI 提供国内可直连的免费大模型，OpenAI 兼容接口。本插件让你无需手动配置，安装后自动完成对接。

- 安装后 Agnes AI 自动出现在「设置 → 模型」，自带「API 密钥」输入框，粘贴即用；
- 免费模型自动进入聊天框右下角的模型列表，直接选用；
- 官方新增免费模型时自动检测并补进列表，无需重复配置；
- 模型列表、上下文长度等都可在界面里直接编辑，也可点「获取模型列表」一键拉取。

一、注册并获取密钥

1. 打开 Agnes AI 官网注册登录：<https://www.agnes-ai.com>
2. 进入控制台的 开发者 / API 板块，创建一个 API Key 并复制保存。

顺序不限：也可以先装插件、再去注册。没填密钥前发消息会提示你去填写。

二、安装并填写密钥（三步）

| 步骤 | 操作 |
| 1 | 安装本插件，然后重启 DeepSeek Harness（插件在启动时登记一次服务商）。 |
| 2 | 打开 设置 → 模型，找到 Agnes AI，点「编辑」。 |
| 3 | 在弹出的「API 密钥」输入框里粘贴密钥，保存。 |

完成。模型立即出现在聊天输入框右下角的模型列表中。密钥由 Harness 凭据服务保管，不会明文写入配置。

三、模型类型说明（重点）

Agnes AI 的模型分两类，请按需添加：

| 类型 | 计费 | 代表模型 | 说明 |
| Flash 系列 | 免费 | agnes-2.5-flash、agnes-3.0-flash | 有免费额度，受每分钟请求数限制。agnes-2.5-flash 还支持看图。插件默认登记的就是这类，装上即用。 |
| Pro 系列 | 付费 | agnes-2.5-pro-alpha、agnes-2.5-pro-beta、agnes-3.0-pro | 需要账户有余额的付费 Token 套餐。使用前请确认你的 Agnes 账户有余额。 |

本插件默认只登记免费的 Flash 模型，装上就能直接对话。

⚠️ 关于「获取模型列表」：在「设置 → 模型 → Agnes AI → 编辑」里点「获取模型列表」，会拉取 Agnes 官方全部模型，包含 Pro 付费模型。
如果你添加了 Pro 模型但账户没有余额，发消息会报错（常显示为「API 密钥无效」之类）。
这不代表插件或密钥有问题，而是余额不足——请先充值，再使用 Pro 模型。

图片 / 视频模型：Agnes 另有 agnes-image-（生图）与 agnes-video-（生视频）模型。这类模型暂不支持单独对接，本插件当前版本未纳入；后续版本会支持，到时无需重新安装即可使用。

四、自动更新，以及插件和模型的关系

- 插件会每隔一段时间向 GET /v1/models 查询一次，发现官方新增的免费模型就自动追加，不会删除你已有的模型；
- 模型列表、参数都可在「设置 → 模型」里手动编辑。

插件和模型是分开的：模型添加好以后，插件本身可以删除，模型不会跟着消失，仍然可以正常使用。
只是删除插件后，上面「自动检测新模型」的功能会停止；以后如果彻底不需要这些模型，需要自己到「设置 → 模型」里手动删掉。

五、常见问题

Q：装完在设置里找不到 Agnes AI？ A：需要完整重启 DeepSeek Harness（整个软件退出再打开）。插件在启动时登记服务商。

Q：发消息提示密钥相关错误？ A：先确认已在「设置 → 模型 → Agnes AI」里填好密钥；若你用的是 Pro 模型，请确认 Agnes 账户有余额（余额不足也会表现为密钥错误）。

六、技术信息

- 接口根地址：https://apihub.agnes-ai.com/v1
- 协议：OpenAI chat/completions（支持流式输出）
- 鉴权：Authorization: Bearer <你的 API Key>
- 自动发现：GET /v1/models

本插件通过向 Harness 内置适配器 pi-ai 登记一条服务商档案来工作，因此密钥输入框、模型选择器、模型编辑界面全部是 Harness 原生功能，体验与手动添加服务商完全一致。