v2.9.0: agnes-2.5-flash 已全面开放

v2.9.0 更新

核心变更

agnes-2.5-flash 从灰度测试升级为全面开放。

基于 2026-07-19 实测确认：Free / Starter 账户均可使用。

更新内容

1. 模型选择表：2.5-flash 改为已全面开放，新增实测对比表
2. 模型参数速查区状态改为已全面开放
3. 灰度自检区移除灰度措辞
4. 测试结果解读表更新
5. 全部工具链默认模型改为 agnes-2.5-flash

v2.8.0 — agnes-2.5-flash 灰度可用性检查

新增功能

agnes-2.5-flash 灰度可用性检查

官方 2026-07-13 宣布 agnes-2.5-flash 灰度上线 Agnes Code 桌面端，API 预计本周内全面开放，不限期免费。

更新内容：

1. 触发词增加 2.5/2.5-flash/2.5-pro/灰度检查/模型检查/可用性检查等
2. 模型选择表新增 agnes-2.5-flash 行（灰度测试中），原 2.0-flash 标注稳定版
3. 模型参数速查区新增 agnes-2.5-flash 小节
4. 灰度自检区新增「测试 0：agnes-2.5-flash 可用性自检」（curl + Python + 2.0 vs 2.5 对比脚本）
5. 测试结果解读表新增 2.5-flash 行
6. 全部工具链（OpenClaw/HermesAgents/WorkBuddy/Cherry Studio/Opencode）模型选项增加 2.5-flash 灰度提示

累积更新（v1.6.0~v2.8.0）：

• 仓库引用统一迁移至 imsancn/agnes-ai-skill
• 图像尺寸 6 档位完整版
• Context 512K + Max Output 65.5K
• Token Plan 四档位一键切换
• HTML 助手档位切换 UI
• 版本检查 5 步流程 + 错误码参考 22 个状态码
• RPM 速查表 + 订阅配额

v2.7.1 - 新增 2048×2048 精确2K档位 + 6档位完整映射规则

v2.7.1 (2026-07-01)

🆕 新发现：1:1 正方形 2048×2048 精确2K输出

在 v2.7.0 基础上，通过扩展测试发现 Agnes 图像模型支持 2048×2048（1:1）精确2K输出，宽高都是16的倍数（128×128）。

完整更新

1. 新增精确2K档位：2048×2048（1:1）

• 请求 2048x2048 → 输出 2048x2048（4.19MP，宽高都是16的倍数）✅
• 这是继 2624x1472（16:9）之后发现的第二个精确2K档位

2. 尺寸表升级为6档位完整版

• 从 v2.7.0 的3档位扩展为 6个固定输出档位
• 新增 1K 4:3 档（1152×864）、1K 3:4 档（864×1152）、2K 1:1 档（2048×2048）

3. 降级示例补充4:3/3:4族

• 请求 2048×1536 → 输出 1152×864（1K 4:3）
• 请求 1536×2048 → 输出 864×1152（1K 3:4）

6个固定输出档位一览

档位	比例	精确分辨率	像素	宽÷16	高÷16
1K	4:3	1152×864	~1MP	✅72	✅54
1K	3:4	864×1152	~1MP	✅54	✅72
1K	16:9	1312×736	~1MP	✅82	✅46
2K	1:1	2048×2048	~4.2MP	✅128	✅128
2K	16:9	2624×1472	~3.9MP	✅164	✅92
4K	16:9	3848×2160	~8.3MP	❌240.5	✅135

影响文件

• SKILL.md（尺寸表升级6档位 + 降级示例补充 + 版本号）
• agnes-ai-assistant.html（3处尺寸标注同步更新）

v2.7.0 - 图像分辨率映射规则修正

v2.7.0 (2026-06-30)

🐛 重大实测修正：图像分辨率映射规则

基于对 Agnes 图像模型的系统性实测，发现并修正了尺寸表中的严重错误：

核心发现：

• Agnes 图像模型 只有 3 个固定输出档位：1K(1312x736)、2K(2624x1472)、4K(3848x2160)
• 2624x1472 是唯一支持精确 16:9 2K 输出的尺寸（宽高都是16的倍数）
• 其他所有"标准2K"尺寸（如 2560x1440、1920x1080 等）全部被降级到 1K(1312x736)

修复内容：

1. SKILL.md 图像尺寸表：16:9 2K 从 2560x1440 修正为 2624x1472
2. 新增完整映射规则说明：列出所有实测降级示例，标注 Agnes 内部 3 个固定档位
3. agnes-ai-assistant.html：同步更新 3 处尺寸标注（2.0-flash/2.1-flash/FAQ）

实测数据：

• 请求 1280x720 → 输出 1312x736（1K）
• 请求 1920x1080 → 输出 1312x736（1K）
• 请求 2048x1152 → 输出 1312x736（1K）
• 请求 2304x1296 → 输出 1312x736（1K）
• 请求 2560x1440 → 输出 1312x736（1K）
• 请求 2624x1472 → 输出 2624x1472（2K，✅ 原尺寸）
• 请求 2720x1536 → 输出 2728x1528（4.17MP，非16倍数）
• 请求 2880x1620 → 输出 2880x1616（4.65MP，高-4像素）
• 请求 3840x2160 → 输出 3848x2160（4K）

使用建议：

• 如需 16:9 的2K分辨率且保证宽高都是16的倍数，必须使用 2624x1472
• 其他比例继续使用原尺寸（4:3/3:4 不受影响）

影响文件

• SKILL.md（图像尺寸表 + 版本号）
• agnes-ai-assistant.html（3处尺寸标注）

v2.6.0

v2.6.0 更新内容

✨ 新增

• 如何切换默认档位（SKILL.md）

  • 三种方式：告诉 AI / 手动编辑 SKILL.md / HTML 助手切换
  • 安装后即可按需切换，无需重启

• 订阅变更后如何更新档位（SKILL.md）

  • 升级降级时的操作流程

• 版本发布规则（SKILL.md）

  • 不主动发布新版本到 GitHub，需用户确认后才推送

• README 档位切换方式说明表

  • 三种切换方式对比（告诉 AI / 手动编辑 / HTML 助手）

• README Token Plan 档位对比表

  • Free / Starter / Plus / Pro 四档完整参数对比
  • 引用官方 TOKEN_PLAN_FAQ

📝 修改

• 版本号 v2.5.0 → v2.6.0
• README Token Plan 声明从 blockquote 改为正文加粗格式，更醒目

v2.5.0

v2.5.0 更新内容

⚙️ 用户档位配置（核心新功能）

SKILL.md 新增「用户档位配置」区块，支持 Free / Starter（默认） / Plus / Pro 一键切换：

• 修改 一行即可切换档位
• AI 自动根据档位调整所有 RPM、配额和使用建议
• 各档位参数速查表（RPM、配额、退避时间等）
• AI 行为规则：读取 user_tier → 查表 → 使用对应档位参数

HTML 助手 新增档位切换 UI：

• 侧边栏「我的档位」下拉框（Free / Starter ⭐ / Plus / Pro）
• 切换后所有 RPM、配额数值动态更新
• 档位选择自动保存到 localStorage
• FAQ、429 错误码、模型卡片等处数值随档位变化

🏷️ Token Plan 优化版声明

• README 标题改为「Agnes AI 帮助中心 — Token Plan 优化版」
• README 开头醒目声明本仓库是基于 Token Plan 的优化版本
• GitHub 仓库 About 更新：「Free/Starter/Plus/Pro 四档位一键切换 | RPM·配额·使用建议自动适配」

各档位参数

参数	Free	Starter ⭐	Plus	Pro
月费	/usr/bin/bash		0	0
文本 RPM	20	1,000	1,000	1,000
视频 RPM	1	5	5	5
文本配额	无限	1,500次/5h	7,500次/5h	30,000次/5h
图像配额	无限	4,000张/天	4,000张/天	4,000张/天
视频配额	无限	500秒/天	500秒/天	500秒/天

v2.4.0

v2.4.0 更新内容

🎯 默认假设从 Free 改为 Starter（⭐ 推荐档位）

• 全文档默认推荐 Starter /月：文本 RPM 1,000（Free 的 50 倍）、视频 RPM 5（Free 的 5 倍）
• RPM 表增加 Starter 独立行，⭐ 标注推荐
• 429 错误码全处更新：双标 Free + Starter
• FAQ / 检查清单 / 最佳实践全部双标

🎬 视频生成 RPM 重大变更

• Free: 视频 RPM 从 20 下调至 1（每分钟只能生成 1 个视频）
• Starter: 视频 RPM 5
• Enterprise: 视频 RPM 2
• 合并自 lj 上游 v1.2.13

🚫 移除 agnes-1.5-flash 引用

• SKILL.md 和 HTML 中所有 1.5 Flash 引用已清除
• 仅保留 agnes-2.0-flash 作为唯一文本模型

📋 Section 5 全面重写

• 新增「用户类型」表（Free / Starter ⭐ / Enterprise / Token Plan）
• 新增「API Key 类型与限制池」章节
• 订阅配额增加 $/月 单位 + 配额计算说明
• 引用官方 TOKEN_PLAN_FAQ.md

⚠️ 1M 上下文回滚标注

• 官方 MODEL_CATALOG.md 声明 1M 已回滚（rolled back for stability）
• 但官方文档页面仍标注 512K / 65.5K
• 两处矛盾已加注说明，建议以官方文档页面为准

📝 触发词新增

• Token Plan、订阅、Starter、Plus、Pro

---

合并来源：

• lj1270998580-crypto/Agnes-help-skill（v1.2.13: 视频 RPM → 1）
• AgnesAI-Labs/Agnes-AI（MODEL_CATALOG 2026.06.28 + TOKEN_PLAN_FAQ）

v2.3.0

v2.3.0 更新内容

新增功能

• 版本检查升级为5步流程：检测版本 → 读取更新内容 → 向用户报告 → 用户选择更新 → HTML/API文档检查（合并自 lj 上游）
• 新增「官方问题反馈渠道」章节：3种场景（Bug反馈、需求建议、进度查询），含 GitHub Issues、Projects 看板、support@agnes-ai.com（合并自 lj 上游）
• 新增 Section 5A「API 错误码参考」：22个状态码的中英文对照，含常见原因和建议方案（合并自 Agnes AI 官方 ERROR_CODES.md）
• 常见错误速查表底部增加反馈引导：排查无效时引导用户到官方反馈渠道
• 触发词增加：反馈、Bug 反馈、问题反馈、错误码

合并来源

• lj1270998580-crypto/Agnes-help-skill（2026-06-23 提交：版本检查升级、反馈渠道、反馈触发词）
• AgnesAI-Labs/Agnes-AI（2026-06-23 提交：双语 ERROR_CODES.md）

保留的自定义修改

• 删除所有 引用
• 默认启用 Thinking 模式
• video_id 必须查询 + num_frames 10 个合法值
• 来源声明（3行）
• 仓库引用统一为
• README 超链接
• 图像默认 9:16 2K，移除 1:1 比例
• Section 5 访问与限制（RPM 速查表 + 订阅配额）
• agnes-2.0-flash Context 标注为 512K（内测，官方文档未同步）

v2.2.0

v2.2.0 更新内容

新增：访问与限制章节（Section 5）

• 文本/图像/视频模型 RPM 速查表（Free / Enterprise / Token Plan）
• 付费订阅配额（Starter / Plus / Pro）
• RPM 字段说明（公开请求 RPM vs 实际可执行 RPM）
• 引用官方 MODEL_CATALOG.md

新增：官方 GitHub

• 头部信息增加官方 GitHub 链接：https://github.com/AgnesAI-Labs/Agnes-AI
• 社区资源增加官方模型目录链接

来源声明更新

• 增加官方 GitHub 来源（AgnesAI-Labs/Agnes-AI）
• 移除定制详细说明列表，精简来源声明

其他

• Context 规格说明增加官方 MODEL_CATALOG 引用
• 全文 RPM 引用统一指向第 5 节

v2.1.0

v2.1.0 更新内容

同步上游（lj1270998580 v1.2.10）

• Context 升级 512K：Agnes-2.0-Flash 上下文窗口从 256K 升级至 512K，Max Output 从 65.5K 调整为 64K
• 4K 图片已全面支持：所有用户可用，不再需要灰度自检
• 1M 上下文灰度测试更新：测试基准从 256K 更新为 512K（需发送 2.5M+ 字符）

用户自定义修改

• 图像默认 9:16 2K：默认分辨率从 1K 改为 9:16 2K（1440x2560）
• 移除 1:1 比例：图像尺寸表不再包含 1:1（1024x1024）选项
• 灰度自检更新：4K 图片标记为已全面支持，1M 上下文仍为灰度

保留的历史自定义

• 移除 agnes-1.5-flash
• agnes-2.0-flash 默认启用 Thinking 模式
• default-enabled: true
• video_id 必须查询 + num_frames 10 个合法值
• Responses API 多轮函数调用不可靠警告
• 来源声明 + 仓库引用统一为 imsancn/agnes-ai-skill