设备名与令牌解耦 + iOS Broker 应用内登录 / 消息 / 图库 / 记录持久化 + 三端 bug 修复

设备名与令牌解耦（presence 按 device_id 键控）： - hub 主键改稳定 device_id（presence / online / kick 用之），peer 路由仍按设备名经 hub 内 clientFor 解析——不动传输核心；Client 加 Name + 连接键，PresenceDevice 加 device_id，sse 传 claims.DeviceID，publishPresence 按 device_id 判在线、name 取自 devices 表 - 改名走已有 PATCH /api/devices/{device_id}（不重铸会话、不换 token、不中断 SSE）+ hub.Rename 更新活跃连接名 + 重广播 presence，全端即时无重复项；sessions 列表 name 用 devices 表覆盖 broker Label；web 改名从重铸迁到 PATCH，iOS 设置页即时改名；DeviceItem / DeviceInfo 按 device_id 键控判本机 - 移除「需移除两次」：publishPresence 不再把「有 device_id 但无 devices 行」的 live 连接当在线（吊销后用未过期 token 重连的僵尸），只显示 code-less 连接；合法重登新建行故正常 - revoke 对无 broker 会话的本地行也清（清掉合成测试 / 幽灵设备）；跨端吊销 / 断连一律按 device_id Kick iOS Broker 应用内登录（免扫码）： - BrokerLogin.swift：ASWebAuthenticationSession 跑 broker /device/authorize + /device/token 的 PKCE 设备授权流（对齐桌面 loopback，自定义 scheme cdrop://auth-callback 回调）→ /api/auth/device-session 代铸出带真名 + 稳定 device_id 的设备会话；DeviceIDStore 跨登录复用 device_id 杜绝重登重复 - LoginView 主登录改 broker 账号登录、扫码降级为可展开备选 iOS 功能补全： - 设备间消息（引擎 main.ts 单条增量过桥 + onNativeEvent sendMessage；EngineController 消息状态 + 新 MessagesView 会话 UI；后端 /api/message 已就绪） - 图库发送（PhotosPicker 文件 / 图库菜单 → stagePhotoData → 复用 cdrop-file 发送链路；NSPhotoLibraryUsageDescription） - 传输历史 / 消息记录持久化（RecordsStore 落 Application Support JSON，跨重启存活）+ 长按删除 + 清空（二次确认） - 进行中传输主动取消 / 立即切中继（详情页两按钮，复用引擎桥命令） - 身份愈合（引擎 /api/me 取真实显示名经 identityUpdated 回报 Keychain，修扫码登录「用户显示 UUID」） - 触发本地网络权限（NWBrowser 浏览 _cdrop._tcp）使 WKWebView WebRTC 取 host 候选 iOS 发送 / 启动修复： - 发送在读文件即失败：引擎在 https 源下 fetch("cdrop-file://") 跨源 + Range 头触发 CORS 预检被拦 → 改走原生桥 bridgeFileSource / readFileSlice（512 KiB 分块 base64），绕开 CORS、整文件仍不整体进内存 - 冷启重开「missing injected session」：EngineWebView.makeUIView 在 boot 注入前确定性接好 auth，消除注入竞态桌面 bug 修复： - 登出静默失败：window.confirm 在 Wails WebView 失效（返回 falsy 致动作被静默跳过）→ 跨平台 DOM 确认弹窗（utils/confirm 的 Promise 式 confirmDialog + ui/ConfirmHost 的 Mantine Modal）取代之；登出改 await 先吊销 broker 会话再清本地（桌面 clearDesktopSession 会丢 Go 侧 refresh 的竞态） - 扫 iOS 登录二维码被拒「不是本站的码」：wails:// 源永不等 https 站点源 → 桌面放宽 parseLinkApprovalUrl 的 origin 等值校验（仍留 /link 路径 + r/c；批准 r/c 一律发往本端后端、外站码只 404，无开放重定向） - macOS 本地网络权限触发（localnetwork_darwin NWBrowser + Info.plist 键）；相机修复（NSCameraUsageDescription） web / 跨端： - presence 透传 device_id + 离线检测按 device_id；会话列表随 presence 防抖重拉（已登出设备自动从列表消失，不再需手动刷新）；移除设备 / 清剪贴板 / 撤销令牌 / 登出均改 DOM 确认弹窗分发 / 签名： - 真机签名从手动 scaffold 改自动 provisioning（删 Signing.xcconfig，project.yml 去 profile specifier，just ios-device 用 -allowProvisioningUpdates + ASC 团队 key）；App Group 改名 group.net.commilitia.Commilitia-Drop（含 entitlements） - hub 测试加 device_id 键控 + 改名解耦回归（-race）
2026-06-27 03:50:04 +08:00
parent 44096069a7
commit 127070e226
51 changed files with 1655 additions and 227 deletions
@@ -1,3 +1,4 @@
+import AuthenticationServices
 import Foundation
 import Observation
 import UIKit
@@ -35,14 +36,19 @@ final class AuthManager

    var session: Session?
    var qrPayload: String?
-    var statusText: String = t("ios.login.generating")
+    // 空初值：登录页以 broker 账号登录为主，无操作时不显状态文案；各登录流程开始时自行设置。
+    var statusText: String = ""
    // 二维码已失效（denied/expired/失败）→ 登录页据此提示并高亮「刷新二维码」。
    var qrExpired = false

-    // 登录代次：每次 startQRLogin 自增，旧轮询据此识别自己已被刷新取代、丢弃结果，避免
-    // 「刷新时仍在轮询」两条循环并发改 statusText / qrPayload 打架。
+    // 登录代次：每次 startQRLogin / startBrokerLogin 自增，旧流程据此识别自己已被取代、丢弃
+    // 结果，避免两条登录流程并发改 statusText / session 打架。
    private var loginGeneration = 0

+    // Broker 登录期间强持 ASWebAuthenticationSession 封装（其 presentationContextProvider 为 weak、
+    // session 自身亦须保活至回调），完成 / 失败后置空。
+    private var brokerFlow: BrokerAuthFlow?
+
    // Keychain 持久化坐标（单 app 私有，见 Keychain.swift）。
    private static let keychainService = "net.commilitia.cdrop.session"
    private static let keychainAccount = "session"
@@ -110,14 +116,152 @@ final class AuthManager
        }
    }

+    // 应用内 Broker 登录（device-authorization + PKCE，见 BrokerLogin.swift）：手机直接输账号登录，
+    // 无需另一台设备扫码。流程＝拉 broker 配置 → ASWebAuthenticationSession 授权拿 code → 换 bootstrap
+    // 令牌 → 代铸成 cdrop 设备会话（带真名 / 稳定 device_id）→ 落 full 会话 + Keychain。
+    func startBrokerLogin() async
+    {
+        loginGeneration += 1
+        let gen = loginGeneration
+        qrExpired = false
+        statusText = t("ios.login.brokerStarting")
+        do
+        {
+            let cfg = try await fetchAuthConfig()
+            guard !cfg.brokerURL.isEmpty, !cfg.brokerApp.isEmpty else { throw BrokerLoginError.incompleteConfig }
+
+            let verifier = PKCE.randomToken(64)
+            let challenge = PKCE.challenge(for: verifier)
+            let state = PKCE.randomToken(24)
+            let redirectURI = "cdrop://auth-callback"
+
+            var comp = URLComponents(string: cfg.brokerURL.trimmingTrailingSlash() + "/device/authorize")!
+            comp.queryItems = [
+                URLQueryItem(name: "app", value: cfg.brokerApp),
+                URLQueryItem(name: "redirect_uri", value: redirectURI),
+                URLQueryItem(name: "state", value: state),
+                URLQueryItem(name: "code_challenge", value: challenge),
+                URLQueryItem(name: "code_challenge_method", value: "S256"),
+                URLQueryItem(name: "description", value: "Commilitia Drop iOS"),
+            ]
+            guard let authURL = comp.url else { throw BrokerLoginError.incompleteConfig }
+
+            let flow = BrokerAuthFlow()
+            brokerFlow = flow
+            let callback = try await flow.run(url: authURL, callbackScheme: "cdrop")
+            brokerFlow = nil
+            if gen != loginGeneration { return }
+
+            let items = URLComponents(url: callback, resolvingAgainstBaseURL: false)?.queryItems ?? []
+            guard items.first(where: { $0.name == "state" })?.value == state
+            else { throw BrokerLoginError.stateMismatch }
+            guard let code = items.first(where: { $0.name == "code" })?.value, !code.isEmpty
+            else { throw BrokerLoginError.missingCode }
+
+            let bootstrap = try await exchangeDeviceToken(
+                brokerURL: cfg.brokerURL, code: code, verifier: verifier, redirectURI: redirectURI)
+            let ds = try await mintDeviceSession(bootstrap: bootstrap)
+            if gen != loginGeneration { return }
+
+            DeviceIDStore.value = ds.device_id
+            let realName = (ds.name?.isEmpty == false) ? ds.name! : ds.user_id
+            session = Session(accessToken: ds.access_token,
+                              refreshToken: ds.refresh_token,
+                              user: User(id: ds.user_id, name: realName, avatar: ds.avatar),
+                              deviceName: ds.device_name ?? DeviceNameStore.value,
+                              deviceId: ds.device_id,
+                              scope: "full")
+            persist()
+        }
+        catch
+        {
+            brokerFlow = nil
+            if gen != loginGeneration { return }
+            // 用户主动取消（关闭授权页）不算失败：静默回到登录页等待再次操作。
+            if let asErr = error as? ASWebAuthenticationSessionError, asErr.code == .canceledLogin
+            {
+                statusText = t("ios.login.waiting")
+                return
+            }
+            statusText = t("ios.login.failed")
+        }
+    }
+
    func logout()
    {
        session = nil
        qrPayload = nil
-        statusText = t("ios.login.generating")
+        statusText = ""
        Keychain.delete(service: Self.keychainService, account: Self.keychainAccount)
    }

+    // ---- Broker 登录辅助：配置拉取 / 令牌交换 / 代铸 ----
+
+    private struct AuthConfig { let brokerURL: String; let brokerApp: String }
+
+    private struct DeviceTokenResp: Decodable
+    {
+        let access: String
+        let refresh: String
+        let access_expires: Int64
+    }
+
+    // 代铸响应：access/refresh + 稳定 device_id + 经边缘核验的真实身份（user_id/name/avatar）。
+    private struct DeviceSessionResp: Decodable
+    {
+        let access_token: String
+        let refresh_token: String
+        let device_id: String
+        let device_name: String?
+        let user_id: String
+        let name: String?
+        let avatar: String?
+    }
+
+    private func fetchAuthConfig() async throws -> AuthConfig
+    {
+        let (data, _) = try await URLSession.shared.data(from: URL(string: "\(apiBase)/api/auth/config")!)
+        let obj = (try? JSONSerialization.jsonObject(with: data)) as? [String: Any] ?? [:]
+        return AuthConfig(brokerURL: obj["broker_url"] as? String ?? "",
+                          brokerApp: obj["broker_app"] as? String ?? "")
+    }
+
+    private func exchangeDeviceToken(
+        brokerURL: String, code: String, verifier: String, redirectURI: String) async throws -> String
+    {
+        var req = URLRequest(url: URL(string: brokerURL.trimmingTrailingSlash() + "/device/token")!)
+        req.httpMethod = "POST"
+        req.setValue("application/json", forHTTPHeaderField: "Content-Type")
+        req.setValue("application/json", forHTTPHeaderField: "Accept")
+        req.httpBody = try JSONSerialization.data(withJSONObject: [
+            "code": code, "code_verifier": verifier, "redirect_uri": redirectURI,
+        ])
+        let (data, resp) = try await URLSession.shared.data(for: req)
+        let status = (resp as? HTTPURLResponse)?.statusCode ?? 0
+        guard status == 200 else { throw BrokerLoginError.tokenFailed(status) }
+        let tr = try JSONDecoder().decode(DeviceTokenResp.self, from: data)
+        guard !tr.access.isEmpty else { throw BrokerLoginError.badResponse }
+        return tr.access
+    }
+
+    private func mintDeviceSession(bootstrap: String) async throws -> DeviceSessionResp
+    {
+        var req = URLRequest(url: URL(string: "\(apiBase)/api/auth/device-session")!)
+        req.httpMethod = "POST"
+        req.setValue("Bearer \(bootstrap)", forHTTPHeaderField: "Authorization")
+        req.setValue("application/json", forHTTPHeaderField: "Content-Type")
+        req.setValue("ios", forHTTPHeaderField: "X-Device-Type")
+        req.httpBody = try JSONSerialization.data(withJSONObject: [
+            "device_id": DeviceIDStore.value,
+            "device_name": DeviceNameStore.value,
+            "device_type": "ios",
+        ])
+        let (data, resp) = try await URLSession.shared.data(for: req)
+        let status = (resp as? HTTPURLResponse)?.statusCode ?? 0
+        guard status == 200 else { throw BrokerLoginError.deviceSessionFailed(status) }
+        return try JSONDecoder().decode(DeviceSessionResp.self, from: data)
+    }
+
    // 持久化当前会话到 Keychain（扫码批准后调用）。
    private func persist()
    {
@@ -136,6 +280,30 @@ final class AuthManager
        persist()
    }

+    // updateIdentity：引擎据 /api/me 取到真实显示名（QR 登录注入的是 subject UUID 名）→ 经桥
+    // identityUpdated 回报，更新会话身份 + Keychain，使设置页显示真名而非 UUID（#12）。仅换
+    // 显示身份，令牌 / 设备名不变。
+    func updateIdentity(name: String, avatar: String?)
+    {
+        guard let cur = session else { return }
+        let av = (avatar?.isEmpty == false) ? avatar : cur.user.avatar
+        session = Session(accessToken: cur.accessToken, refreshToken: cur.refreshToken,
+                          user: User(id: cur.user.id, name: name, avatar: av),
+                          deviceName: cur.deviceName, deviceId: cur.deviceId, scope: cur.scope)
+        persist()
+    }
+
+    // updateDeviceName：本机即时改名成功（PATCH /api/devices/{device_id}）后经桥 renamed 回报，
+    // 更新会话里的设备名 + Keychain，使重启后 boot 注入新名。令牌 / 身份不变——设备名与令牌解耦。
+    func updateDeviceName(_ name: String)
+    {
+        guard let cur = session else { return }
+        session = Session(accessToken: cur.accessToken, refreshToken: cur.refreshToken,
+                          user: cur.user, deviceName: name,
+                          deviceId: cur.deviceId, scope: cur.scope)
+        persist()
+    }
+
    // 仅供本机模拟器联调（CDROP_DEBUG_SESSION=1）：注入占位会话跳过扫码，用于验证引擎从
    // prod 加载 + 桥往返。令牌无效、鉴权会 401，但能证 engine.html 在 WKWebView 里加载运行。
    func debugSession()
@@ -0,0 +1,111 @@
+import AuthenticationServices
+import CryptoKit
+import Foundation
+import UIKit
+
+// 应用内 Broker 登录（device-authorization + PKCE，对齐桌面 desktop/platform/oauth.go）。iOS 无法
+// 跑 loopback 监听，故用 ASWebAuthenticationSession + 自定义 scheme 回调（cdrop://auth-callback）：
+//   1. GET  {broker}/device/authorize?app=cdrop&redirect_uri=cdrop://auth-callback&state&code_challenge&S256
+//   2. 用户在 broker SSO 授权 → 回调 cdrop://auth-callback?code=..&state=..
+//   3. POST {broker}/device/token {code, code_verifier, redirect_uri} → bootstrap 机器令牌
+//   4. POST {api}/api/auth/device-session（Bearer bootstrap）→ cdrop 设备会话（带真名 / device_id）
+// 这样手机上直接输账号登录，无需另一台设备扫码批准。
+// 前置：broker 须为 cdrop 应用注册 redirect_uri cdrop://auth-callback（同桌面 loopback 须注册）。
+
+enum BrokerLoginError: Error
+{
+    case incompleteConfig
+    case cannotStart
+    case noCallback
+    case stateMismatch
+    case missingCode
+    case tokenFailed(Int)
+    case deviceSessionFailed(Int)
+    case badResponse
+}
+
+// ASWebAuthenticationSession 的 async 封装 + 展示锚点提供者。须被持有至完成（session 的
+// presentationContextProvider 是 weak，且 session 自身也须保活），故由 AuthManager 在登录期间强持。
+@MainActor
+final class BrokerAuthFlow: NSObject, ASWebAuthenticationPresentationContextProviding
+{
+    private var session: ASWebAuthenticationSession?
+
+    // 打开授权页，等回调 URL（cdrop://auth-callback?code=..&state=..）。用户取消 / 失败抛错。
+    func run(url: URL, callbackScheme: String) async throws -> URL
+    {
+        try await withCheckedThrowingContinuation
+        { cont in
+            let s = ASWebAuthenticationSession(url: url, callbackURLScheme: callbackScheme)
+            { [weak self] callback, error in
+                self?.session = nil
+                if let error { cont.resume(throwing: error) }
+                else if let callback { cont.resume(returning: callback) }
+                else { cont.resume(throwing: BrokerLoginError.noCallback) }
+            }
+            s.presentationContextProvider = self
+            // 共享浏览会话：若用户已在 Safari 登录 broker SSO，则免再输密码（无缝 SSO）。
+            s.prefersEphemeralWebBrowserSession = false
+            self.session = s
+            if !s.start() { cont.resume(throwing: BrokerLoginError.cannotStart) }
+        }
+    }
+
+    func presentationAnchor(for session: ASWebAuthenticationSession) -> ASPresentationAnchor
+    {
+        let scenes = UIApplication.shared.connectedScenes.compactMap { $0 as? UIWindowScene }
+        return scenes.flatMap { $0.windows }.first { $0.isKeyWindow }
+            ?? scenes.first?.windows.first
+            ?? ASPresentationAnchor()
+    }
+}
+
+// 跨登录持久的稳定 device_id（broker meta / 会话↔设备连接键）。存 UserDefaults，登出不清——
+// 故重登复用同一 device_id，broker R2 幂等轮换同一会话、设备表 UPSERT 同一行，杜绝重复设备项
+// （对齐 web 的 localStorage cdrop.device_id）。首次为空，由后端铸发后回存。
+enum DeviceIDStore
+{
+    private static let key = "cdrop.device_id"
+    static var value: String
+    {
+        get { UserDefaults.standard.string(forKey: key) ?? "" }
+        set { UserDefaults.standard.set(newValue, forKey: key) }
+    }
+}
+
+// PKCE / 随机串（对齐桌面 randString：n 字节 base64url 取前 n 字符，落在 PKCE unreserved 集内）。
+enum PKCE
+{
+    static func randomToken(_ n: Int) -> String
+    {
+        var bytes = [UInt8](repeating: 0, count: n)
+        _ = SecRandomCopyBytes(kSecRandomDefault, n, &bytes)
+        return String(Data(bytes).base64URLEncoded().prefix(n))
+    }
+
+    static func challenge(for verifier: String) -> String
+    {
+        let digest = SHA256.hash(data: Data(verifier.utf8))
+        return Data(digest).base64URLEncoded()
+    }
+}
+
+extension Data
+{
+    // base64url（无填充，- / _ 替 + /），用于 PKCE challenge / 随机串。
+    func base64URLEncoded() -> String
+    {
+        base64EncodedString()
+            .replacingOccurrences(of: "+", with: "-")
+            .replacingOccurrences(of: "/", with: "_")
+            .replacingOccurrences(of: "=", with: "")
+    }
+}
+
+extension String
+{
+    func trimmingTrailingSlash() -> String
+    {
+        hasSuffix("/") ? String(dropLast()) : self
+    }
+}
@@ -2,34 +2,70 @@ import CoreImage.CIFilterBuiltins
 import SwiftUI
 import UIKit

-// 扫码登录界面：显示二维码 + 引导用已登录的 cdrop 扫码批准。轮询在 AuthManager 里。
+// 登录界面：主登录＝应用内 Broker 账号登录（ASWebAuthenticationSession，直接输账号、无需另一台
+// 设备）；扫码登录降级为可展开的备选（需另一台已登录设备扫码批准）。两条流程经 AuthManager。
 struct LoginView: View
 {
    @Environment(AuthManager.self) private var auth
+    @State private var showQR = false

    var body: some View
    {
-        VStack(spacing: 24)
+        VStack(spacing: 20)
        {
            Spacer()
            Text(t("app.brand"))
                .font(.largeTitle)
                .bold()
-            qrArea
-            Text(auth.statusText)
-                .font(.callout)
-                .foregroundStyle(auth.qrExpired ? Color.red : Color.secondary)
-            refreshButton
-            Text(t("ios.login.guide"))
-                .font(.footnote)
-                .foregroundStyle(.secondary)
-                .multilineTextAlignment(.center)
-                .padding(.horizontal, 40)
+
+            // 主登录：应用内 broker 账号登录。
+            Button { Task { await auth.startBrokerLogin() } }
+            label:
+            {
+                Label(t("ios.login.broker"), systemImage: "person.crop.circle")
+                    .frame(maxWidth: .infinity)
+            }
+            .buttonStyle(.glassProminent)
+            .padding(.horizontal, 40)
+
+            if !auth.statusText.isEmpty
+            {
+                Text(auth.statusText)
+                    .font(.callout)
+                    .foregroundStyle(auth.qrExpired ? Color.red : Color.secondary)
+                    .multilineTextAlignment(.center)
+                    .padding(.horizontal, 40)
+            }
+
+            // 备选：扫码登录（需另一台已登录设备）。展开时才发起二维码，避免无谓请求。
+            DisclosureGroup(isExpanded: $showQR)
+            {
+                VStack(spacing: 16)
+                {
+                    qrArea
+                    refreshButton
+                    Text(t("ios.login.guide"))
+                        .font(.footnote)
+                        .foregroundStyle(.secondary)
+                        .multilineTextAlignment(.center)
+                }
+                .padding(.top, 12)
+            }
+            label:
+            {
+                Text(t("ios.login.scanAlt"))
+                    .font(.subheadline)
+            }
+            .padding(.horizontal, 40)
+            .onChange(of: showQR)
+            {
+                if showQR, auth.qrPayload == nil { Task { await auth.startQRLogin() } }
+            }
+
            Spacer()
        }
        .padding()
        .tint(.cdropAccent)
-        .task { await auth.startQRLogin() }
    }

    // 刷新二维码：失效后高亮（glassProminent），未失效时也常驻可手动刷新。两种玻璃样式类型