README.md
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 个独立页面模板：今日更新、求软件、内容举报
- 📱 响应式布局：手机 / 平板 / 桌面全适配
📥 安装
- 将
LB_down文件夹上传到站点usr/themes/目录 - 进入 Typecho 后台 → 控制台 → 外观，启用「LB Down」主题
- 进入 设置外观，按需配置各选项卡
🚀 快速上手：发布第一篇资源文章
后台 → 撰写文章，除了标题和正文，自定义字段是灵魂：
| 字段 | 说明 |
|---|---|
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 主题 · 让下载站搭建更简单