app/upstream/account_fields.py

"""anuma.ai 账号专属凭据字段说明（文档性质）。

:class:`~app.account.Account` 用 ``extra=allow`` 容纳这些字段；注册机注册成功后
写入 account/<name>.json（含这些字段 + name/created_at/disabled 等通用字段）。
"""
from __future__ import annotations

# anuma.ai 账号凭据字段
UPSTREAM_ACCOUNT_FIELDS: dict[str, str] = {
    "privy_access_token": "Privy identity token（上游 authorization: Bearer；~1h 过期，可自动刷新）",
    "privy_pat": "Privy persisted access token（privy:pat；仅刷新端点 Bearer 用）",
    "privy_app_id": "Privy 应用 ID（JWT aud，如 cmjrfihuc03h8l10ca0bi9o2y）",
    "privy_refresh_token": "Privy refresh token（可选；自动刷新用，一次性轮换）",
    "privy_cf_cookie": "auth.privy.io 的 CF clearance cookie 串（可选；浏览器 DevTools 复制，绑定 UA+IP，过期需重抓）",
    "conversation_id": "会话 UUID（x-conversation-id 头；缺省时上游自动开新会话）",
    "wallet_address": "关联的加密钱包地址（Privy linked account）",
    "source_email": "注册邮箱（通用字段，Privy 登录用）",
}