refactor(article): 优化首页最新文章查询逻辑

- 重构 getIndexRecentArticles 方法，分离查询构建逻辑到独立方法
- 添加置顶文章ID集合构建方法，提高查找效率
- 实现分页补偿机制，确保多页间文章数量一致性
- 修复分页时置顶文章重复显示问题
- 更新 AGENTS.md 文档，补充首页两列对齐约束说明

Author: csfwff

AGENTS.md

@@ -53,6 +53,7 @@
 - VIP 管理页样式需注意 `home.css` 的 `.form--admin label { flex: 1; }` 会影响布局；配置项行在 `vip-admin.scss` 中需显式改为整行（label/builder 100%）并对 checkbox 使用类型选择器，避免控件被放大。
 - 有效期字段：勋章 `expireTime`（毫秒，`0`=永久）；会员 `expiresAt`（可回填勋章到期）。
 - 首页最新文章链路：`IndexProcessor#loadIndexData` 通过 `ArticleQueryService#getIndexRecentArticles(fetchSize, page)` 组装 classic/mobile 首页“最新文章”；第一页置顶插入与数量行为在该方法维护。
+- 首页两列对齐约束：`getIndexRecentArticles` 的第一页会插入全部置顶且不截断；第二页起需按第一页“置顶占位数”补偿 `fetchSize` 与分页偏移，保证两列等高且不丢中间文章。
 - 路由总入口：`Router#requestMapping` + 各 Processor `register()`；新增路由先决定使用 `loginCheck` / `apiCheck` / `permission` / `anonymousViewCheck` 哪条链路。
 - `LoginCheckMidware#handle`：未登录统一 401（特殊 URI `/gen` 返回空 SVG）；支持 `Sessions` 与 `apiKey` 两种登录态来源。
 - 新接口若需“页面登录态 + apiKey 调用”双兼容，路由层优先挂 `loginCheck::handle`，处理方法再读取 `context.attr(User.USER)`；避免只挂 `permission` 导致拿不到当前用户对象。

src/main/java/org/b3log/symphony/service/ArticleQueryService.java

@@ -1320,30 +1320,38 @@ public List<JSONObject> getIndexRecentArticles(int fetchSize, int page) {
         try {
             Stopwatchs.start("Query index recent articles");
             try {
-                Query query = new Query().
-                        setFilter(CompositeFilterOperator.and(
-                                new PropertyFilter(Article.ARTICLE_TYPE, FilterOperator.NOT_EQUAL, Article.ARTICLE_TYPE_C_DISCUSSION),
-                                new PropertyFilter(Article.ARTICLE_TYPE, FilterOperator.NOT_EQUAL, Article.ARTICLE_TYPE_C_LONG),
-                                new PropertyFilter(Article.ARTICLE_STATUS, FilterOperator.EQUAL, Article.ARTICLE_STATUS_C_VALID),
-                                new PropertyFilter(Article.ARTICLE_SHOW_IN_LIST, FilterOperator.NOT_EQUAL, Article.ARTICLE_SHOW_IN_LIST_C_NOT),
-                                new PropertyFilter(Article.ARTICLE_CREATE_TIME, FilterOperator.GREATER_THAN_OR_EQUAL, String.valueOf(DateUtils.addDays(new Date(), -30).getTime())))).
-                        setPageCount(1).setPage(page, fetchSize).
-                        addSort(Article.ARTICLE_LATEST_CMT_TIME, SortDirection.DESCENDING);
-                ret = articleRepository.getList(query);
-
+                final int normalizedPage = Math.max(page, 1);
                 final List<JSONObject> stickArticles = getStickArticles();
-                if (!stickArticles.isEmpty() && page == 1) {
-                    final Iterator<JSONObject> i = ret.iterator();
-                    while (i.hasNext()) {
-                        final JSONObject article = i.next();
-                        for (final JSONObject stickArticle : stickArticles) {
-                            if (article.optString(Keys.OBJECT_ID).equals(stickArticle.optString(Keys.OBJECT_ID))) {
-                                i.remove();
+                final Set<String> stickArticleIds = buildArticleIdSet(stickArticles);
+
+                if (1 == normalizedPage) {
+                    final Query query = buildIndexRecentArticlesQuery(1, fetchSize);
+                    ret = articleRepository.getList(query);
+
+                    if (!stickArticles.isEmpty()) {
+                        final Iterator<JSONObject> iterator = ret.iterator();
+                        while (iterator.hasNext()) {
+                            final JSONObject article = iterator.next();
+                            if (stickArticleIds.contains(article.optString(Keys.OBJECT_ID))) {
+                                iterator.remove();
                             }
                         }
-                    }
 
-                    ret.addAll(0, stickArticles);
+                        ret.addAll(0, stickArticles);
+                    }
+                } else {
+                    final int extraSize = calcIndexRecentExtraSize(fetchSize, stickArticleIds);
+                    final int actualFetchSize = fetchSize + extraSize;
+                    final int fromIndex = (normalizedPage - 1) * fetchSize + (normalizedPage - 2) * extraSize;
+                    final int toIndex = fromIndex + actualFetchSize;
+
+                    final Query query = buildIndexRecentArticlesQuery(1, toIndex);
+                    final List<JSONObject> queried = articleRepository.getList(query);
+                    if (queried.size() <= fromIndex) {
+                        ret = new ArrayList<>();
+                    } else {
+                        ret = new ArrayList<>(queried.subList(fromIndex, Math.min(queried.size(), toIndex)));
+                    }
                 }
             } finally {
                 Stopwatchs.end();
@@ -1359,6 +1367,44 @@ public List<JSONObject> getIndexRecentArticles(int fetchSize, int page) {
         }
     }
 
+    private Query buildIndexRecentArticlesQuery(final int page, final int fetchSize) {
+        return new Query().
+                setFilter(CompositeFilterOperator.and(
+                        new PropertyFilter(Article.ARTICLE_TYPE, FilterOperator.NOT_EQUAL, Article.ARTICLE_TYPE_C_DISCUSSION),
+                        new PropertyFilter(Article.ARTICLE_TYPE, FilterOperator.NOT_EQUAL, Article.ARTICLE_TYPE_C_LONG),
+                        new PropertyFilter(Article.ARTICLE_STATUS, FilterOperator.EQUAL, Article.ARTICLE_STATUS_C_VALID),
+                        new PropertyFilter(Article.ARTICLE_SHOW_IN_LIST, FilterOperator.NOT_EQUAL, Article.ARTICLE_SHOW_IN_LIST_C_NOT),
+                        new PropertyFilter(Article.ARTICLE_CREATE_TIME, FilterOperator.GREATER_THAN_OR_EQUAL, String.valueOf(DateUtils.addDays(new Date(), -30).getTime())))).
+                setPageCount(1).setPage(page, fetchSize).
+                addSort(Article.ARTICLE_LATEST_CMT_TIME, SortDirection.DESCENDING);
+    }
+
+    private Set<String> buildArticleIdSet(final List<JSONObject> articles) {
+        final Set<String> articleIds = new HashSet<>();
+        for (final JSONObject article : articles) {
+            articleIds.add(article.optString(Keys.OBJECT_ID));
+        }
+
+        return articleIds;
+    }
+
+    private int calcIndexRecentExtraSize(final int fetchSize, final Set<String> stickArticleIds) throws RepositoryException {
+        if (stickArticleIds.isEmpty()) {
+            return 0;
+        }
+
+        final Query firstPageQuery = buildIndexRecentArticlesQuery(1, fetchSize);
+        final List<JSONObject> firstPageArticles = articleRepository.getList(firstPageQuery);
+        int duplicatedCount = 0;
+        for (final JSONObject article : firstPageArticles) {
+            if (stickArticleIds.contains(article.optString(Keys.OBJECT_ID))) {
+                duplicatedCount++;
+            }
+        }
+
+        return Math.max(0, stickArticleIds.size() - duplicatedCount);
+    }
+
     /**
      * Gets the long articles (articleType=6) for index display.
      *