tier-management

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Requirements

前置要求

Before using this skill, ensure you have:

GitHub CLI:
```
brew install gh && gh auth login
```
Node.js/npx:
```
brew install node
```
Wrangler:
```
npm install -g wrangler
```
jq:
```
brew install jq
```
(for parsing JSON)
sops:
```
brew install sops
```
(for decrypting secrets)

Must run from the

pollinations

repo root with access to

enter.pollinations.ai/

使用本技能前，请确保你已安装：

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/

的访问权限。

Tier Levels

层级等级

Tier	Emoji	Pollen/Day	Criteria
microbe	🦠	0.1	Entry tier (auto-upgrades once verified)
spore	🍄	1	Verified accounts
seed	🌱	3	GitHub engagement
flower	🌸	10	Contributor
nectar	🍯	20	Coming soon

层级	表情	每日花粉量	达标条件
microbe	🦠	0.1	入门层级（验证后自动升级）
spore	🍄	1	已验证账户
seed	🌱	3	GitHub互动记录
flower	🌸	10	贡献者
nectar	🍯	20	即将推出

Upgrade Paths

升级路径

🍄 Spore → 🌱 Seed

🍄 Spore层级 → 🌱 Seed层级

⭐ Starred the pollinations repo
💬 Opened an issue or PR
💳 Made a purchase

⭐ 已为pollinations仓库点亮星标
💬 提交过issue或PR
💳 有过购买记录

🌱 Seed → 🌸 Flower

🌱 Seed层级 → 🌸 Flower层级

🛠️ Pushed code to pollinations/pollinations
📦 Has a project in our showcase
🌐 Built something open-source using our API

🛠️ 向pollinations/pollinations仓库推送过代码
📦 项目已收录至我们的展示列表
🌐 基于我们的API开发过开源项目

Evaluate User Tier

评估用户层级

Check for Flower (any ONE qualifies)

检查是否符合Flower层级（满足任意一项即可）

Has commits to pollinations?

bash

gh api 'search/commits?q=repo:pollinations/pollinations+author:USERNAME' --jq '.total_count'

Has a project in our lists?

bash

grep -ri "author.*USERNAME" pollinations.ai/src/config/projects/

是否向pollinations仓库提交过代码？

bash

gh api 'search/commits?q=repo:pollinations/pollinations+author:USERNAME' --jq '.total_count'

项目是否在我们的列表中？

bash

grep -ri "author.*USERNAME" pollinations.ai/src/config/projects/

Check for Seed (any ONE qualifies)

检查是否符合Seed层级（满足任意一项即可）

Involved in issues/PRs?

bash

gh api 'search/issues?q=repo:pollinations/pollinations+involves:USERNAME' --jq '.total_count'

Starred repo?

bash

.claude/skills/tier-management/scripts/fetch-stargazers.sh USERNAME

是否参与过issue/PR？

bash

gh api 'search/issues?q=repo:pollinations/pollinations+involves:USERNAME' --jq '.total_count'

是否为仓库点亮星标？

bash

.claude/skills/tier-management/scripts/fetch-stargazers.sh USERNAME

Update User Tier

更新用户层级

How Tiers Work Now

当前层级机制

Tier balance refills daily at midnight UTC via Cloudflare cron trigger
No rollover - balance resets to tier amount each day
Just update D1 - no external subscription system needed

层级余额每日重置：通过Cloudflare定时触发器在UTC时间午夜重置
不结转：每日余额重置为对应层级的额度
仅需更新D1数据库：无需外部订阅系统

Quick Update

快速更新流程

Step 1: Find user

步骤1：查找用户

bash

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%';"

bash

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%';"

Step 2: Update tier

步骤2：更新层级

bash

npx wrangler d1 execute DB --remote --env production \
  --command "UPDATE user SET tier='TIER' WHERE github_username='USERNAME';"

Balance will update automatically at next midnight UTC refill.

bash

npx wrangler d1 execute DB --remote --env production \
  --command "UPDATE user SET tier='TIER' WHERE github_username='USERNAME';"

余额将在下次UTC时间午夜的自动重置时更新。

Step 3 (Optional): Immediate balance update

步骤3（可选）：立即更新余额

bash

undefined

bash

undefined

Set balance immediately (e.g., flower = 10 pollen)

立即设置余额（例如，flower层级=10花粉）

npx wrangler d1 execute DB --remote --env production
--command "UPDATE user SET tier='flower', tier_balance=10 WHERE github_username='USERNAME';"

Step 4: Notify user on GitHub

步骤4：在GitHub通知用户

🎉 **Tier Upgrade!**

Hey @USERNAME! You've been upgraded to **[EMOJI] [TIER] tier**! ✨

Your benefits:
- [POLLEN] pollen/day (refills daily at midnight UTC)
- 🎨 All standard models

Thanks for being part of pollinations.ai! 🚀

🎉 **层级升级通知！**

嗨 @USERNAME！你已升级为 **[表情] [层级名称] 层级**！ ✨

你将获得以下权益：
- 每日[花粉量]花粉（UTC时间午夜自动重置）
- 🎨 可使用所有标准模型

感谢你加入pollinations.ai！ 🚀

Batch Processing

批量处理

Find Users with Billing Issues

查找存在账单问题的用户

Use the model-debugging skill to find users hitting 402 errors (billing/quota):

bash

undefined

使用model-debugging技能查找遇到402错误（账单/配额问题）的用户：

bash

undefined

Find spore-tier users with >10 402 errors in last 24 hours

查找过去24小时内出现10次以上402错误的spore层级用户

.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


> **Note**: 402 = billing issues (pollen balance, key budget). 403 = permission issues (model access denied).

.claude/skills/model-debugging/scripts/find-402-users.sh 24 10 spore | cut -f1 > /tmp/users.txt


> **注意**：402错误表示账单问题（花粉余额、密钥预算不足）。403错误表示权限问题（模型访问被拒绝）。

Check if User is a Developer

检查用户是否为开发者

bash

undefined

bash

undefined

Check single user

检查单个用户

.claude/skills/tier-management/scripts/check-github-dev.sh OliverCWY

Output: dev: repos=12 followers=13 account_year=2017

输出示例：dev: repos=12 followers=13 account_year=2017

undefined

undefined

Batch Upgrade Devs to Seed

批量将开发者升级至Seed层级

bash

undefined

bash

undefined

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


The script:
- Checks GitHub profile for dev activity (repos, followers, account age)
- Only upgrades users currently on spore tier (won't downgrade)
- Has 2s delay between GitHub API calls to avoid rate limiting
- Shows summary of upgraded/skipped users

.claude/skills/tier-management/scripts/upgrade-devs.sh /tmp/users.txt


该脚本功能：
- 检查GitHub资料中的开发者活动（仓库数量、关注者数量、账户注册时长）
- 仅升级当前为spore层级的用户（不会降级）
- GitHub API调用之间有2秒延迟，避免触发速率限制
- 显示升级/跳过用户的汇总信息

Check User Balance

检查用户余额

bash

.claude/skills/tier-management/scripts/check-user-balance.sh username_or_email

bash

.claude/skills/tier-management/scripts/check-user-balance.sh username_or_email

Legacy Batch Evaluate

旧版批量评估流程

bash

export ENTER_ADMIN_TOKEN=your_token
export TIER_EVAL_GIST_ID=your_gist_id  # optional
.claude/skills/tier-management/scripts/batch-evaluate.sh

bash

export ENTER_ADMIN_TOKEN=your_token
export TIER_EVAL_GIST_ID=your_gist_id  # 可选
.claude/skills/tier-management/scripts/batch-evaluate.sh

Key Files

关键文件

File	Purpose
`enter.pollinations.ai/src/tier-config.ts`	Tier → pollen mapping (source of truth)
`enter.pollinations.ai/src/scheduled.ts`	Cron handler: daily refill
`enter.pollinations.ai/src/auth.ts`	Sets tier on new user registration
`enter.pollinations.ai/wrangler.toml`	Cron schedule: `0 0 * * *`

文件	用途
`enter.pollinations.ai/src/tier-config.ts`	层级→花粉量映射（权威配置源）
`enter.pollinations.ai/src/scheduled.ts`	定时任务处理器：每日余额重置
`enter.pollinations.ai/src/auth.ts`	新用户注册时设置初始层级
`enter.pollinations.ai/wrangler.toml`	定时任务调度： `0 0 * * *`

Notes

注意事项

Tier balance resets daily at midnight UTC (no rollover)
New users get
```
spore
```
tier + 1 pollen immediately
Tier upgrades take effect on next refill (or set
```
tier_balance
```
manually)

层级余额每日重置：UTC时间午夜重置（不结转）
新用户自动获得
```
spore
```
层级+1花粉额度
层级升级将在下次余额重置时生效（或手动设置
```
tier_balance
```
立即生效）