咨询客服
功能对照：RiPro-V5 参考主题 vs 线上平台（码良软件）
生成日期：2026-09-24
参考对象：C:\Users\Administrator\Desktop\codex开发项目汇总\loveps开发文档\ripro-v5\ripro-v5
对照对象：apps/web（前台 Next.js）+apps/admin（后台）+apps/api（NestJS API）
对照方式：读 RiPro-V5 的inc/options/admin-options.php（3060 行设置）、inc/setup-db.php（建表）、inc/template-ajax.php（25 个用户接口）、inc/template-shop.php、inc/template-tags.php、admin/pages/*、template-parts/**，再逐项在线上平台源码里 grep 验证，不靠印象判断。
一、结论速览
线上平台已经把 RiPro-V5 的主体功能补齐了，用户中心甚至比 RiPro 更全（多了已购软件、我的评论、
我发布的商品、素材管理、在线客服）。所以这份对照表的重点不是"缺一大堆"，而是两类问题：
- 有设置项、没实现（属于 bug，优先修）
- 有运营价值、但确实空着的功能（按优先级补）
Top 5 最值得补：
| # | 功能 | 为什么排前面 |
|---|---|---|
| 1 | 前台深色模式 | 后台已有 dark_mode_enabled / default_color_mode 两个开关，前台一行实现都没有，用户开了开关没任何效果 —— 这是缺陷不是新功能 |
| 2 | 内容隐藏三件套（登录可见 / 回复可见 / 付费可见） | 线上只有"付费可见"。回复可见是资源站拉评论量最有效的手段，且实现成本很低 |
| 3 | 文章浏览量统计 | 线上完全为空。热度榜、相关文章权重、"值不值得买"的社交证明全依赖它 |
| 4 | 图片懒加载 + 缩略图规格 | 全站只有 1 处 loading="lazy"。资源站列表图多，首屏性能与流量成本直接相关 |
| 5 | 支付订单名称自定义 | 一行设置，解决微信支付把"资源/源码"判敏感词导致的支付失败 |
二、建议补齐清单（按优先级）
优先级定义：
- P0 = 缺陷或强依赖，建议下一批就做
- P1 = 运营价值明确，1~2 批内做
- P2 = 有价值但依赖外部资质或需先定业务口径
- P3 = 锦上添花，可排到最后
| 优先级 | 功能 | RiPro-V5 对应 | 线上平台现状 | 建议做法 | 主要收益 |
|---|---|---|---|---|---|
| P0 | 前台深色模式 | dark_mode_enabled、default_color_mode、site_logo_dark、顶部切换按钮 | 设置项已存在，前台未实现：无 data-theme、无 prefers-color-scheme、CSS 无暗色变量 | 在 legacy-home.css 抽一层 CSS 变量，`，头部加切换按钮并写入 localStorage；auto 走 prefers-color-scheme；暗色时用 site_logo_dark` | 修掉"设置项假开关"；夜间阅读体验 |
| P0 | 内容隐藏：登录可见 | ri-login-hide 短代码 | 无 | 投稿编辑器加容器语法 :::login ... :::，渲染时按登录态输出，未登录显示占位提示 | 引导注册 |
| P0 | 内容隐藏：回复可见 | ri-reply-hide 短代码 | 无 | 同上，语法 :::reply ... :::，按"当前用户是否在本文评论过"判定 | 拉评论量、提 SEO |
| P1 | 文章浏览量 / 阅读数 | zb_add_post_views、zb_get_post_views | 无（源码 0 命中） | Content.views 字段 + 详情页上报接口（做去重/节流）+ 列表与详情展示 + 后台可排序 | 热度榜依据、社交证明 |
| P1 | 图片懒加载与缩略图规格 | 懒加载、缩略图比例、自动抓取首图、随机缩略图 | 全站仅 1 处 loading="lazy"；无缩略图尺寸规格 | 统一 `` + 占位骨架；媒体库生成多尺寸 | 首屏性能、带宽成本 |
| P1 | 全站弹窗公告 | 全站弹窗公告（标题/内容/是否自动弹出） | 无 | 主题设置加公告组（启用/标题/富文本/自动弹出/展示频率/有效期）+ 前台 Modal，localStorage 记已读 | 活动通知、涨价与规则告知 |
| P1 | 作者分佣（投稿者分成） | is_site_author_aff、site_author_aff_ratio | 有"用户推广佣金"，无作者维度分成 | 订单结算时按资源/商品的 submittedById 给作者记佣金，复用现有佣金与提现链路 | 让投稿量真正起来 |
| P1 | 注册/登录图形验证码 | is_site_img_captcha、get_img_captcha | 无（0 命中） | 注册、登录失败 N 次、评论三处加图形验证码（服务端生成 + 校验） | 防刷注册、防撞库 |
| P1 | 文章页结构化 FAQ | 内容页"常见问题"配置（多组标题+描述） | 只有 GEO 页面有 FAQ | 内容表加 FAQ 字段（可排序多组），详情页输出 + 结构化数据 | 与 GEO 主业务天然契合 |
| P1 | 支付订单名称自定义 | site_shop_name_txt（默认"商城自助购买"） | 无 | 主题设置加一项，下单时作为 subject 传给支付通道 | 规避支付风控导致的失败 |
| P2 | 邮箱验证码（注册/找回） | is_site_mail_captcha、send_mail_captcha_code | 有 SMTP 配置，无验证码链路 | 复用已有 mail 设置，加验证码表 + 发送接口 + 校验 | 账号安全 |
| P2 | 第三方登录（QQ/微信/公众号） | inc/sns/{qq,weixin,mpweixin} | 无（0 命中 oauth） | 需先拿到开放平台资质；走 OAuth + 绑定已有账号 | 注册转化 |
| P2 | 游客购买 / 免登录下单 | 商城模式三档（关闭 / 全能含游客 / 仅登录） | 必须登录才能下单 | 引入"游客订单"（下单时收手机号/邮箱，订单凭据可查询） | 转化率 |
| P2 | 资源购买有效期 | site_post_pay_expire_day（0 = 永久） | 无（购买即永久） | 权益表加 expiresAt，过期后详情页回到未购买态 | 订阅式复购 |
| P2 | 支付渠道扩充 | 支付宝/微信/易支付/码支付/PayPal/USDT | 只有虎皮椒（微信+支付宝） | 抽象渠道接口（已有 provider 结构），按需接易支付或 USDT | 降低单一通道风险 |
| P2 | 评论增强：评论点赞 / 图片评论 | 评论点赞 | 无评论点赞 | 复用现有 reactions 结构，加 CommentReaction | 评论互动 |
| P2 | 无限滚动 / 加载更多 | zb_get_infinite_scroll_button | 只有页码分页 | 列表页加分页方式开关（页码/加载更多） | 移动端体验 |
| P2 | 主题设置导出 / 导入（JSON 备份） | 备份设置 | 有审计日志，无设置快照 | 主题设置页加"导出/导入 JSON"，导入前自动存快照 | 140 项设置改坏可秒恢复 |
| P2 | 微信内访问引导 | is_weixin_visit | 无 | 识别 UA 为微信时，软件下载页提示"点击右上角用浏览器打开" | 提高下载成功率 |
| P2 | 视频源多平台支持 | zb_get_video_source_types | 仅支持直链播放（且只用在首页 hero） | 解析 B 站/腾讯/优酷 iframe 或第三方解析地址 | 资源站视频演示 |
| P3 | 首页装修区块扩充 | 分类块、CMS 块、动态、数据总览、指定标题文章、刮刮卡 | 只有"首屏轮播 + 首页内容"两块 | 把首页内容拆成可排序的区块类型，至少补"分类块 / 排行榜块" | 首页运营灵活度 |
| P3 | 刮刮卡 / 抽奖互动 | home-scratch-card | 无 | 前端 Canvas 刮层 + 概率与库存表 + 中奖发金币 | 活动玩法（非刚需） |
| P3 | 侧边栏组件自由排序 | 作者信息、购买卡、文章列表、排行榜 | 有侧边栏配置但粒度较粗 | 后端存顺序数组，前端按序渲染 | 版面灵活度 |
| P3 | 网址导航 / 友情链接独立页 | is_site_link_manager_page | 只有页脚链接 | 复用导航菜单数据源做一个 /links 页 | 交换友链 |
| P3 | 多语言 / 智能翻译 | 网站智能多语言（translate.js） | 无 | 除非确定要做出海，否则不建议做（维护成本高） | 海外流量 |
三、已对齐（不需要补）
这些线上都已经实现了，列出来是为了避免重复投入。
| 模块 | 已实现项 | 对应 RiPro-V5 |
|---|---|---|
| 用户中心 | 基本信息、我的余额、我的会员、我的订单、下载记录、我的收藏、我的推广、我的工单、我的投稿、退出登录 | get_uc_menus() 全部 10 项 |
| 用户中心（超出 RiPro） | 已购软件、我的评论、我发布的商品、素材管理、在线客服 | RiPro 无 |
| 金币体系 | 站内币名称、图标、充值套餐、充值说明、最小提现、余额流水 | 站内币名称/充值套餐/充值说明/最小最大充值数 |
| 签到 | 每日签到开关 + 奖励数值 + 已签到状态 | is_site_qiandao + site_qiandao_coin_num |
| 会员 | 会员套餐（名称/天数/价格）、会员每日下载额度、会员说明（4 条可配）、VIP 介绍页、VIP 卡 | 会员组三级 + 套餐 + 协议说明 + 每日下载次数 + VIP 价格页 |
| 推广 | 推广链接、邀请码注册、佣金比例、佣金记录、最低提现额、提现申请与后台人工审核 | aff 表 + user_aff_action + 提现说明 + 最低提现 |
| 卡券 | CDK 兑换码（生成/管理/兑换）、卡券管理后台 | cao_cdk_tbl（充值卡 + 邀请码） |
| 工单 | 用户提交工单 + 后台工单管理 + 状态 | cao_ticket_tbl + user_save_ticket + ticket.php |
| 投稿 | 用户投稿 + 后台审核 + 状态机（草稿/待审/已上架/回收站） | 投稿功能 + is_site_tougao |
| 内容互动 | 点赞、收藏、分享、分享二维码 | zb_add_post_likes / zb_add_post_fav / add_share_post |
| 文章详情 | 面包屑、目录 TOC、上下篇、相关文章、作者信息、底部版权声明（均可在主题设置里独立开关） | 内容页同名开关项 |
| 评论 | 评论开关、是否需审核、每页数量、我的评论 | ajax_comment + 评论设置 |
| 搜索 | 搜索开关、仅匹配标题、分类筛选、搜索范围、结果数量 | 高级搜索整组 |
| 登录注册 | 登录/注册开关、仅邀请码注册、用户协议与隐私政策地址、登录页背景图、找回/重置密码 | 登录注册整组 + user_lostpwd / user_restpwd |
| 站点外观 | 9 组 140 项主题设置、深色 logo 字段、内容区宽度、网站背景、导航配色、手机底部导航、右侧悬浮菜单、高级页脚、ICP 与公安备案 | 布局设置 + 底部设置 + 基本设置 |
| 页面 | 标签云页、VIP 介绍页、客户案例页、GEO 页、软件商城页、资源商城页 | 标签云、VIP 页、网址导航、专题 |
| 商城 | 文章资源配置（价格/VIP 折扣/会员免费/永久会员免费/禁止普通用户购买/免费下载需登录/隐藏内容/视频/演示按钮/自定义按钮）、会员套餐、商城订单 | 商城基本设置 + 默认发布字段 |
| 支付 | 虎皮椒（微信 + 支付宝）、支付状态轮询、支付二维码、退款 | 支付接口配置 + get_pay_select_html |
| 后台运营 | 订单管理、卡券管理、推广佣金、推广提现、下载日志、批量改价、数据清理、审计日志、工单管理、后台充值、支付通道、媒体库、客户服务、合作线索、账号与权限 | order / cdk / cdk-add / cdk-output / aff / down / edit-posts / clear / ticket / admin-pay |
| 广告 | 广告位配置（adSlots） | 广告设置 |
| 邮件 | SMTP 配置 + 邮件通知 | 邮件设置 |
| 导航 | 导航菜单维护（顶部/页脚/移动端） | 菜单管理 + 导航设置 |
| 首页 | 首屏轮播（含视频 hero）+ 首页内容区块 | 首页 12 种小工具（部分覆盖） |
| 编辑器 | 折叠块、提示框（含中文别名）、任务列表、表格（含列对齐）、图集、代码块（标题/行号/高亮行）、脚注、高亮、撤销重做、表格可视化、发布前体检 | RiPro 的短代码体系（ri-accordions / ri-alerts / rihide 等） |
四、线上平台独有（RiPro-V5 没有）
这部分不需要向 RiPro 学，是自研平台已经领先的地方。
| 能力 | 说明 |
|---|---|
| 软件商城 | 软件商品 + 版本 + 安装包文件 + 支持平台矩阵 + 用户投稿安装包 |
| 内容审核工作流 | 先审核后上架，文章与软件商品共用状态机（草稿/待审/已上架/回收站） |
| GEO 业务线 | GEO 套餐、GEO 权益（独立于会员体系的有效期与额度）、GEO 订单、GEO 案例页 |
| 客户服务工作台 | 客服会话、分配、回复、处理状态 |
| 合作线索（轻 CRM） | 合作咨询承接与转化阶段跟踪 |
| 素材管理 | 用户侧媒体库（图片直传 + 素材复用） |
| 审计日志 | 后台操作审计 |
| 安全维护 | 数据清理（待支付订单、超期下载日志），带预览与确认凭据 |
| 批量改价 | 文章资源商品批量改价（含三态覆盖） |
| 富文本编辑器 | 14 项 Markdown 能力，含发布前体检与可视化表格 |
| 架构 | Next.js + NestJS + PostgreSQL + Meilisearch，前后台分离，容器化发布 |
五、不建议做 / 不适用
| 项 | 原因 |
|---|---|
| 卡密发货系统 | RiPro 自己在源码里把这一组设置整段注释掉了（admin-options.php L2058），说明商业版也没启用 |
| 优惠券 | RiPro 同样没有（只有 CDK）。现有 CDK 已能覆盖"折扣码/满减"的多数场景，除非要做复杂促销 |
| 主题授权 / License | 自研平台不需要 |
| 网站安全密钥、后台登录地址访问密码、下载显示真实文件名 | 属于 WordPress 场景的补丁（防刷、防猜后台地址）；线上是前后台分离 + 独立鉴权，不适用同一套思路（真实文件名反而建议保留可读） |
| 多语言 / 智能翻译 | 维护成本高，除非确定出海 |
| 子分类自定义排序 ID、卡密导出格式微调 | 本次开发的是同一套功能的不同实现风格差异，不是功能缺失 |
六、建议落地顺序
第 1 批（P0，修缺陷 + 低成本高收益）
- 前台深色模式（把已有设置项接上）
- 内容隐藏：登录可见 / 回复可见
- 支付订单名称自定义
第 2 批（P1，运营基建）
- 文章浏览量统计 + 榜单
- 图片懒加载与缩略图规格
- 全站弹窗公告
- 作者分佣
- 图形验证码
- 文章页结构化 FAQ
第 3 批（P2，按业务口径决定）
- 邮箱验证码 / 第三方登录 / 游客购买 / 购买有效期 / 支付渠道扩充
- 主题设置导出导入、微信内引导、评论点赞、无限滚动、视频源
第 4 批（P3，锦上添花）
- 首页装修区块扩充、刮刮卡、侧边栏排序、网址导航页
附：本次对照的证据来源
| 证据 | 位置 |
|---|---|
| RiPro-V5 全部设置分区与字段 | inc/options/admin-options.php（22 个 section / 3060 行） |
| RiPro-V5 建表（订单/下载/推广/卡密/工单） | inc/setup-db.php L56-151 |
| RiPro-V5 用户接口（25 个） | inc/template-ajax.php（user_qiandao、user_aff_action、vip_cdk_action、get_captcha_img 等） |
| RiPro-V5 功能标签 | inc/template-tags.php（zb_add_post_views、is_site_img_captcha、is_site_mail_captcha 等） |
| RiPro-V5 用户中心菜单 | inc/template-shop.php get_uc_menus() L943-983 |
| RiPro-V5 后台页面 | admin/pages/（pay/aff/cdk/cdk-add/cdk-output/clear/down/edit-posts/order/ticket） |
| 线上平台设置项 | apps/api/src/modules/site/theme-settings.ts（9 组 140 项） |
| 线上平台导航与模块 | apps/admin/components/admin-shell.tsx、apps/api/src/modules/*、apps/web/components/user/user-nav.tsx |
