> 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/configuration.md).

# 配置指南

## 入口

模块大部分功能均可直接通过模块设置 UI 进行配置。可通过以下方式中任意一种打开模块设置。

### 从微信设置进入

微信首页 -> 「我」-> 「设置」-> 「WeKit 设置」

### 从微信主页加号进入

微信首页 -> 右上角 `+` 号 -> 菜单中点击「WeKit 设置」

### 从主页浮动按钮进入

如果已启用「界面美化 / 主屏幕添加 FAB」且添加了「模块设置」菜单项: 微信首页 -> 右下角浮动按钮 -> 「模块设置」

### 从模块应用进入

如果微信包名为默认的 `com.tencent.mm`: 模块应用 -> 「打开模块设置」

如果使用修改包名的微信分身, 可在模块应用右上角菜单中选择「设置宿主包名」, 修改 模块应用首页快捷方式所打开的微信。

## 页面导航

模块设置底栏包含四个 Tab, 可点击底栏或左右滑动切换:

* **主页**: 查看模块状态、功能数量、版本、设备和加载环境。
* **功能**: 搜索功能, 或按分类查看和配置功能。
* **日志**: 查看、保存、分享和清理运行日志与崩溃日志。
* **设置**: 配置主题、调试、兼容、配置备份、更新和关于信息。

## 功能设置

功能设置位于底栏「功能」Tab 中。可以按名称或说明搜索功能, 也可以进入分类查看。 普通功能可直接打开或关闭; 名称旁带齿轮图标的功能还可点击进入详细配置。此类功能 可能有固定展示顺序。

各设置项及分组的详细说明请参见 [功能设置说明](https://ujhhgtgteams.gitbook.io/wekit-docs/pages/7LhEuauamxcMhUjaZzG3#功能设置)。

## 日志

底栏「日志」Tab 分为「运行日志」和「崩溃日志」。可选择不同日志文件查看, 也可:

* 下拉刷新当前列表
* 分享或保存当前日志文件
* 从右上角菜单刷新、转到顶部、转到底部或清空对应类型的全部日志

详细说明请参见 [日志说明](https://ujhhgtgteams.gitbook.io/wekit-docs/pages/7LhEuauamxcMhUjaZzG3#日志)。

## 通用设置

通用设置位于底栏「设置」Tab 中。页面顶部显示当前微信账号, 下方可配置模块界面、 调试、兼容、配置备份和更新等选项。

详见 [通用设置说明](https://ujhhgtgteams.gitbook.io/wekit-docs/pages/7LhEuauamxcMhUjaZzG3#通用设置)。

## 模块数据目录

### 一般数据

模块运行时的文件存放在以下位置:

```
/sdcard/Android/data/<宿主包名>/WeKit/
├── logs/                     # 运行日志
├── assets/                   # 媒体资源 (需手动创建)
├── scripts_java/             # Java 脚本 (需手动创建)
├── scripts_python/           # Python 插件
├── sticker_panel/            # 表情面板本地数据
├── voice_panel/              # 语音面板本地数据
├── themes/                   # 界面主题
├── crashes/                  # 崩溃日志 (需启用「调试/崩溃拦截」)
└── dex_cache/                # DEX 缓存 (自动生成)
```

#### 媒体资源目录

「自定义消息气泡」所用的气泡文件存放于 `<模块数据>/assets/` 目录下, 可在该功能设置中导入和更换 `.9.png` 气泡图片，不必手工操作目录。

#### 脚本目录

**Java**

Java 脚本目录存放于 `<模块数据>/scripts_java/` 目录下, 该目录下每个目录放置一个脚本, 每个脚本目录至少包含 `info.prop` `main.java`。

#### 贴纸目录

表情面板数据存放于 `<模块数据>/sticker_panel/`，通过面板导入和管理；语音面板使用 `<模块数据>/voice_panel/`。

详见 [表情面板](https://github.com/Ujhhgtg/WeKit-Dev/tree/master/docs/features/chat/sticker-panel.md)。

### KV 存储

模块的配置数据 (MMKV 文件) 存放在:

* **单用户**: `/data/data/<宿主包名>/files/mmkv/{wekit_prefs,wekit_prefs.crc}`
* **多用户 (如双开微信)**: `/data/user/<宿主安卓用户 ID>/<宿主包名>/files/mmkv/{wekit_prefs,wekit_prefs.crc}`

> 如果模块功能失效或设置异常, 可以尝试清除上述 MMKV 文件 (会丢失所有设置)。

## 扩展包

需要 Python 或其他可选运行时的功能，通过「设置 → 更新 → 扩展包」管理对应组件。缺少包时按界面提示安装；功能开关不等于扩展已经可用。

## 下一步

* [常见问题](/wekit-docs/faq.md) — 遇到异常? 先看看是不是常见问题
* [问题反馈指南](/wekit-docs/bug-report-guide.md) — 了解如何提交问题报告
* [建议反馈指南](/wekit-docs/feature-request-guide.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/configuration.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.