zown-gemini-governor

🎛️ Gemini TPM 速率限制智能防控专家

基于 Zown 协议的 Token 管理方案,通过原子管道和上下文剪枝技术,有效防止 Gemini API 速率限制,保障复杂工程任务的稳定执行。

收藏
8.9k
安装
2.7k
版本
v0.1.0
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

Zown Gemini Governor 是一款专注于解决 Gemini API 速率限制(TPM)问题的策略性技能。它通过建立标准化的"原子管道"工作流程,为开发者提供系统化的 Token 管理方案,特别适用于高复杂度的工程任务和多步骤代码生成场景。

核心用法
该技能的核心在于实施三大协议:首先是上下文剪枝,要求将历史记录压缩至 MEMORY.md 并保持实时上下文低于 500 tokens,避免"token fat"导致的性能衰减;其次是50% 规则的速率限制预防机制,当检测到当前分钟 TPM 使用率超过 50% 或 2 分钟内发送超过 3 个重型工程提示时,强制触发 60 秒冷却期;最后是原子逻辑,要求将复杂任务拆解为单一可验证步骤,禁止在单轮对话中混合"计划"与"执行"。此外,技能还规范了多代理协作时的身份文件压缩和状态同步协议。

显著优点
作为纯文档型资产,该技能具有极高的安全性与透明度,不存在代码执行风险。其方法论价值在于将模糊的"避免 429 错误"经验转化为可量化的操作标准(50% 阈值、500 tokens 限制、3 提示/2 分钟规则),显著提升了大规模代码生成任务的稳定性。通过强制冷却和上下文压缩,能有效延长 API 会话的有效工作时长,减少因速率限制导致的任务中断。

潜在局限
该技能的主要局限在于其指导性质——它提供的是协议规范而非现成工具,用户需要自行实现 cooldown.py 等辅助脚本。来源等级为 T3(个人开发者),长期维护与更新存在不确定性。此外,其策略可能过于保守(如固定的 60 秒冷却),在某些紧急场景下可能造成不必要的时间损耗,且目前专门针对 Gemini 设计,通用性有限。

适合群体
主要面向频繁使用 Gemini API 进行复杂工程开发、常遭遇 429 速率限制的中高级开发者,特别是那些需要执行多步骤代码生成、大型重构任务或长时间 AI 辅助编程的技术团队。对于追求 API 调用稳定性和 Token 使用效率的 DevOps 工程师和架构师同样具有参考价值。

使用风险
用户需自行承担脚本实现的安全责任,若按示例实现冷却脚本,需确保其不包含恶意代码。过度依赖强制冷却可能导致工作流效率降低。作为社区贡献项目,其策略可能未及时跟进 Gemini API 的最新限制政策变更。此外,频繁的文件压缩和记忆体管理可能增加认知负担,不当的上下文剪枝甚至可能导致重要历史信息丢失。

安全解读

核心用法

Zown Gemini Governor 是一套面向 Google Gemini 模型的 Token 速率管理协议,专为高频工程任务设计。其核心机制包含三层:

1. 上下文剪枝(Context Pruning):强制将大型身份文件(如 SOUL.md)压缩至 500 Token 以内,通过 MEMORY.md 维持状态,避免上下文膨胀导致的隐性消耗。

2. 50% 阈值冷却(50% Rule):实时监控 TPM(Tokens Per Minute)使用率,一旦超过 50% 或 2 分钟内触发 3 次以上重型工程提示,自动执行 60 秒强制冷却(python3 scripts/cooldown.py 60)。

3. 原子流水线(Atomic Pipeline):将复杂任务拆分为单一可验证步骤,禁止"计划+执行"的单轮合并操作,确保每一步都可追溯、可恢复。

显著优点

  • 零代码执行风险:纯 Markdown 文档型 Skill,无实际可执行代码块,网络攻击面为零
  • 工程级鲁棒性:针对 Gemini 1.5 Pro/Flash 的 4M TPM 硬限制设计,经 openclaw 组织实战验证
  • 协作透明性:内置多 Agent 协作协议,强制同步 MEMORY.md 防止状态漂移
  • 热插拔设计:支持 CLI 旁路模式(gemini 命令),轻量问答时可完全绕过会话上下文

潜在局限

  • 手动执行依赖:冷却脚本需用户环境预置 python3 scripts/cooldown.py,Skill 本身不自动执行
  • Token 计数盲区:依赖外部 session_status 工具获取 TPM 数据,无内置计数器
  • 单模型局限:协议针对 Gemini 优化,对 Claude/GPT 系列的 RPM/TPM 混合限制适配性有限
  • 许可证缺失:当前版本未声明开源许可证,影响企业合规采用

适合人群

  • 使用 Gemini API 进行 多文件代码生成批量文档处理 的开发者
  • 频繁遭遇 429 RESOURCE_EXHAUSTED 错误、需要 确定性速率控制 的工程团队
  • 运行长期会话(>1 小时)且需 防止上下文爆炸 的 Agent 工作流

常规风险

| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 误用风险 | 中 | 过度冷却可能导致任务延迟,建议结合业务 SLA 调整阈值 |
| 环境依赖 | 低 | cooldown.py 脚本需自行实现,文档未提供参考实现 |
| 协议漂移 | 低 | Zown 协议版本迭代时,MEMORY.md 格式可能需同步更新 |

安全认证摘要

经 CLS-Certify v2.1.0 扫描:S 级/92分,T2 来源可信度(openclaw GitHub 组织)。纯 Markdown 架构,零外部调用,符合 GDPR/CCPA 数据最小化原则。

zown-gemini-governor 内容

手动下载zip · 1.5 kB
SKILL.mdtext/markdown
请选择文件