docs: 更新全客户端命名与构建分发文档
This commit is contained in:
+27
-2
@@ -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 Broker,Broker、Caddy 与服务端使用同一个 application key;历史 Casdoor
|
||||
直连、自签会话和 shortcut token 描述仅用于理解演进,不代表当前部署。
|
||||
- P2P 数据面已从 WebView JavaScript 下沉:桌面使用 Go / pion,iOS / iPadOS 使用 libwebrtc;
|
||||
Web 仍使用浏览器 `RTCPeerConnection`。三端共享信令、relay 编排与线协议。
|
||||
- macOS 正式分发复用既有 Developer ID Application 证书并经 Apple 公证;iPhone / iPad
|
||||
复用既有 Apple Development 证书,使用 CLI 构建安装,不使用 Xcode GUI。
|
||||
|
||||
---
|
||||
|
||||
## 1. 目标
|
||||
|
||||
跨 OS(Win / macOS / Linux / iOS / Android)服务,提供:
|
||||
|
||||
Reference in New Issue
Block a user