更新记录

1.0.0（2026-03-02） 下载此版本

• 支持章节付费、广告解锁、广告券、SVIP
• 支持阅读进度云端同步
• 支持字体、背景、夜间模式等阅读设置

平台兼容性

uni-app(3.8.7)

叩猫小说阅读器 - 插件使用说明

一款功能完整的小说阅读器组件，支持滑动翻页、章节付费解锁、广告激励、SVIP 等，适用于 uni-app 小说/阅读类小程序。

一、功能特性

• 阅读设置：字体大小、背景色（含夜间模式）
• 章节目录：目录列表、跳章、阅读进度
• 章节付费：付费起点可配置，支持广告解锁、广告券、SVIP
• 激励视频：看广告解锁章节或获得广告券
• 阅读进度：云端保存与恢复

二、快速开始

2.1 引入方式

将插件导入项目后，在阅读页中引入阅读器组件即可使用。

2.2 基本用法

<template>
  <view class="reader-page">
    <koumaonovel-reader
      :book-id="bookId"
      :chapter-id="chapterId"
      :api-base-url="apiBaseUrl"
    />
  </view>
</template>

<script>
export default {
  data() {
    return {
      bookId: 1,
      chapterId: null,
      apiBaseUrl: 'https://your-api.com/api'
    }
  }
}
</script>

三、小程序端界面

3.1 首页

首页展示推荐书籍、流行推荐及书籍列表，支持下拉刷新。

3.2 书籍详情

展示封面、书名、作者、简介，支持加入书架、开始阅读。

3.3 阅读器

阅读器支持滑动翻页、字体与背景调节、目录切换、锁章解锁等。

3.4 章节解锁

锁章可预览若干行，支持观看广告、使用广告券或开通 SVIP 解锁。

3.5 搜索

按书名关键词搜索书籍。

3.6 我的

个人中心包含书架、阅读历史、广告券、SVIP、账单等。

3.7 广告券

广告券列表，支持签到领取、看广告获得，用于解锁付费章节。

3.8 SVIP

开通 SVIP 可免费阅读全部付费章节。

四、管理后台界面

4.1 仪表盘

统计概览，展示用户数、书籍数、订单等数据。

4.2 书籍管理

书籍列表、新增/编辑/删除、一键导入等。

4.3 导入规则

TXT 导入规则配置，支持预设格式与自定义正则。

4.4 一键导入

上传 TXT 文件，选择导入规则，自动解析并创建书籍与章节。

4.5 推荐管理

推荐栏、流行推荐的书籍配置与排序。

4.6 章节管理

章节列表、付费配置、新增/编辑/删除章节。

4.7 功能配置

功能开关（付费、广告、SVIP、广告券等）及付费参数配置。

4.8 平台配置

多平台（如微信小程序）的 appId、appSecret 等配置。

五、配置说明

5.1 后端接口

插件需配合后端 API 使用，主要接口包括：

5.2 功能开关

通过 /config/features 接口可配置：

• paymentEnabled：是否开启章节付费
• svipEnabled：是否开启 SVIP
• adEnabled：是否开启广告
• adCouponEnabled：是否开启广告券

六、注意事项

1. 编码：请确保项目及文档使用 UTF-8 编码，避免乱码。
2. 图片：文档中的截图已上传至图床，若链接失效请联系作者。
3. 平台：支持微信小程序、H5、App 等 uni-app 支持平台。
4. 依赖：需自行配置后端 API 及数据库，插件仅包含前端阅读器与相关页面。

七、更新日志

• 支持章节付费、广告解锁、广告券、SVIP
• 支持阅读进度云端同步
• 支持字体、背景、夜间模式等阅读设置

愿您财源广进，也希望我能得偿所愿。