> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qomicex.top/llms.txt
> Use this file to discover all available pages before exploring further.
# 插件设置页（settingsPages）
## 插件设置页（settingsPages）
插件经常需要提供自己的配置界面（开关、API Key、默认行为等）。与其把"设置"按钮散落在插件页面各处，不如把设置界面**统一收进启动器**：在「设置 → 插件 → 插件设置」里，左侧纵向 tab 逐插件列出，右侧就是该插件提供的设置界面。用户找得到、不会迷路。
## 快速开始
**第 1 步**：在 `manifest.json` 的 `contributes.settingsPages` 中声明设置页（`.qplugin` 包内 HTML 的相对路径）：
```json theme={null}
{
"id": "top.qomicex.weather",
"name": "天气",
"version": "1.0.0",
"layers": ["l2"],
"entry": { "frontend": "dist/index.html" },
"contributes": {
"settingsPages": ["dist/settings.html"]
}
}
```
**第 2 步**：在包内编写 `dist/settings.html`。它是一个普通 HTML 页面，与插件主页运行在**完全相同的沙箱环境**（iframe 沙箱 + 完整 `__PLUGIN_API__` 桥 + 主题变量注入），用 `getSettings` / `setSettings` 读写插件自己的配置即可：
```html theme={null}
```
**第 3 步**：打包 `.qplugin` 安装并启用插件。「设置 → 插件 → 插件设置」会出现以插件名命名的 tab，打开即是你写的界面。
## 运行环境
* **iframe 沙箱**：`