鉴权并入 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 必填校验
2026-06-26 02:07:11 +08:00
parent c79b176b87
commit 10cf36ecee
104 changed files with 7533 additions and 5318 deletions
@@ -0,0 +1,121 @@
+import Foundation
+
+// 接收落盘管理器（对应桌面 desktop/platform/download.go）：把接收到的字节写入 app 沙盒
+// Documents。小文件整文件写（saveWhole）；大文件流式 begin / append / finalize；abort
+// 丢弃临时文件。线程：由 EngineController 在主线程调用，文件 IO 同步执行（首版求简单可
+// 验，后续可挪后台队列）。
+final class DownloadManager
+{
+    private struct Active
+    {
+        let handle: FileHandle
+        let tmpURL: URL
+    }
+
+    private var active: [String: Active] = [:]
+
+    private func downloadDir() -> URL
+    {
+        return FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)[0]
+    }
+
+    // 列出已落盘的接收文件（Documents 顶层，排除流式临时 .part / 隐藏文件），最近的在前。
+    // 供应用内「收到的文件」视图浏览 / 打开 / 转发，也是 Files app 可见的同一批文件。
+    func receivedFiles() -> [URL]
+    {
+        let urls = (try? FileManager.default.contentsOfDirectory(
+            at: downloadDir(),
+            includingPropertiesForKeys: [ .contentModificationDateKey ],
+            options: [ .skipsHiddenFiles ])) ?? []
+        return urls
+            .filter { $0.pathExtension != "part" && !$0.lastPathComponent.hasPrefix(".cdrop-") }
+            .sorted { a, b in modDate(a) > modDate(b) }
+    }
+
+    func deleteReceivedFile(_ url: URL)
+    {
+        try? FileManager.default.removeItem(at: url)
+    }
+
+    private func modDate(_ url: URL) -> Date
+    {
+        return (try? url.resourceValues(forKeys: [ .contentModificationDateKey ]))?
+            .contentModificationDate ?? .distantPast
+    }
+
+    // 整文件写入（接收端小文件路径，对应桥 saveDownload）。返回最终绝对路径。
+    func saveWhole(name: String, data: Data) throws -> String
+    {
+        let url = uniqueURL(for: sanitize(name))
+        try data.write(to: url)
+        return url.path
+    }
+
+    func begin(sessionId: String) throws
+    {
+        cleanup(sessionId)   // re-begin 安全：先清旧条目再开新文件
+        let tmp = downloadDir().appendingPathComponent(".cdrop-\(sanitize(sessionId)).part")
+        FileManager.default.createFile(atPath: tmp.path, contents: nil)
+        let handle = try FileHandle(forWritingTo: tmp)
+        active[sessionId] = Active(handle: handle, tmpURL: tmp)
+    }
+
+    func append(sessionId: String, data: Data) throws
+    {
+        guard let a = active[sessionId] else { throw Err.unknownSession }
+        try a.handle.write(contentsOf: data)
+    }
+
+    func finalize(sessionId: String, name: String) throws -> String
+    {
+        guard let a = active[sessionId] else { throw Err.unknownSession }
+        try a.handle.close()
+        active[sessionId] = nil
+        let dest = uniqueURL(for: sanitize(name))
+        try FileManager.default.moveItem(at: a.tmpURL, to: dest)
+        return dest.path
+    }
+
+    func abort(sessionId: String)
+    {
+        cleanup(sessionId)
+    }
+
+    private func cleanup(_ sessionId: String)
+    {
+        guard let a = active[sessionId] else { return }
+        try? a.handle.close()
+        try? FileManager.default.removeItem(at: a.tmpURL)
+        active[sessionId] = nil
+    }
+
+    // 唯一化：若已存在则插入 (1) (2)…（对应桌面 uniquePath）。
+    private func uniqueURL(for name: String) -> URL
+    {
+        let dir = downloadDir()
+        let base = (name as NSString).deletingPathExtension
+        let ext = (name as NSString).pathExtension
+        var candidate = dir.appendingPathComponent(name)
+        var i = 1
+        while FileManager.default.fileExists(atPath: candidate.path)
+        {
+            let next = ext.isEmpty ? "\(base) (\(i))" : "\(base) (\(i)).\(ext)"
+            candidate = dir.appendingPathComponent(next)
+            i += 1
+        }
+        return candidate
+    }
+
+    // 文件名 sanitize：只取末段、剥路径分隔符，防目录穿越（对应桌面 sanitizeFileName）。
+    private func sanitize(_ name: String) -> String
+    {
+        let last = (name as NSString).lastPathComponent
+        let cleaned = last.replacingOccurrences(of: "/", with: "_")
+        return cleaned.isEmpty ? "download" : cleaned
+    }
+
+    enum Err: Error
+    {
+        case unknownSession
+    }
+}