关于 tier-management
tier-management 是用于在 pollinations 仓库评估和更新用户等级的运维技能,涵盖资格检查、数据库更新、余额处理及批量升级脚本。
主要功能
- 01检查 GitHub 活动以评估等级资格
- 02查询并更新 D1 中的用户等级
- 03处理等级余额补充及即时更新
- 04查找需审核的计费错误用户
- 05通过试运行执行开发者批量升级
适用场景
- 01评估用户是否符合 Seed 或 Flower 资格
- 02更新等级并按需设置余额
- 03审核计费错误账户或批量升级开发者
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ pollinations/ pollinations --skill tier-management安装后在 Claude Code 中输入/tier-management确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
.gitignorescripts/check-github-dev.shcheck-user-balance.shfetch-stargazers.shupdate-tier.shupgrade-devs.sh详细介绍
要求
使用此技能前,请确保已安装:
- GitHub CLI:
brew install gh && gh auth login - Node.js/npx:
brew install node - Wrangler:
npm install -g wrangler - jq:
brew install jq(用于解析 JSON) - sops:
brew install sops(用于解密密钥)
必须在 pollinations 仓库根目录下运行,并且能够访问 enter.pollinations.ai/。
等级
| 等级 | 表情符号 | Pollen | 周期 | 条件 |
|---|---|---|---|---|
| microbe | 🦠 | 0 | 无 | 账户正在审核中 |
| spore | 🍄 | 0.01 | 每小时 | 已验证的账户 |
| seed | 🌱 | 0.15 | 每小时 | GitHub 活跃度 |
| flower | 🌸 | 0.4 | 每小时 | 贡献者 |
| nectar | 🍯 | 0.8 | 每小时 | 旧版等级 — 仍为现有用户提供支持,不再授予 |
升级路径
🍄 Spore → 🌱 Seed
- ⭐ 为 pollinations 仓库点星
- 💬 提交 issue 或 PR
- 💳 进行购买
🌱 Seed → 🌸 Flower
- 🛠️ 向 pollinations/pollinations 推送代码
- 📦 在我们的展示列表中有项目
- 🌐 使用我们的 API 构建开源项目
评估用户等级
检查是否符合 Flower(满足任意一项即可)
是否向 pollinations 提交过代码?
gh api 'search/commits?q=repo:pollinations/pollinations+author:USERNAME' --jq '.total_count'
是否在我们的列表中有项目?
grep -ri "author.*USERNAME" pollinations.ai/src/config/projects/
检查是否符合 Seed(满足任意一项即可)
是否参与过 issue/PR?
gh api 'search/issues?q=repo:pollinations/pollinations+involves:USERNAME' --jq '.total_count'
是否为仓库点过星?
.claude/skills/tier-management/scripts/fetch-stargazers.sh USERNAME
更新用户等级
当前等级机制
- 所有等级的等级余额每小时补充一次
- 不结转 - 每个周期都会将余额重置为该等级的额度
- 只需更新 D1 - 无需外部订阅系统
快速更新
步骤 1:查找用户
cd enter.pollinations.ai
npx wrangler d1 execute DB --remote --env production \
--command "SELECT id, github_username, email, tier, tier_balance FROM user WHERE LOWER(github_username) LIKE '%USERNAME%';"
步骤 2:更新等级
npx wrangler d1 execute DB --remote --env production \
--command "UPDATE user SET tier='TIER' WHERE github_username='USERNAME';"
余额将在下一个每小时补充周期自动更新。
步骤 3(可选):立即更新余额
# Set balance immediately (e.g., flower = 0.4 pollen)
npx wrangler d1 execute DB --remote --env production \
--command "UPDATE user SET tier='flower', tier_balance=0.4 WHERE github_username='USERNAME';"
步骤 4:在 GitHub 上通知用户
Hey @USERNAME! You've been upgraded to [EMOJI] [TIER] tier!
Your benefits:
- [POLLEN] free compute (refills hourly)
- All standard models
批量处理
查找存在计费问题的用户
使用 model-debugging 技能查找遇到 402 错误(计费/额度)的用户:
# Find spore-tier users with >10 402 errors in last 24 hours
.claude/skills/model-debugging/scripts/find-402-users.sh 24 10 spore
# Save to file for batch processing
.claude/skills/model-debugging/scripts/find-402-users.sh 24 10 spore | cut -f1 > /tmp/users.txt
注意:402 = 计费问题(Pollen 余额、密钥预算)。403 = 权限问题(模型访问被拒绝)。
检查用户是否为开发者
# Check single user
.claude/skills/tier-management/scripts/check-github-dev.sh OliverCWY
# Output: dev: repos=12 followers=13 account_year=2017
批量将开发者升级为 Seed
# Dry run first (no changes)
.claude/skills/tier-management/scripts/upgrade-devs.sh /tmp/users.txt --dry-run
# Apply upgrades
.claude/skills/tier-management/scripts/upgrade-devs.sh /tmp/users.txt
该脚本:
- 检查 GitHub 个人资料中的开发者活动(仓库、关注者、账户年龄)
- 仅升级当前处于 spore 等级的用户(不会降级)
- 在 GitHub API 调用之间延迟 2 秒,以避免触发速率限制
- 显示已升级/已跳过用户的汇总信息
检查用户余额
.claude/skills/tier-management/scripts/check-user-balance.sh username_or_email
关键文件
| 文件 | 用途 |
|---|---|
enter.pollinations.ai/src/tier-config.ts | 等级 → Pollen 映射(事实来源) |
enter.pollinations.ai/src/scheduled.ts | Cron 处理程序:等级补充(每小时/每天) |
enter.pollinations.ai/src/auth.ts | 为新用户注册设置等级 |
enter.pollinations.ai/wrangler.toml | Cron 计划:0 0 * * * |
备注
- 所有等级的等级余额每小时补充一次;不结转
- 新用户会获得
spore等级 + 每小时 0.01 Pollen - 等级升级将在下一个补充周期生效(或手动设置
tier_balance)
评论
支持 Markdown