Leaderboard zh

Leaderboard · [中文]

排行榜

与其他 Claude Code 用户比较分数。参与完全自愿。

加入排行榜

cc-proficiency share

前提条件：

• gh CLI 已安装并认证（gh auth login）
• 已配置 Gist（先运行 cc-proficiency init）
• 至少运行过一次分析（cc-proficiency analyze）

加入时会发生什么：

1. 显示隐私摘要，准确列出将公开分享的内容
2. 将数据同步到您的私有 Gist
3. 创建一个独立的公开 Gist，仅包含您的公开资料 JSON（cc-proficiency-public.json）
4. 在 cc-proficiency 仓库开启 GitHub Issue，注册您的公开 Gist URL
5. GitHub Action 处理该 Issue，将您的条目添加到注册表并关闭 Issue
6. 将 leaderboard: true 和您的 publicGistId 保存到本地配置文件

注册 Issue 处理完成后（通常在几分钟内），您的资料将出现在排行榜中。

查看排行榜

cc-proficiency leaderboard [--sort=<field>] [--limit=N]

默认输出按平均分排序的前 20 名用户：

  cc-proficiency Leaderboard (12 users)
  ──────────────────────────────────────────────────────────
   #  User             Avg   CC   Tool  Agen  Prmp  Ctx
  ──────────────────────────────────────────────────────────
    1  @alice            94    97    96    91    95    91
    2  @bob              87    82    91    85    88    89
    3  @carol            86    90    88    80    85    87
    4  @yourname         84    77    96    69    81   100  ◄
  ──────────────────────────────────────────────────────────
  12 users · Updated just now

您自己的条目用 ◄ 标记。

排序选项：

--sort=	排序依据
avg	所有 5 个领域分数的平均值（默认）
cc-mastery	CC 掌握度领域分数
tool-mcp	工具与 MCP 领域分数
agentic	智能体领域分数
prompt-craft	提示技巧领域分数
context-mgmt	上下文管理领域分数
hours	Claude Code 总使用时长
streak	当前连续天数

限制显示数量：

cc-proficiency leaderboard --sort=hours --limit=10

排名工作原理

1. 排行榜命令从项目维护者的公开 Gist 获取注册表（一个 JSON 文件，列出所有参与者及其公开 Gist ID）
2. 对于每个注册表条目，获取其公开 Gist 读取 PublicProfile JSON
3. 对条目进行排序并显示
4. 结果在本地缓存，避免频繁调用 GitHub API

PublicProfile 结构仅包含公开安全的字段：

{
  "version": "1.0.0",
  "username": "yourname",
  "memberSince": "2026-01-01",
  "domains": [
    { "id": "cc-mastery", "score": 77, "confidence": "high" },
    { "id": "tool-mcp",   "score": 96, "confidence": "high" },
    ...
  ],
  "streak": { "current": 12, "longest": 30 },
  "achievementCount": 9,
  "totalSessions": 139,
  "totalHours": 39.3,
  "lastUpdated": "2026-03-18T10:22:00Z"
}

保持资料更新

加入排行榜后，每次会话结束后您的公开资料会自动更新（通过 Stop 钩子 → process → 推送）。公开 Gist 的内容被原地更新，Gist ID 保持不变。

您也可以手动更新：

cc-proficiency push

退出排行榜

cc-proficiency share --remove

执行步骤：

1. 在 cc-proficiency 仓库开启移除 Issue
2. GitHub Action 处理移除请求，从注册表中删除您的条目
3. 删除您的公开 Gist
4. 从本地配置中清除 leaderboard 和 publicGistId

您的私有 Gist（徽章 + 私有数据）不受影响。

注册机制

排行榜由 GitHub 基础设施驱动，无需中心服务器：

用户运行 cc-proficiency share
  → 创建包含 PublicProfile JSON 的公开 Gist
  → 在 cc-proficiency 仓库开启"加入"Issue
  → GitHub Action 读取 Issue，将条目添加到注册表 JSON
  → 关闭 Issue

cc-proficiency leaderboard
  → 从仓库获取注册表
  → 对每个条目，获取用户的公开 Gist
  → 聚合并排序

这意味着：

• 无需中心服务器或数据库——所有内容都托管在 GitHub
• 注册表是版本控制的 JSON 文件（LeaderboardRegistry），存储在项目维护者的公开 Gist 中
• 每位用户的数据存储在各自的公开 Gist 中——用户自己掌控

隐私摘要

加入排行榜时公开的内容：

• GitHub 用户名
• 领域分数（5 个数字，每个 0–100）
• 连续天数（当前和最长）
• 成就数量
• 总会话数和总时长
• 加入时间

绝对不会分享的内容：

• 会话详情、项目名称、文件路径、提示内容
• 您在哪个会话中使用了哪些工具
• 您的私有 Gist 内容
• 任何转录数据

完整说明请参阅 Privacy-zh。