中国 帮助

社交互动

官方 免费 插件

Wujies 无界平台(wujies.cn)的社交互动应用,一个插件一个仓库:

v1.0.9 5 次安装 本季度 1 次

<p> <a href="https://wujies.cn" target="_blank" rel="nofollow"> <img width="100" src="https://wujies.cn/brand/logo-stacked.svg" alt="Wujies 无界 logo"> </a> </p>

<p><b>社交互动</b>,关注、收藏、评论、点赞、分享、拉黑与互动统计。</p> <p> <a rel="nofollow"><img alt="应用版本" src="https://img.shields.io/badge/app-1.0.4-111111?style=flat-square"></a> <a rel="nofollow"><img alt="应用编码" src="https://img.shields.io/badge/code-social-0057FE?style=flat-square"></a> <a rel="nofollow"><img alt="License" src="https://img.shields.io/badge/license-MIT-green?style=flat-square"></a> <br> <a rel="nofollow">功能特性</a> <a rel="nofollow">预览</a> <a rel="nofollow">安装</a> <a rel="nofollow">设置</a> <a rel="nofollow">常见问题</a> <a href="https://docs.wujies.cn/docs/wujies/5.x/platform/plugin" rel="nofollow">插件开发</a> <a href="https://gitee.com/wujies" rel="nofollow">Gitee</a> </p>


Wujies 无界平台(wujies.cn)的社交互动应用,一个插件一个仓库:

  • 后台:应用市场装上后多一个「社交互动」菜单,前端是远程应用(frontend/,45 个文件), 管关注、收藏、评论、点赞、分享、拉黑与互动统计。
  • 前台:本应用不放直出的公开页模板,只对外提供评论 / 互动 / 关注三族 JSON 接口 (/site/comment/**、/site/interaction/**、/site/follow/**),由各应用自己的公开页去调用。
  • 对外能力:把「关注关系」通过平台 SPI FollowRelationApi 暴露给其它应用(图床的「只看关注的作者」用的就是它)。

应用编码 social | 应用版本 1.0.4 | 后端构件 wujies-social-plugin

✨ 功能特性

  • 👥 关注 — 关注 / 取关、关注状态(单个与批量)、关注类型(分组、特别关注)、粉丝与关注列表。
  • 🗂️ 关注分组 — 分组管理,关注关系可按分组归类。
  • 🚫 黑名单 — 拉黑与解除,与关注关系同一套目标口径。
  • ⭐ 收藏 + 收藏夹 — 通用收藏表 + 收藏夹(含公开标记 is_public),可按用户列出收藏夹与夹内条目。
  • ❤️ 点赞(通用) — 以「目标类型 + 目标 id」定位,重复点幂等;取消后再点走软删行复活,不打乱计数。
  • 💬 评论(通用) — 评论树、单栋展开、审核与批量审核,正文上限 500 字。
  • 🔁 转发(通用) — 记录转发行为,share_type 走字典。
  • 📊 互动统计 — 每个目标五个计数(点赞 / 收藏 / 评论 / 转发 / 浏览),支持单条刷新、批量刷新、热榜与趋势。
  • 📈 关注统计 — 每个用户的关注数 / 粉丝数 / 好友数 / 特别关注数。
  • 🌐 前台三族 JSON 接口 — 评论、点赞收藏转发、关注,全部匿名可读、受控可写(见「前台接口」)。
  • ⚡ 异步 + 同步兜底 — 计数与行为可走 MQ 消费者,投递失败当场退回同步落库。
  • 🧮 计数投影 — target_type='image' 时把点赞数 / 评论数投影到图床 gallery_image 自己那两列。
  • 🔐 多租户 — 十一张业务表都带 tenant_id,与平台其它应用同一套租户口径。

📸 预览

社交互动主界面

![社交互动主界面](docs/screenshots/social.png)

🚀 安装

环境要求

| 项 | 要求 | |---|---| | 平台版本 | &gt;=5.6.2 &lt;6.0.0(app.json 的 engine) | | 后端构建 | JDK 17+(父 POM 的 java.version 为 17) | | 前端构建 | Node.js 18+(建议 20 LTS 及以上),npm | | 消息队列 | 可选:不配 RabbitMQ 也能跑(site-write-mode 默认 sync),配了才会走异步消费者 | | 可选联动 | 装了 gallery 才有计数投影的目标表;没装时那条 UPDATE 影响 0 行,不影响点赞本身 | | 安装方式 | 管理端「应用市场 → 本地安装」上传 zip,或由上架中心(wujies-market)发布后由平台拉取 |

从应用市场安装

  1. 打开管理端「应用市场 → 本地安装」,上传打包好的 zip;或经上架中心发布后由平台拉取。
  2. 安装时自动执行 migrations/ 下的脚本(建 11 张表 + 4 套字典)。
  3. 装完刷新菜单,出现「社交互动」即成功。
  4. 要用前台评论区 / 点赞按钮,前台页所在的主题按 data-cms-comment-* 之类的钩子接上即可,不需要再装别的插件。

包里两个产物的路径由 app.json 的 assets 决定: frontend → frontend/index.js | backend → backend/wujies-social-plugin-1.0.4.jar。

从源码构建

在本仓库根打包(三条命令各管一段,都在本仓库根执行):

powershell -NoProfile -ExecutionPolicy Bypass -File package.ps1 -CheckOnly   # ① 打包前检查:清单/产物/迁移/菜单/密钥,几秒返回
powershell -NoProfile -ExecutionPolicy Bypass -File package.ps1 -Dev         # ② 开发包:不签名,落 ..\.plugin-dist\social\dev
powershell -NoProfile -ExecutionPolicy Bypass -File package.ps1              # ③ 正式包:构建 + 用 keys\private.pem 签名

关于上面三条命令的取值口径:

  • 判据是「脚本所在仓库根有没有 app.json」,所以在本仓库里不要传 -Plugin(它按子目录找清单, 会报「找不到插件目录」);-FrontendProject / -FrontendDist 也不用传 —— 独立布局的前端工程固定就是 本仓库 frontend/、产物 frontend/dist,脚本自己跑 npm run build(首次先 cd frontend &amp;&amp; npm install, 缺依赖时脚本会把这条命令直接报给你)。只想复用现成产物就加 -SkipBuild。
  • -SkipFrontend 只用于没有前端的纯后端应用:带前端时它会连「复制前端产物」一起跳过, 出的包只有 app.json,装上去没有界面。
  • -CheckOnly 打出的 CHECK|级别|项|说明 行就是管理端「开发工具 → 插件开发 → 打包」抽屉里那份体检清单, 两边跑的是同一套检查;有 ERROR 时正式打包会被直接拦下。签名密钥在本仓库 keys/ (private.pem + public.pem,已在 .gitignore 里),生成或更换用 -Keygen (覆盖已有密钥要显式加 -KeygenForce,旧钥先整份备份进 keys\backup\&lt;时间戳&gt;\)。 参数全表与产物结构见文档站「打包应用」与「密钥与签名」两页。

手工构建:

mvn -B -o package -DskipTests              # 后端(前提见「常见问题」)
cd frontend &amp;&amp; npm install &amp;&amp; npm run build  # 前端,产物 dist/index.js + assets/social-app.css

最快的开发路子不用打包、不用重启宿主:启动平台宿主,打开管理端「开发工具 → 插件开发」, 找到 social 这一行点「启动后端」(自动编译并加载 target/classes,同时开启监听)与「启动前端」 (常驻 vite build --watch,保存源码即重建,刷新页面生效,没有 HMR)。全流程见 文档站「插件开发」。

升级与卸载

  • 升级:换 app.json 的 version 后重新打包上传;已执行的迁移脚本不可改内容, 要加表 / 加字典一律加新编号脚本。
  • 卸载:管理端「应用市场」里卸载,平台按 migrations/01-create-social-tables.sql 里 CREATE TABLE 的清单清理这 11 张表(social_block / social_comment / social_favorite / social_favorite_folder / social_follow / social_follow_group / social_follow_statistics / social_like / social_share / social_statistics / social_user_action)。
  • ⚠️ 卸载后图床的「只看关注」会静默退化成不过滤(FollowRelationApi 不在,宿主拿不到实现), 不会报错也不会 500 —— 这是刻意的降级口径。

⚙️ 设置

后台没有独立配置页:运营参数都在各自列表页上(关注 / 分组 / 黑名单 / 收藏夹 / 互动统计 / 互动行为 / 点赞 / 评论 / 收藏 / 转发)。运行期只有一个开关在宿主配置:

| 键 | 取值 | 说明 | |---|---|---| | wujies.social.site-write-mode | sync(默认)/ mq | 前台写接口(点赞 / 收藏 / 转发)是请求内落库还是投 MQ 先回乐观数 |

⚠️ 写错档位启动即失败(IllegalStateException):留一个拼错的 mq 静默跑同步, 等于这个开关从来没生效过。

菜单入口

| 菜单 | 路径 | 组件键 | 权限前缀 | |---|---|---|---| | 关注统计 | follow/management/followStatistics | remote:social/social/followStatistics | social:followStatistics:* | | 关注数据 | follow/management/follow | remote:social/social/follow | social:follow:* | | 关注分组 | follow/management/followGroup | remote:social/social/followGroup | social:followGroup:* | | 黑名单 | follow/management/block | remote:social/social/block | social:block:* | | 收藏夹 | follow/management/favoriteFolder | remote:social/social/favoriteFolder | social:favoriteFolder:* | | 互动统计 | action/management/statistics | remote:social/social/statistics | social:statistics:* | | 互动行为 | action/management/userAction | remote:social/social/userAction | social:userAction:* | | 点赞(通用) | action/management/like | remote:social/social/like | social:like:* | | 评论(通用) | action/management/comment | remote:social/social/comment | social:comment:* | | 收藏(通用) | action/management/favorite | remote:social/social/favorite | social:favorite:* | | 转发(通用) | action/management/share | remote:social/social/share | social:share:* |

菜单树里还有两个中间目录(M,本身没有 perms):关注管理(social-follow-management, path follow/management)与 互动管理(social-action-management,path action/management)。 每个 C 页面下挂 5 个 F 按钮(query / add / edit / remove / export), 前缀与 app.json 里的 perms 逐字对应,改名会让已授权角色失效。

🧩 依赖与插件支持

| 项 | 说明 | |---|---| | 依赖插件 | 无(app.json 的 dependencies 为空)—— 社交自己就是被依赖方 | | 对外 SPI | 实现 cn.wujies.common.plugin.sdk.FollowRelationApi(FollowRelationApiAdapter),供图床等应用查关注关系 | | 计数投影 | GalleryImageCountSync 用 JdbcTemplate 直更 gallery_image.like_count / comment_count;表不在时影响 0 行 | | 消息队列 | RabbitMQConstant.SocialInteraction 的 exchange / queue / routing key,队列声明在宿主的 RabbitMQ 配置里(插件子上下文声明的队列宿主看不见) | | 平台存储 | 不使用;本插件不落文件 | | 公共 API | 前端走打进包内的 @wujies/api-client,运行时由宿主 import map 提供 vue / element-plus / @wujies/ui-shared 单例 |

前台接口

本应用没有 site-templates/,也没有 site-styles/,所以没有本屏自带的样式要发。 它对外的门面是三族只回 JSON 的端点(都挂在 /site/** 匿名族上):

| 组 | 端点 | 说明 | |---|---|---| | 评论 | GET /site/comment/tree | 评论树:顶层一排,每栋下面只带出前 2 条回复(REPLY_PREVIEW = 2) | | 评论 | GET /site/comment/replies | 展开某一栋剩下的回复 | | 评论 | GET /site/comment/location | 按 userId 取用户所在地(前台显示用) | | 评论 | POST /site/comment | 发评论(正文 ≤ 500 字) | | 评论 | POST /site/comment/like | 点赞 / 取消点赞某条评论(social_like.target_type='comment') | | 互动 | GET /site/interaction/state | 某个目标的三个计数 + 「我点过没有」 | | 互动 | POST /site/interaction/like /favorite /share | 点 / 取消,返回最新计数(幂等由服务端兜住) | | 互动 | GET /site/interaction/mine /by-user /folders /folder-items | 我的互动、某人的互动、收藏夹与夹内条目 | | 关注 | GET /site/follow/status/{id}、/status-batch | 关注状态(单个 / 批量) | | 关注 | POST / DELETE /site/follow/{id} | 关注 / 取关,返回最新状态 | | 关注 | GET /site/follow/statistics/{userId}、/followers、/following | 统计与列表 |

谁要用评论区或那三颗按钮,就在自己的公开页里调这几条 —— 端点跟着插件走是因为插件各自的类加载器: 本仓库的产物主题那侧读不到兄弟插件的东西,静态资源与接口都由本插件自己发,口径与 wujies-cms-plugin README「写主题时必须守住的五条」第 5 条一致。

匿名写口子的三道闸(改之前先看,都是实测踩出来的):

  1. 目标类型白名单:这条匿名路径只放行 article 与 image(SocialSiteInteractionService.TARGET_TYPES), 别让 /site/** 变成「任何应用的任何对象都能被点赞收藏」的通用写口。
  2. 按 IP 限流(SocialSiteRateGuard):进程内固定窗口,一个 ConcurrentHashMap 就够挡住「一个人拿脚本刷」。 为什么不用平台的 @RateLimiter:它靠宿主上下文里的 RateLimiterAspect 织入, 而插件跑在自己的 PluginApplicationContext 里,宿主的自动代理创建器不继承给子上下文 —— 注解在插件 controller 上就是「编译通过、运行时不生效」(现场实测:连续 34 次请求一次都没挡)。 口径是单机限流:按 IP 分桶,多实例各算各的。
  3. @RepeatSubmit 只当第一层:光靠它挡不住换 IP 的脚本,所以限流必须在本插件里自己做。

计数投影与消息队列

  • social_* 那几张通用表才是源头:目标自己的表(例如图床的 gallery_image)不认识它们, 所以点赞数 / 评论数那两列由社交侧投影过去(GalleryImageCountSync,只在 target_type='image' 时写)。
  • 投影走 JdbcTemplate 直更,不经 MyBatis ⇒ 租户拦截器不会补条件,按全局唯一主键 image_id 定位。
  • 写坏了只记日志:互动条的数由社交表当场回数,不该把访客刚点下去那一次退回去。
  • MQ 是可选加速:SocialSiteInteractionPublisher 投 RabbitMQConstant.SocialInteraction, SocialInteractionConsumer 消费后落库并维护统计;投递失败返回 false,调用方当场同步落库。
  • 消费者按消息里的 tenantId 跑 TenantHelper 上下文,并手动 basicAck(不靠自动确认)。
  • 互动统计的五个计数在 social_statistics(点赞 / 收藏 / 评论 / 转发 / 浏览),支持单条刷新与批量刷新, 热榜与趋势另有查询端点。

关注关系作为平台能力

图床的「只看关注的作者」、商城的「关注店铺」这类跨应用需求,走的是平台 SPI 而不是直接读表:

  • 契约 FollowRelationApi 在 wujies-common-plugin-sdk(父加载器可见),实现是 FollowRelationApiAdapter(本插件);消费方用 ObjectProvider,缺席即降级。
  • 适配器先问一句「装了没」(PluginServiceProvider.isPluginLoaded("social")),没装就返回空集 —— 否则彻底删除会把 social_follow 一起 DROP,消费方一查表就是「表不存在」的 500。
  • 传进来的候选集为空时直接短路,既省一次查询,也避免拼出 in () 这种非法 SQL。
  • SocialFollow 是租户表,不手动拼 tenant_id,交给多租户插件。

开发环境

git clone git@gitee.com:wujies/wujies-social-plugin.git
cd wujies-social-plugin

打包脚本:本仓库自带完整的 package.ps1(母本在 wujies-plugins 仓库根,各仓用 node scripts/sync-package-script.mjs 同步过来),clone 下来就能在本仓库根直接体检、构建、签名、出包、 生成密钥,不需要回到单体仓库,也不需要手工传产物路径。

前端 SDK:已迁到已发布的 @wujies/* SDK(ui-shared / components / api-client / ui-plugin-bundler-kit)。frontend/vite.config.ts 只声明 defineRemoteApp({ appCode, root }), 共享依赖一律 external、运行期由宿主 import map 兜到同一份实例;宿主独有工具与业务模块 (@/utils/wujies、@/api/system/*、UserSelect/MemberSelect 等)按原样复制进了 frontend/src/ (含 utils/requestCache.ts),proxy?.$modal / useDict / download 与 ImageUpload/UserDetail/Module*Settings 由宿主运行时提供。 本仓库前端可独立构建;要直接落位到宿主,构建前设 WUJIES_FRONTEND_DIST=/app-market-dist/remote-apps。

仓库布局

| 位置 | 内容 | |---|---| | pom.xml | Maven 模块(父 pom = cn.wujies.plugins:wujies-plugins-parent,`` 已置空) | | app.json | 应用清单,打包器读的唯一事实来源(code / version / menus / assets) | | src/ | Java 源码(105 个文件):adapter / controller / portal / site / listener / support / domain / mapper / service | | src/main/resources/mapper/social/ | 十一个 Mapper XML | | migrations/ | 2 个脚本:01 建 11 张表、02 四套字典(social_action_type / social_follow_type / social_share_type / social_target_type) | | frontend/ | 远程应用源码(src/ 45 个文件),入口 frontend/src/index.ts | | docs/screenshots/social.png | 预览图 |

❓ 常见问题

Q:陌生人 clone 后 mvn package 报找不到 wujies-plugins-parent? 父 pom 与 wujies-common-* 目前只有本地 mvn install 出来的版本,还没发布到 Maven 仓库。 本机装过就能通,本机实测 mvn -B -o package -DskipTests 通过。

Q:前台点赞不生效 / 计数不动? 先看 wujies.social.site-write-mode:mq 档需要 RabbitMQ 真的通。投递失败会自动退回同步落库, 但消费者没起时会看到「互动统计」迟迟不更新;排查顺序是队列 → 消费者日志 → 统计刷新。 另注意匿名路径只放行 article / image 两种 target_type,其它类型直接被拒。

Q:为什么插件里写 @RateLimiter 没效果? 宿主那套限流靠 RateLimiterAspect 这个 @Aspect bean,插件子上下文不继承宿主的自动代理创建器 —— 标注解等于没标(实测连续 34 次请求一次没挡)。本插件用 SocialSiteRateGuard 自己按 IP 限流。

Q:评论树里回复不全? 正常。树只带每栋前 2 条回复(REPLY_PREVIEW = 2),剩下的用 GET /site/comment/replies 展开, 前台那句「等 N 条回复」数的正是这些。

Q:点赞数被点乱了 / 取消再点变成两条? 不会:取消是软删,再点走复活那条行(uk_target_user 不含 del_flag),计数由服务端回数。 如果你手工往 social_like 插重复行,才会出现两行 —— 那是绕过服务端的结果。

Q:图床的点赞数对不上? gallery_image.like_count 是社交侧投影过来的(只有 target_type='image' 才写),源头是 social_like。 投影失败只记日志,不阻塞访客操作;对账以社交表为准,重刷一次互动即可修正。

Q:卸载社交后图床报 500? 不会。适配器先问 isPluginLoaded("social"),没装返回空集;消费方用 ObjectProvider 拿实现, 缺席就按「没有关注关系」降级。真出现 500 请查消费方是否还在直接注入 SocialFollowMapper。

Q:菜单同步后只剩一个光杆「社交互动」目录? 生成清单时不能按 perms LIKE 'social:%' + path 过滤:真实菜单树里还有两个中间目录 (关注管理 follow/management、互动管理 action/management),它们既没有 social: 前缀的 perms、 path 里也不含 social,按条件过滤会把它们连同下面 11 个页面一起丢掉(实测只解析出 1 行)。 要从根目录用递归 CTE 整棵取。

Q:前端页面无样式 / 控制台报 component 解析不出来? frontend/src/index.ts 的 styles 必须是真实产物名 social-app.css(按工程包名 @wujies-plugins/social-app 命名);菜单 component 必须是 remote:social/social/&lt;视图键&gt;, 视图键与 views/social/** 文件名一致。

Q:打包时提示「找不到插件目录」? 在本仓库根不要传 -Plugin —— 脚本按「仓库根有没有 app.json」判定布局,传了它就去找子目录清单。

🔒 隐私与外部资源

  • 不收集、不上报任何遥测;关注、收藏、评论、点赞、转发、统计都只存本平台数据库。
  • 前台匿名写接口只收「目标类型 + 目标 id + 当前登录会话」,按 IP 进程内限流,不接第三方统计脚本。
  • 本仓库不含任何密钥或凭据;签名密钥只在本机 keys/(已 gitignore)。
  • 外呼只有平台自己的 RabbitMQ(可选)与同一部署内的其它应用,没有外部第三方服务。

📄 许可证与致谢

MIT(条文见仓库根目录 LICENSE,许可口径与 wujies-platform 一致)。

💬 反馈与建议

参考

wujies-hello-plugin(已按新布局跑通前端独立构建的样板)、 wujies-ui(npm 上 @wujies/* 四件套的源码仓)、 文档站「插件开发」章节。

v1.0.9 2026-11-16 960 KB

评论加载更多:新增 /site/comment/tree/page,按顶层评论游标分页;保留老 /tree 返回结构

v1.0.8 2026-11-16 954 KB

关注/粉丝列表跳过 count(*),总数改用 social_follow_statistics(与页头数字同一份);百万行账号的粉丝列表从 2.3 秒降到百毫秒级。

v1.0.7 2026-11-16 953 KB

修复后台卡死与导出 OOM:概览改库内聚合并按租户缓存 60 秒;导出限行 2 万行;分页参数兜底防止全表扫描;统计列表计数去掉 left join

v1.0.6 2026-11-16 2.1 MB

公开评论树加 200 行上限并取最近评论,修复单篇 81 万条评论撑爆后端;需配合 cms 1.0.23。

v1.0.5 2026-11-11 平台 >=5.6.2 <6.0.0 946 KB

评论目标类型新增 app,支持应用市场的公开评论

v1.0.4 2026-11-10 平台 >=5.6.2 <6.0.0 945 KB

新增

  • site 公开关注/收藏夹与互动异步写入口径
  • 前台评论限流守卫;互动接口与图床计数同步注释瘦身

修复

  • 同步公钥检查——开源仓 yml 只有环境变量占位符时改比部署仓 keys/package-public.pem

其他

  • social 1.0.4 —— 版本号与包内 jar 名同步
  • social 1.0.3 —— 版本号与包内 jar 名同步
v1.0.3 2026-11-08 平台 >=5.6.2 <6.0.0 913 KB

patch 升级 1.0.3

v1.0.1 2026-10-01 平台 >=5.6.2 <6.0.0 952 KB

这个版本没有写更新日志。

评论区需要浏览器启用 JavaScript 才能加载。