feat(emoji): 添加表情分组分享和本地上传功能

- 实现表情分组分享码生成功能，支持静态快照分享
- 添加表情分组分享码导入功能，支持创建新的分组
- 集成本地表情上传功能，支持图片格式验证和大小限制
- 优化计数器位置计算逻辑，调整默认显示位置
- 扩展表情管理界面，增加分享和导入操作按钮
- 实现表情分组的批量导出和导入功能，支持跨用户分享
- 添加本地上传触发器和文件处理流程，集成前端上传组件

Author: csfwff

AGENTS.md

@@ -44,6 +44,8 @@
 ## 关键链路（持续维护）
 - 前端全局主题变量入口：`src/main/resources/scss/_variables.scss`；`$theme-primary` 会影响 `module`/首页卡片/聊天室等主区背景，深色会导致整站大面积染色；顶栏建议在 `base.scss`/`mobile-base.scss` 的 `.nav` 单独设色。
 - 移动端文章页（`skins/mobile/article.ftl`）存在多个 `#replyUseName`（含隐藏占位 `.fn-none`）；`m-article.js` 处理回复目标时需优先选中非 `.fn-none` 节点，避免“回复对象已记录但指示未显示”。
+- 新版表情面板的入口与工具条统一由 `src/main/resources/js/emoji-groups.js` 渲染；文章页/聊天室 FTL 里旧的 `#uploadEmoji` 尾栏大多已注释，恢复“本地上传”优先改这里，不要分别恢复多套模板。
+- 表情集分享链路使用新表 `emoji_share` 保存“分组快照 + 永久分享码”；分享内容是静态快照，后续源分组变更不会实时同步，导入会在目标用户下新建自定义分组并同步补入其“全部”分组。
 - 首页右栏专栏列表（classic）需使用 `module-list long-column-module-list`（见 `skins/classic/index.ftl` 的“最新专栏/热门专栏/最近阅读”）；否则会命中 `.module-list .title` 默认 `margin-left: 30px` 产生左侧空白。
 - 勋章管理页：`/admin/medal`
   - 后端：`src/main/java/org/b3log/symphony/processor/MedalProcessor.java`（`showAdminMedal`、`register`）

sql/20260318_emoji_share.sql

@@ -0,0 +1,14 @@
+CREATE TABLE IF NOT EXISTS `symphony_emoji_share` (
+  `oId` VARCHAR(19) NOT NULL,
+  `emojiShareCode` VARCHAR(16) NOT NULL,
+  `emojiShareOwnerUserId` VARCHAR(19) NOT NULL,
+  `emojiShareGroupId` VARCHAR(19) NOT NULL,
+  `emojiShareGroupName` VARCHAR(64) NOT NULL,
+  `emojiShareSnapshot` LONGTEXT NOT NULL,
+  `emojiShareEmojiCount` INT NOT NULL DEFAULT 0,
+  `emojiShareImportedCount` INT NOT NULL DEFAULT 0,
+  `emojiShareCreatedTime` BIGINT NOT NULL,
+  PRIMARY KEY (`oId`),
+  UNIQUE KEY `uk_emoji_share_code` (`emojiShareCode`),
+  KEY `idx_emoji_share_owner_created` (`emojiShareOwnerUserId`, `emojiShareCreatedTime`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

src/main/java/org/b3log/symphony/model/EmojiShare.java

@@ -0,0 +1,39 @@
+/*
+ * Rhythm - A modern community (forum/BBS/SNS/blog) platform written in Java.
+ * Modified version from Symphony, Thanks Symphony :)
+ * Copyright (C) 2012-present, b3log.org
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package org.b3log.symphony.model;
+
+/**
+ * Emoji share snapshot model constants.
+ */
+public final class EmojiShare {
+
+    private EmojiShare() {
+    }
+
+    public static final String EMOJI_SHARE = "emoji_share";
+
+    public static final String SHARE_CODE = "emojiShareCode";
+    public static final String OWNER_USER_ID = "emojiShareOwnerUserId";
+    public static final String GROUP_ID = "emojiShareGroupId";
+    public static final String GROUP_NAME = "emojiShareGroupName";
+    public static final String SNAPSHOT = "emojiShareSnapshot";
+    public static final String EMOJI_COUNT = "emojiShareEmojiCount";
+    public static final String IMPORTED_COUNT = "emojiShareImportedCount";
+    public static final String CREATED_TIME = "emojiShareCreatedTime";
+}

src/main/java/org/b3log/symphony/processor/EmojiProcessor.java

@@ -30,6 +30,7 @@
 import org.b3log.latke.service.ServiceException;
 import org.b3log.symphony.model.EmojiGroup;
 import org.b3log.symphony.model.EmojiGroupItem;
+import org.b3log.latke.model.User;
 import org.b3log.symphony.processor.middleware.LoginCheckMidware;
 import org.b3log.symphony.service.CloudService;
 import org.b3log.symphony.service.EmojiMgmtService;
@@ -107,6 +108,8 @@ public static void register() {
         Dispatcher.post("/api/emoji/group/add-emoji", emojiProcessor::addEmojiToGroup, loginCheck::handle);
         Dispatcher.post("/api/emoji/group/add-url-emoji", emojiProcessor::addUrlEmojiToGroup, loginCheck::handle);
         Dispatcher.post("/api/emoji/group/remove-emoji", emojiProcessor::removeEmojiFromGroup, loginCheck::handle);
+        Dispatcher.post("/api/emoji/group/share/create", emojiProcessor::createGroupShare, loginCheck::handle);
+        Dispatcher.post("/api/emoji/group/share/import", emojiProcessor::importGroupShare, loginCheck::handle);
         Dispatcher.post("/api/emoji/emoji/update", emojiProcessor::updateEmojiItem, loginCheck::handle);
         Dispatcher.post("/api/emoji/emoji/migrate", emojiProcessor::migrateOldEmoji, loginCheck::handle);
     }
@@ -567,6 +570,58 @@ public void removeEmojiFromGroup(final RequestContext context) {
         }
     }
 
+    public void createGroupShare(final RequestContext context) {
+        try {
+            final JSONObject currentUser = getCurrentUser(context);
+            final JSONObject requestJSONObject = context.requestJSON();
+            final String groupId = requestJSONObject.optString("groupId");
+            if (StringUtils.isBlank(groupId)) {
+                context.renderJSON(new JSONObject()).renderCode(StatusCodes.ERR).renderMsg("缺少分组参数");
+                return;
+            }
+
+            final JSONObject resultData = emojiMgmtService.createShareSnapshot(
+                    currentUser.optString(Keys.OBJECT_ID), groupId
+            );
+            final JSONObject result = new JSONObject();
+            result.put("code", StatusCodes.SUCC);
+            result.put("data", resultData);
+            context.renderJSON(result);
+        } catch (final ServiceException e) {
+            LOGGER.log(Level.WARN, "Create emoji group share failed", e);
+            context.renderJSON(new JSONObject()).renderCode(StatusCodes.ERR).renderMsg(e.getMessage());
+        } catch (final Exception e) {
+            LOGGER.log(Level.ERROR, "Create emoji group share failed", e);
+            context.renderJSON(new JSONObject()).renderCode(StatusCodes.ERR).renderMsg("生成分享码失败");
+        }
+    }
+
+    public void importGroupShare(final RequestContext context) {
+        try {
+            final JSONObject currentUser = getCurrentUser(context);
+            final JSONObject requestJSONObject = context.requestJSON();
+            final String shareCode = requestJSONObject.optString("shareCode");
+            if (StringUtils.isBlank(shareCode)) {
+                context.renderJSON(new JSONObject()).renderCode(StatusCodes.ERR).renderMsg("请输入分享码");
+                return;
+            }
+
+            final JSONObject resultData = emojiMgmtService.importShareSnapshot(
+                    currentUser.optString(Keys.OBJECT_ID), shareCode
+            );
+            final JSONObject result = new JSONObject();
+            result.put("code", StatusCodes.SUCC);
+            result.put("data", resultData);
+            context.renderJSON(result);
+        } catch (final ServiceException e) {
+            LOGGER.log(Level.WARN, "Import emoji group share failed", e);
+            context.renderJSON(new JSONObject()).renderCode(StatusCodes.ERR).renderMsg(e.getMessage());
+        } catch (final Exception e) {
+            LOGGER.log(Level.ERROR, "Import emoji group share failed", e);
+            context.renderJSON(new JSONObject()).renderCode(StatusCodes.ERR).renderMsg("导入分享码失败");
+        }
+    }
+
     // 用户修改表情名字
     /**
      * Updates an emoji item (name and sort).
@@ -717,5 +772,31 @@ private boolean isSafeName(final String name) {
         return SAFE_NAME_PATTERN.matcher(name).matches();
     }
 
+    private JSONObject getCurrentUser(final RequestContext context) {
+        Object userObj = context.attr(User.USER);
+        if (userObj instanceof JSONObject) {
+            return (JSONObject) userObj;
+        }
+
+        JSONObject currentUser = Sessions.getUser();
+        if (currentUser != null) {
+            return currentUser;
+        }
+
+        try {
+            final JSONObject requestJSONObject = context.requestJSON();
+            final String apiKey = requestJSONObject.optString("apiKey");
+            if (StringUtils.isNotBlank(apiKey)) {
+                currentUser = ApiProcessor.getUserByKey(apiKey);
+                if (currentUser != null) {
+                    return currentUser;
+                }
+            }
+        } catch (final Exception ignored) {
+        }
+
+        return new JSONObject();
+    }
+
 
 }

src/main/java/org/b3log/symphony/repository/EmojiShareRepository.java

@@ -0,0 +1,46 @@
+/*
+ * Rhythm - A modern community (forum/BBS/SNS/blog) platform written in Java.
+ * Modified version from Symphony, Thanks Symphony :)
+ * Copyright (C) 2012-present, b3log.org
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package org.b3log.symphony.repository;
+
+import org.b3log.latke.repository.AbstractRepository;
+import org.b3log.latke.repository.FilterOperator;
+import org.b3log.latke.repository.PropertyFilter;
+import org.b3log.latke.repository.Query;
+import org.b3log.latke.repository.RepositoryException;
+import org.b3log.latke.repository.annotation.Repository;
+import org.b3log.symphony.model.EmojiShare;
+import org.json.JSONObject;
+
+/**
+ * Emoji share repository.
+ */
+@Repository
+public class EmojiShareRepository extends AbstractRepository {
+
+    public EmojiShareRepository() {
+        super(EmojiShare.EMOJI_SHARE);
+    }
+
+    public JSONObject getByShareCode(final String shareCode) throws RepositoryException {
+        final Query query = new Query().setFilter(
+                new PropertyFilter(EmojiShare.SHARE_CODE, FilterOperator.EQUAL, shareCode)
+        );
+        return getFirst(query);
+    }
+}