admin/Commilitia-Drop
1
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
34 Commits 2 Branches 0 Tags
34f0db215cbe1921e2a7a526d201292939b1161a
Commit Graph

7 Commits

Author SHA1 Message Date
admin 34f0db215c Mac 后台常驻（隐藏 Dock + 关窗续跑）：引擎 / 监听上移 App 级 
实现②隐藏 Dock 图标 + ③可靠后台刷新，交付单窗口、可后台常驻的 App。

- 新增 MacBackgroundController（@MainActor App 级单例）：持有 engine + auth（脱离窗口 @State，生命周期与 App 一致）。把引擎离屏 WebView 挂常驻隐藏 NSWindow（始终在窗口层级、避 WebKit 无窗口挂起，且脱离主窗口生命周期——关主窗口引擎不销毁，SSE / presence / 传输 / 剪贴板续跑）+ App 级 ProcessInfo.beginActivity 防 App Nap + 按登录态启停剪贴板 monitor / 全局热键。observeAuth（withObservationTracking 桥 Observation→命令式）观察 auth.session 驱动 start/stop
- 新增 MacAppDelegate（@NSApplicationDelegateAdaptor）：applicationDidFinishLaunching 应用 Dock 策略 + bootstrap 后台运行时；applicationShouldTerminateAfterLastWindowClosed=false——关最后一个窗口不退出，菜单栏常驻续跑
- CommilitiaDropMacApp：engine / auth 改由 MacBackgroundController 持有（不再窗口 @State）；MacAppRoot 只做登录门界面切换、不挂引擎生命周期。MacRootView 移除内嵌 EngineWebView + 移除窗口 onAppear/onDisappear 的 monitor/hotkey（全上移 controller）——关窗引擎 / 同步 / 热键不再停
- 设置加「后台」区：隐藏 Dock 图标开关（@AppStorage macHideDock → NSApp.setActivationPolicy .accessory/.regular，默认 regular 显示）+ 后台常驻说明；剪贴板自动同步开关改调 controller.refreshClipboardMonitor；登出只 auth.logout（引擎复位交 controller 随会话变 nil 统一处理）。菜单栏「打开主窗口」先 NSApp.activate 再 openWindow（accessory / 关窗后窗口可前置可见）
- 三项能力齐备：①菜单栏图标（既有 MenuBarExtra）②隐藏 Dock（新增，可设置切换）③可靠后台刷新（新增：引擎 / monitor / 热键 App 级持有 + 隐藏窗口托 WebView + App 级 App Nap 防护 + 关窗不退出续跑）
- 验证：just mac-build（CommilitiaDropMac.app）+ iOS 模拟器（CommilitiaDrop.app）均 BUILD SUCCEEDED；ad-hoc 启动冒烟通过（进程存活、无崩溃报告、干净退出）。运行期后台同步须用户登录后自测（Broker OAuth 需账号）
 2026-07-11 12:26:34 +08:00
admin f273f2466e Mac Quick Send：全局热键 + 菜单栏（Phase 4c） 
- MacQuickSend（@Observable 单例）：激活 app + NSOpenPanel 多选文件 → 置 pending；MacRootView 观察 pending → 切到「传输」区 + 弹 MacComposeSheet 选目标设备发送（复用现有发送流程与 engine.sendFile）
- MacHotkey：Carbon RegisterEventHotKey 全局热键 ⌃⌥⌘S（无须辅助功能权限）触发 Quick Send。事件处理器须 C 函数指针，用不捕获闭包（只调静态 MacQuickSend.trigger）+ dispatch 主队列再弹模态（避免 Carbon 回调内跑模态）。登录（MacRootView onAppear）注册、登出（onDisappear）注销
- 菜单栏加「快速发送文件…」（登录态）
- 桌面 Wails 实际未实现全局热键（仅曾计划），此为原生 Mac 增益。键位暂固定 ⌃⌥⌘S，后续可做成设置项
- 验证：just mac-build（CommilitiaDropMac.app）BUILD SUCCEEDED；iOS 无关（仅改 macOS-only 文件），不受影响
 2026-07-08 00:15:10 +08:00
admin b55cb615a3 Mac 原生系统通知 + 接收目录可配（Phase 4b·1） 
- MacNotifier：窗口非前台（!NSApp.isActive）时对「收到消息 / 收到文件」发原生系统通知（UNUserNotificationCenter，授权已由引擎启动的 PushRegistry.requestAuthorizationAndRegister 一并请求）。对齐桌面 app.ShowNotification——前台事件由应用内 NoticeOverlay / 未读红点负责，仅 app 非活跃才发系统通知，避免与应用内提示重复。引擎 handleNotify 的 "message"（新到对端消息，非当前会话）+ "transferDone"（incoming 且 completed）两处加 macOS 挂钩
- 接收目录可配：DownloadManager.downloadDir 在 macOS 读 UserDefaults macDownloadDir（设置页 NSOpenPanel 选目录），未配 / 目录已失效则回退系统「下载」目录（比「文稿」更符桌面直觉）；iOS 仍固定沙盒 Documents。设置加「接收」区（显示当前保存目录 + 选择目录…）。非沙盒构建用普通路径即可；沙盒分发（Phase 6）须改安全作用域书签
- 验证：just mac-build（CommilitiaDropMac.app）+ iOS 模拟器（CommilitiaDrop.app）均 BUILD SUCCEEDED
 2026-07-08 00:07:59 +08:00
admin 492563ae44 Mac 剪贴板自动同步（上行）+ 菜单栏快捷（Phase 4a） 
- MacClipboardMonitor：NSPasteboard changeCount 轮询 500ms + ProcessInfo.beginActivity(.userInitiatedAllowingIdleSystemSleep) 防 App Nap，本机复制的普通文本自动上传云剪贴板。移植桌面 desktop/platform/clipboard.go 的 Monitor 回环守卫（selfHash 自写回声消费一次并解除 + lastHash 去重）与 clipboard_darwin.m 过滤（org.nspasteboard.{Concealed,Transient,AutoGenerated} 敏感标记跳过 / Handoff shared-pasteboard 暂存路径跳过 / 富文本从 RTF·RTFD 派生纯文本）
- EngineController：加 uploadClipboardText(_:)（monitor 直传已解析文本，绕过再读 pasteboard 避免暂存路径等边角，静默不弹空提示）；macOS 写剪贴板前 armSelfWrite 武装守卫（手动拉取写入的内容不被 monitor 再上传成回环）
- 设置加「自动同步本机复制（上行）」开关（@AppStorage macClipboardAutoSync，默认开）；MacRootView 按开关 onAppear/onChange 启停、登出（视图消失）即停；菜单栏加剪贴板上传 / 拉取（登录态）
- 下行自动（远端 → 本机自动写剪贴板）仍待办：共享引擎 JS 仅在手动 clipboardPull 时回灌原生 "clipboard" 通知，远端 SSE clipboard:update 在 WebView 壳不落原生（桌面走 Wails 专路 ApplyRemoteClipboard）；补齐须改 web/src 引擎 + prod 部署（Mac 从线上加载 engine.html）+ 按 device_type=macos 门控免误伤 iOS。手动拉取（设置 / 菜单栏）已可用
- 验证：just mac-build（CommilitiaDropMac.app）+ iOS 模拟器（CommilitiaDrop.app）均 BUILD SUCCEEDED
 2026-07-07 23:53:52 +08:00
admin 5bee5b8942 Mac 原生五区视图（Phase 3b） 
在共享引擎公开 API 之上写 Mac 原生视图（不复用 iOS TabView 视图，改按 Mac 惯用交互），接入 MacRootView 五区取代占位。引擎零改动——feature 方法皆 internal，Mac 视图同 target 可直调。

- 传输 MacTransfersView：NSOpenPanel 多选发送 + 拖放发送（.dropDestination，Mac 独有无 iOS 前例）+ 进行中列表（进度条 / 速度 / 直连·中继 / 右键取消·切中继）+ 历史（右键打开·在 Finder 显示·删记录）+ 清空历史；MacComposeSheet（待发文件列表 + 目标设备 radioGroup 选择）
- 文件 MacFilesView：engine.receivedFiles() 轮询（onAppear + history.count 变即刷）+ 双击 / 右键打开（NSWorkspace.open）+ 在 Finder 显示（activateFileViewerSelecting）+ 转发（confirmationDialog 选设备 → sendFile）+ 删除
- 消息 MacMessagesView：HSplitView 双栏（会话列表 + 线程），选中即 setActiveConversation + markConversationRead、离开置 nil，撰写栏 canMessage 门控，气泡 in/out 对齐 + 未读红点
- 设备 MacDevicesView 增强：macDeviceSymbol 类型图标 + 排除本机（selfDeviceID）+ 右键移除设备（confirmationDialog + revokeDevice）
- 设置 MacSettingsView 增强：设备名可改（TextField + renameSelf）+ 云剪贴板上传 / 拉取 + 引擎诊断（status / 信令 hubConnected·hubReconnecting / 在线设备数）+ 引擎日志
- NoticeOverlay 挂 MacRootView 窗口顶部（吊销 / 改名 / 剪贴板 / 登录审批反馈自动横幅）；Sources/NotificationBanner.swift 纳入 Mac target
- deviceSymbol / fileByteSize 因所在 iOS 源文件（RootView / SendComposeSheet）未纳入 Mac target，按同语义在 MacFeatureViews 另置一份
- 验证：just mac-build（CommilitiaDropMac.app）+ iOS 模拟器（CommilitiaDrop.app）均 BUILD SUCCEEDED
 2026-07-07 22:48:22 +08:00
admin 512d7563ee 原生 macOS 引擎 + Broker 登录接通（Phase 3a） 
- 引擎 / 鉴权跨平台 in-place（iOS 路径 #if 守卫、逐字不变，仅加 macOS/AppKit 分支）：EngineController（import 守卫 + 剪贴板 UIPasteboard→NSPasteboard 上下行两处 + device_type 平台条件）、EngineWebView（UIViewRepresentable→typealias 统一后分 NSViewRepresentable）、Theme（动态色 Color(nsColor:dynamicProvider) 同 RGB）、DeviceNameStore（Host.current().localizedName）、PushRegistry（NSApplication.registerForRemoteNotifications）、Auth/BrokerLogin（presentationAnchor→NSApplication.keyWindow）、Auth/AuthManager（死 import UIKit 守卫）
- BackgroundTaskManager：整文件 #if os(iOS)（BGContinuedProcessingTask 为 API_UNAVAILABLE(macos)、编译级拒绝）+ macOS 同签名 no-op stub，使 EngineController.syncBackgroundTask 调用点无须改动
- device_type 修正（非机械）：Mac 原生客户端 boot 注入 device_type=macos（与桌面 Wails 客户端一致，后端 / 各端已识别），不再硬编 ios——否则其他端设备列表图标错、且触发其 isWakeable 的 contains("ios") 误判本 Mac 可推送唤醒
- CommilitiaDropMac target 纳入「引擎 + 登录」最小集：Shared + Sources/Engine + Sources/Auth（除 iOS 专属 LoginView）+ RecordsStore / PushRegistry / LocalNetworkPermission / DeviceNameStore / BackgroundTaskManager + Resources/i18n；依赖 WebRTC；Info.plist 加 cdrop:// 回调 scheme（ASWebAuthenticationSession OAuth 回调）+ 本地网络（NSLocalNetworkUsageDescription / NSBonjourServices _cdrop._tcp）
- Mac 壳接引擎：CommilitiaDropMacApp（@State auth + engine，MacAppRoot 登录门 + 会话激活分桶记录）、MacLoginView（Broker 账户登录，免相机）、MacRootView（背景挂离屏引擎 WebView 保活 + 设备真实 presence 列表 + 设置账号/登出/引擎日志）、MacMenuContent（账号 + 在线设备数）。传输/文件/消息详情暂占位，随 Phase 3b 复用 iOS 视图
- 验证：just mac-build（CommilitiaDropMac.app）+ iOS 模拟器（CommilitiaDrop.app）均 BUILD SUCCEEDED。运行期登录 / 引擎联通待真机自测（Broker OAuth 需账号交互）
 2026-07-07 22:22:30 +08:00
admin 29e5c0a739 原生 macOS 客户端脚手架 + 元数据完整命名去缩写 
- 命名去缩写：xcodegen 项目 + 四 target CDrop*→CommilitiaDrop*（CommilitiaDrop / …Share / …Widgets / …Tests）；3 个 widget/control kind net.commilitia.cdrop.*→net.commilitia.Commilitia-Drop.*（旧装控件将成孤儿，需在设备重加）；Tests @testable import CommilitiaDrop。刻意不动线协议 / 身份标识——bundle ID 家族、URL scheme cdrop://、Bonjour _cdrop._tcp、keychain service、DataChannel cdrop-file、entitlements 文件名——以免破跨端互通或丢会话
- 新增 macOS app target CommilitiaDropMac（platform macOS / deploymentTarget 26.0 / ARCHS arm64 / 与 iOS 同 bundle net.commilitia.Commilitia-Drop，同 App Store 记录 + 同 App Group）：sources 仅 MacApp/，Info.plist 经 xcodegen 生成，本地 ad-hoc 免账号编译
- Mac 壳 MacApp/（Allman，#if os(macOS) 守卫，独立 @main 不与 iOS CDropApp 冲突）：CommilitiaDropMacApp（@main + 单窗口 Window + windowResizability contentMinSize + 去 ⌘N + MenuBarExtra window 风格）、MacRootView（NavigationSplitView 侧栏五区骨架 传输/文件/消息/设备/设置 + 占位详情 MacPlaceholder + 品牌头）、MacMenuContent（菜单栏占位）
- Support/macOS/AppMac.entitlements：App Group group.net.commilitia.Commilitia-Drop 预置待用；macOS 下 App Group 属受限能力须 provisioning profile，故脚手架阶段 project.yml 暂不引用，待 Phase 6 Developer ID 签名再挂
- 根 Justfile：ios-sim-build / ios-device 跟随重命名（项目 / scheme / .app 路径）；新增 mac-build（xcodegen + xcodebuild -sdk macosx，本地 ad-hoc）
- 验证：CommilitiaDropMac.app 与 CommilitiaDrop.app（iOS 模拟器）均 BUILD SUCCEEDED；WebRTC 走 -clonedSourcePackagesDirPath 复用已缓存 xcframework
 2026-07-07 21:43:51 +08:00