Monova 主题介绍与使用手册

官网：https://monova.dreamstory.cn/
演示站1：https://zland.top
演示站2：https://pokedream.cn

适用版本：Monova 1.28.x / Monova Core 1.28.x / MonovaVideo 0.13.x

Monova 是一套面向内容站、资源站和社区型站点的 Typecho 主题。主题负责页面展示、响应式布局和外观配置，Monova Core 负责用户、投稿、社区、动态、资源下载、会员、商城、支付和后台管理等业务能力，MonovaVideo 提供视频采集、播放、弹幕和视频会员权限。

这份文档面向站长和编辑，不需要阅读 PHP 代码即可完成安装、配置和日常运营。

目录

1. 功能概览
2. 安装前准备
3. 安装与首次配置
4. 主题外观设置
5. Monova Core 功能中心
6. 首页与模块 DIY
7. 视频中心与采集
8. 写作、文章和资源下载
9. 用户、投稿和创作中心
10. 社区与动态广场
11. 会员、积分、商城和支付
12. 搜索、SEO、性能和 PWA
13. 备份、升级和回滚
14. 安全与权限说明
15. 常见问题

功能概览

• 响应式首页、文章列表、文章详情、分类、标签、作者和归档页面。
• 站点品牌：常规 Logo、深色背景 Logo、Favicon、默认封面、默认头像和侧栏横幅。
• 首页多功能导航横幅，支持图片或视频背景、站内搜索、热门关键词和快捷入口。
• 可视化模块 DIY：首页、侧栏和用户中心分别编辑，支持草稿、预览、方案、发布历史和回滚。
• 文章目录、置顶、封面、角标、相关推荐、评论、点赞、收藏、分享和版权组件。
• Markdown 编辑器、安全 HTML 白名单、回复可见短代码、文章资源下载和二维码交付。
• 注册登录、邮箱验证码、密码安全、用户资料、头像、关注、通知、私信和用户中心。
• 前台投稿、草稿、审核、驳回、撤回、版本记录、个人图片库和创作者数据。
• 社区论坛、板块权限、主题、回复、Markdown、附件、提及、举报、版主和积分奖励。
• 动态广场：用户发布和删除自己的动态，管理员统一审核和管理。
• 视频中心：MacCMS API 采集、分类绑定、定时任务、多线路播放、剧集、弹幕、轮播和 VIP 视频权限。
• VIP 会员、余额、积分、积分商城、商品、SKU、优惠券、订单、退款、物流、评价和提现。
• 搜索增强、推荐、SEO、Robots、Sitemap、媒体优化、缓存、PWA 和离线兜底页。

安装前准备

完整业务功能需要：

• Typecho 1.3 或兼容版本。
• PHP 7.3 或更高版本，建议 PHP 8.1/8.2。
• MySQL 5.7+ 或 MariaDB 10.3+。
• PDO MySQL、GD、OpenSSL、Fileinfo、Mbstring 和 DOM 扩展。
• PHP 开启文件上传；主题和插件目录需要可读，涉及上传或设置备份时需要相应目录可写。

当前 Monova Core 不支持 SQLite 业务表迁移。纯主题页面可以在 SQLite 的 Typecho 上运行，但用户、投稿、商城、会员、社区等 Core 功能需要 MySQL 或 MariaDB。

安装与首次配置

上传文件

发布包分为四种：

• monova-theme-版本.zip：主题包，解压为 /usr/themes/monova/。
• monova-core-版本.zip：核心插件包，解压为 /usr/plugins/MonovaCore/。
• monova-video-版本.zip：视频采集插件包，解压为 /usr/plugins/MacVideo/。
• monova-suite-版本.zip：主题、Core 和视频插件整合包。

不要多套一层目录，例如不要出现 /usr/themes/monova/monova/。上传前后建议按照 SHA256SUMS.txt 校验压缩包。

启用顺序

1. 登录 Typecho 后台，进入“插件”，启用 Monova Core。
2. 首次启用会创建 Core 业务表，并补齐缺失的功能页面；不会覆盖同 slug 或同模板的已有页面。
3. 进入“外观”，启用 Monova 主题。
4. 如需视频中心，将 MacVideo 放入 /usr/plugins/MacVideo/，在插件列表启用 MonovaVideo；插件会安装视频表并自动创建“视频中心”页面。
5. 打开主题设置，填写站点品牌、功能页面地址和首页内容。
6. 打开 Monova Core -> 工具与维护，确认数据库、PHP 扩展和目录权限正常。
7. 打开 Monova Core -> 主题与授权，按授权中心提供的授权码完成激活。

Core 自动创建的页面包括：

如果某个页面没有显示，先确认页面状态为“公开”、模板选择正确，并检查主题设置中的页面地址是否指向该页面。

主题外观设置

主题设置位于 Typecho 后台的“外观 -> 设置”，页面会按分类显示。

站点品牌

• 常规 Logo：浅色背景使用。
• 反白 Logo：深色模式或图片横幅上使用。
• 站点图标：浏览器标签页、登录界面、用户中心、Apple Touch Icon 和 PWA 使用。

支持 https://、http:// 和站内绝对路径。建议 Logo 使用透明 PNG/WebP，图标使用 512x512 方形图片。留空时使用主题内置默认素材。

基础外观与首页

• 主题色：填写十六进制颜色，例如 #5865f2。
• 默认配色：跟随系统、浅色或深色。
• 默认文章封面：文章没有封面且正文没有图片时使用。
• 首页主标题、副标题、背景图和首页公告。
• 建站日期和页脚文字。

弹窗公告

可设置开关、标题、正文、图片、按钮、显示范围、显示频率和延迟时间。正文使用纯文本，可换行；如果没有正文，即使打开开关也不会弹窗。公告频率按公告内容保存，修改公告后会重新计算显示状态。

侧栏站点卡

可单独设置侧栏头像、顶部背景图片和“订阅本站”按钮。建议背景图使用宽图，推荐尺寸约 960x320；头像使用方形图片。留空时使用主题内置默认图片。

功能页面与链接

页面地址可以填写完整 URL，也可以留空让主题按页面 slug 自动查找。建议先发布功能页面，再回到主题设置确认地址。友情链接每行一条，格式为：

名称|网址|描述|头像网址

描述和头像可以省略，例如：

Monova|https://example.com|主题官方网站|

高级设置

• 前台源码查看限制：可拦截常见右键、F12 和查看源代码快捷键，只能减少普通复制，不能替代服务器安全。
• 自定义 CSS：只填写 CSS 规则。
• 自定义 Head / JavaScript：仅建议填写可信广告、验证或统计代码。

自定义代码会直接影响前台页面。修改前建议保存设置备份，出现白屏时优先清空最近添加的代码。

Monova Core 功能中心

Core 后台入口为“插件 -> Monova Core”，主要分组如下：

• 总览：业务统计、版本、数据库和功能域状态。
• 用户与成长：作者认证、等级、签到、任务、积分和勋章。
• 商业与交易：余额、VIP、商品、优惠券、订单、提现、退款、评价和物流。
• 内容与社区：消息、私信、投稿、社区、动态、附件和举报。
• 外观与 DIY：模块、列表、搜索、文章详情和全局组件。
• 站点与增长：推荐、SEO、性能、媒体和 PWA。
• 通知与接入：支付回调和邮件通知。
• 运维与安全：健康检查、清理、访问策略、备份与恢复。
• Monova 服务：主题授权、版本文档和兼容性诊断。

保存设置后，如果页面提示成功但前台未变化，请先清理页面缓存、反向代理缓存和 Service Worker 缓存，再使用无痕窗口检查。

首页与模块 DIY

进入 Monova Core -> 外观与 DIY -> 模块 DIY：

1. 选择首页、侧栏或用户中心工作区。
2. 从模块库添加模块，拖动调整顺序。
3. 在模块设置中配置内容来源、数量、排序、样式、设备显隐和排除分类。
4. 保存草稿并打开预览。
5. 确认无误后发布；发布会保留历史版本，可在历史列表回滚。

常用首页模块包括最新文章、推荐文章、文章轮播、横向文章、分类目录、热门搜索、资源、商品、积分商城、社区主题、公告、导航和自定义文本等。

内容来源和文章数量

模块的“内容来源”决定取数范围，“显示数量”决定一次展示多少篇。两者不是同一个设置。指定分类可以填写分类名称、别名或 ID；排除分类支持多个值，用逗号分隔，并会包含对应子分类。

关闭“启用全站内容侧栏”后，文章流会自动使用更紧凑的四栏布局，文章和独立页面使用全宽结构；论坛和用户中心的功能导航不受影响。手机端文章卡片统一采用两栏布局。

顶部导航和移动端 Dock

全局组件中可以设置：

• 顶部栏启用状态、固定方式、自动分类、自动页面、搜索、深浅切换和用户入口。
• 自定义导航，支持顶级项目和二级下拉菜单。
• 页脚介绍、版权文字和友情链接。
• 手机端底部菜单，最多五项。
• 返回顶部、主题切换和悬浮快捷按钮。
• 广告位的标题、图片、链接、说明和样式。

广告位只接受文本、图片和安全链接，不执行广告 HTML 或脚本。

视频中心与采集

安装并启用 MonovaVideo 后，后台会出现 MonovaVideo -> 视频管理、轮播管理、弹幕管理 和 会员权限。视频插件依赖 Monova Core 的数据库和 VIP 服务，建议先启用 Core，再启用视频插件。

配置采集源

在“视频管理”中新增 MacCMS JSON API 采集源，填写名称、接口地址和密钥（如采集站要求）。保存后进入“分类绑定”，先同步远端分类，再把需要的远端分类绑定到本站视频分类；未绑定的分类不会被采集。每个采集源可选择补采详情播放源，并执行“采集当天”“采集本周”或“采集所有”。

采集任务支持手动逐页运行、查看持久化日志和继续未完成任务。后台为每个启用的采集源提供定时任务 URL，可交给服务器计划任务定时请求；URL 包含私钥，不要公开。采集完成后，前台“视频中心”只展示已发布视频，支持类型、年代和关键词筛选。

播放、弹幕与会员

视频可以配置多条播放线路和剧集。前台支持 HLS/M3U8、MP4 等直接地址，并提供线路切换、上一集/下一集、自动连播、倍速和观看进度；跨域播放需要远端服务器允许本站域名。弹幕按视频和剧集保存，管理员可以审核、隐藏、删除和处理举报。

在“会员权限”中可以设置全站默认观看规则，也可以为指定视频设置最低 VIP 等级。无权限用户仍可浏览简介和剧集目录，但不会获得播放器或真实播放地址。视频源健康检测可检查清单、密钥、首个分片及 CORS 响应。

写作、文章和资源下载

文章编辑字段

在 Typecho 新建或编辑文章时，主题会提供以下字段：

• 文章封面：留空时提取正文第一张图片，再没有图片才使用默认封面。
• 文章角标：例如“推荐”“教程”。
• 首页置顶：只影响首页文章流，不改变分类、标签和搜索排序。
• 内容权限：公开、登录后可见、VIP 可见或余额购买。
• VIP 最低等级、付费价格和受保护内容。
• 页面封面、文章详情布局、标题布局、目录布局和文章底部组件。
• 相关文章来源：同分类、同标签或最新文章。

Markdown 和 HTML

文章、投稿和社区编辑器支持 Markdown。编辑器提供常用格式、代码块、链接、图片和回复可见按钮。

受信任的 HTML 也可以使用，但输出会经过白名单过滤。常用段落、标题、列表、表格、链接、图片、引用、代码、折叠详情等标签可以保留；script、iframe、表单、svg、canvas、事件属性和危险 URL 会被移除。普通投稿者不能通过 HTML 绕过过滤。

回复可见内容

在文章编辑器中点击“回复可见”即可插入，也可以手写：

[hide type="reply"]
这里填写登录用户回复后才能看到的内容。
[/hide]

游客会看到提示并跳转到评论区；评论提交并达到显示条件后，用户可以看到隐藏内容。请不要把密码、支付密钥或真正的私密文件直接写在文章正文中。

文章资源下载

在文章字段中选择“资源交付方式”：

• 下载链接：每行一条，格式为 名称|地址|提取码，最多 8 条。
• 二维码领取：每行填写一张二维码图片，最多 3 张。

链接和二维码是二选一。支持 https://、http:// 和 / 开头的站内路径。资源配置后，文章会进入资源中心，资源下载组件是否显示由 Monova Core -> 文章详情 控制。

后台 Monova Core -> 文章详情 -> 资源下载安全与审计 可以设置受控下载、同站来源校验、签名有效期、每分钟放行上限和日志保留时间。受控下载会使用短时签名、权限校验和频率限制，不会在后台列表直接展示真实资源目标。

可选的私有资源目录使用 private://文件名 格式。该目录必须在 PHP open_basedir 允许范围内；不使用私有资源时无需创建目录，也无需修改服务器配置。

用户、投稿和创作中心

注册和账户

注册、登录、验证码、密码长度、登录失败次数、锁定时间和邀请码在 Monova Core -> 基础与功能域 -> 登录与账户安全 配置。用户可在用户中心修改昵称、简介、头像和密码，头像上传后会保存为站点媒体并在未登录页面正常显示。

投稿设置

在 Monova Core -> 基础与功能域 -> 投稿与创作 设置：

• 投稿总开关和最低等级。
• 每日投稿数量上限和提交间隔。
• 允许投稿的分类。
• 达到指定等级后是否自动发布。
• 单图大小、单篇图片数量和允许的图片类型。
• 版本保留、自动保存和预约发布天数。

创作中心支持保存草稿、继续编辑、上传封面、个人图片库、Markdown 预览、提交审核、查看审核意见、撤回和删除草稿。待审核或已发布文章按照站点审核策略处理；需要修改已提交内容时，应先按前台提示撤回或创建新版本。

管理员在 Monova Core -> 投稿审核 审阅正文、封面、分类、标签和资源设置，可通过、驳回或填写审核意见。审核通过后文章会进入正常文章流，驳回内容会返回作者可编辑状态。

创作者广场和数据

创作者广场展示公开作者档案、认证状态、文章、阅读、下载和粉丝数据。作者认证规则在“作者与认证”中设置，认证申请可以由管理员批准、驳回或撤销。

社区与动态广场

社区论坛

在 Monova Core -> 社区论坛 可以创建板块并设置：

• 板块名称、别名、介绍、图标、封面和排序。
• 开放、只读或隐藏状态。
• 发帖和回复最低等级。
• VIP 专属及最低 VIP 等级。
• 板主 UID。
• 主题和回复的立即发布或审核模式。
• 附件大小、数量和文件类型。

用户可以发布主题、回复、点赞、收藏、提及用户、上传附件和举报内容。管理员或板主可以审核、置顶、加精、锁定、移动、隐藏和处理举报。附件下载不会暴露服务器物理路径。

动态广场

动态广场页面默认 slug 为 moments。登录用户可以发布文字动态、删除自己的动态，并进行点赞、评论和互动；管理员可以在 Monova Core -> 动态广场 审核、隐藏或删除违规动态。动态功能的开关、长度和审核规则以后台当前版本显示为准。

消息和私信

消息中心支持提及、回复、互动、订单、系统和私信分类。管理员可以在“消息与私信”中设置总开关、最低等级和发送间隔。用户不能给自己发送私信；屏蔽关系、删除视图和已读状态按用户分别保存。

会员、积分、商城和支付

VIP 会员

在 Monova Core -> VIP 会员 配置会员套餐的名称、等级、价格、时长、权益、推荐套餐和页面展示。支持限时会员和永久会员；续费会从当前到期时间顺延，永久会员不会被限时套餐覆盖。

文章选择“VIP 可见”后，公开正文可以作为试看内容，受保护内容只对达到等级的用户显示。游客和普通用户只能看到权限提示。

积分和成长

在“用户成长”中设置签到、任务、互动、创作和每日次数。等级经验、等级名称、积分奖励和人工调整都会写入审计流水。积分商城可以发布会员、数字资源或其他权益商品，并设置库存、兑换限制和发放记录。

商城和订单

商城支持虚拟商品、实物商品、多个 SKU、库存、购物车、优惠券、收货地址、发货、物流、评价、售后和退款。已有订单或评价的商品建议下架，不要强制删除，以免破坏交易历史。

支付

在 Monova Core -> 支付与回调 配置支付服务商、回调地址、签名算法和可用渠道。支付宝、微信或聚合接口的商户参数必须与服务商后台一致。上线前应使用测试金额验证：创建订单、支付回调、重复回调、订单查询、退款和余额变更。

支付密钥不会写入设置备份，也不应写入文章、主题自定义代码或日志。修改支付配置后请保留一份安全的服务器端备份。

作者分成和提现

在“提现结算”中设置最低提现金额、单次上限、手续费、处理天数和作者分成。管理员审核提现后再进行实际打款；打款凭证和审核备注应保留，方便对账。

搜索、SEO、性能和 PWA

搜索与发现

搜索增强可以提供实时建议、搜索历史、热门关键词、文章/作者/资源/社区综合结果、筛选、排序和无结果推荐。热门词可选择手动设置、热门文章标题关键词或混合来源，不会把分类目录名称当作文章标题。

SEO

SEO 设置支持标题模板、描述、分享图、规范链接、文章类型、组织信息、面包屑、Robots、Sitemap 和搜索页 noindex。修改站点域名、Logo 或分享图后，建议使用搜索引擎的 URL 检查工具重新抓取。

性能和媒体

媒体设置支持响应式图片、WebP/AVIF 协商、懒加载、资源版本、预取和缓存策略。开启 CDN 时，必须确保图片、CSS、JS、PWA Manifest 和 Service Worker 使用同一站点协议和正确缓存头。

PWA

PWA 页面可以配置应用名称、短名称、主题色、安装提示、静态资源缓存、公开页面缓存、离线兜底页和更新提示。修改图标或缓存策略后，浏览器可能仍使用旧 Service Worker，需在浏览器应用设置中更新或清除站点数据。

备份、升级和回滚

设置备份

进入 Monova Core -> 备份与导入 下载设置 JSON。设置备份包含主题外观、模块布局、文章布局、搜索、SEO、性能、媒体、PWA、会员页面和运维策略等；不包含密码、登录令牌、支付密钥、订单和用户业务数据。

因此，正式升级前还必须：

1. 使用数据库工具完整备份 Typecho 数据库。
2. 备份 /usr/uploads/、私有资源目录和站点自定义配置。
3. 核对发布包 SHA-256。
4. 先覆盖 MonovaCore，再覆盖 monova 主题。
5. 登录后台访问一次 Core，让数据库迁移器完成幂等升级。
6. 清理页面缓存、CDN 缓存和 Service Worker。

当前版本的在线一键更新尚未启用，升级仍采用经过校验的人工上传方式。不要直接把开发目录覆盖正式站点，也不要删除 zibtype_* 业务表。回滚时应同时恢复文件和同一时间点的数据库备份，避免版本不匹配。

安全与权限说明

• 授权状态、域名、安装实例和有效期由授权中心签发 Token 校验；授权中心不会接收文章、用户或订单内容。
• 前台授权失效时，站点会阻止公开访问，并引导管理员进入授权设置。
• HTML、Markdown、评论、投稿和社区内容都会经过输出过滤；不要把过滤器当成存储密钥的方案。
• 资源下载可以使用短时签名、来源校验、频率限制和审计日志。
• 普通用户只能修改自己的资料、草稿、动态和允许编辑的内容；管理员操作应保留审核备注。
• “禁止查看源码”只能降低普通复制行为，不能防止开发者工具、服务器文件读取或截图。
• 不要在公开文章、主题自定义 Head、广告代码、截图或工单中粘贴数据库密码、支付密钥和授权中心私钥。

常见问题

前台出现授权验证页面

进入 Monova Core -> 主题与授权 检查授权码、绑定域名、Token 有效期和完整性状态。若刚更换域名、服务器或目录，先确认授权中心允许重新绑定，再重新激活。

功能页面是空白或 404

确认页面已公开、模板名称正确、主题为 Monova、Core 已启用，并检查主题设置中的页面地址。固定链接规则变化后，重新保存 Typecho 的固定链接设置。

Core 显示 Server Error

先查看 PHP 错误日志，再进入“工具与维护”查看扩展、数据库表和目录权限。常见原因是 PHP 版本过低、PDO MySQL/DOM/Fileinfo 缺失、数据库用户没有建表权限或旧缓存仍在执行旧文件。

文章封面没有显示

优先检查文章封面 URL 是否可访问。留空时主题会依次使用正文第一张图片和后台“默认文章封面”；远程图片被防盗链或 HTTPS 混合内容拦截时，请使用站内图片路径。

资源二维码或下载地址保存后消失

二维码模式每行一张，最多三张；链接模式每行使用 名称|地址|提取码。请确认字段没有被主题自定义代码隐藏，并在保存草稿后重新打开文章检查。二维码图片必须是 HTTP(S) 或站内绝对路径。

私有资源不可用

检查 PHP open_basedir 是否允许私有资源目录，目录是否存在且 PHP 可读。若不需要私有资源，可以继续使用普通 HTTPS 链接，不影响其他下载功能。

修改设置后前台没有变化

清理 Typecho、Nginx/CDN、浏览器和 Service Worker 缓存；确认点击了“保存”或“发布”。模块 DIY 必须先发布草稿，单纯保存草稿不会影响访客。

更新后原来的设置是否会丢失

正常覆盖主题和 Core 文件不会删除数据库中的主题设置和业务数据。但自定义过主题 PHP/CSS 的文件可能被覆盖，升级前应导出设置并单独保存自定义代码。跨数据库 Schema 版本回滚时必须恢复数据库备份。

旧表名为什么仍然是 zibtype_*

这是历史兼容的数据库表前缀，与当前 Monova 品牌名称无关。除非执行官方迁移脚本，否则不要重命名、删除或清空这些表。

获取帮助时应提供的信息

提交问题时请提供：Monova 和 Core 版本、Typecho/PHP/MySQL 版本、出错页面、浏览器控制台或 PHP 日志中的错误摘要，以及是否使用 CDN、缓存、open_basedir 或自定义代码。请先删除授权码、密码、支付密钥、Cookie 和用户隐私数据。