# LB Down · Typecho 下载站主题

一款专为**软件 / 资源下载站**打造的 Typecho 主题，首页自带 macz 风格推荐轮播、最新更新卡片墙、下载榜单，内置多通道通知系统（邮件 / 飞书 / 企业微信 / 钉钉 / PushPlus），开箱即用。

> 适用版本：Typecho 1.3.0 ｜ PHP 8.0 - 8.3
> 作者：小野 ｜ 官网：<https://lb5.net>

---

## ✨ 主题特性

- 🎠 **macz 风格双栏推荐轮播**：左侧大图 + 信息 + 下载按钮，右侧缩略图列表自动切换
- 🃏 **3D 卡片墙**：资源卡片悬停 3D 倾斜 + 糖果色渐变，网格 / 大配图双布局
- 🏆 **下载榜单**：按下载量排行，7 列小卡片展示
- 🔍 **首页 / 分类页筛选栏**：按分类、授权、语言、排序多维度筛选
- 📜 **双翻页模式**：传统分页符 / 滚动自动加载，二选一
- 📊 **下载统计 + 五星评分**：记录每个资源的下载次数，支持最热排序
- 🌙 **暗黑模式**：浅色 / 深色 / 跟随系统，访客可一键切换
- 🔔 **五通道通知**：SMTP 邮件、飞书、企业微信、钉钉、PushPlus 可同时开启，后台一键测试
- 🧭 **悬浮侧栏**：QQ 临时会话 + 二维码、微信、今日更新 / 求软件 / 举报入口、返回顶部
- 🌐 **IP 属地识别**：内置 ip2region 离线库，评论 / 日志显示归属地
- 🖥️ **浏览器图标识别**：自动匹配访客浏览器图标
- 📄 **3 个独立页面模板**：今日更新、求软件、内容举报
- 📱 **响应式布局**：手机 / 平板 / 桌面全适配

---

## 📥 安装

1. 将 `LB_down` 文件夹上传到站点 `usr/themes/` 目录
2. 进入 Typecho 后台 → **控制台 → 外观**，启用「LB Down」主题
3. 进入 **设置外观**，按需配置各选项卡

---

## 🚀 快速上手：发布第一篇资源文章

后台 → 撰写文章，除了标题和正文，**自定义字段**是灵魂：

| 字段 | 说明 |
|---|---|
| `thumb` | 资源缩略图 / 封面图 URL |
| `version` | 版本号，如 `v26.0 中文版` |
| `fileSize` | 文件大小，如 `7.48 GB` |
| `systemReq` | 系统要求（选填） |
| `language` | 语言，如 `简体中文` |
| `license` | 授权：免费 / VIP免费 / 付费 / 试用 / 开源 |
| `unzipPassword` | 解压密码（详情页显示复制按钮） |
| `downloadLinks` | 下载链接，每行一条：`线路名\|链接地址\|local或cloud` |
| `changelog` | 更新日志 |
| `recommend` | 填 `推荐` 进入首页轮播 |

> 只有填写了 `downloadLinks` 的文章，详情页才会显示下载按钮。

---

## ⚙️ 后台设置（设置外观）

| 选项卡 | 内容 |
|---|---|
| **基础设置** | 站点 Logo、副标题、关于本站、页脚文字、ICP 备案号 |
| **显示设置** | 每页数量、侧栏数量、推荐轮播开关与数量、筛选栏开关、列表布局、最新更新卡片行列数、下载榜单分类、文章卡片分类、翻页方式 |
| **备案信息** | ICP / 公安备案号与链接 |
| **功能开关** | 下载统计、评分功能 |
| **邮件通知** | 邮件 SMTP + 飞书 / 企业微信 / 钉钉 / PushPlus 五通道 |
| **其他设置** | 第三方统计代码、悬浮侧栏（QQ / 微信 / 各入口链接） |

---

## 🔔 通知功能（重点）

所有渠道可**同时开启**，求软件 / 举报提交后多通道推送，每个渠道都带「测试发送」按钮：

- **邮件**：SMTP 465(SSL) / 587(TLS)，QQ / 163 邮箱需用**授权码**（非登录密码）
- **飞书**：群机器人 Webhook
- **企业微信**：群机器人 Webhook
- **钉钉**：群机器人 Webhook（建议安全设置选「自定义关键词」）
- **PushPlus**：微信推送，免费版每天 200 条

详细获取步骤见主题内《通知配置教程.txt》。

---

## 📄 独立页面模板

后台 → 独立页面 → 新建页面，右侧选择模板：

- **今日更新**（`newest.php`）：自动列出最近 40 篇文章
- **求软件**（`request.php`）：访客提交需求，触发通知
- **内容举报**（`report.php`）：访客举报内容，触发通知

建好后把页面链接填入 **设置外观 → 其他 → 悬浮按钮链接**。

---

## ❓ 常见问题

| 问题 | 解答 |
|---|---|
| 首页轮播不显示？ | 文章需设置 `recommend=推荐`，且「推荐轮播」开关开启 |
| 下载按钮不显示？ | 文章未填写 `downloadLinks` 字段 |
| 没有下载统计 / 评分？ | 在「功能开关」里开启 |
| 分类页没筛选栏？ | 「分类页筛选栏展示」填了分类 ID 才显示，留空则全部显示 |
| 显示的是小卡片而非大图卡？ | 把分类 ID 填入「文章卡片分类」 |
| 改配置没反应？ | 点「保存设置」后浏览器强制刷新（Ctrl+F5） |

---

## 📜 开源说明

本项目为开源主题，代码中保留的第三方库版权声明（`phpmailer.php`、`smtp.php`、`lib/ip2region/`）请勿删除。

**反馈与交流**：<https://lb5.net>

---

*LB Down 主题 · 让下载站搭建更简单*