鉴权并入 Auth Broker：委派设备会话统一模型 + 四端迁移

后端（委托 Auth Broker，路径 A）：
- 删自建鉴权（OIDC exchange / 自签会话 / step-up / shortcut / web_sessions / accounts），cdrop 不再存任何凭证；鉴权中间件改读边缘注入的 X-Auth-Subject/Scope/Meta/Name/Roles 头（dev 旁路保留）；Claims 加 Tier() / Guest()
- internal/brokerclient：mint / revoke（带 X-Broker-App）/ refresh / ListSessions（R1 列举），直连内网、吊销幂等

统一会话模型“委派设备会话”（Delegated Device Sessions）：
- 每个客户端（浏览器 / 桌面 / 扫码设备）＝一条带 meta(device_id) + label 的 broker 机器会话；Broker 作设备会话唯一注册表（R1 按用户＋app 列举 + R2 按 (user,app,meta) 幂等铸造），cdrop 退化为薄覆盖层、不再自存权威会话表
- 新增代铸端点 POST /api/auth/device-session：凭边缘已验明的 X-Auth-Subject 委托 broker 铸 / 轮换设备会话（meta=device_id、按调用方 tier 防越权、sameOrigin CSRF、per-IP 限流）；R2 幂等保证同一 device_id 重登原地轮换、不堆重复设备
- 会话列表＝R1 权威 + 叠加 type（本地缓存）/ online（Hub presence，按设备名）/ current（meta 匹配本请求 X-Auth-Meta）+ 过滤 meta=""（device-authorize 引导会话残留）；devices 表降级为 type/presence 薄缓存（非会话权威），device_id 主键、upsert 按 user 限定
- 吊销按 device_id → 缓存优先 / R1 兜底解析 sid → broker 吊销 + X-Broker-App；扫码登录保留三密钥编排，collect 改委托 broker 铸 + 落缓存行

Web 前端：
- 登录走 broker 全局 SSO 代跳（/api/auth/login 302）；bootstrap 经 /api/me 注入身份后代铸设备会话（稳定 device_id 存 localStorage、Web Locks 跨 tab 串行防重复铸造）；refresh 走 /api/auth/refresh
- 设备管理按 device_id；改名＝同 device_id 重代铸（R2 原地轮换换 label、不产生重复行）；登录页反应式守卫修登录回环
- 去 OIDC PKCE / step-up（删 oauth.callback / stepUp）

桌面客户端（Wails）：
- loopback PKCE（RFC 8252）改指 broker 设备授权流（/device/authorize + /device/token）拿引导令牌，再代铸出带 meta 的托管设备会话——与浏览器同模型、同管理、同吊销；身份取自代铸响应（修“显示名显示为 UUID”）；refresh 保留显示名；稳定 device_id 入桌面配置

iOS 客户端（arch A，原生 SwiftUI + 离屏无头 WebView 引擎 + 原生↔JS 桥）：
- 引擎 / 文件管理 / 设备管理 / 应用图标 / 本地化（此前实现，随本次落入版本库）
- 鉴权＝引擎自刷（boot 注入 refresh_token）+ broker 轮换经 sessionRotated 回报原生更新 Keychain；去 cookie 同步；Session 加 refreshToken / deviceId

实时 / 健壮性：
- presence 走 Hub union（设备表行 ∪ 表外实时连接，按名去重、live-only 标在线）
- Hub 通道 close 一律在写锁内、非阻塞 send 一律在读锁内，消除 close-vs-send 闭通道 send panic（revoke 每次 Kick 后该路径变热）

配置 / 删旧栈：
- config 改 broker 接入（CDROP_BROKER_* / CDROP_PUBLIC_URL / 按档 TTL），prod 强校验 broker 配置 + PUBLIC_URL（CSRF Origin 守卫不失效）
- 删 auth.go / selftoken.go / shortcut.go / jwks.go + 三表（web_sessions / accounts / shortcut_tokens）及验证链；.env.example / compose.snippet.yaml / Caddyfile.snippet 更新为 broker 模型（人机分流 + 公开端点放行 + X-Auth-Meta 透传）
- 测试全重写：QR / 会话含 mock broker（R1 列举 + R2 幂等）；hub 加 close-vs-send 并发回归；config 加 prod 必填校验

.env.example

@@ -3,21 +3,22 @@
 CDROP_AUTH_MODE=dev
 CDROP_DEV_TOKEN=replace-with-32-byte-random-base64
 
-# prod 模式所需（填入你的 OIDC provider，如自建 Casdoor / Keycloak）
+# prod 模式所需（Auth Broker 路径 A）。cdrop 把身份与会话生命周期委托给 broker：每个受控
+# 请求在边缘由 broker /verify（经 Caddy）鉴权并注入 X-Auth-* 头；扫码批准 / 设备续期 / 吊销
+# 经 broker 内部 + 公开 API。cdrop 不再自做 OIDC、不存任何凭证。
 # CDROP_AUTH_MODE=prod
-# CDROP_OIDC_AUTHORIZE_URL=https://your-idp.example/login/oauth/authorize
-# CDROP_OIDC_TOKEN_URL=https://your-idp.example/api/login/oauth/access_token
-# CDROP_OIDC_JWKS_URL=https://your-idp.example/.well-known/jwks
-# CDROP_OIDC_ISSUER=https://your-idp.example/
-# prod 强制非空：填你的 OAuth client_id（多值逗号分隔，web + 桌面端共用时填同一个）
-# CDROP_OIDC_AUDIENCE=your-client-id
-# CDROP_OIDC_CLIENT_ID=your-client-id
-# CDROP_OIDC_REDIRECT_URI=https://your-domain.example/oauth/callback
-# CDROP_OIDC_SCOPES=openid profile email
-# prod 强制非空：浏览器免重登会话的 refresh_token 落盘加密密钥（任意长度高熵串，
-# 内部 SHA-256 派生为 32 字节 AES-256 密钥）。留空则 prod 启动期校验失败、拒启动。
-# CDROP_SESSION_SECRET=
-# CDROP_HS256_SECRET=
+# broker 内网地址（docker 内网直连，绝不经公网反代——以保 /internal/* 与 /refresh 可达）。
+# prod 强制非空。
+# CDROP_BROKER_BASE_URL=http://broker-internal-ip:8080
+# broker /internal/* 端点共享密钥（作 X-Internal-Key 发送）。prod 强制非空，向运维取、勿硬编码。
+# CDROP_BROKER_INTERNAL_KEY=
+# broker 公开源（浏览器全局 SSO 登录跳转 / 原生客户端设备授权流的目标）。留空则
+# /api/auth/login 与原生登录不可用。
+# CDROP_BROKER_PUBLIC_URL=https://sso.your-domain.example
+# 本应用在 broker apps 注册表里的 key（默认 cdrop）。
+# CDROP_BROKER_APP=cdrop
+# 部署公开源（拼扫码 QR 链接 / CSRF Origin 校验 / Web Push 默认联系标识）。
+# CDROP_PUBLIC_URL=https://drop.your-domain.example
 # CDROP_TURN_URL=stun:your-stun.example:3478
 
 # 可选：Web Push（VAPID）推送通知。用 `just vapid-keygen` 生成一对密钥；二者须同时
@@ -27,22 +28,20 @@ CDROP_DEV_TOKEN=replace-with-32-byte-random-base64
 # CDROP_VAPID_PRIVATE_KEY=
 # CDROP_VAPID_SUBJECT=mailto:you@your-domain.example
 
-# 可选：扫码登录（QR）与 cdrop 自签会话。SESSION_SECRET 已设时默认开启；下列均有默认值，
-# 不配即用默认，各项可单独调整 / 关闭对应行为。
-# CDROP_QR_LOGIN_ENABLED=true            # 关闭则 /api/auth/qr/* 返回 503
-# CDROP_QR_REQUEST_TTL_SECONDS=120       # 二维码 / 登录请求有效期（秒）
-# CDROP_QR_GUEST_TTL_SECONDS=3600        # 仅此次（受限访客）会话 TTL（秒）
-# CDROP_QR_PERSIST_TTL_HOURS=168         # 信任此设备（持久）会话 TTL（小时）
-# CDROP_SESSION_TOKEN_TTL_SECONDS=900    # cdrop 自签 access token TTL（秒）
-# CDROP_STEP_UP_ENABLED=false            # 批准扫码设备等敏感动作要求 provider 再认证
-# CDROP_STEP_UP_MAX_AGE_SECONDS=300      # step-up 的 auth_time 新鲜度窗口（秒）
-# CDROP_ACCOUNT_MATCH_CLAIM=email        # 写入 accounts.match_key 的 JWT claim
+# 可选：扫码登录（QR）+ 按档令牌 TTL（批准后经 broker 委托签发对应 tier 的会话）。下列均有
+# 默认值，不配即用默认。
+# CDROP_QR_LOGIN_ENABLED=true              # 关闭则 /api/auth/qr/* 返回 503
+# CDROP_QR_REQUEST_TTL_SECONDS=120         # 二维码 / 登录请求有效期（秒）
+# CDROP_FULL_ACCESS_TTL_SECONDS=900        # full 设备 access token TTL（秒）
+# CDROP_FULL_REFRESH_TTL_SECONDS=604800    # full 设备 refresh TTL（秒，7 天，滑动）
+# CDROP_GUEST_ACCESS_TTL_SECONDS=900       # guest（访客借用）access token TTL（秒）
+# CDROP_GUEST_REFRESH_TTL_SECONDS=86400    # guest refresh TTL（秒，1 天，滑动）
 
 # 通用
 CDROP_DB_PATH=./cdrop.db
 CDROP_LISTEN=:8080
-# Device row max age (sliding via auth-middleware UPSERT and SSE keepalive).
-# Bound by brief §2 refresh_token sliding window (196h ≈ 8 days). Default 196.
+# 设备行最大存活（鉴权中间件 TouchDevice 与 SSE keepalive 滑动刷新 last_seen）。
+# 不应短于 broker 会话的 refresh 窗口（full 7 天）。默认 196 小时。
 CDROP_DEVICE_TTL_HOURS=196
 
 # Cloudflare Realtime TURN（可选；不配则 /api/calls/credentials 返回 STUN-only fallback）。