更新记录

3.28.0（2026-09-29） 下载此版本

新增:教务模块面向线下面授与小班教学的经营管理工具 新增:表单收集支持绑定到「加入学习前」 新增:管理端登录增加图形验证码 新增:管理端顶部菜单搜索，输入关键词直接定位功能页 新增:管理端「店铺信息」支持设置网站图标（.ico） 新增:管理端用户订阅支持「调整时效」 新增:页面装修支持「复制页面」 新增:直播观众被管理员拉黑后立即退出直播间，正在观看时无需刷新或重进 新增:管理端直播中控台支持伪直播课程预览，按开播时间对齐播放进度 新增:移动端直播间提供「直播详情」入口 优化:投诉设置支持选择「提交后跳转」，可返回首页或关闭页面 优化:管理端订单列表支持按下单时间、支付时间筛选 优化:管理端课程表单的直播设置独立分区展示 优化:管理端表单标题字数上限由 10 字放宽至 15 字 优化:移动端横屏直播画面上移，不再被底部消息区遮挡 优化:移动端活动详情与报名页时间条支持展示活动结束时间 优化:移动端余额、积分、红包提现记录进入时展示加载占位，减少白屏闪跳 优化:小程序提交体验版时自动携带当前系统版本号 修复:直播消息服务连接异常——首次连接失败后长期停在「正在连接」且无重连入口，PC 端未登录时抛出「已登出」报错 修复:移动端文件上传失败时仍提示上传成功 修复:打开已删除或失效的课程、直播分享链接后反复弹窗无法退出，现直接返回首页 修复:通过分享链接或小程序码进入页面后底部导航不显示、当前菜单不高亮 修复:移动端默认分享信息晚于页面数据返回，将课程、商品标题与主图覆盖成站点名称和站点图标 修复:视频播放器大按钮与加载动画遮挡页面底部操作栏、吸顶导航与弹窗，导致按钮无法点击 修复:课程详情页误提示播放异常并持续转圈，专栏目录长期停留在「加载中」 修复:订单、收藏、学习记录等多个列表页首次进入闪现「暂无数据」、请求失败后页面卡住 修复:管理端已设为隐藏的实物商品仍能在用户端被查看和访问 修复:题库批量导入时不定项选择题只有一个正确答案被判为无效 修复:圈子预售页底部导航与页内「首页」按钮重复展示 提示:本次更新需重新上传微信小程序

3.27.0（2026-09-04） 下载此版本

新增：直播支持连麦互动，讲师可邀请学员连麦（视频连麦 / 语音连麦） 新增：实物商品订单支持批量发货 新增：管理端新增用户标签功能，便于学员分类管理 新增：视频课程支持单独设置拖拽进度条开关 新增：管理员端新版本更新提醒 优化：直播观看体验优化（低延迟、多清晰度、断流自动恢复） 修复：移动端 H5 底部导航安全区显示问题 修复：直播观看偶发黑屏、卡顿、断流问题 提示：本次更新需重新上传小程序

3.25.0（2026-08-24） 下载此版本

新增：圈子插件，支持圈子创建与管理、动态发布、评论互动与问答、成员管理 新增：直播回放自动播放 优化：直播回放播放异常兼容处理

平台兼容性

uni-app(4.0)

凸知（Tuzhi） 是一套完整的知识付费解决方案，支持私有化部署，覆盖课程售卖、直播授课、圈子社区、考试测评、分销营销、实物商品等完整业务场景，提供管理后台、移动端（H5 / 微信小程序）、PC 学员端等多端入口，帮助个人 IP、教培机构与品牌商家搭建自有卖课平台。

凸知移动端 是一款基于 uni-app（Vue 2）+ TDesign 开发的知识付费移动端前端，支持 H5 / 微信小程序 多端编译（不支持 App 打包）。覆盖课程点播、直播、专栏、圈子社区、订单支付（前端交互）、优惠券、余额红包、考试答题等完整学习场景。

系统演示：

一、功能特性

• 终端覆盖：电脑端 / 微信公众号（H5）/ 微信小程序多端学习
• 课程内容：图文 / 视频 / 音频 / 专栏售卖，支持试看试听、课件资料与内容保护
• 互动教学：练习 / 考试测评 / 题库 / 试卷库 / 证书 / 表单 / 圈子社区
• 直播能力：直播授课 / 伪直播 / 回放 / 直播带货 / 送礼物 / 发红包
• 营销增长：分销推广 / 优惠券 / 每日签到 / 积分商城 / 付费会员卡 / 组合商品 / 卡密兑换
• 实物商品：商品管理 / 多规格 SKU / 限购设置 / 售后退换
• 交易支付：购物车 / 订单管理 / 余额支付 / 微信支付 / 支付宝支付
• 用户数据：用户管理 / 订阅记录 / 学习分析 / 交易分析 / 订单管理
• 系统安全：页面 DIY 装修 / 云存储 / 短信与消息推送 / 管理员权限 / 版权保护（跑马灯 / 防录屏）

界面预览：

二、系统架构

凸知是一套完整的知识付费系统，由四个部分组成：

凸知终端技术结构：

整体调用链路：移动端 / PC 学员端 / 管理后台 → 后端接口服务（{code, msg, data} 协议）→ MySQL 数据库。

本仓库仅开源移动端前端源码；如需后端服务或管理后台等其余端的源码，需购买商业授权获取，详见「十一、使用许可」与授权价格。

三、技术栈

四、快速开始

环境要求：Node.js >= 14（建议 16/18）、npm

# ① 安装依赖
npm install

# ② H5 开发（默认不启用 Mock，对接真实后端；如需 Mock 见「Mock 数据」）
npm run dev:h5

浏览器访问 http://localhost:8080 即可看到完整页面效果。

微信小程序编译：

# ③ 小程序开发模式（监听编译，产物在 dist/dev/mp-weixin）
npm run dev:mp-weixin

# ④ 小程序生产构建（内置 TDesign 适配补丁，产物在 dist/build/mp-weixin）
npm run build:mp-weixin

用微信开发者工具「导入项目」选择对应产物目录（开发选 dist/dev/mp-weixin，生产选 dist/build/mp-weixin），并在 src/manifest.json 中替换为自己的 appid。

对接真实后端：

1. 修改 src/siteinfo.js 中的 siteroot 为你的后端地址；
2. 在 src/common/request/api_list.js 中核对接口地址与 {code, msg, data} 协议；
3. 微信小程序构建需在 src/manifest.json 中替换为自己的 appid。

五、构建

小程序构建内置 TDesign 适配补丁（scripts/），构建成功后产物在 dist/build/ 下。

⚠️ 注意：当前版本不支持 App 打包，仅支持 H5 与微信小程序两个平台。

六、Mock 数据

• H5 开发模式（NODE_ENV=development）默认关闭，全部走真实后端接口；
• 开启方式：将 src/static/config.js 的 enableMock 改为 true（显式设置优先级最高），或通过 uni.setStorageSync('enableMock', true) / 环境变量 MOCK_ENABLE 切换；
• 覆盖 200+ 接口，fixture 位于 src/mock/data/，按 module/action 路由镜像；
• 未覆盖的接口自动透传真实网络并输出提示；
• Mock 数据由仓库内 mock-crawler 工具采集真实后端响应生成，发布前已做敏感字段脱敏（token/openid/手机号等）。

七、目录结构

src/
├── pages/        页面（index 主包 + public/app/user/order/course 五个分包，约 100+ 页面）
│   ├── index/        首页（主包唯一页面，tabBar 入口）
│   ├── launch/       启动页（加载与参数透传跳转，未在 pages.json 注册）
│   ├── public/       公共分包：登录 / 注册 / 找回密码 / 协议 / 搜索 / 消息 / 结果页等
│   ├── app/          业务功能分包：活动 / 圈子 / 考试 / 优惠券 / 积分 / 签到 / 证书 / 分销 / 直播带货等
│   ├── user/         用户分包：个人中心 / 资产 / 余额 / 地址 / 收藏 / 学习记录 / 订阅 / 红包等
│   ├── order/        订单分包：订单列表 / 详情 / 提交 / 评价 / 售后 / 物流等
│   ├── course/       课程分包：课程详情 / 分类 / 专栏 / 小组 / 直播等
│   └── template/     页面模板（新建页面的三文件拆分参考，未在 pages.json 注册）
├── components/   组件（tz/ 自研组件库、uview-ui、qiun-data-charts、视频播放器等）
├── common/       公共层
│   ├── request/  接口封装（$api 点分路由、统一鉴权/错误处理）
│   ├── utils/    工具（路由映射、支付、直播、OSS 签名等）
│   ├── order/    订单状态处理
│   └── ***/   微信登录/分享 SDK 封装
├── mock/         Mock 数据（H5 开发模式默认关闭，开启方式见「六、Mock 数据」）
├── static/       静态资源
├── pages.json    页面路由与分包配置
└── manifest.json 应用配置（appid 等）

八、开发约定

• 页面采用 xxx.vue + js.vue + css.css 三文件拆分（<script src="./js.vue"> + @import "./css.css"），逻辑与样式分离；
• 接口调用统一走 this.$api('module.action', data)，登录态、401 跳转、错误提示由拦截器统一处理；
• 业务组件优先复用 components/tz/ 自研组件库；
• 提交信息遵循 Conventional Commits（feat: / fix: / chore:）。

九、相关链接

十、软件安全

安全问题请通过 Issue（需注明"安全"）或邮件私下报告给项目维护团队，请勿在公开渠道描述可利用的漏洞细节。我们将在确认后尽快修复并同步发布。

十一、使用许可

• 本软件遵循 凸知开源协议 V1.0（非商业用途免费，商业用途需购买商业授权），详见 LICENSE；
• 第三方组件许可声明见 THIRD-PARTY-NOTICES.md；