feat: 统一 Commilitia Drop 全客户端命名与分发
This commit is contained in:
+22
-10
@@ -1,4 +1,4 @@
|
||||
# cdrop 桌面客户端实施计划
|
||||
# Commilitia Drop 桌面客户端实施计划
|
||||
|
||||
> Wails v2 · macOS 优先 + Windows 已落地
|
||||
> 状态：**macOS 与 Windows 双端均已实现并 RDP/真机实测通过**——A2 前端复用 + 托盘/菜单栏 + 剪贴板双向同步 + 桌面设置 + session 持久化 + 开机自启（含自启静默驻留）+ 设备类型登记。macOS 见 §10，Windows 落地（含「custom-scheme 不支持流式」核心坑与 127.0.0.1 本地代理解法）见 §11。计划已据原生平台研究 sweep（`desktop/RESEARCH.md`）校正。
|
||||
@@ -26,7 +26,9 @@
|
||||
|
||||
## 0. 范围、非范围与本轮关键决策
|
||||
|
||||
**范围**：常驻桌面客户端，补浏览器做不到的——后台常驻、剪贴板自动监听上传、文件落盘、系统通知、全局快捷键。平台 **macOS（Apple Silicon + Intel）优先**，**Windows（x64）保持兼容**（同源、同分支，平台差异用 Go build tag 隔离）。
|
||||
**范围**：常驻桌面客户端，补浏览器做不到的——后台常驻、剪贴板自动监听上传、文件落盘、
|
||||
系统通知、全局快捷键。平台 **macOS（仅 Apple Silicon）优先**，**Windows（x64）保持兼容**
|
||||
（同源、同分支，平台差异用 Go build tag 隔离）。
|
||||
|
||||
**非范围（推后）**：Linux 打包、iOS / Android 原生、自更新（仅版本检查提示）、产品化 / 多租户、Admin、Symmetric NAT 的 mDNS 直连、本地内容缓存 / 离线。
|
||||
|
||||
@@ -109,7 +111,7 @@ sweep 把 D1 从“最高风险未知”变成“路径已明、含一处后端
|
||||
|
||||
### 3.1 回调通道：loopback（已定，弃 scheme）
|
||||
|
||||
采用 **RFC 8252 loopback**：Go 起临时 `127.0.0.1:0`（必须 IPv4 字面量，不用 `localhost`）HTTP server 捕获 `code`。相对自定义 scheme `cdrop://` 的优势：免单实例锁、免 `Info.plist` / 注册表登记、免深链解析、跨平台代码一致。scheme 留作未来“浏览器点 cdrop 链接唤起桌面端”的另一用例。
|
||||
采用 **RFC 8252 loopback**：Go 起临时 `127.0.0.1:0`（必须 IPv4 字面量，不用 `localhost`）HTTP server 捕获 `code`。相对自定义 scheme `commilitia-drop://` 的优势：免单实例锁、免 `Info.plist` / 注册表登记、免深链解析、跨平台代码一致。scheme 留作未来“浏览器点 Commilitia Drop 链接唤起桌面端”的另一用例。
|
||||
|
||||
### 3.2 token 交换放 Go 侧（已定）
|
||||
|
||||
@@ -166,13 +168,20 @@ sweep 源码级确认：Casdoor 支持 public client（PKCE 时 `client_secret`
|
||||
- **Quick Send 浮窗（sweep 校正）**：**Wails v2 单原生窗口**，开不了第二个原生窗。v2 内只能“同窗 HTML 浮层 / 路由切换”近似；“失焦自隐”v2 无现成钩子、要自写 ObjC `NSWindowDelegate windowDidResignKey`（v2 路线最脏一块）。**这是上 v3 的最强理由**（v3 多窗口每窗一等对象）。
|
||||
- 产品化时建议热键可重绑（规避撞车）。
|
||||
|
||||
### D6 · 打包（无证书：仅 `.app`）
|
||||
- **macOS（当前路径）**：`wails build -platform darwin/universal` 产出 `build/bin/<App>.app`（`lipo` 合并 arm64 + amd64）。**不公证、不 DMG、无 Developer ID**。为满足 D3 通知与稳定身份，做 **ad-hoc 签名** `codesign -s - --force --deep <App>.app` + `Info.plist` 带 `CFBundleIdentifier`。分发靠手动（右键打开 / 去 quarantine）。
|
||||
- **entitlements（若 ad-hoc 也带）**：非沙箱只需 `com.apple.security.network.client`；purego dlopen 系统 framework **不需** `disable-library-validation`；Carbon 热键不需 entitlement。（不要列通知 / 剪贴板 / 热键 entitlement——过度声明。）
|
||||
### D6 · 打包与分发（2026-07-31 已验证）
|
||||
- **macOS（当前路径）**：`just desktop-dist-mac` 构建 Apple Silicon ARM64 Wails app，复用
|
||||
既有 Developer ID Application 证书，以 hardened runtime + secure timestamp 签名；先提交
|
||||
app 公证并 staple，再生成含 `/Applications` 链接的 DMG，对 DMG 签名、单独公证并 staple。
|
||||
app 与 DMG 均已获 Apple `Accepted`，Gatekeeper 评估为 `Notarized Developer ID`。
|
||||
- **entitlements**：当前非沙箱瘦客户端不额外声明通知、剪贴板或热键 entitlement；purego
|
||||
`dlopen` Apple 系统 framework 不需 `disable-library-validation`，Carbon 热键也不需要
|
||||
entitlement。后续引入第三方 dylib 或沙箱时重新评估。
|
||||
- **Windows**：`wails build -platform windows/amd64 [-nsis]` 产出 `.exe` / NSIS 安装器；当前**不签名**（SmartScreen 会提示），获代码签名证书后再 `signtool`。
|
||||
- **版本检查**：启动 / 定时拉版本端点，过期提示去下载，**不自更新**。
|
||||
- **将来获证书**：完整 codesign（Developer ID）+ notarytool + DMG + CI 流程见 `desktop/RESEARCH.md` D6 手册，届时直接套用。
|
||||
- **CI**：D6 后 GitHub Actions 双 runner（macos-latest / windows-latest）跑构建 + 防回归（无证书阶段仅构建 + ad-hoc，不跑公证）。
|
||||
- **操作入口**：完整构建、签名、公证、安装和验收流程见
|
||||
`docs/client-build-install.md`；底层命令与设计依据见 `desktop/RESEARCH.md` D6 手册。
|
||||
- **CI**：后续 GitHub Actions 双 runner（macos-latest / windows-latest）跑构建 + 防回归；
|
||||
macOS runner 导入 Developer ID 后跑公证，Windows 在获得 Authenticode 证书后加入签名。
|
||||
|
||||
---
|
||||
|
||||
@@ -296,7 +305,8 @@ A2 复用（地基，先让真 web UI 在桌面跑起来 + 登录走 Go 桥）
|
||||
|
||||
### 10.6 实现状态（2026-06-13 实现，本地全绿）
|
||||
|
||||
`go build ./... / go test -race ./... / web tsc / wails build` 全部通过，产出 `build/bin/cdrop-desktop.app`（内嵌真 web 应用，8 个绑定就绪）。
|
||||
`go build ./... / go test -race ./... / web tsc / wails build` 全部通过，产出
|
||||
`build/bin/Commilitia Drop.app`（内嵌真 web 应用，8 个绑定就绪）。
|
||||
|
||||
落地与对 §10.1–10.4 的关键决策：
|
||||
|
||||
@@ -389,7 +399,9 @@ Windows 侧无 cgo——darwin 的 NSStatusBar/NSPasteboard CGO 走 build tag
|
||||
|
||||
- **设备类型**：客户端发 `X-Device-Type`（桌面按 `runtime.GOOS` 注入 macos/windows），后端中间件白名单登记（替代写死 `browser`），前端 i18n 本地化展示（浏览器 / macOS 客户端 / Windows 客户端…）。
|
||||
- **设备名持久化**修复：`SaveSettings` 合并保留 `DeviceName`（设置页 `DesktopConfig` 无 device_name 字段，原先存设置会用空值覆盖）。
|
||||
- **统一软件名** `Commilitia Drop Desktop`（`.app` / `.exe`）；品牌 `.icns`（macOS）/ `.ico`（Windows，无 ImageMagick 时用一次性 Go 工具封 PNG-in-ICO）；bundle id `net.commilitia.cdrop`。
|
||||
- **统一软件名** `Commilitia Drop`（`.app` / `.exe`）；品牌 `.icns`（macOS）/ `.ico`
|
||||
（Windows，无 ImageMagick 时用一次性 Go 工具封 PNG-in-ICO）；稳定内部 bundle id
|
||||
`net.commilitia.cdrop`。
|
||||
- **Cmd+,（Ctrl+,）→ 设置**：`main.tsx` 全局 keydown，桌面与浏览器通用。
|
||||
|
||||
### 11.5 自启静默驻留（autostart → 不弹窗，直接驻留菜单栏 / 托盘）
|
||||
|
||||
Reference in New Issue
Block a user