> For the complete documentation index, see [llms.txt](https://ujhhgtgteams.gitbook.io/wekit-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ujhhgtgteams.gitbook.io/wekit-docs/installation.md).

# 安装指南

## 下载

本项目不会发布稳定版本, 请从以下渠道下载最新 CI 构建产物 (每夜版):

* [GitHub CI Release](https://github.com/Ujhhgtg/WeKit/releases/tag/CI)
* [GitHub Actions](https://github.com/Ujhhgtg/WeKit/actions/workflows/ci.yml)
* [Telegram 超级群组](https://t.me/+7j5dJ6g16B43OWVl)

**Xposed 和 Zygisk 共用同一份 APK**, 不再单独发布 `wekit-zygisk` 模块 ZIP。所有 standard / legacy、debug / release APK 都支持两种安装方式, 仅支持 ARM64 (`arm64-v8a`)。

| 变体       | 选择方式                                       |
| -------- | ------------------------------------------ |
| standard | 默认选择; 包含现代 libxposed 和传统 Xposed 入口         |
| legacy   | 需要强制使用传统 Xposed API 时选择; 不含现代 libxposed 入口 |

Zygisk 模式可使用任一变体。两者的 Android 应用包名和 Zygisk 模块 ID 相同, 同一种安装方式下会互相覆盖。

从 GitHub Actions 下载 `wekit-apk` 产物时, 先解压外层归档并取出所需 APK。 Xposed 模式直接安装 APK; Zygisk 模式只将 APK 的扩展名从 `.apk` 改为 `.zip`, 例如 `app-standard-release.apk` → `app-standard-release.zip`, 再交给 Root 管理器。 不要直接刷入 Actions 的外层归档, 也不要解压重打包 APK。

## 安装

同一个微信实例只启用一种 WeKit 加载方式。切换方式前先关闭原方式的作用域或 WebUI 开关, 具体见 [切换加载方式](https://ujhhgtgteams.gitbook.io/wekit-docs/pages/PEIuOdrVI72tRE6VFTR8#切换加载方式)。

### Root + Xposed (以 [LSPosed](https://github.com/JingMatrix/Vector) 为例)

1. 下载模块 APK
2. 安装模块
3. 在 LSPosed 管理器中启用模块, 并勾选微信
   * 若 LSPosed 提示「此模块是为较新的 Xposed 版本设计的, 因此某些功能可能无法使用」, 忽略即可, 不影响模块使用
4. 重启微信

### 免 Root + Xposed (以 [NPatch](https://github.com/7723mod/NPatch) 为例)

1. 下载模块与 NPatch 管理器 APK
2. 安装模块与 NPatch 管理器
3. 修补微信, 并根据你的需求选择「本地模式」或「集成模式」。若使用「集成模式」, 需在「嵌入模块」界面勾选「WeKit」。修补时, 包名必须为 `com.tencent.mm` 或以 `com.tencent.mm` 开头, 且建议启用「注入文件提供器」以方便管理模块 KV 数据。
4. 安装修补后的微信。由于未知原因, 即使修补的包名与已安装应用的包名不一致, NPatch 也会请求卸载已安装应用, 请注意不要误操作导致丢失微信数据。
5. 若使用「本地模式」, 需在修补的微信作用域中启用 WeKit。

### Root + Zygisk

1. 下载上述 WeKit APK, 将扩展名从 `.apk` 改为 `.zip`
2. 确保你的 Root 管理器中已启用任意 Zygisk 实现

   对于非 Magisk 用户, 请确保安装了任意 Zygisk 模块

   对于 Magisk 用户, 请确保在 Magisk 设置中启用了 `Zygisk`, *或* 安装了任意 Zygisk 模块

   如未安装 Zygisk 模块, 请安装以下三个中任意一个: [Zygisk Next](https://github.com/Dr-TSNG/ZygiskNext), [ReZygisk](https://github.com/PerformanC/ReZygisk/), [NeoZygisk](https://github.com/JingMatrix/NeoZygisk)
3. 在 Root 管理器的模块安装入口刷入改名后的 ZIP, 无须另行安装 WeKit 应用
4. 按 Root 管理器提示重启设备
5. 打开模块 WebUI, 为对应微信实例打开开关

   对于 Magisk 用户, 请使用第三方 WebUI 实现, 例如 [KsuWebUIStandalone](https://github.com/KOWX712/KsuWebUIStandalone)
6. 完全结束并重新启动微信

详细操作和常见问题见 [Zygisk 模式](/wekit-docs/zygisk.md)。

## 更新

* **Xposed**: 更新已安装或嵌入修补包中的 WeKit APK, 然后完全结束并重新启动微信。
* **Zygisk**: 将新版 APK 改名为 `.zip` 后, 在 Root 管理器中覆盖刷入, 按管理器提示 重启。注入目标开关会保留, 详细重启要求见 [Zygisk 更新](https://ujhhgtgteams.gitbook.io/wekit-docs/pages/PEIuOdrVI72tRE6VFTR8#更新)。

直接安装 APK 与刷入模块分别更新各自部署。只更新 WeKit 应用不会更新 Zygisk 模块, 只刷入模块也不会更新已安装或嵌入修补包中的 APK。

## 修复微信热更新导致的模块不加载

如果模块不加载且日志没有报错, 请尝试采取以下步骤。

### Root + Xposed

1. 授予模块 Root 权限
2. 打开模块应用
3. 右上角三个点菜单 -> 「修复模块加载」 -> 确定
4. 重启微信

### 免 Root + Xposed (需「注入文件提供器」; 以 MT 管理器为例)

1. 启动 MT 管理器
2. 左上角菜单 -> 右上角三个点菜单 -> 添加本地存储
3. 左上角菜单 -> 微信 -> 使用此文件夹 -> 允许
4. 打开添加的微信, 打开 `./data/`, 删除所有 `tinker` 开头文件夹里的内容
5. 对上述每个文件夹, 依次执行: 长按文件夹 -> 属性 -> 权限 -> 修改 -> 取消打钩全部, 勾选两个「同时应用到所有...」 -> 确定
   * 若打开添加的微信显示的目录为空, 启动微信并重试

## 下一步

* [配置指南](/wekit-docs/configuration.md) — 了解如何使用和配置功能


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ujhhgtgteams.gitbook.io/wekit-docs/installation.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.