Add homepage i18n and zh-CN guides

Update docusaurus deps and clean zh-CN installation

Author: boa-z

docs/development/architecture.md

@@ -65,7 +65,7 @@ LiveContainer is more than a shell app—it is a small runtime that re-hosts arb
 - The loader resolves the program entry point and jumps to it; the guest then calls `UIApplicationMain` as usual.
 
 ### Multi-account support & keychain semi-separation
-- 128 keychain access groups are defined. Containers randomly pick groups to reduce cross-app keychain collisions, enabling isolated sign-ins per container.
+- [128 keychain access groups](https://github.com/LiveContainer/LiveContainer/blob/main/entitlements.xml) are defined. Containers randomly pick groups to reduce cross-app keychain collisions, enabling isolated sign-ins per container.
 
 ## Limitations
 

docs/development/i18n.md

@@ -0,0 +1,56 @@
+---
+title: Documentation i18n Workflow
+sidebar_position: 3
+---
+
+# Documentation i18n Workflow
+
+LiveContainer’s docs ship in English and Simplified Chinese. This guide explains how to keep the translations in sync whenever you edit Markdown pages or UI strings.
+
+## 1. Generate translation sources
+
+Run the built-in Docusaurus helper whenever you add or rename docs:
+
+```bash
+npm run write-translations
+# or a single locale:
+npm run write-translations -- --locale zh-CN
+```
+
+This command updates:
+
+- `i18n/zh-CN/docusaurus-plugin-content-docs/current/**` – translated Markdown copies.
+- `i18n/zh-CN/code.json` – UI strings coming from MDX JSX, metadata, etc.
+- `i18n/zh-CN/docusaurus-theme-classic/*.json` – navbar/footer/search labels.
+
+Commit these files alongside your English edits so translators see the diffs.
+
+## 2. Edit translated Markdown
+
+Each English doc keeps its original `id`. The translated file must live in the same relative path inside `i18n/zh-CN/docusaurus-plugin-content-docs/current`. Example:
+
+- English: `docs/guides/jit-support.md`
+- Chinese: `i18n/zh-CN/docusaurus-plugin-content-docs/current/guides/jit-support.md`
+
+Copy the front matter and structure verbatim, then translate the body. Keep code blocks, admonitions, and inline HTML exactly where they are so MDX renders correctly.
+
+If you use Crowdin, push the updated sources, let translators work there, then pull translations back into this folder.
+
+## 3. Translate theme strings
+
+Navbar/footer/search labels live under `i18n/zh-CN/docusaurus-theme-classic`. Run `write-translations` and update the JSON files when you change `docusaurus.config.js` (e.g., add a new navbar item).
+
+## 4. Validate builds
+
+Always test both locales locally:
+
+```bash
+npm run start -- --locale zh-CN
+npm run build -- --locale zh-CN
+```
+
+Start the dev server with `--locale zh-CN` if you need to inspect only the Chinese site. For production builds, add a CI job that runs `npm run build -- --locale zh-CN` so missing translations fail fast.
+
+## 5. Let translators know
+
+When opening a PR that changes English content, mention whether translations are required. If you can’t translate immediately, leave a TODO comment in the matching `i18n/zh-CN` file or create an issue tagged `needs-translation`.

docs/faq/compatibility.md

@@ -16,7 +16,7 @@ Unfortunately, not every iOS app cooperates with LiveContainer. Before opening a
 
 1. **Update LiveContainer** to the latest stable or nightly build.
 2. Decide whether the guest is **private** or **shared** and document that choice. Some bugs only happen with shared containers.
-3. Note whether the app uses **JIT** or **JIT-less** mode. Run the [JIT-Less Diagnose](../guides/jit-less-diagnose-page.md) tool to ensure certificates are valid.
+3. Note whether the app uses **JIT** or **JIT-less** mode. Run the [JIT-Less Diagnose](/docs/guides/jit-less-diagnose-page) tool to ensure certificates are valid.
 4. If tweaks are enabled, temporarily disable them (long-press app → Settings → Tweak folder → `None`) to rule out conflicts.
 5. Use **Settings → Data Management → Export Logs** immediately after reproducing the issue and attach the zip to your report.
 6. Mention if the app is running in **multitask mode** or through another LiveContainer instance.

docs/installation.md

@@ -73,9 +73,9 @@ If you reinstall AltStore/SideStore using AltServer, you will need to go through
 
 Once the basics work, explore the following guides:
 
-- [Multiple LiveContainers](./guides/multiple-livecontainers.md) — run additional containers and share apps between them.
-- [JIT Support](./guides/jit-support.md) — configure automatic JIT enablers or scripts.
-- [JIT-Less Diagnose Page](./guides/jit-less-diagnose-page.md) — verify imported certificates and troubleshoot signing issues.
-- [Tweaks](./guides/tweaks.md) — inject CydiaSubstrate tweaks globally or per app.
-- [Multitask](./guides/multitask.md) — float guest apps in resizable windows.
-- [Lock & Hide Apps](./guides/lock-app.md) — protect sensitive guests with Face ID or Strict Hiding mode.
+- [Multiple LiveContainers](/docs/guides/multiple-livecontainers) — run additional containers and share apps between them.
+- [JIT Support](/docs/guides/jit-support) — configure automatic JIT enablers or scripts.
+- [JIT-Less Diagnose Page](/docs/guides/jit-less-diagnose-page) — verify imported certificates and troubleshoot signing issues.
+- [Tweaks](/docs/guides/tweaks) — inject CydiaSubstrate tweaks globally or per app.
+- [Multitask](/docs/guides/multitask) — float guest apps in resizable windows.
+- [Lock & Hide Apps](/docs/guides/lock-app) — protect sensitive guests with Face ID or Strict Hiding mode.

i18n/en/code.json

@@ -344,5 +344,53 @@
   "theme.tags.tagsPageTitle": {
     "message": "Tags",
     "description": "The title of the tag list page"
+  },
+  "home.logoAlt": {
+    "message": "LiveContainer Logo",
+    "description": "Alt text for the homepage logo"
+  },
+  "home.heroTitle": {
+    "message": "LiveContainer",
+    "description": "Homepage hero title"
+  },
+  "home.heroSubtitle": {
+    "message": "Run iOS apps in a sandbox without jailbreak",
+    "description": "Homepage hero subtitle"
+  },
+  "home.getStartedButton": {
+    "message": "Get Started",
+    "description": "Primary call-to-action button on homepage"
+  },
+  "home.metaTitle": {
+    "message": "LiveContainer",
+    "description": "Meta title used for the homepage"
+  },
+  "home.pageDescription": {
+    "message": "Run iOS apps in a sandbox without jailbreak",
+    "description": "Meta description for the homepage"
+  },
+  "home.feature.noJailbreak.title": {
+    "message": "No Jailbreak Required",
+    "description": "Feature section title"
+  },
+  "home.feature.noJailbreak.description": {
+    "message": "Run iOS apps in a secure sandbox environment without needing to jailbreak your device.",
+    "description": "Feature description for no jailbreak"
+  },
+  "home.feature.multipleContainers.title": {
+    "message": "Multiple Containers",
+    "description": "Feature title for multiple containers"
+  },
+  "home.feature.multipleContainers.description": {
+    "message": "Create multiple isolated containers for the same app with different data.",
+    "description": "Feature description for multiple containers"
+  },
+  "home.feature.jit.title": {
+    "message": "JIT Support",
+    "description": "Feature title for JIT support"
+  },
+  "home.feature.jit.description": {
+    "message": "Optional JIT mode for better performance and compatibility with more apps.",
+    "description": "Feature description for JIT support"
   }
 }

i18n/en/docusaurus-plugin-content-docs/current.json

@@ -22,5 +22,9 @@
   "sidebar.docsSidebar.category.Guides": {
     "message": "Guides",
     "description": "The label for category Guides in sidebar docsSidebar"
+  },
+  "sidebar.docsSidebar.doc.Installation": {
+    "message": "Installation",
+    "description": "The label for the doc item Installation in sidebar docsSidebar, linking to the doc installation"
   }
 }

i18n/zh-CN/code.json

@@ -344,5 +344,53 @@
   "theme.tags.tagsPageTitle": {
     "message": "标签",
     "description": "The title of the tag list page"
+  },
+  "home.logoAlt": {
+    "message": "LiveContainer 标志",
+    "description": "Alt text for the homepage logo"
+  },
+  "home.heroTitle": {
+    "message": "LiveContainer",
+    "description": "Homepage hero title"
+  },
+  "home.heroSubtitle": {
+    "message": "无需越狱，在沙盒中运行 iOS 应用",
+    "description": "Homepage hero subtitle"
+  },
+  "home.getStartedButton": {
+    "message": "开始使用",
+    "description": "Primary call-to-action button on homepage"
+  },
+  "home.metaTitle": {
+    "message": "LiveContainer",
+    "description": "Meta title used for the homepage"
+  },
+  "home.pageDescription": {
+    "message": "无需越狱，在沙盒中运行 iOS 应用",
+    "description": "Meta description for the homepage"
+  },
+  "home.feature.noJailbreak.title": {
+    "message": "无需越狱",
+    "description": "Feature section title"
+  },
+  "home.feature.noJailbreak.description": {
+    "message": "无需越狱即可在安全的沙盒环境中运行 iOS 应用。",
+    "description": "Feature description for no jailbreak"
+  },
+  "home.feature.multipleContainers.title": {
+    "message": "多容器",
+    "description": "Feature title for multiple containers"
+  },
+  "home.feature.multipleContainers.description": {
+    "message": "为同一应用创建多个隔离容器，并保留不同的数据。",
+    "description": "Feature description for multiple containers"
+  },
+  "home.feature.jit.title": {
+    "message": "JIT 支持",
+    "description": "Feature title for JIT support"
+  },
+  "home.feature.jit.description": {
+    "message": "可选的 JIT 模式提升性能，并兼容更多应用。",
+    "description": "Feature description for JIT support"
   }
 }

i18n/zh-CN/docusaurus-plugin-content-docs/current.json

@@ -1,22 +1,30 @@
 {
   "version.label": {
-    "message": "Next",
+    "message": "最新",
     "description": "The label for version current"
   },
   "sidebar.docsSidebar.category.Getting Started": {
-    "message": "Getting Started",
+    "message": "快速开始",
     "description": "The label for category Getting Started in sidebar docsSidebar"
   },
   "sidebar.docsSidebar.category.Development": {
-    "message": "Development",
+    "message": "开发",
     "description": "The label for category Development in sidebar docsSidebar"
   },
   "sidebar.docsSidebar.category.FAQ": {
-    "message": "FAQ",
+    "message": "常见问题",
     "description": "The label for category FAQ in sidebar docsSidebar"
   },
   "sidebar.docsSidebar.doc.Introduction": {
-    "message": "Introduction",
+    "message": "简介",
     "description": "The label for the doc item Introduction in sidebar docsSidebar, linking to the doc intro"
+  },
+  "sidebar.docsSidebar.category.Guides": {
+    "message": "指南",
+    "description": "The label for category Guides in sidebar docsSidebar"
+  },
+  "sidebar.docsSidebar.doc.Installation": {
+    "message": "安装",
+    "description": "The label for the doc item Installation in sidebar docsSidebar, linking to the doc installation"
   }
 }

i18n/zh-CN/docusaurus-plugin-content-docs/current/basics/installation.md

@@ -0,0 +1,76 @@
+---
+title: 系统架构
+---
+
+# LiveContainer 架构概览
+
+LiveContainer 不只是一个外壳应用，它在自身沙盒中重新托管任意 iOS 应用，提供 Tweak 注入、多任务以及 JIT-Less 运行。本页概述最新代码库的组成以及启动流程。
+
+## 项目结构
+
+### 主可执行文件（`LiveContainer`）
+- 整个平台的入口，负责启动、数据管理、容器生命周期，并为每个 Guest 启动 LiveProcess。
+- 未运行 Guest 时，会加载 SwiftUI 界面（`LiveContainerSwiftUI`）。
+
+### LiveContainerSwiftUI
+- 由 [@hugeBlack](https://github.com/hugeBlack) 贡献的 SwiftUI 前端。
+- 内含本地化资源（`Localizable.xcstrings`）。欢迎通过 [Crowdin 项目](https://crowdin.com/project/livecontainer) 参与翻译。
+
+### LiveProcess
+- 轻量级辅助可执行文件，真正的 Guest Loader。它使用不同的 Bundle ID，在相同权限下运行，便于多任务和基于 PID 的 JIT。
+- 负责修补 Guest 二进制、配置 dyld、注入 Tweaks，并把控制权交给应用入口。
+
+### MultitaskSupport
+- 实现应用内浮窗以及原生 iPadOS 窗口。
+- 与主容器通信，在多个 LiveProcess 实例间同步状态与输入。
+
+### SideStore 助手
+- 与 SideStore 的刷新/JIT API 集成，提供后台证书刷新、源更新以及 URL Scheme 处理。
+
+### TweakLoader
+- 随应用发布的迷你 Substrate Loader。
+- 通过新增 Load Command 注入到每个 Guest；若需要可以替换 `TweakLoader.dylib` 符号链接。
+
+### ZSign
+- 随附的签名工具（基于 [zhlynn/zsign](https://github.com/zhlynn/zsign)，使用 [Feather](https://github.com/khcrysalis/Feather) 分支）。
+- LiveContainer 维护的版本针对多容器和自定义权限做了调整。
+
+### 第三方库
+- `fishhook`、`litehook` 与 `OpenSSL` 以子模块形式存在，为 Hook 与签名流程提供底层能力。
+
+## 工作原理
+
+### 预处理 Guest 可执行文件
+- 重写 `__PAGEZERO` 段（`vmaddr = 0xFFFFC000`，`vmsize = 0x4000`），以便在 LiveProcess 中映射。
+- 将 Mach-O 类型从 `MH_EXECUTE` 改为 `MH_DYLIB`。
+- 注入新的 Load Command，在 `UIApplicationMain` 前加载 `TweakLoader.dylib`。
+
+### 修补 `@executable_path`
+- 新版本通过 litehook/fishhook Hook `dyld4::APIs::_NSGetExecutablePath`。
+- Hook 调用原函数后，使 `config.process.mainExecutablePath` 可写并替换为 Guest 的路径。
+- 旧的 SIGSEGV Hack 已废弃，但仍记录在 [主仓库 README](https://github.com/LiveContainer/LiveContainer/blob/main/README.md) 中。
+
+### 修补 `NSBundle.mainBundle`
+- 重写该属性，让请求 Bundle 元数据的 API 得到 Guest 的数据而不是 LiveContainer 的。
+
+### 绕过库校验/签名
+- 有 JIT 时，LiveContainer 会调用已配置的 Enabler 解除签名检查。
+- 在 JIT-Less 模式下，内置的 ZSign 会使用 AltStore/SideStore 导入的证书重签每个 Guest 和 Tweak。
+- 方案基于 [Restoring Dyld Memory Loading](https://blog.xpnsec.com/restoring-dyld-memory-loading)。
+
+### 启动应用
+- LiveProcess 使用 `dlopen` 加载修补后的二进制。
+- `TweakLoader` 载入 CydiaSubstrate 以及当前所选的 Tweak 文件夹。
+- Loader 找到入口点并跳转，Guest 随后照常调用 `UIApplicationMain`。
+
+### 多账号与钥匙串半隔离
+- 定义了 [128 个钥匙串访问组](https://github.com/LiveContainer/LiveContainer/blob/main/entitlements.xml)，容器会随机分配，从而降低同一应用不同容器之间的碰撞，方便多账号登录。
+
+## 限制
+
+- Guest 的原生权限不会被复制，只能使用赋予 LiveContainer 的基础权能。
+- App 权限（摄像头、媒体库等）在所有 Guest 间共享。
+- 容器共享同一沙盒，恶意应用可能读取其他应用的数据。
+- 无法注册 App Extension（SpringBoard 不知道这些扩展，而且 App ID 数量有限）。
+- 某些多任务场景下，硬件键盘或「iPhone 镜像」依旧会受限制。
+- 远程推送和自定义 URL Scheme 通常不可用，因为 LiveContainer 无法在 SpringBoard 中注册它们。