reflex-capacitor 0.3.2__tar.gz

reflex_capacitor-0.3.2/.gitignore

@@ -0,0 +1,59 @@
+*.py[cod]
+.states
+.web
+*.db
+assets/external/
+
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+
+# Virtual environments
+.venv
+venv/
+
+# Secrets & local env (never commit)
+.env
+.env.*
+!.env.example
+*.pem
+*.p12
+
+# Android / iOS signing & vendor push config
+*.keystore
+*.jks
+keystore.properties
+google-services.json
+GoogleService-Info.plist
+
+# Android SDK path (machine-specific)
+local.properties
+**/local.properties
+
+# Capacitor project (generated by reflex-capacitor init/sync)
+capacitor/
+node_modules/
+
+# Mobile build outputs (if copied outside capacitor/)
+*.apk
+*.aab
+*.ipa
+
+# Reflex export artifacts
+frontend.zip
+*.zip
+
+# IDE / editor (optional local)
+.idea/
+.vscode/
+*.swp
+.cursor/

reflex_capacitor-0.3.2/CHANGELOG.md

@@ -0,0 +1,115 @@
+# Changelog
+
+All notable changes to this project are documented here.
+
+## [0.3.2] — 2026-08-25
+
+### Fixes
+
+- `project.urls` must be absolute HTTPS links for PyPI (relative `docs/README.md` caused upload 400)
+
+## [0.3.1] — 2026-08-25
+
+### Fixes
+
+- Hatch wheel: drop redundant `force-include` for `bridge/assets` (already packaged via `packages`), which caused duplicate `bridge.js` and failed `python -m build`
+
+## [0.3.0] — 2026-08-25
+
+Phase 5 features for PyPI, plus a Python 3.12 compatibility fix for Android manifest permission patching.
+
+### Fixes
+
+- Android `uses-permission` insert: use positional `str.replace(..., 1)` (Python 3.12 rejects `count=` keyword)
+
+### Deep linking
+
+- [docs/guide/deep-linking.md](docs/guide/deep-linking.md) — Android / iOS URL scheme 配置与 Reflex 事件处理
+- Demo：`appUrlOpen` 展示、`on_app_load` 自动轮询原生事件
+
+### Push notifications
+
+- `PHASE5_PLUGIN_IDS` — optional `push-notifications` plugin tier
+- `mobile.push_register()` / `push_check_permissions()` / `push_request_permissions()`
+- Bridge push listeners → `pushRegistration`, `pushNotificationReceived`, etc.
+- [docs/guide/push-notifications.md](docs/guide/push-notifications.md) — FCM / APNs 接入说明
+- Documented as **opt-in** for PyPI consumers (not in default `ALL_PLUGIN_IDS`)
+
+### CLI proxy (npm / Gradle)
+
+- `--proxy URL` on `init` / `sync` / `run` / `build` / `dev` (env: `REFLEX_CAPACITOR_PROXY`)
+- Default: **no proxy**; ambient `http_proxy` / `HTTPS_PROXY` are stripped for child processes
+
+### Host dependency checks
+
+- Stronger `doctor` / alias `check`: Reflex, Node, npm, JDK 17+, Android SDK platforms & build-tools
+- `init` / `build` / `run` / `dev` fail fast with an explicit missing list (no auto-install of host SDKs)
+- `--device` requires `adb` for run/dev
+
+### PyPI publish CI
+
+- [`.github/workflows/publish-pypi.yml`](.github/workflows/publish-pypi.yml) — on GitHub Release `published`; secret `PYPI_API_TOKEN`
+- Verifies wheel includes `bridge.js` + scaffold; tag `vX.Y.Z` must match `pyproject.toml` version
+
+### Docs restructure (2026-08-25)
+
+- [docs/README.md](docs/README.md) — hub; docs split into **`guide/`** (howto) + **`design/`** (architecture & plan)
+- New howto: [cli](docs/guide/cli.md), [configuration](docs/guide/configuration.md), [android-build](docs/guide/android-build.md), [install](docs/guide/install.md), [faq](docs/guide/faq.md)
+- New design: [packaging](docs/design/packaging.md), [security-network](docs/design/security-network.md)
+- Slim [getting-started](docs/guide/00-getting-started.md); [roadmap](docs/design/04-roadmap.md); [ADR](docs/design/03-development-plan.md)
+- Docs split: `guide/` (user) + `design/` (maintainer); merged plan/ADR; PyPI sdist ships core guide only
+
+### L1 integration tests
+
+- `tests/test_integration_scaffold.py` — offline scaffold / post_build / finalize_bridge / Manifest
+- `tests/conftest.py` — fixtures
+- `tests/helpers.py` — fake export / node_modules helpers
+- Run: `pytest tests/ -m integration`
+
+### L3 device smoke
+
+- `scripts/device-smoke.sh` — adb install, launch, logcat bridge check, optional deep link
+- `tests/test_device_smoke.py` — `-m device` (skips without adb)
+- [docs/guide/testing.md](docs/guide/testing.md)
+
+### iOS platform compatibility
+
+- `bridge/ios_plist.py` — Info.plist usage descriptions on `finalize_bridge`
+- `mobile.platform_info()` + bridge `isAndroid` / `isIos` / `platformInfo`
+- [docs/guide/platform.md](docs/guide/platform.md)
+
+## [0.2.0] — 2026-08-24
+
+Phase 1–4 core complete. See [docs/guide/00-getting-started.md](docs/guide/00-getting-started.md) for the full workflow.
+
+### Phase 4 — Release builds
+
+- `reflex-capacitor build android|ios` — release/debug APK/AAB via Gradle
+- Android signing via `REFLEX_CAPACITOR_KEYSTORE_*` env vars or CLI flags
+- [docs/guide/publishing.md](docs/guide/publishing.md) — keystore, Play Store, iOS notes
+- GitHub Actions workflow `android-release-aab.yml` (manual, production secrets)
+
+### Phase 3 — P1 + dev experience
+
+- P1 bridge APIs: camera, geolocation, preferences, filesystem, keyboard, browser, `invoke`
+- Built-in image editor (free crop, pinch zoom) — [docs/guide/image-editor.md](docs/guide/image-editor.md)
+- `reflex-capacitor dev android` — LAN device development — [docs/guide/dev-reload.md](docs/guide/dev-reload.md)
+- Native reverse events: `setup_native_listeners`, `poll_native_events`
+- Camera/geolocation Android fixes (permissions, feedback toasts)
+
+### Phase 2 — Native bridge P0
+
+- `window.__REFLEX_CAPACITOR__` + `mobile.*` Python API
+- P0: notify, toast, haptics, share, clipboard, device, network, etc.
+- Demo native tab + CI Environment matrix (lan / staging / production)
+- [docs/guide/permissions.md](docs/guide/permissions.md), [docs/guide/debug.md](docs/guide/debug.md)
+
+### Phase 1 — Shell + remote backend
+
+- `CapacitorPlugin`, CLI (`init`, `sync`, `run`, `open`, `doctor`)
+- HTTP LAN backend support (`cleartext`, `androidScheme: http`)
+- GitHub Actions debug APK — [docs/guide/ci.md](docs/guide/ci.md)
+
+## [0.1.0] — Initial
+
+- Project scaffold, remote Capacitor shell concept

reflex_capacitor-0.3.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 0x7eQiChen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

reflex_capacitor-0.3.2/PKG-INFO

@@ -0,0 +1,126 @@
+Metadata-Version: 2.5
+Name: reflex-capacitor
+Version: 0.3.2
+Summary: Package a Reflex app as a Capacitor mobile app (remote backend).
+Project-URL: Homepage, https://github.com/JiaLiangChen99/reflex_capacitor
+Project-URL: Documentation, https://github.com/JiaLiangChen99/reflex_capacitor/blob/main/docs/README.md
+Project-URL: Changelog, https://github.com/JiaLiangChen99/reflex_capacitor/blob/main/CHANGELOG.md
+Project-URL: Repository, https://github.com/JiaLiangChen99/reflex_capacitor
+Project-URL: Issues, https://github.com/JiaLiangChen99/reflex_capacitor/issues
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: android,capacitor,ios,mobile,packaging,reflex
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1.0
+Requires-Dist: reflex>=0.9.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Package a Reflex app as a Capacitor mobile app
+
+Ship the same Reflex frontend into an iOS / Android WebView via
+[Capacitor](https://capacitorjs.com), talking to a **hosted** Reflex backend over HTTPS/WSS.
+
+**Docs (Chinese howto / design / roadmap):** [`docs/README.md`](docs/README.md) ·
+**Start here:** [`docs/guide/00-getting-started.md`](docs/guide/00-getting-started.md) ·
+[FAQ](docs/guide/faq.md) · [Install & PyPI](docs/guide/install.md) · [CHANGELOG](CHANGELOG.md)
+
+```bash
+pip install reflex-capacitor   # or: pip install -e .
+reflex-capacitor check --android
+reflex-capacitor init --platform android
+# set CapacitorPlugin(backend_url=...) in rxconfig.py
+reflex-capacitor sync
+reflex-capacitor run android           # device / emulator
+reflex-capacitor build android --debug # APK
+```
+
+Host toolchains (Node / JDK / Android SDK / Xcode) are **detected, never auto-installed**.
+See [`docs/guide/cli.md`](docs/guide/cli.md) and [`docs/guide/install.md`](docs/guide/install.md).
+
+## Configure
+
+```python
+# rxconfig.py
+import reflex as rx
+from reflex_capacitor import CapacitorPlugin
+from reflex_capacitor.bridge.plugins import ALL_PLUGIN_IDS
+
+config = rx.Config(
+    app_name="demo",
+    cors_allowed_origins=["*"],  # tighten in production
+    plugins=[
+        CapacitorPlugin(
+            backend_url="https://api.example.com",
+            app_id="com.example.myapp",
+            app_name="My App",
+            plugins=ALL_PLUGIN_IDS,  # default in code is CORE only; ALL recommended
+        ),
+    ],
+)
+```
+
+Push notifications are **opt-in** (`PHASE5_PLUGIN_IDS`). Details:
+[`docs/guide/configuration.md`](docs/guide/configuration.md),
+[`docs/guide/push-notifications.md`](docs/guide/push-notifications.md).
+
+## Commands
+
+| Command | Purpose |
+|---------|---------|
+| `doctor` / `check` | Host dependency report (`--android`, `--device`, `--ios`) |
+| `init` | Scaffold `capacitor/`, `npm install`, `cap add` |
+| `sync` | `reflex export` → `www/` → `npx cap sync` |
+| `run` / `dev` | Sync + launch (dev: LAN backend helper) |
+| `build` | Release/debug APK, AAB, or iOS archive |
+| `open` | Open Android Studio / Xcode |
+
+Proxy for npm/Gradle (off by default): `--proxy URL` or `REFLEX_CAPACITOR_PROXY`.
+
+Full CLI: [`docs/guide/cli.md`](docs/guide/cli.md) · Dev reload: [`docs/guide/dev-reload.md`](docs/guide/dev-reload.md) ·
+Store signing: [`docs/guide/publishing.md`](docs/guide/publishing.md)
+
+## Python API
+
+```python
+from reflex_capacitor import mobile
+
+mobile.notify("Hello", "From Reflex")
+mobile.get_current_position(State.on_gps)
+mobile.setup_native_listeners(back_button="emit")
+mobile.poll_native_events(State.on_native_events)
+```
+
+API map: [`docs/guide/02-native-bridge.md`](docs/guide/02-native-bridge.md)
+
+## Backend URL
+
+| Environment | URL | Notes |
+|-------------|-----|-------|
+| Production | `https://…` | WSS; required for store builds |
+| LAN | `http://192.168.x.x:port` | cleartext + `androidScheme: http` (automatic) |
+| Emulator → host | `http://10.0.2.2:8000` | Android emulator loopback |
+
+Network & CORS: [`docs/guide/configuration.md`](docs/guide/configuration.md)
+
+## Layout
+
+| Path | Role |
+|------|------|
+| `src/reflex_capacitor/` | Library (`CapacitorPlugin`, CLI, bridge) |
+| `demo/` | Sample app |
+| `capacitor/` | Generated Capacitor project (after `init`) |
+| `docs/` | Docs hub: [`docs/README.md`](docs/README.md) (`guide/` + `design/`) |
+
+## CI
+
+- Debug APK — [`docs/guide/ci.md`](docs/guide/ci.md)
+- Release AAB — [`docs/guide/publishing.md`](docs/guide/publishing.md)
+
+## Limitations
+
+- **Remote backend only** — no embedded Python on device
+- **Not a mobile UI kit** — Reflex UI + `mobile.*` bridge
+- **Android-first** — iOS needs macOS; no iOS CI in this repo yet
+- Host SDKs checked by `check`, never installed by this tool

reflex_capacitor-0.3.2/README.md

@@ -0,0 +1,107 @@
+# Package a Reflex app as a Capacitor mobile app
+
+Ship the same Reflex frontend into an iOS / Android WebView via
+[Capacitor](https://capacitorjs.com), talking to a **hosted** Reflex backend over HTTPS/WSS.
+
+**Docs (Chinese howto / design / roadmap):** [`docs/README.md`](docs/README.md) ·
+**Start here:** [`docs/guide/00-getting-started.md`](docs/guide/00-getting-started.md) ·
+[FAQ](docs/guide/faq.md) · [Install & PyPI](docs/guide/install.md) · [CHANGELOG](CHANGELOG.md)
+
+```bash
+pip install reflex-capacitor   # or: pip install -e .
+reflex-capacitor check --android
+reflex-capacitor init --platform android
+# set CapacitorPlugin(backend_url=...) in rxconfig.py
+reflex-capacitor sync
+reflex-capacitor run android           # device / emulator
+reflex-capacitor build android --debug # APK
+```
+
+Host toolchains (Node / JDK / Android SDK / Xcode) are **detected, never auto-installed**.
+See [`docs/guide/cli.md`](docs/guide/cli.md) and [`docs/guide/install.md`](docs/guide/install.md).
+
+## Configure
+
+```python
+# rxconfig.py
+import reflex as rx
+from reflex_capacitor import CapacitorPlugin
+from reflex_capacitor.bridge.plugins import ALL_PLUGIN_IDS
+
+config = rx.Config(
+    app_name="demo",
+    cors_allowed_origins=["*"],  # tighten in production
+    plugins=[
+        CapacitorPlugin(
+            backend_url="https://api.example.com",
+            app_id="com.example.myapp",
+            app_name="My App",
+            plugins=ALL_PLUGIN_IDS,  # default in code is CORE only; ALL recommended
+        ),
+    ],
+)
+```
+
+Push notifications are **opt-in** (`PHASE5_PLUGIN_IDS`). Details:
+[`docs/guide/configuration.md`](docs/guide/configuration.md),
+[`docs/guide/push-notifications.md`](docs/guide/push-notifications.md).
+
+## Commands
+
+| Command | Purpose |
+|---------|---------|
+| `doctor` / `check` | Host dependency report (`--android`, `--device`, `--ios`) |
+| `init` | Scaffold `capacitor/`, `npm install`, `cap add` |
+| `sync` | `reflex export` → `www/` → `npx cap sync` |
+| `run` / `dev` | Sync + launch (dev: LAN backend helper) |
+| `build` | Release/debug APK, AAB, or iOS archive |
+| `open` | Open Android Studio / Xcode |
+
+Proxy for npm/Gradle (off by default): `--proxy URL` or `REFLEX_CAPACITOR_PROXY`.
+
+Full CLI: [`docs/guide/cli.md`](docs/guide/cli.md) · Dev reload: [`docs/guide/dev-reload.md`](docs/guide/dev-reload.md) ·
+Store signing: [`docs/guide/publishing.md`](docs/guide/publishing.md)
+
+## Python API
+
+```python
+from reflex_capacitor import mobile
+
+mobile.notify("Hello", "From Reflex")
+mobile.get_current_position(State.on_gps)
+mobile.setup_native_listeners(back_button="emit")
+mobile.poll_native_events(State.on_native_events)
+```
+
+API map: [`docs/guide/02-native-bridge.md`](docs/guide/02-native-bridge.md)
+
+## Backend URL
+
+| Environment | URL | Notes |
+|-------------|-----|-------|
+| Production | `https://…` | WSS; required for store builds |
+| LAN | `http://192.168.x.x:port` | cleartext + `androidScheme: http` (automatic) |
+| Emulator → host | `http://10.0.2.2:8000` | Android emulator loopback |
+
+Network & CORS: [`docs/guide/configuration.md`](docs/guide/configuration.md)
+
+## Layout
+
+| Path | Role |
+|------|------|
+| `src/reflex_capacitor/` | Library (`CapacitorPlugin`, CLI, bridge) |
+| `demo/` | Sample app |
+| `capacitor/` | Generated Capacitor project (after `init`) |
+| `docs/` | Docs hub: [`docs/README.md`](docs/README.md) (`guide/` + `design/`) |
+
+## CI
+
+- Debug APK — [`docs/guide/ci.md`](docs/guide/ci.md)
+- Release AAB — [`docs/guide/publishing.md`](docs/guide/publishing.md)
+
+## Limitations
+
+- **Remote backend only** — no embedded Python on device
+- **Not a mobile UI kit** — Reflex UI + `mobile.*` bridge
+- **Android-first** — iOS needs macOS; no iOS CI in this repo yet
+- Host SDKs checked by `check`, never installed by this tool

reflex_capacitor-0.3.2/docs/README.md

@@ -0,0 +1,43 @@
+# reflex-capacitor 文档
+
+**remote** 模式：Reflex 静态前端进 Capacitor 壳，连远端 Python 后端。
+
+| 目录 | 读者 | 说明 |
+|------|------|------|
+| **[guide/](guide/)** | 使用者 | 安装、配置、CLI、打包、API、调试 |
+| **[design/](design/)** | 维护者 | 架构、打包原理、规划、测试（**不进 PyPI 包**） |
+
+👉 首读：[guide/00-getting-started.md](guide/00-getting-started.md) · [guide/faq.md](guide/faq.md)
+
+---
+
+## guide/ — 用户文档（推荐）
+
+| 文档 | 用途 |
+|------|------|
+| [00-getting-started.md](guide/00-getting-started.md) | 快速上手 |
+| [install.md](guide/install.md) | pip / 依赖 / PyPI / 推送 GitHub 前检查 |
+| [faq.md](guide/faq.md) | 常见问题 |
+| [cli.md](guide/cli.md) | 命令行 |
+| [configuration.md](guide/configuration.md) | `CapacitorPlugin`、CORS、平台 |
+| [android-build.md](guide/android-build.md) | 本机打 APK |
+| [02-native-bridge.md](guide/02-native-bridge.md) | `mobile.*` API |
+| [dev-reload.md](guide/dev-reload.md) | 真机开发 |
+| [debug.md](guide/debug.md) | 排障 |
+| [publishing.md](guide/publishing.md) | 签名与上架 |
+| [ci.md](guide/ci.md) | GitHub Actions 打 APK |
+
+**按需阅读**（可选能力）：[permissions.md](guide/permissions.md) · [deep-linking.md](guide/deep-linking.md) · [push-notifications.md](guide/push-notifications.md)
+
+---
+
+## design/ — 架构与规划（仓库内）
+
+| 文档 | 用途 |
+|------|------|
+| [01-architecture.md](design/01-architecture.md) | 三层架构 |
+| [packaging.md](design/packaging.md) | export → sync 数据流 |
+| [plan.md](design/plan.md) | ADR + 路线图 |
+| [testing.md](design/testing.md) | L1/L3 测试 |
+
+[CHANGELOG.md](../CHANGELOG.md) · [README.md](../README.md)

reflex_capacitor-0.3.2/docs/guide/00-getting-started.md

@@ -0,0 +1,111 @@
+# 快速上手
+
+> 最后更新：2026-08-25  
+> 平台：**Android**（Windows/Linux 可开发）；**iOS** 需 Mac。
+
+最短路径：装好依赖 → 配 `backend_url` → `init` / `sync` → 真机或 CI 出包。细节见专题文档；总索引见 [README.md](../README.md)。
+
+---
+
+## 1. 安装与检查
+
+```bash
+pip install reflex-capacitor   # 或本仓库: pip install -e .
+reflex-capacitor check --android
+```
+
+- 缺什么会逐条列出；**本 CLI 不代装** Node / JDK / Android SDK。
+- 安装与 PyPI 发布说明 → [install.md](install.md)
+- 仅同步前端：`check`（不必 `--android`）。
+- 真机运行：`check --android --device`（要求 `adb`）。
+
+环境说明 → [android-build.md](android-build.md) · 命令全集 → [cli.md](cli.md)
+
+---
+
+## 2. 最小配置
+
+```python
+import reflex as rx
+from reflex_capacitor import CapacitorPlugin
+from reflex_capacitor.bridge.plugins import ALL_PLUGIN_IDS
+
+config = rx.Config(
+    app_name="demo",
+    cors_allowed_origins=["*"],  # 生产请收紧
+    plugins=[
+        CapacitorPlugin(
+            backend_url="http://192.168.1.56:8001",  # 生产用 https://
+            app_id="dev.reflex.myapp",
+            app_name="My App",
+            plugins=ALL_PLUGIN_IDS,  # 推送等见 configuration.md
+        ),
+    ],
+)
+```
+
+| 环境 | `backend_url` |
+|------|----------------|
+| 局域网调试 | `http://<PC局域网IP>:端口`（自动 cleartext） |
+| 生产 | `https://api.example.com` |
+
+完整配置 → [configuration.md](configuration.md)
+
+---
+
+## 3. 首次出包
+
+```bash
+reflex-capacitor init --platform android
+reflex-capacitor sync
+reflex-capacitor run android          # 需设备/模拟器
+# 或只打 APK：
+reflex-capacitor build android --debug
+```
+
+下载慢时显式代理（默认**不用**代理）：
+
+```bash
+reflex-capacitor sync --proxy http://127.0.0.1:7890
+```
+
+无本机 SDK → [ci.md](ci.md)。后端需 `0.0.0.0`，手机与 PC 同网。
+
+日常开发 → [dev-reload.md](dev-reload.md) · 调试 → [debug.md](debug.md)
+
+---
+
+## 4. 原生 API（摘录）
+
+```python
+from reflex_capacitor import mobile
+
+mobile.notify("标题", "正文")
+mobile.get_current_position(State.on_gps)
+mobile.setup_native_listeners(back_button="emit")
+mobile.poll_native_events(State.on_native_events)
+```
+
+完整表 → [02-native-bridge.md](02-native-bridge.md) · 权限 → [permissions.md](permissions.md)
+
+---
+
+## 5. 发布
+
+```bash
+reflex-capacitor build android              # release APK
+reflex-capacitor build android --format aab
+```
+
+签名与上架 → [publishing.md](publishing.md)
+
+---
+
+## 6. 已知限制
+
+- **仅 remote 后端**（设备上不跑 Python）
+- **推送可选**（`PHASE5_PLUGIN_IDS`）→ [push-notifications.md](push-notifications.md)
+- **iOS** 需 Mac；本仓库 CI 未跑 iOS
+- 定位等机型差异 → [debug.md](debug.md)
+
+变更记录 → [CHANGELOG.md](../../CHANGELOG.md) · 常见问题 → [faq.md](faq.md)