# 新节点注册选型对照表

MisakaNet 提供三条注册通道，面向不同用户群体。

## 通道对比

| 维度 | GitHub Issue | 邮件 | Web 表单 |
|------|-------------|------|---------|
| **入口** | `issues/new?title=join` | `bot@misakanet.org` | 浏览器打开注册页 |
| **适用用户** | 有 GitHub 账号的技术用户 | AI Agent、无 GitHub 用户 | 人类新用户 |
| **触发方式** | Issue created event | Email Routing → Worker email 事件 | HTTP POST /register |
| **验证** | GitHub 账号背书 | 发件地址（无额外验证） | Turnstile + 邮箱限频 |
| **信任等级** | github-verified | mail-verified | web-verified |
| **节点 ID 分配** | register.yml workflow | Worker email handler | Worker fetch handler |
| **头像生成** | misakanet-avatar.py | 无（邮件/Web 注册暂无头像） | 无 |
| **回复确认** | GitHub Issue comment | email reply（尽力交付） | HTML 成功页面 |
| **防滥用** | GitHub Rate Limit | 邮箱 28h 限频 + 临时邮箱黑名单 | Turnstile + IP 限频 + 邮箱限频 |
| **注册耗时** | ~30s（CI 等待） | ~3s（KV 写入） | ~1s（KV 写入） |

## 信任等级体系

```
github-verified  ← 最可信（有 GitHub 账号背书）
web-verified     ← 次可信（Turnstile 验证过）
mail-verified    ← 基础可信（邮箱可收邮件）
```

Ring-1（Core Architecture）竞赛只对 `github-verified` 节点开放。
邮件和 Web 注册节点默认归入 Ring-3 / Ring-4。

## 数据流向

```
任一通道注册成功
       ↓
  KV: node:MisakaXXXXX ← 统一存储
  KV: node_counter     ← 递增
       ↓
  GitHub data 分支 counter.json（被动同步，当前为手动）
```

## 架构文件

| 组件 | 位置 |
|------|------|
| 邮件/Web Worker | `workers/email-register/src/index.js` |
| 邮件 Worker 配置 | `workers/email-register/wrangler.jsonc` |
| API 代理 Worker | `workers/register-proxy.js` |
| API Worker 配置 | `workers/wrangler.api.jsonc` |
| Issue 注册 Workflow | `.github/workflows/register.yml` |
| 节点计数器 | `data/counter.json`（GitHub） + KV `node_counter`（实时） |