docs: 更新全客户端命名与构建分发文档

This commit is contained in:
2026-07-31 23:12:41 +08:00
parent 5ebab84ee3
commit 5d7bae41c5
5 changed files with 1234 additions and 216 deletions
+27 -2
View File
@@ -1,13 +1,38 @@
# Commilitia Drop — 跨 OS 剪贴板与文件传输服务
> 本文是项目最初的 MVP 规格(设计基线),保留作架构参考;**当前实现状态以 [`CHANGELOG`](CHANGELOG.html) 为准**——其后已落地剪贴板/消息通道、Wails 桌面端、扫码登录与 Auth Broker、**原生数据面(P2P 数据面从浏览器 JS 下沉原生:桌面 pion、iOS libwebrtc**、iOS 原生客户端、安全加固等,部分「远期」项已实现。
> 本文是项目最初的 MVP 规格(设计基线),保留作架构参考;**当前实现状态以
> [`CHANGELOG`](CHANGELOG.html) 为准**。全客户端正式构建、签名、安装和分发流程见
> [`CLIENT_BUILD_INSTALL.md`](CLIENT_BUILD_INSTALL.md)。
项目代号 / 仓库名 / 二进制名:`cdrop`
产品名:Commilitia Drop
内部项目代号 / 仓库名:`cdrop`
部署域名:`drop.commilitia.net`
节点:自托管(单机 Docker + 反代)
---
## 当前实现叠加层(2026-07-31
以下状态覆盖本文后续仍保留的历史 MVP 假设:
- 正式客户端为 Web、Windows Wails x86-64、macOS Wails ARM64,以及共用 SwiftUI target 的
iPhone / iPad。macOS 原生 target 尚未完成迁移验收,不得替代 Wails,也不得并行发布。
- 用户可见应用名统一为“Commilitia Drop”,桌面端不再带 “Desktop” 后缀;正式桌面产物为
`Commilitia Drop.exe``Commilitia Drop.app``Commilitia Drop.dmg`
- 用户可见或可诊断的协议命名统一为 `commilitia-drop://auth-callback`
`commilitia-drop-file``_commilitia-drop._tcp` 和 Broker application key
`commilitia-drop`
- Bundle ID、App Group、Keychain service、LaunchAgent label、环境变量和数据目录等内部身份,
只要不直接、不可更改地决定系统显示名,就保持稳定以保护既有权限、钥匙串和配置。
- 鉴权已委托 Auth BrokerBroker、Caddy 与服务端使用同一个 application key;历史 Casdoor
直连、自签会话和 shortcut token 描述仅用于理解演进,不代表当前部署。
- P2P 数据面已从 WebView JavaScript 下沉:桌面使用 Go / pioniOS / iPadOS 使用 libwebrtc
Web 仍使用浏览器 `RTCPeerConnection`。三端共享信令、relay 编排与线协议。
- macOS 正式分发复用既有 Developer ID Application 证书并经 Apple 公证;iPhone / iPad
复用既有 Apple Development 证书,使用 CLI 构建安装,不使用 Xcode GUI。
---
## 1. 目标
跨 OSWin / macOS / Linux / iOS / Android)服务,提供: