LabTheme · 使用文档

① 安装主题

• 付款确认后，到「会员中心 → 主题授权」点击下载，得到 starisle-theme.zip。
• 登录你的 WordPress 后台 → 外观 → 主题 → 安装主题 → 上传，选择下载的 zip。
• 点击启用即可，包内已含全部必要配置，无需额外设置。
• 固定链接如果不是「朴素」，建议到 设置 → 固定链接 保存一次以刷新伪静态规则。
• 想要快速看到完整效果：设置 → QUQ 演示数据 → 「导入演示内容」，一键创建示例文章、视频、作品与商品（标题带【演示】前缀，可整批删除）。

② 启用 AI 能力

• 后台 → 设置 → AI 摘要，填入 DeepSeek 或通义千问的 API Key（OpenAI 兼容接口）。
• 保存后新发布/更新的文章会自动生成摘要、要点与标签；老文章可在同一页批量补生成。
• AI 问答浮窗、内容质检、语义相关推荐共用这个 Key，按调用量在你的账号计费。
• 视频转写（可选）：另填 SiliconFlow 的 Key 即可启用语音转文字。

③ 外观与内容

• 菜单：外观 → 菜单，主题会在首次启用时自动创建主导航（首页/文章/视频/作品集/会员中心）。
• 配色方案：外观 → 自定义 → 配色方案，内置深空极光 / 暮色霞光 / 星夜紫罗兰三套整站配色一键切换；「品牌强调色」可单独覆盖。
• 作品集：后台 → 作品集 → 新建，填封面图与 EXIF/项目信息，发布后出现在 /works/ 瀑布流。
• 视频：后台 → 视频频道 → 新建，支持直链与 HLS，可设公开/会员/单独购买三级权限。
• 会员与积分：无需配置，注册登录、Pro 订阅、签到/邀请积分开箱即用。

④ 更新主题

• 新版本发布后，你的站点每 12 小时自动检查一次；后台「主题」页会出现更新提示。
• 点击「更新」即可在线升级，无需重新下载安装包。
• 也可以到「外观 → 主题授权」点「立即检查」手动触发。
• 每次更新的内容见更新日志：/theme/changelog/。

⑤ 增长工具：网盘 · 任务 · 统计 · 邮件

• 会员网盘：注册用户在「会员中心 → 文件网盘」管理私有文件，支持拖拽上传、在线预览、外链分享（可设提取码与有效期）。
• 大文件上传：超过单文件上限的文件自动分片上传（最大 2GB），无需调整服务器上传限制。
• 每日任务：签到、阅读、评论、分享四类任务自动发积分，可在会员中心「我的积分」页查看面板。
• 站点统计：后台 → 站点统计，查看 PV 走势、来源与销售页转化漏斗（数据仅存本站，保留 90 天）。
• 后台总览：后台 → QUQ 概览，收入、流量、销售漏斗、邮件状态、网盘用量与系统健康一屏看全。
• 网盘周报：每周自动巡检临时分片与回收站，并把各用户配额使用汇总发到站长邮箱（使用率超 80% 会高亮提醒）。
• SEO 基础包开箱即用：自动输出文章结构化数据、面包屑与 meta 描述，站点地图在 /wp-sitemap.xml；如安装 SEO 插件会自动让位。
• 邮件送达：后台 → 设置 → QUQ 邮件，填入 SMTP 服务器（推荐 QQ/163 授权码或阿里云邮件推送）并点「发送测试邮件」验证；发送错误会显示在同一页面。
• 支付宝当面付：设置 → 支付宝当面付，填入 AppID、应用私钥与支付宝公钥即可收款；订单页会出现扫码付款二维码，回调自动确认。需在支付宝开放平台开通「当面付」并确保应用公钥与后台一致。
• 图片上传可选自动压缩：超过 300KB 的图片自动压到最长边 1920px，网盘页可开关。

⑥ 随手记社区（/moments/）

• 随手记是站内的微博式短内容时间线：登录用户可发布文字（500 字内）与最多 9 张图片，游客可浏览不可发布。
• 可见范围：发布时可选「所有人」或「仅自己」，私密内容只有你本人与管理员可见，信息流中带 🔒 标识。
• 互动：点亮（点赞）、评论、复制单条链接、分享卡片（一键生成带二维码的图片，可保存转发）；自己的评论可随时删除。
• 奖励：发布随手记 +3 星光，每天前 5 条有效；头像/昵称可点击进入 TA 的个人主页（/moment-author/用户名/）。
• 话题与提及：正文里写 #话题# 自动归类（侧栏与侧边栏「热门话题」可点击筛选），@昵称 会给对方发送站内信 + 邮件通知。
• 通知：别人提及、评论或点亮你的随手记时，你会收到站内信和邮件；可在会员中心关闭邮件通知偏好。
• 浏览方式：最新 / 热门 / 关注三个页签（关注页只看已关注星友的动态）；顶部搜索框支持关键词实时过滤，10 分钟内可编辑自己发布的内容。
• 图片处理：前台上传的图片自动压缩到最长边 1600px 并叠加「QUQ Lab」水印，GIF 动图不处理。
• 每周一上午 9 点，近 90 天活跃用户会收到「本周热门随手记」邮件摘要（Top 5，按点亮与评论数排名）。

⑦ 随手记内容管理（管理员）

• 敏感词过滤：后台 → 随手记 → 敏感词，一行一个词，命中后发布会被拦截（同时作用于随手记与评论）。
• 举报处理：后台 → 随手记 → 举报管理，集中查看被举报内容、举报次数与举报人，可「忽略举报」或「删除内容」；第 1/3/10 次举报会邮件通知站长。
• 评论审核：游客不可评论随手记；登录用户的评论直接显示，作者删除自己的评论即时生效。

⑧ 商城与工单（管理员）

• 商品发布：后台 → 商城 → 新建商品，除价格与封面外可填预览图、目录、试读内容、售后说明与销量基数；商城页自动生成销量主推位、三步购买流程与常见问题区。
• 发货承诺：收银台自动展示「12 小时内发货」承诺卡；每日上午 9 点未发货订单会汇总成邮件提醒站长，不会漏单。
• 工单处理：后台 → 工单反馈，对话按微信气泡时间线展示（你的回复在右侧绿色气泡）；回复保存后用户立即收到站内信 + 邮件通知。
• 工单状态：待处理 / 已回复 / 已关闭三种状态可切换；用户在已关闭工单里再发消息会自动重开；待处理工单数量显示在管理条徽标上。
• 工单规则：用户未关闭工单上限 5 个、提交间隔 60 秒、每分钟最多发送 10 条；图片附件单条最多 3 张（单张 5MB 内，仅限本站上传目录）。
• 催办机制：每日 9 点检查「待处理且用户等待超 12 小时」的工单，汇总邮件催办；确保 设置 → 常规 的管理员邮箱是真实地址。
• 常见问题：新会话表单上方的 5 条 FAQ 在 inc/feedback.php 的 starisle_ticket_faq() 中维护，可按需增删。

⑨ 常见问题排查

• 更新提示没出现：已启用主题的站点每 12 小时自动检查一次，也可到「外观 → 主题授权」点「立即检查」。
• AI 摘要没生成：检查 API Key 余额；后台文章编辑页有生成状态与「重新生成」按钮。
• 伪静态 404：设置 → 固定链接 重新保存一次；确认服务器开启了 rewrite。
• 邮件发不出去/进垃圾箱：到 设置 → QUQ 邮件 检查 SMTP 配置，发件账号需与服务商要求一致；「最近一次发送错误」会显示具体原因。
• 系统邮件样式：自动跟随所选配色方案（页头底色与强调色联动），在自定义器里切换配色后新邮件即时生效。
• 网盘上传失败：检查磁盘配额（免费 200MB，Pro 2GB，可积分扩容）；文件类型需在允许范围内（php/html/脚本类始终拒绝）。
• 分享链接打不开：确认链接未撤销、未过有效期；同一 IP 输错提取码超过 30 次/小时会被暂时限制。
• 收不到随手记通知：站内信在会员中心铃铛里；邮件需确认会员中心的通知偏好未关闭，且站点 SMTP 配置正常。
• 随手记打不开/404：设置 → 固定链接 重新保存一次刷新伪静态；确认「随手记」页面未被删除（后台 → 页面）。
• 授权相关问题（域名变更、站点迁移、重装）：在会员中心「主题授权」页操作或联系站长，页面内有逐步指引。