========================================================
 LB Down 下载站主题 · 新手使用教程
========================================================
适用：Typecho 1.3.0 / PHP 8.0+
作者：小野
官网：https://lb5.net
========================================================

【目录】
一、安装与启用
二、发布第一篇软件文章（核心！）
三、后台设置详解（按选项卡）
四、首页各区块说明
五、独立页面模板（今日更新/求软件/内容举报）
六、悬浮侧栏
七、通知功能（邮件/飞书/企微/钉钉/PushPlus）
八、常见问题

========================================================
一、安装与启用
========================================================
1. 把 LB_down 文件夹放到：站点目录/usr/themes/ 下
2. 进入 Typecho 后台 → 控制台 → 外观 → 启用「LB Down」
3. 主题自带推荐数据（轮播、榜单等）需要自己发布文章后才会丰满

========================================================
二、发布一篇软件文章（最重要）
========================================================
后台 → 管理 → 写文章（或 内容 → 撰写文章）：

1. 【标题】填软件名，如：Photoshop 2026 for Mac
2. 【正文】填软件介绍（支持图文）
3. 【分类】勾选软件所属分类（如"应用"）
   分类在 后台→管理→分类 里先建好
4. 【自定义字段】是灵魂，往下拉填写：
   ----------------------------------------
   thumb          资源缩略图/封面图 URL（图标或大图地址）
   version        版本号，如 v26.0 中文版
   fileSize       文件大小，如 7.48 GB
   systemReq      系统要求，如 支持 M 系列芯片（选填）
   language       语言：简体中文/英文等
   license        授权：免费/VIP免费/付费/试用/开源
   unzipPassword  解压密码（详情页显示复制按钮）
   downloadLinks  下载链接，每行一条：
                  线路名|链接地址|local或cloud
                  例：百度网盘|https://pan.baidu.com/xxx|cloud
   changelog      更新日志
   recommend      设为"推荐到轮播"→ 出现在首页顶部轮播
   ----------------------------------------
5. 发布

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

========================================================
三、后台设置详解（控制台 → 设置外观）
========================================================

【基础设置】
  logoUrl        站点 Logo 图片地址（留空显示文字标题）
  siteSubtitle   标题旁的小字描述
  关于本站内容   页脚"关于本站"区域，支持 HTML
  页脚文字       页脚底部版权文字
  ICP 备案号     填了显示在页脚

【显示设置】
  pageSize       列表每页数量（默认 20）
  sidebarNum     侧边栏热门/最新显示数量
  推荐轮播开关    首页顶部大轮播
  推荐轮播数量    轮播显示几条
  推荐排除分类    这些分类的文章不进轮播
  筛选栏开关      首页筛选栏（分类/授权/语言/排序）
  分类页筛选栏展示 填分类ID，只有这些分类页显示筛选栏（留空=全部显示）
  列表布局样式    默认卡片模式（网格+3D效果）
  最新更新分类展示 填分类ID（逗号分隔），首页"最新更新"的分类标签
  最新更新每排卡片数 默认 4
  最新更新展示排数   默认 3（4×3=12张，超出点"更多"）
  下载榜单分类    填分类ID，首页"下载榜单"按下载量排行
  文章卡片分类    填分类ID，这些分类用"大配图+标题+日期"的文章卡
  列表翻页方式    传统分页符 / 滚动自动加载（二选一）

【功能开关】
  下载统计       记录每个资源的下载次数（榜单/最热排序靠它）
  评分功能       详情页五星评分

【邮件通知】详见第七部分

【其他设置】
  统计代码       百度统计/Google Analytics 等
  悬浮侧栏       右侧圆形按钮条（QQ/微信/链接/返回顶部）
    - QQ 客服号       填QQ号，点击打开临时会话
    - QQ 二维码图片   悬停显示二维码
    - 微信二维码图片  有图才显示微信按钮
    - 今日更新/VIP/求软件/举报链接 填页面地址显示对应按钮

========================================================
四、首页各区块说明
========================================================
从上到下：

1. 推荐轮播（macz 风格双栏）
   左侧大图+信息+下载按钮，右侧缩略图列表（进度条自动切换）
   数据来源：文章自定义字段 recommend=推荐

2. 筛选栏（可选，filterEnable 控制）
   按分类/授权/语言/排序筛选首页列表

3. 最新更新 + 分类标签
   点分类标签切换下方卡片；底部"更多资源"跳到当前分类页

4. 资源卡片（4列×3行=12张，可配置）
   悬停有 3D 倾斜 + 糖果色渐变效果

5. 下载榜单（可选，downloadRankCats 控制）
   按下载量降序，7列×2行小卡片（图标+名字）

6. 更多按钮 → 跳当前分类完整列表

========================================================
五、独立页面模板
========================================================
后台 → 管理 → 独立页面 → 新建页面 → 右侧选模板：

1. 今日更新（newest.php）
   自动列出最近 40 篇文章，用于悬浮按钮"今日更新"

2. 求软件（request.php）
   访客填"软件名称+描述+联系方式"，提交后发通知（邮件/飞书等）

3. 内容举报（report.php）
   访客填"链接+原因"，提交后发通知

建好后，把页面链接填到：设置外观→其他→悬浮按钮链接

========================================================
六、悬浮侧栏
========================================================
设置外观→其他→悬浮侧栏=开启，然后：
- QQ：填QQ号（点击聊天）和/或二维码图（悬停显示）
- 微信：填二维码图
- 今日更新/VIP/求件/举报：填对应页面链接
- 返回顶部：自动显示

========================================================
七、通知功能（邮件/飞书/企微/钉钉/PushPlus）
========================================================
设置外观 → 邮件通知 选项卡，所有渠道可同时开启：

【邮件】
  SMTP服务器  smtp.qq.com / smtp.163.com
  端口        465(SSL) / 587(TLS)
  账号        发信邮箱
  密码/授权码  QQ/163 用授权码（不是登录密码！）
  管理员邮箱   通知收件人

【飞书】群→设置→群机器人→自定义机器人→复制Webhook
【企业微信】群→群机器人→添加→复制Webhook
【钉钉】群→智能群助手→自定义→复制Webhook
   （建议安全设置选"自定义关键词"）
【PushPlus】pushplus.plus 登录→一对一推送→复制Token

填完点底部「测试发送」按钮验证（每个渠道一个按钮）。

求软件/举报提交后，开启的渠道都会收到通知。

详细获取步骤见同目录《通知配置教程.txt》

========================================================
八、常见问题
========================================================

Q1：首页卡片/轮播不显示？
  A：文章要设置"recommend=推荐"才会进轮播；
     最新更新要配置"最新更新分类展示"。

Q2：下载按钮不显示？
  A：文章没填 downloadLinks 字段。

Q3：详情页没有下载统计/评分？
  A：功能开关里开启"下载统计/评分功能"。

Q4：分类页没有筛选栏？
  A："分类页筛选栏展示"填了分类ID，只有这些分类显示；
     留空则所有分类页都显示。

Q5：卡片悬停渐变闪烁？
  A：已修复（3D效果在内层，hover判定在外层），
     正常不会闪烁。

Q6：文章分类显示的是软件卡而不是大图卡？
  A：在"文章卡片分类"里填上该分类ID。

Q7：改了配置没反应？
  A：先点"保存设置"，然后浏览器强制刷新（Ctrl+F5）。

Q8：悬浮侧栏/轮播等区域怎么隐藏？
  A：对应开关关掉即可（轮播=推荐轮播开关，
     悬浮侧栏=其他→悬浮侧栏）。

Q9：页脚热门分类/快速链接不显示？
  A：确认有分类/独立页面；版本 1.0.70 后已修复
     组件单例导致的空列表问题。

Q10：如何改每排卡片数？
  A：显示设置→最新更新每排卡片数/展示排数。

========================================================
 END · 祝你建站顺利
 遇到问题先看这里，再不行看《通知配置教程.txt》
========================================================
