> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# 打赏插件

> 适用版本 1.0.0 ｜ Halo ≥ 2.27.0 ｜ 后台路径：插件 / 打赏插件设置

为个人站长提供独立打赏页面：站长配置自己的微信 / 支付宝收款码，访客扫码后提交打赏记录，站长确认后展示在赞助者墙；可选对接爱发电，订单自动同步入库。

**插件不参与资金流转**：不接入支付网关，不代收、不结算、不抽成。微信 / 支付宝的款项直接进入站长自己的收款账户；爱发电为可选对接，插件只通过开放接口读取订单数据。

## 打赏页

插件注册固定路由 `/reward`，自动套用当前主题的页头与页脚（依赖 Halo 2.26.0+ 的 `layout` 契约）。

![打赏页](/images/reward/reward-page.png)

点击页面按钮后弹出提交表单，不占用页面空间：

![填写打赏信息模态框](/images/reward/reward-modal.png)

- 收款码点击可放大查看
- 模态框支持 `Esc` 或点击遮罩关闭，提交成功后自动关闭
- 桌面端两栏，窄屏自动单栏

## 功能

| 范围 | 能力                                      |
| -- | --------------------------------------- |
| 前台 | 独立页面 `/reward`，支持微信、支付宝与爱发电三种打赏方式       |
| 前台 | 打赏信息表单以模态框呈现；赞助者墙只展示已确认记录               |
| 前台 | 自动套用主题页头页脚；资源完全本地，不加载外部 CDN、字体或统计脚本     |
| 后台 | 配置分基础、收款、记录、爱发电、通知五组                    |
| 后台 | 记录页支持搜索、状态筛选、批量确认 / 拒绝 / 删除、CSV 导出、手动新增 |
| 集成 | Finder API、公开 REST API，主题可引用模态框或自建表单    |
| 安全 | 图形验证码、提交与读取限流；联系方式与交易单号仅后台可见            |

## 使用前提

1. Halo ≥ 2.27.0
2. 站点没有占用 `/reward` 路径的自定义页面（有的话先改掉它的固定链接）
3. 主题提供 `layout` 契约（Halo 2.26.0+ 的页面布局契约；未提供时页面无法套用主题外壳）

## 相关链接

- 插件仓库：[https://github.com/AloneNanNan/halo-plugin-reward](https://github.com/AloneNanNan/halo-plugin-reward)
- 适配效果参考（[楠枝小笺](https://www.nanzhiy.cn/reward)）
- 应用市场：在 Halo 后台搜索「打赏插件」

## 下一步

- [安装与启用](/reward/install.md)
- [配置项](/reward/settings.md)
- [打赏记录与确认](/reward/records.md)
- [爱发电对接](/reward/afdian.md)
- [常见问题](/reward/faq.md)