Add single task debug mode

tasks/dailyTrending.js

@@ -18,6 +18,7 @@ const {
   waitForElements,
   getPageInfo,
 } = require(path.join(__dirname, '..', 'utils', 'page'));
+const { runDebugSteps } = require(path.join(__dirname, '..', 'utils', 'debugSteps'));
 
 const PROJECT_CARD_SELECTORS = [
   '.hot-selection .recommend-card',
@@ -32,44 +33,91 @@ const PROJECT_CARD_SELECTORS = [
  * 执行查看热门任务
  * @param {import('playwright').Page} page - 主页面
  */
-async function dailyTrending(page) {
+async function dailyTrending(page, options = {}) {
   logger.info('👉 执行查看热门');
 
-  // 从主页面找到"查看热门"任务卡片
-  const tasks = await page.locator('.novice-task-item-box').all();
-  const trendingTask = await findTaskByTitle(tasks, '查看热门');
+  const ctx = {
+    page,
+    trendingTask: null,
+    trendingPage: null,
+    cards: [],
+    detailPage: null,
+  };
 
-  if (!trendingTask) {
-    throw new Error('未找到"查看热门"任务卡片');
-  }
-
-  // ── 第一步：打开热门页面 ──
-  const trendingPage = await openNewPage(
-    page.context(),
-    () => trendingTask.locator('.toComplete').click()
-  );
+  const steps = [
+    {
+      name: '查找查看热门任务卡片',
+      page: (state) => state.page,
+      run: async (state) => {
+        const tasks = await state.page.locator('.novice-task-item-box').all();
+        state.trendingTask = await findTaskByTitle(tasks, '查看热门');
+        if (!state.trendingTask) {
+          throw new Error('未找到"查看热门"任务卡片');
+        }
+      },
+      inspect: async (state) => ({
+        taskCardCount: await state.page.locator('.novice-task-item-box').count(),
+        titleLabelCount: await state.page.locator('.task-card-title__label-text').count(),
+        toCompleteCount: await state.page.locator('.toComplete').count(),
+      }),
+    },
+    {
+      name: '点击去完成并打开热门页',
+      page: (state) => state.page,
+      run: async (state) => {
+        state.trendingPage = await openNewPage(
+          state.page.context(),
+          () => state.trendingTask.locator('.toComplete').click()
+        );
+        state.currentPage = state.trendingPage;
+      },
+      inspect: async (state) => ({
+        taskToCompleteVisible: await state.trendingTask.locator('.toComplete').isVisible().catch(() => false),
+      }),
+    },
+    {
+      name: '查找热门项目卡片',
+      page: (state) => state.trendingPage,
+      run: async (state) => {
+        state.cards = await findProjectCards(state.trendingPage);
+      },
+      inspect: async (state) => ({
+        hotSelectionCount: await state.trendingPage.locator('.hot-selection').count(),
+        recommendCardCount: await state.trendingPage.locator('a.recommend-card').count(),
+        sourceModuleLinkCount: await state.trendingPage.locator('a[href*="source_module"]').count(),
+        allLinkCount: await state.trendingPage.locator('a[href]').count(),
+      }),
+    },
+    {
+      name: '打开第一个热门项目详情页',
+      page: (state) => state.trendingPage,
+      run: async (state) => {
+        state.detailPage = await openLinkPage(
+          state.trendingPage.context(),
+          state.cards[0],
+          { label: '热门项目详情页' }
+        );
+        state.currentPage = state.detailPage;
+      },
+      inspect: async (state) => ({
+        cardCount: state.cards.length,
+      }),
+    },
+    {
+      name: '等待热门项目详情页加载',
+      page: (state) => state.detailPage,
+      run: async (state) => {
+        await waitPageReady(state.detailPage);
+        logger.info('热门项目详情页已打开');
+      },
+    },
+  ];
 
   try {
-    const cards = await findProjectCards(trendingPage);
-
-    // ── 第二步：点击第一个热门项目，打开详情页 ──
-    const firstCard = cards[0];
-
-    const detailPage = await openLinkPage(
-      trendingPage.context(),
-      firstCard,
-      { label: '热门项目详情页' }
-    );
-
-    try {
-      // 等待详情页加载
-      await waitPageReady(detailPage);
-      logger.info('热门项目详情页已打开');
-    } finally {
-      await safeClose(detailPage);
-    }
+    await runDebugSteps('查看热门', steps, ctx, options);
   } finally {
-    await safeClose(trendingPage);
+    await safeClose(ctx.detailPage);
+    await safeClose(ctx.trendingPage);
   }
 }