Merge branch 'feat/in-folder-resume-button-in-library-top-b'

tuku/logic/reader.c

@@ -7,6 +7,8 @@
  *     之后走纯内存快路径（不再读配置）。
  * M7：阅读模式（翻页/条漫）与每册 last page 同为 meow_config 小键（reader.mode/page.<册标识>，
  *     册标识=规范化目录路径的 FNV-1a64）；书库行角标经 mr_cont_badge 读取同一份状态。
+ * M33：mr_cont_resume_page 给「进入目录后的顶栏续读按钮」做可用性判定与页码夹持
+ *     （保存页超出当前页数 → 钳到末页；空目录/无图片 → 无入口）。
  * 依赖面：只 include 配置/日志两个模块头（不含 UI）；宿主测试用
  * test/settings_reader_stub.c 顶替 meow_config_* 与 meow_log。
  */
@@ -182,3 +184,17 @@ int mr_cont_badge(const char *dir, char *out, int outsz)
     snprintf(out, (size_t)outsz, "续读 P%d", page + 1);
     return 1;
 }
+
+int mr_cont_resume_page(const char *dir, int pages)
+{
+    int page = mr_cont_get_page(dir, -1);
+    if (page < 0) return -1;
+    if (pages == 0) return -1;       /* 空目录/无图片：没有可续读的页 */
+    if (pages < 0) return page;      /* 页数未知（列表截断）：上界交给阅读器钳制 */
+    if (page >= pages) {
+        meow_log(MEOW_LOG_INFO, "reader: resume page %d beyond %d pages (%s), clamp to last",
+                 page + 1, pages, dir ? dir : "");
+        return pages - 1;
+    }
+    return page;
+}

tuku/logic/reader.h

@@ -48,6 +48,15 @@ void mr_cont_save(const char *dir, int page, int mode);
 /* 书库行续读角标：1=写入 "续读 P5"（page>0 才有记录）；0=无。 */
 int  mr_cont_badge(const char *dir, char *out, int outsz);
 
+/* 目录内「续读」入口的可用页（M33：按钮在**进入目录后**的顶栏，不在上层列表行）。
+ *   pages >  0：该目录当前图片页数；保存页 >= pages（文件被删/目录变短）→ 钳到 pages-1
+ *               并 INFO 日志注明，保证「续读」永远落在有效页；
+ *   pages == 0：空目录/无图片 → 恒 -1（入口不显示）；
+ *   pages <  0：页数未知（书库列表被 MR_LIB_SCAN_MAX 截断）→ 有记录就原样返回，
+ *               上界交给阅读器 open_book 的 mr_nav_clamp_page 钳制。
+ * 返回 -1 = 当前目录没有可用的续读记录（不显示入口）。 */
+int  mr_cont_resume_page(const char *dir, int pages);
+
 #ifdef __cplusplus
 }
 #endif

tuku/test/test_browse_ui_host.c

@@ -13,6 +13,9 @@
  *      不弹错误横幅；顶栏刷新/重扫可重试成功；
  *   U6 子目录不可读：停留原目录 + 顶部提示横幅；
  *   U7 书库不再碰缓存目录：CBZ 解压页缓存 mrpage_* 原样保留，且不写任何 bmp。
+ *   U8 目录内续读入口（M33）：顶栏「续读」只在当前所在目录有进度时出现（上层列表行
+ *      不加角标），动作数 3/2 随导航切换；点按从续读页打开当前目录；保存页超页数
+ *      钳到末页；空目录/无进度不显示；从阅读器返回后重新判定。
  *
  * 编译：见 test/run_tests.sh（链 SDK 源码树 + 打桩；只发布 meow_ui.a 的环境自动 SKIP）。
  * ui/library/library.c 以 -DMR_LIBRARY_UI_TEST_HOOKS 编译出测试接缝；logic/library.c
@@ -47,6 +50,16 @@ int         library_test_retry(void);
 int         library_test_go_up(void);
 int         library_test_drag_active(void);
 int         library_test_has_list(void);
+int         library_test_topbar_actions(void);
+int         library_test_resume_page(void);
+int         library_test_topbar_hit(int x, int y);
+
+/* 顶栏命中枚举（与 ui/library/library.c 的 LIB_TB_* 同值）。 */
+#define LIB_TB_NONE     0
+#define LIB_TB_BACK     1
+#define LIB_TB_RESUME   2
+#define LIB_TB_REFRESH  3
+#define LIB_TB_SETTINGS 4
 
 /* 阅读器入口打桩：记录被打开的册路径 / 起始页 / 按名定位的文件名（本测试不建 reader 页）。 */
 #define MR_READER_START_RESUME (-1)
@@ -416,6 +429,108 @@ int main(void)
               "library writes no bmp to cache (pages=%d thumbs=%d)", pages_after, thumbs_after);
     }
 
+    /* ---- U8：目录内续读入口（M33） ----
+     * 顶栏「续读」只在**已进入的目录本身**有阅读进度时出现（不在上层列表的文件夹行
+     * 加角标/按钮——用户明确要求「进入了该文件夹才有显示」）。点按 = 从续读页打开
+     * 当前目录；保存页超出当前图片数（文件被删）→ 钳到末页；空目录/无进度不显示。 */
+    const int tby = meow_ui_statusbar_height() + 28;
+    char empty_dir[MR_PATH_MAX];
+    joinp(empty_dir, sizeof empty_dir, root, "empty");
+    /* 顶栏宽 480、动作从右往左各 48px：设置最右 [422,470)、刷新 [374,422)、
+     * 续读（有进度时）[326,374)。 */
+    const int x_resume = 350, x_refresh = 395, x_settings = 440;
+
+    /* 根没有进度：只有刷新+设置两个动作，续读格不存在（不是置灰占位）。 */
+    CHECK(library_test_load(root) == 1, "U8 load root");
+    CHECK(library_test_topbar_actions() == 2, "no-progress dir has 2 actions (got %d)",
+          library_test_topbar_actions());
+    CHECK(library_test_resume_page() == -1, "no resume page without progress");
+    CHECK(library_test_topbar_hit(x_resume, tby) == LIB_TB_NONE,
+          "no resume hit cell when hidden");
+    CHECK(library_test_topbar_hit(x_refresh, tby) == LIB_TB_REFRESH,
+          "refresh cell intact without resume");
+    CHECK(library_test_topbar_hit(x_settings, tby) == LIB_TB_SETTINGS,
+          "settings cell intact without resume");
+
+    /* album 有 2 张图；写入进度 P2（page=1）后进入 → 3 个动作。 */
+    mr_cont_set_page(album_dir, 1);
+    CHECK(library_test_load(album_dir) == 1, "U8 load album");
+    CHECK(library_test_topbar_actions() == 3, "dir with progress has 3 actions (got %d)",
+          library_test_topbar_actions());
+    CHECK(library_test_resume_page() == 1, "resume page=%d (want 1)",
+          library_test_resume_page());
+    CHECK(library_test_topbar_hit(x_resume, tby) == LIB_TB_RESUME, "resume cell hits");
+    CHECK(library_test_topbar_hit(x_refresh, tby) == LIB_TB_REFRESH,
+          "refresh still hits with 3 actions");
+    CHECK(library_test_topbar_hit(x_settings, tby) == LIB_TB_SETTINGS,
+          "settings still hits with 3 actions");
+    CHECK(library_test_topbar_hit(20, tby) == LIB_TB_BACK, "back cell still hits");
+
+    /* 点续读 = 从当前目录的续读页打开（阅读器按自己的全量目录册再夹持一次）。 */
+    g_opened_n = 0;
+    g_opened[0] = '\0';
+    g_opened_name[0] = '\0';
+    g_opened_start = 12345;
+    library_on_tap(x_resume, tby);
+    CHECK(g_opened_n == 1 && strcmp(g_opened, album_dir) == 0,
+          "tap resume opens current dir (%s)", g_opened);
+    CHECK(g_opened_start == MR_READER_START_RESUME, "resume tap uses resume start (%d)",
+          g_opened_start);
+    CHECK(strcmp(library_test_dir(), album_dir) == 0, "resume tap does not navigate");
+
+    /* 顶栏刷新仍重扫当前目录（下拉/刷新后可见性保持）。 */
+    char extra[MR_PATH_MAX];
+    joinp(extra, sizeof extra, album_dir, "003.png");
+    touch_file(extra);
+    library_on_tap(x_refresh, tby);
+    CHECK(library_test_rows() == 3, "refresh rescans dir after resume (rows=%d)",
+          library_test_rows());
+    CHECK(library_test_topbar_actions() == 3, "resume survives refresh");
+    unlink(extra);
+
+    /* 返回上层：上层没有这层的进度 → 续读隐藏；再进入 → 重新出现。 */
+    CHECK(library_test_go_up() == 1 && strcmp(library_test_dir(), root) == 0, "up to root");
+    CHECK(library_test_topbar_actions() == 2, "resume hidden in parent without progress");
+    CHECK(library_test_topbar_hit(x_resume, tby) == LIB_TB_NONE, "resume cell gone in parent");
+    CHECK(library_test_load(album_dir) == 1, "re-enter album");
+    CHECK(library_test_topbar_actions() == 3, "resume back after re-enter");
+
+    /* 根也是目录：根有进度时同样显示（root.png 一页，page 0 是有效记录）。 */
+    mr_cont_set_page(root, 0);
+    CHECK(library_test_go_up() == 1 && strcmp(library_test_dir(), root) == 0, "up to root again");
+    CHECK(library_test_topbar_actions() == 3, "root shows resume when it has progress");
+    CHECK(library_test_resume_page() == 0, "root resume page=%d (want 0)",
+          library_test_resume_page());
+
+    /* 边界：保存页超出当前图片数（文件被删）→ 钳到末页（2 页 → 下标 1），仍显示。 */
+    mr_cont_set_page(album_dir, 99);
+    CHECK(library_test_load(album_dir) == 1, "load album with stale page");
+    CHECK(library_test_resume_page() == 1, "stale page clamps to last (got %d)",
+          library_test_resume_page());
+    CHECK(library_test_topbar_actions() == 3, "clamped resume still visible");
+
+    /* 空目录：即使有残留记录也不显示（没有可续读的页）。 */
+    mr_cont_set_page(empty_dir, 2);
+    CHECK(library_test_load(empty_dir) == 1, "load empty dir");
+    CHECK(library_test_resume_page() == -1, "empty dir has no resume entry");
+    CHECK(library_test_topbar_actions() == 2, "empty dir hides resume (got %d)",
+          library_test_topbar_actions());
+
+    /* 从阅读器返回后重判：Pictures 本来没有进度 → 2；阅读器离开时写入进度后，
+     * 走真实 view 生命周期（push reader → pop）→ library on_enter 重判为 3。 */
+    CHECK(library_test_load(pics_dir) == 1, "load Pictures without progress");
+    CHECK(library_test_topbar_actions() == 2, "Pictures initially 2 actions");
+    mr_cont_set_page(pics_dir, 2);            /* 模拟阅读器离开时刚写盘 */
+    meow_view *faux_reader = meow_view_create(ACT_READER, MEOW_VIEW_ACTIVITY, NULL, NULL);
+    meow_view_page_push(ACT_READER);
+    meow_view_page_pop();
+    CHECK(meow_ui_activity_active() == ACT_LIBRARY, "back on library after reader");
+    CHECK(library_test_topbar_actions() == 3, "resume appears after reader return (got %d)",
+          library_test_topbar_actions());
+    CHECK(library_test_resume_page() == 2, "resume page after return=%d",
+          library_test_resume_page());
+    meow_view_free(faux_reader);
+
     meow_view_free(lib);
     meow_ui_shutdown();
     rm_rf(data);

tuku/test/test_library.c

@@ -6,7 +6,9 @@
  *   T3 单层扫描：目录 + 受支持图片 + 档案册混排（目录优先、组内自然序）；
  *      其它普通文件/隐藏项/符号链接不列；副标题扫描期生成一次（无占位/无懒判定）；
  *      行类型；不可读路径 -> -1；max_depth 忽略；浏览根前缀判据 mr_path_within_root；
- *   T4 阅读方向状态（logic/reader.c）。
+ *   T4 阅读方向状态（logic/reader.c）；
+ *   T5 目录内续读入口的页码判定（mr_cont_resume_page）：无记录/空目录 -> 无入口，
+ *      页数未知（列表截断）不夹持，保存页超页数钳到末页，记录按目录隔离。
  *
  * 编译（在 tuku/ 下）：
  *   gcc -Wall -Wextra -O1 -I. -I../sdk test/test_library.c logic/library.c logic/reader.c \
@@ -15,6 +17,7 @@
  */
 #include "logic/library.h"
 #include "logic/reader.h"
+#include "test/settings_reader_stub.h"
 
 #include <dirent.h>
 #include <stdio.h>
@@ -272,6 +275,38 @@ static void test_direction(void)
     mr_reader_set_direction(MR_DIR_RTL);
 }
 
+/* 目录内「续读」入口的页码判定（M33）。 */
+static void test_cont_resume(void)
+{
+    const char *dir   = "/sdcard/album";
+    const char *other = "/sdcard/other";
+    mr_test_cfg_clear();
+
+    CHECK(mr_cont_resume_page(dir, 5) == -1, "no record -> no resume entry");
+
+    mr_cont_set_page(dir, 3);
+    CHECK(mr_cont_resume_page(dir, 5) == 3, "page in range kept");
+    CHECK(mr_cont_resume_page(dir, 4) == 3, "last valid page kept");
+    CHECK(mr_cont_resume_page(dir, 0) == -1, "empty dir -> no resume entry");
+    CHECK(mr_cont_resume_page(dir, -1) == 3,
+          "unknown page count (truncated list) -> unclamped");
+
+    CHECK(mr_cont_resume_page(dir, 3) == 2, "page == pages -> clamp to last");
+    mr_cont_set_page(dir, 99);
+    CHECK(mr_cont_resume_page(dir, 3) == 2, "page beyond pages -> clamp to last");
+    CHECK(mr_cont_resume_page(dir, 0) == -1, "stale record in empty dir -> no entry");
+
+    CHECK(mr_cont_resume_page(other, 9) == -1,
+          "resume records are per directory (no leak)");
+    CHECK(mr_cont_resume_page(NULL, 9) == -1, "NULL dir -> no entry");
+
+    /* 第一页也是有效记录（用户就停在第一页退出）：入口要显示。 */
+    mr_cont_set_page(dir, 0);
+    CHECK(mr_cont_resume_page(dir, 1) == 0, "first page record is a valid entry");
+
+    mr_test_cfg_clear();
+}
+
 int main(void)
 {
     test_natural();
@@ -279,6 +314,7 @@ int main(void)
     test_parent();
     test_scan();
     test_direction();
+    test_cont_resume();
     printf("%s: %d passed, %d failed\n", g_fail ? "FAIL" : "PASS", g_pass, g_fail);
     return g_fail ? 1 : 0;
 }

tuku/ui/library/library.c

@@ -1,6 +1,7 @@
 /* ui/library/library.c — 图库浏览页（ACT_LIBRARY）：文件管理器模型。
  *
- *   TopAppBar（标题 + 返回 + 刷新 + ⚙）+ meow_listview（src2 行数据源）。
+ *   TopAppBar（标题 + 返回 + [续读] + 刷新 + ⚙）+ meow_listview（src2 行数据源）；
+ *   [续读] 只在当前目录有阅读进度时出现（见下「目录内续读入口」）。
  *
  * 浏览语义（M18，用户要求「完全像文件管理器」）：
  *   - 列表 = 当前目录一层的「子目录 + 受支持图片 + .cbz/.zip 档案册」，目录优先、组内自然序；
@@ -14,6 +15,19 @@
  *   - 根目录不可访问（未插卡/挂载失败）→ 列表空态「未检测到 SD 卡」+ 顶栏刷新重试；
  *     重进本页也会自动重扫。子目录不可读 → 停留原目录 + 顶部提示横幅。
  *
+ * 目录内续读入口（M33，用户要求）：顶栏在**当前所在目录有阅读进度**时多一个「续读」动作
+ * （MEOW_ICON_PLAY_ARROW），点按 = mr_reader_open_dir_at(g_cur_dir, MR_READER_START_RESUME)
+ * 直接回到上次退出那页。定位是**进入该文件夹之后才有**——不在上层列表的目录行上加角标、
+ * 按钮或「目录自动当书」语义（M18 明确删掉的模型，勿 reintroduce）：上层列表仍然只是
+ * 文件管理器行，只有真进来了才知道这层有没有进度。
+ * 可见性随导航实时重判：load_dir（进入/返回/下拉刷新）与 library_page_enter（从阅读器返回，
+ * 进度可能刚被写入）都调 resume_refresh；根目录也是目录，有进度时同样显示。
+ * 顶栏动作是创建期固定的（SDK 无「动态隐藏 action」API），因此可见性变化时整条顶栏重建：
+ * 无进度时是真的 2 个动作（刷新/设置），没有空占位或死点击区；「续读」插在最左，
+ * 刷新/设置的下标与命中区不变。
+ * 边界：保存页超出当前目录图片数（文件被删）→ 钳到末页并 INFO 日志（mr_cont_resume_page）；
+ * 空目录/无图片/目录不可读 → 不显示入口。
+ *
  * 行绑定（src2 模式）：meow_listview_create(..., lib_src, ...) 每帧对可见行取一次行数据；
  * lib_src 只读 g_lib 内存（指针直出，不做 IO/格式化），滚动与点击路径零解码零文件访问。
  *
@@ -39,8 +53,11 @@ static meow_widget *g_tb;
 static meow_widget *g_lv;
 static meow_scroll *g_scroll;
 static int g_list_x, g_list_y, g_list_w, g_list_h;
+static int g_act_resume = -1;       /* 顶栏「续读」（-1=当前目录无进度，动作不存在） */
 static int g_act_refresh = -1;
 static int g_act_settings = -1;
+static int g_resume_on;             /* 1=当前目录有可用续读记录（顶栏 3 个动作） */
+static int g_resume_page = -1;      /* 「续读」将打开的页（已夹持；-1=无入口） */
 static int g_tb_back;               /* 顶栏返回箭头是否显示（根目录隐藏） */
 static int g_sd_missing;            /* 1=根目录不可访问（未检测到 SD 卡的空态） */
 
@@ -152,6 +169,57 @@ static void update_topbar(void)
     meow_topappbar_set_back(g_tb, g_tb_back);
 }
 
+/* 重建顶栏：动作集由 g_resume_on 决定（3=含续读 / 2=只有刷新+设置）。
+ * SDK 的 TopAppBar 动作是 add_action 创建期固定、没有隐藏/删除 API，所以用「重建」实现
+ * 真正的按需显示（不留空占位、不留 12px 死点击区，动作数就是 2 或 3）。
+ * 续读放最左：刷新/设置的下标仍是倒数第二/最后一个，命中区与改动前完全一致。 */
+static void topbar_build(void)
+{
+    int sb = meow_ui_statusbar_height();
+    if (g_tb) { meow_widget_free(g_tb); g_tb = NULL; }
+    g_act_resume = g_act_refresh = g_act_settings = -1;
+
+    g_tb = meow_topappbar_create(0, sb, meow_ui_width(), MR_TOPAPPBAR_H, "图库");
+    if (!g_tb) return;
+    if (g_resume_on) {
+        /* label "续读" 在被 set_item_icon 转位图后不绘制，但保留为该动作的语义名。 */
+        g_act_resume = meow_topappbar_add_action(g_tb, "续读");
+        if (g_act_resume >= 0)
+            meow_topappbar_set_item_icon(g_tb, g_act_resume, MEOW_ICON_PLAY_ARROW);
+    }
+    g_act_refresh = meow_topappbar_add_action(g_tb, "");
+    if (g_act_refresh >= 0) meow_topappbar_set_item_icon(g_tb, g_act_refresh, MEOW_ICON_REFRESH);
+    g_act_settings = meow_topappbar_add_action(g_tb, "");
+    if (g_act_settings >= 0) meow_topappbar_set_item_icon(g_tb, g_act_settings, MEOW_ICON_SETTINGS);
+    update_topbar();
+}
+
+/* 当前目录的图片页数（与阅读器目录册同一套单层判据：受支持图片、非隐藏、普通文件）。
+ * -1=列表被 MR_LIB_SCAN_MAX 截断 → 真实页数 >= 已列出数，未知；此时不做上界夹持，
+ * 交给阅读器 open_book（mr_nav_clamp_page）按它自己的全量枚举钳制。 */
+static int cur_page_count(void)
+{
+    if (g_lib.truncated) return -1;
+    int n = 0;
+    for (int i = 0; i < g_lib.count; i++)
+        if (g_lib.items[i].kind == MR_LIB_KIND_IMAGE) n++;
+    return n;
+}
+
+/* 重新判定「续读」入口（load_dir / 从阅读器返回 / 下拉刷新后都走这里）。
+ * 只在当前所在目录有可用续读时显示；无进度/空目录/无图片 → 隐藏（零占位）。 */
+static void resume_refresh(void)
+{
+    g_resume_page = mr_cont_resume_page(g_cur_dir, cur_page_count());
+    int on = (g_resume_page >= 0);
+    if (!g_tb || on != g_resume_on) {
+        g_resume_on = on;
+        topbar_build();
+    } else {
+        update_topbar();
+    }
+}
+
 static void list_invalidate(void)
 {
     meow_ui_invalidate(g_list_x, g_list_y, g_list_w, g_list_h);
@@ -221,7 +289,7 @@ static int load_dir(const char *dir)
             snprintf(g_cur_dir, sizeof g_cur_dir, "%s", target);
             g_sd_missing = 1;
             list_rebuild();
-            update_topbar();
+            resume_refresh();       /* SD 卡空态：无列表/无图片 → 续读入口隐藏 */
             repaint_all();
             meow_log(MEOW_LOG_INFO, "library: storage root unavailable: %s (errno=%d %s)",
                      target, errno, strerror(errno));
@@ -243,7 +311,7 @@ static int load_dir(const char *dir)
     g_sd_missing = 0;
 
     list_rebuild();
-    update_topbar();
+    resume_refresh();               /* 进入/返回/刷新都重判：当前目录有进度才显示续读 */
     g_drag = 0;
     g_dragged = 0;
     repaint_all();
@@ -312,6 +380,12 @@ void library_on_tap(int x, int y)
     if (g_tb) {
         int hit = meow_topappbar_hit(g_tb, x, y);
         if (hit == MEOW_TOPBAR_BACK) { library_go_up(); return; }
+        if (g_act_resume >= 0 && hit == g_act_resume) {
+            /* 一键回到本目录上次退出那页：续读页由阅读器按自己的全量目录册再夹持一次。 */
+            if (g_resume_page >= 0)
+                mr_reader_open_dir_at(g_cur_dir, MR_READER_START_RESUME);
+            return;
+        }
         if (g_act_refresh >= 0 && hit == g_act_refresh) { refresh_current(); return; }
         if (g_act_settings >= 0 && hit == g_act_settings) {
             meow_view_page_push(ACT_SETTINGS);
@@ -404,15 +478,9 @@ static void library_page_create(meow_view *v, void *ctx)
     (void)v;
     (void)ctx;
 
-    int w = meow_ui_width();
-    int sb = meow_ui_statusbar_height();
-    g_tb = meow_topappbar_create(0, sb, w, MR_TOPAPPBAR_H, "图库");
-    if (g_tb) {
-        g_act_refresh = meow_topappbar_add_action(g_tb, "");
-        if (g_act_refresh >= 0) meow_topappbar_set_item_icon(g_tb, g_act_refresh, MEOW_ICON_REFRESH);
-        g_act_settings = meow_topappbar_add_action(g_tb, "");
-        if (g_act_settings >= 0) meow_topappbar_set_item_icon(g_tb, g_act_settings, MEOW_ICON_SETTINGS);
-    }
+    /* 启动时还不知道根目录有没有进度：先按「无续读」建顶栏（2 个动作），
+     * load_dir 里的 resume_refresh 会按实际可见性决定是否补上「续读」动作。 */
+    topbar_build();
 
     hint_place();
     g_hint_id = meow_draw_custom_register(MEOW_Z_TOP, g_hint_x, g_hint_y,
@@ -446,7 +514,9 @@ static void library_page_enter(meow_view *v, void *ctx)
     g_dragged = 0;
     /* 无 SD 卡空态：重进页面即重扫（用户要求的可重试路径之一）。 */
     if (g_sd_missing) load_dir(g_cur_dir);
-    update_topbar();
+    /* 从阅读器/设置页返回：进度可能刚被阅读器写盘（离开阅读页时 cont_save_now），
+     * 因此每次进页都重判「续读」可见性（幂等；无变化时只刷新标题/返回箭头）。 */
+    resume_refresh();
     mr_nav_report();
     meow_ui_paint_full();
 }
@@ -468,7 +538,9 @@ static void library_page_destroy(meow_view *v, void *ctx)
     if (g_scroll) { meow_scroll_free(g_scroll); g_scroll = NULL; }
     if (g_lv) { meow_widget_free(g_lv); g_lv = NULL; }
     if (g_tb) { meow_widget_free(g_tb); g_tb = NULL; }
-    g_act_refresh = g_act_settings = -1;
+    g_act_resume = g_act_refresh = g_act_settings = -1;
+    g_resume_on = 0;
+    g_resume_page = -1;
     mr_library_free(&g_lib);
 }
 
@@ -549,6 +621,37 @@ int library_test_topbar_back(void)
     return g_tb_back;
 }
 
+/* 顶栏动作数：2=刷新+设置（当前目录无进度），3=再加上「续读」。 */
+int library_test_topbar_actions(void)
+{
+    return (g_act_resume >= 0 ? 1 : 0) + (g_act_refresh >= 0 ? 1 : 0) +
+           (g_act_settings >= 0 ? 1 : 0);
+}
+
+/* 「续读」将打开的页（已按当前页数夹持；-1=没有入口）。 */
+int library_test_resume_page(void)
+{
+    return g_resume_page;
+}
+
+/* 顶栏命中（走真实 meow_topappbar_hit）：0=无 1=返回 2=续读 3=刷新 4=设置。
+ * 用于断言三个动作的点击区互不遮挡、且无进度时续读区不存在。 */
+#define LIB_TB_NONE     0
+#define LIB_TB_BACK     1
+#define LIB_TB_RESUME   2
+#define LIB_TB_REFRESH  3
+#define LIB_TB_SETTINGS 4
+int library_test_topbar_hit(int x, int y)
+{
+    if (!g_tb) return LIB_TB_NONE;
+    int hit = meow_topappbar_hit(g_tb, x, y);
+    if (hit == MEOW_TOPBAR_BACK) return LIB_TB_BACK;
+    if (hit >= 0 && hit == g_act_resume) return LIB_TB_RESUME;
+    if (hit >= 0 && hit == g_act_refresh) return LIB_TB_REFRESH;
+    if (hit >= 0 && hit == g_act_settings) return LIB_TB_SETTINGS;
+    return LIB_TB_NONE;
+}
+
 /* 当前列表空态文案（无 SD 卡/空文件夹）。 */
 const char *library_test_empty_text(void)
 {