# 第八章：模块系统

> [ <mark style="color:orange;background-color:yellow;">Forward模块文档与实例库</mark>](https://github.com/InchStudio/ForwardWidgets)

用户可以参照以上开发文档进行模块的开发，也鼓励大家用ai进行开发，目前已有的十多款组件，过半数由作者通过模块开发

***

### 🔗 模块导入方式

Forward 支持两种模块导入路径：

* **外部链接导入**：在「设置 - 模块」中输入模块源地址，点击添加。
* **本地 `.fwd or .js` 文件导入**：支持从本地文件系统导入 `.fwd or .js` 格式的模块配置。

***

### 👤 进入首页配置

1. 在首页右上角点击头像图标，进入「首页配置」模式。
2. 可进行以下操作：
   * **点击 `＋` 按钮添加模块**：选择空位插入模块。
   * **拖动模块进行排序或重排**。
   * **支持模块分组**：部分同类型模块可自动组合为一行模块组。

***

### 🧱 模板与数据源选择

每个模块由两部分构成：

* **模板**：决定模块的外观排布样式，如「列表浏览-全宽」、「观剧进度」等。
* **数据源**：模块的数据来源，可以是聚合推荐、榜单内容、个人喜好等。

部分支持参数配置（如类型、年份、排序方式等），增强展示的个性化效果。

<figure><img src="https://603220482-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDp6bn34WIwgguevDQZE4%2Fuploads%2FoIS4EjG2RiM65RQq4kNb%2FSTIIITCH_2025_06_24_12_01_03.PNG?alt=media&#x26;token=11b09f51-7f4f-4653-8bc1-0c5270e13038" alt=""><figcaption></figcaption></figure>

***

### 📦 首页配置文件分享与导入（.fwd）

Forward 支持将排布好的首页导出为 `.fwd` 文件，或导入他人分享的配置文件，快速复现相同首页结构。

#### ✅ 导出流程

* 在「首页配置」界面完成布局后，选择导出为 `.fwd` 文件。
* <mark style="color:red;">分享</mark>给其他用户<mark style="color:red;">前</mark>，建议：
  * <mark style="color:orange;">**将 Forward App 升级至最新版**</mark><mark style="color:orange;">。</mark>
  * <mark style="color:orange;">**将使用到的所有模块也更新为最新版**</mark><mark style="color:orange;">。</mark>

#### 📥 导入流程

* 用户可从文件管理器、浏览器或其他应用导入 `.fwd` 文件。
* 如果文件中包含**你尚未添加过的组件**，Forward 会在模块管理界面中新增一个分类「**本地导入**」以方便识别与管理。

<figure><img src="https://603220482-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDp6bn34WIwgguevDQZE4%2Fuploads%2FVNDXA1q8FbwSRgzjw1pU%2FIMG_563157305497-1.jpeg?alt=media&#x26;token=b0500ae3-7c68-488f-b35d-b31e52aea7e6" alt=""><figcaption></figcaption></figure>

***

### 🛡️ 模块免责声明

模块功能来源广泛，Forward 无法对其进行逐一审核：

> 在添加模块时，应甄别其来源，特别是涉及登录信息填写等敏感操作的模块，需自行确保其安全性与可信度。

* Forward 将对用户举报的可疑或恶意模块进行提示标记。
* 对于因模块引发的任何风险（信息泄露、功能异常或版权争议等），Forward **不承担任何责任**。
* 使用过程中请务必遵守所在地法律法规及版权规定。

***

### 💡 使用建议

* 首页模块排布不宜过多不易重复，避免占用过多系统资源。
* 推荐搭配内容类、榜单类与进度类模块，形成多维内容层次。
* 常见优质模块可在以下社区获取推荐：

> Forward - 新视界：<https://t.me/inchmade\\_studio\\>
> Forward - 组件首页CH：<https://t.me/ForwardWidgets>

如果在使用首页配置和模块的过程中感受到一些图标加载不了或者资源无法加载，请订阅以下分流规则（感谢Rinrin）

{% hint style="success" %}
Surge：<https://raw.githubusercontent.com/xxxjacc/SurgeRules/main/ForwardWidgetFilter.list>
{% endhint %}

{% hint style="success" %}
Quanx：<https://gist.github.com/MrRegret/5cd24ef8b6e750b975d705bbb1b3d9d9/raw>
{% endhint %}

{% hint style="success" %}
Loon：<https://gist.github.com/MrRegret/5bb2df7c332157fd35b514af8e635b10/raw>
{% endhint %}

Loon需要在插件中订阅该地址，接着把这个插件代理指向一个可以翻墙的策略or节点
