aozorae/Edgechat

GitHub Actions 会管理服务端加密 Worker Secrets。首次部署时，如果目标 Worker 尚无加密 Secret，工作流会自动生成随机 32 字节 AES 密钥，以独立的版本化 Secret 注入，并记录当前 active key ID。后续普通部署只检查这些 Secret 是否存在，不会重新生成、覆盖或轮换。

生产环境已经存在的 EDGECHAT_ENCRYPTION_KEYRING JSON 密钥环会被原样保留并继续兼容。

需要手动指定密钥时，可创建名为 EDGECHAT_ENCRYPTION_KEYRING 的 GitHub Repository Secret：

{"activeKeyId":"v1","keys":{"v1":"BASE64_ENCODED_32_BYTE_KEY"}}

首次部署会直接采用该值。

已有 Worker 需要自动增量轮换时，手动运行 Deploy Worker 并勾选 rotate_encryption_key。工作流只新增一个版本化密钥 Secret，并把 active key ID 切换到新版本；所有旧 Secret 和旧 JSON 密钥环都保持不变。新消息使用新密钥，旧密文继续使用各自信封中的 key ID 解密。

apply_encryption_keyring 是备用的手动覆盖入口。使用时，Repository Secret 中必须是完整 JSON 密钥环，keys 需要保留所有仍被历史密文引用的旧 key ID，再增加新 key 并更新 activeKeyId。

删除旧 key 会导致对应历史密文永久无法读取。 apply_encryption_keyring 与 rotate_encryption_key 不能在同一次运行中同时启用。

capacitor/ 客户端的 APK 内置 Vue Web UI，并通过少量 Kotlin 对接系统文件选择、通知、麦克风权限、通知会话跳转和外部链接。包名为 com.aozorae.edgechat.web，首次登录时填写自己的 EdgeChat HTTPS 服务地址，不绑定固定部署。

• 安装包：从 GitHub Releases 下载 edgechat-*.apk，并核对 SHA256SUMS.txt。
• 首次使用：填写自己的 EdgeChat HTTPS 服务地址、账号和密码。
• 本地构建：准备 JDK 21 与 Android SDK 36 后，运行 npm run build:capacitor。
• Debug APK：capacitor/android/app/build/outputs/apk/debug/app-debug.apk。
• CI：.github/workflows/capacitor-android-ci.yml 上传 edgechat-capacitor-debug。
• 发布：推送 android-v* 标签或手动运行 Android Release，使用四个 ANDROID_KEYSTORE_* Secrets 构建签名 APK/AAB。
• 服务切换：退出登录后可以修改地址；切换实例时自动清理旧实例令牌。

当前不包含 Room 离线数据库、WorkManager Outbox 或 FCM；应用停止接收消息时，不承诺后台即时通知。

原生 android/ Kotlin + Jetpack Compose 客户端暂时弃用，不再作为默认发行版。源码、API v1 契约与独立 CI 暂时保留。

完整说明见 Android 客户端文档。

# 独立构建演示站
npm run build:demo

# 部署独立演示 Worker
npm run deploy:demo

演示站使用 wrangler.demo.toml 和 .github/workflows/deploy-demo.yml，Worker 名称为 edgechat-demo。GitHub Actions 仅支持手动触发，并读取 DEMO_CLOUDFLARE_ACCOUNT_ID、DEMO_CLOUDFLARE_API_TOKEN，不会改变现有生产部署工作流。

在非交互环境下部署时，需要提前设置 CLOUDFLARE_API_TOKEN。

后台更新检查会在构建时自动记录当前 GitHub 仓库、分支和提交。为了获得准确结果，手动部署应在 Git 仓库内基于已经推送的干净提交构建；源码仓库需要保持公开，浏览器才能直接调用 GitHub Compare API，整个过程不会创建定时任务。

PowerShell 示例：

$env:CLOUDFLARE_API_TOKEN = "your-token"
npm run deploy