@jackwener/opencli 1.7.22 → 1.8.0

package/clis/xiaohongshu/publish.test.js

@@ -76,8 +76,10 @@ describe('xiaohongshu publish', () => {
                     ? { ok: true, sel: '[contenteditable="true"][placeholder*="标题"]', kind: 'contenteditable', actual: '标题走原生输入' }
                     : { ok: true, sel: '[contenteditable="true"][class*="content"]', kind: 'contenteditable', actual: '正文也走原生输入' };
             }
+            if (code.includes('xhs-publish-btn'))
+                return { ok: true, via: 'click', text: '发布' };
             if (code.includes('labels.some'))
-                return true;
+                return false;
             if (code.includes('for (const el of document.querySelectorAll'))
                 return '发布成功';
             throw new Error(`Unhandled evaluate call: ${code.slice(0, 120)}`);
@@ -128,8 +130,10 @@ describe('xiaohongshu publish', () => {
                 return { ok: false, actual: '' };
             if (code.includes('(function(selectors, text)'))
                 return { ok: true, sel: '[contenteditable="true"][placeholder*="标题"]', kind: 'contenteditable', actual: '' };
+            if (code.includes('xhs-publish-btn'))
+                return { ok: true, via: 'click', text: '发布' };
             if (code.includes('labels.some'))
-                return true;
+                return false;
             if (code.includes('for (const el of document.querySelectorAll'))
                 return '发布成功';
             throw new Error(`Unhandled evaluate call: ${code.slice(0, 120)}`);
@@ -177,8 +181,10 @@ describe('xiaohongshu publish', () => {
                     ? { ok: true, actual: '原生失败后回退' }
                     : { ok: true, actual: '正文也回退' };
             }
+            if (code.includes('xhs-publish-btn'))
+                return { ok: true, via: 'click', text: '发布' };
             if (code.includes('labels.some'))
-                return true;
+                return false;
             if (code.includes('for (const el of document.querySelectorAll'))
                 return '发布成功';
             throw new Error(`Unhandled evaluate call: ${code.slice(0, 120)}`);
@@ -227,8 +233,10 @@ describe('xiaohongshu publish', () => {
                 return code.includes('input[maxlength')
                     ? { ok: false, actual: '' }
                     : { ok: true, actual: '正文' };
+            if (code.includes('xhs-publish-btn'))
+                return { ok: true, via: 'click', text: '发布' };
             if (code.includes('labels.some'))
-                return true;
+                return false;
             if (code.includes('for (const el of document.querySelectorAll'))
                 return '发布成功';
             throw new Error(`Unhandled evaluate call: ${code.slice(0, 120)}`);
@@ -259,7 +267,7 @@ describe('xiaohongshu publish', () => {
             { ok: true, actual: 'CDP上传优先' },
             { ok: true, sel: '[contenteditable="true"][class*="content"]', kind: 'contenteditable' },
             { ok: true, actual: '优先走 setFileInput 主路径' },
-            true,
+            { ok: true, via: 'click', text: '发布' },
             'https://creator.xiaohongshu.com/publish/success',
             '发布成功',
         ], {
@@ -301,7 +309,7 @@ describe('xiaohongshu publish', () => {
             { ok: true, actual: 'CDP被拒后回退' },
             { ok: true, sel: '[contenteditable="true"][class*="content"]', kind: 'contenteditable' },
             { ok: true, actual: 'DataTransfer fallback path' },
-            true,
+            { ok: true, via: 'click', text: '发布' },
             'https://creator.xiaohongshu.com/publish/success',
             '发布成功',
         ], {
@@ -366,7 +374,7 @@ describe('xiaohongshu publish', () => {
             { ok: true, actual: 'DeepSeek别乱问' },
             { ok: true, sel: '[contenteditable="true"][class*="content"]', kind: 'contenteditable' },
             { ok: true, actual: '一篇真实一点的小红书正文' },
-            true,
+            { ok: true, via: 'click', text: '发布' },
             'https://creator.xiaohongshu.com/publish/success',
             '发布成功',
         ]);
@@ -390,6 +398,49 @@ describe('xiaohongshu publish', () => {
             },
         ]);
     });
+    it('uses the shadow-DOM method-invoke path when xhs-publish-btn handler succeeds', async () => {
+        // Mirrors the previous "selects the image-text tab and publishes successfully"
+        // mock sequence but returns `via: 'method', name: '_onPublish'` for the publish
+        // trigger evaluate, exercising the shadow-DOM web-component handler path
+        // (the primary #1606 fix). Without this case the fix's main path is uncovered.
+        const cmd = getRegistry().get('xiaohongshu/publish');
+        expect(cmd?.func).toBeTypeOf('function');
+        const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'opencli-xhs-publish-'));
+        const imagePath = path.join(tempDir, 'demo.jpg');
+        fs.writeFileSync(imagePath, Buffer.from([0xff, 0xd8, 0xff, 0xd9]));
+        const page = createPageMock([
+            'https://creator.xiaohongshu.com/publish/publish?from=menu_left',
+            { ok: true, target: '上传图文', text: '上传图文' },
+            { state: 'editor_ready', hasTitleInput: true, hasImageInput: true, hasVideoSurface: false },
+            { ok: true, count: 1 },
+            false,
+            true, // waitForEditForm: editor appeared
+            { ok: true, sel: 'input[maxlength="20"]', kind: 'input' },
+            { ok: true, actual: 'shadow-dom-test' },
+            { ok: true, sel: '[contenteditable="true"][class*="content"]', kind: 'contenteditable' },
+            { ok: true, actual: '走 method-invoke 路径' },
+            { ok: true, via: 'method', name: '_onPublish' }, // shadow-DOM handler success
+            'https://creator.xiaohongshu.com/publish/success',
+            '发布成功',
+        ]);
+        const result = await cmd.func(page, {
+            title: 'shadow-dom-test',
+            content: '走 method-invoke 路径',
+            images: imagePath,
+            topics: '',
+            draft: false,
+        });
+        expect(result).toEqual([
+            {
+                status: '✅ 发布成功',
+                detail: '"shadow-dom-test" · 1张图片 · 发布成功',
+            },
+        ]);
+        // The publish-trigger evaluate must have been the shadow-DOM probe (contains
+        // 'xhs-publish-btn'), not the legacy `button.click()` fallback alone.
+        const evaluateCalls = page.evaluate.mock.calls.map((args) => String(args[0]));
+        expect(evaluateCalls.some((code) => code.includes('xhs-publish-btn'))).toBe(true);
+    });
     it('fails early with a clear error when still on the video page', async () => {
         const cmd = getRegistry().get('xiaohongshu/publish');
         expect(cmd?.func).toBeTypeOf('function');
@@ -431,7 +482,7 @@ describe('xiaohongshu publish', () => {
             { ok: true, actual: '延迟切换也能过' },
             { ok: true, sel: '[contenteditable="true"][class*="content"]', kind: 'contenteditable' },
             { ok: true, actual: '图文页切换慢一点也继续等' },
-            true,
+            { ok: true, via: 'click', text: '发布' },
             'https://creator.xiaohongshu.com/publish/success',
             '发布成功',
         ]);
@@ -479,8 +530,10 @@ describe('xiaohongshu publish', () => {
                     ? { ok: true, actual: '停留在发布页也算成功' }
                     : { ok: true, actual: '草稿成功提示' };
             }
+            if (code.includes('xhs-publish-btn'))
+                return { ok: true, via: 'click', text: '发布' };
             if (code.includes('labels.some'))
-                return true;
+                return false;
             if (code.includes('for (const el of document.querySelectorAll')) {
                 return code.includes('保存成功') ? '保存成功' : '';
             }
@@ -529,8 +582,10 @@ describe('xiaohongshu publish', () => {
                     ? { ok: true, actual: '发布提示不该复用草稿成功' }
                     : { ok: true, actual: '发布成功提示' };
             }
+            if (code.includes('xhs-publish-btn'))
+                return { ok: true, via: 'click', text: '发布' };
             if (code.includes('labels.some'))
-                return true;
+                return false;
             if (code.includes('for (const el of document.querySelectorAll')) {
                 return code.includes('保存成功') ? '保存成功' : '';
             }

package/clis/xiaohongshu/user-helpers.test.js

@@ -1,4 +1,6 @@
 import { describe, expect, it } from 'vitest';
+import { CommandExecutionError } from '@jackwener/opencli/errors';
+import { assertReadableUserSnapshot } from './user.js';
 import { buildXhsNoteUrl, extractXhsUserNotes, flattenXhsNoteGroups, normalizeXhsUserId, } from './user-helpers.js';
 describe('normalizeXhsUserId', () => {
     it('extracts the profile id from a full Xiaohongshu URL', () => {
@@ -117,3 +119,42 @@ describe('extractXhsUserNotes', () => {
         expect(rows[0]?.url).toBe('https://www.rednote.com/user/profile/user-red/note-red?xsec_token=tok&xsec_source=pc_user');
     });
 });
+
+describe('assertReadableUserSnapshot', () => {
+    it('accepts an explicit empty notes array from a readable user store', () => {
+        expect(() => assertReadableUserSnapshot({
+            storePresent: true,
+            notesPresent: true,
+            pageDataPresent: false,
+            noteGroups: [],
+            pageData: {},
+        })).not.toThrow();
+    });
+    it('fails typed when the user store is missing instead of treating parser drift as empty', () => {
+        expect(() => assertReadableUserSnapshot({
+            storePresent: false,
+            notesPresent: false,
+            pageDataPresent: false,
+            noteGroups: [],
+            pageData: {},
+        })).toThrow(CommandExecutionError);
+    });
+    it('fails typed when profile metadata exists but the notes array is missing', () => {
+        expect(() => assertReadableUserSnapshot({
+            storePresent: true,
+            notesPresent: false,
+            pageDataPresent: true,
+            noteGroups: [],
+            pageData: { user: { nickname: 'Alice' } },
+        })).toThrow(CommandExecutionError);
+    });
+    it('fails typed when notesPresent metadata and cloned noteGroups disagree', () => {
+        expect(() => assertReadableUserSnapshot({
+            storePresent: true,
+            notesPresent: true,
+            pageDataPresent: false,
+            noteGroups: null,
+            pageData: {},
+        })).toThrow(CommandExecutionError);
+    });
+});

package/clis/xiaohongshu/user.js

@@ -1,4 +1,5 @@
 import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
 import { extractXhsUserNotes, normalizeXhsUserId } from './user-helpers.js';
 /**
  * Host-agnostic IIFE that snapshots the user profile's Pinia store. Exported
@@ -14,16 +15,33 @@ export const USER_SNAPSHOT_JS = `
         }
       };
 
-      const userStore = window.__INITIAL_STATE__?.user || {};
+      const userStore = window.__INITIAL_STATE__?.user;
+      const hasUserStore = Boolean(userStore && typeof userStore === 'object');
+      const rawNotes = hasUserStore ? (userStore.notes?._value || userStore.notes) : undefined;
+      const rawPageData = hasUserStore ? (userStore.userPageData?._value || userStore.userPageData) : undefined;
       return {
-        noteGroups: safeClone(userStore.notes?._value || userStore.notes || []),
-        pageData: safeClone(userStore.userPageData?._value || userStore.userPageData || {}),
+        noteGroups: safeClone(rawNotes || []),
+        pageData: safeClone(rawPageData || {}),
+        storePresent: hasUserStore,
+        notesPresent: Array.isArray(rawNotes),
+        pageDataPresent: Boolean(rawPageData && typeof rawPageData === 'object' && Object.keys(rawPageData).length > 0),
       };
     })()
   `;
 async function readUserSnapshot(page) {
     return await page.evaluate(USER_SNAPSHOT_JS);
 }
+export function assertReadableUserSnapshot(snapshot) {
+    if (!snapshot || typeof snapshot !== 'object' || Array.isArray(snapshot)) {
+        throw new CommandExecutionError('Malformed Xiaohongshu user snapshot');
+    }
+    if (snapshot.storePresent !== true) {
+        throw new CommandExecutionError('Malformed Xiaohongshu user snapshot: user store was not found');
+    }
+    if (snapshot.notesPresent !== true || !Array.isArray(snapshot.noteGroups)) {
+        throw new CommandExecutionError('Malformed Xiaohongshu user snapshot: notes array was not found');
+    }
+}
 export const command = cli({
     site: 'xiaohongshu',
     name: 'user',
@@ -43,12 +61,14 @@ export const command = cli({
         const limit = Math.max(1, Number(kwargs.limit ?? 15));
         await page.goto(`https://www.xiaohongshu.com/user/profile/${userId}`);
         let snapshot = await readUserSnapshot(page);
+        assertReadableUserSnapshot(snapshot);
         let results = extractXhsUserNotes(snapshot ?? {}, userId);
         let previousCount = results.length;
         for (let i = 0; results.length < limit && i < 4; i += 1) {
             await page.autoScroll({ times: 1, delayMs: 1500 });
             await page.wait(1);
             snapshot = await readUserSnapshot(page);
+            assertReadableUserSnapshot(snapshot);
             const nextResults = extractXhsUserNotes(snapshot ?? {}, userId);
             if (nextResults.length <= previousCount)
                 break;
@@ -56,7 +76,10 @@ export const command = cli({
             previousCount = nextResults.length;
         }
         if (results.length === 0) {
-            throw new Error('No public notes found for this Xiaohongshu user.');
+            // 与 bilibili subtitle 同模式：作者无公开内容是合法 empty 数据条件
+            // （销号 / 私密号 / 全删笔记），不是 fetch 失败。下游应识别 code
+            // EMPTY_RESULT 跳过 rate-limit 启发式、不计入 softFail 阈值。
+            throw new EmptyResultError('xiaohongshu user', '该用户没有公开笔记（可能销号 / 私密 / 全部删除）。');
         }
         return results.slice(0, limit);
     },

package/clis/xiaoyuzhou/download.js

@@ -45,7 +45,7 @@ cli({
         });
         return [{
                 title,
-                podcast: ep.podcast?.title || '-',
+                podcast: ep.podcast?.title || '',
                 status: result.success ? 'success' : 'failed',
                 size: result.success ? formatBytes(result.size) : (result.error || 'unknown error'),
                 file: result.success ? destPath : '-',

package/clis/xiaoyuzhou/transcript.js

@@ -67,7 +67,7 @@ cli({
         }
         return [{
                 title: episode.title || 'episode',
-                podcast: episode.podcast?.title || '-',
+                podcast: episode.podcast?.title || '',
                 status: 'success',
                 segments: kwargs.text === false ? '-' : String(segmentCount),
                 json_file: kwargs.json === false ? '-' : jsonPath,

package/clis/youdao/note.js

@@ -0,0 +1,258 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { ArgumentError, AuthRequiredError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
+
+const ALLOWED_HOSTS = new Set([
+  'share.note.youdao.com',
+  'note.youdao.com',
+  'share.note.youdao.cn',
+  'note.youdao.cn',
+]);
+
+function unwrapEvaluateResult(payload) {
+  if (payload && !Array.isArray(payload) && typeof payload === 'object' && 'session' in payload && 'data' in payload) {
+    return payload.data;
+  }
+  return payload;
+}
+
+function normalizeShareUrl(raw) {
+  const value = String(raw ?? '').trim();
+  if (!value) {
+    throw new ArgumentError('youdao note url cannot be empty', 'Pass a full public share URL from Youdao Notes.');
+  }
+  let parsed;
+  try {
+    parsed = new URL(value);
+  } catch {
+    throw new ArgumentError('Invalid Youdao Note URL', 'Example: https://share.note.youdao.com/ynoteshare/index.html?id=...&type=note');
+  }
+  if (parsed.protocol !== 'https:' && parsed.protocol !== 'http:') {
+    throw new ArgumentError('Youdao Note URL must use http or https');
+  }
+  if (!ALLOWED_HOSTS.has(parsed.hostname)) {
+    throw new ArgumentError('Youdao Note URL must be under note.youdao.com or note.youdao.cn');
+  }
+  if (!parsed.searchParams.get('id')) {
+    throw new ArgumentError('Youdao Note URL must include an id query parameter');
+  }
+  const type = parsed.searchParams.get('type');
+  if (type && type !== 'note') {
+    throw new ArgumentError('youdao note only accepts shared note URLs', 'Shared notebooks are not implemented yet.');
+  }
+  return parsed.toString();
+}
+
+function formatYoudaoTimestamp(value) {
+  if (value == null || value === '') return '';
+  const numeric = Number(value);
+  if (!Number.isFinite(numeric) || numeric <= 0) return String(value);
+  const millis = numeric < 10_000_000_000 ? numeric * 1000 : numeric;
+  const date = new Date(millis);
+  if (Number.isNaN(date.getTime())) return String(value);
+  return date.toISOString();
+}
+
+function buildExtractorJs() {
+  const walkTextFn = `
+    function walkText(node, out) {
+      if (!node || typeof node !== 'object') return;
+      if (Array.isArray(node)) {
+        for (var i = 0; i < node.length; i += 1) walkText(node[i], out);
+        return;
+      }
+      if (typeof node[8] === 'string') {
+        var text = node[8].replace(/\\s+/g, ' ').trim();
+        if (text) out.push(text);
+      }
+      var keys = Object.keys(node);
+      for (var j = 0; j < keys.length; j += 1) {
+        var value = node[keys[j]];
+        if (value && typeof value === 'object') walkText(value, out);
+      }
+    }
+  `;
+  return `
+    (function() {
+      ${walkTextFn}
+      function cleanText(value) {
+        return String(value || '').replace(/\\u00a0/g, ' ').replace(/[ \\t]+\\n/g, '\\n').replace(/\\n{3,}/g, '\\n\\n').trim();
+      }
+      function pageText() {
+        return cleanText((document.body && (document.body.innerText || document.body.textContent)) || '').slice(0, 1000);
+      }
+      function classifyBodyText(text) {
+        if (/登录|登陆|请先登录|无权|权限|访问受限|验证码|安全验证|login|forbidden|permission/i.test(text)) return 'auth';
+        if (/分享已取消|分享不存在|文件不存在|笔记不存在|页面不存在|已过期|不存在|not found|404/i.test(text)) return 'not_found';
+        return '';
+      }
+      function findStoreState(value, depth, seen) {
+        if (!value || typeof value !== 'object' || depth > 10) return null;
+        if (seen.indexOf(value) !== -1) return null;
+        seen.push(value);
+        if (value.storeState && typeof value.storeState === 'object') return value.storeState;
+        if (value.content && value.content.data && typeof value.content.data === 'object') return value;
+        var keys = Object.keys(value);
+        for (var i = 0; i < keys.length; i += 1) {
+          var found = findStoreState(value[keys[i]], depth + 1, seen);
+          if (found) return found;
+        }
+        return null;
+      }
+      function findStoreFromFiber(fiber) {
+        var cursor = fiber;
+        var stack = [];
+        while (cursor || stack.length) {
+          if (!cursor) {
+            cursor = stack.pop();
+            continue;
+          }
+          var fromState = findStoreState(cursor.memoizedState, 0, []);
+          if (fromState) return fromState;
+          var fromProps = findStoreState(cursor.memoizedProps, 0, []);
+          if (fromProps) return fromProps;
+          if (cursor.sibling) stack.push(cursor.sibling);
+          cursor = cursor.child;
+        }
+        return null;
+      }
+      var root = document.querySelector('#root');
+      var body = pageText();
+      var bodyKind = classifyBodyText(body);
+      if (!root) {
+        return [false, bodyKind || 'root_missing', body];
+      }
+      var reactKey = Object.keys(root).find(function(key) { return key.indexOf('__reactContainer$') === 0; });
+      var fiber = (root._reactRootContainer && root._reactRootContainer._internalRoot && root._reactRootContainer._internalRoot.current)
+        || (reactKey ? root[reactKey] : null);
+      if (!fiber) {
+        return [false, bodyKind || 'react_root_missing', body];
+      }
+      var store = findStoreFromFiber(fiber);
+      if (!store) {
+        return [false, bodyKind || 'store_missing', body];
+      }
+      var contentData = store.content && store.content.data;
+      if (!contentData || typeof contentData !== 'object') {
+        return [false, bodyKind || 'content_data_missing', body];
+      }
+      var title = cleanText(contentData.tl || document.querySelector('.file-name')?.textContent || document.title || '');
+      var hasContentField = Object.prototype.hasOwnProperty.call(contentData, 'content');
+      var rawContent = hasContentField ? String(contentData.content || '') : '';
+      var content = '';
+      if (rawContent) {
+        try {
+          var parsed = JSON.parse(rawContent);
+          var parts = [];
+          walkText(parsed, parts);
+          content = cleanText(parts.join('\\n'));
+        } catch (error) {
+          content = cleanText(rawContent);
+        }
+      }
+      var summary = '';
+      var keywords = [];
+      var ai = store.aiSummary;
+      if (ai && ai.aiSummary) {
+        try {
+          var aiPayload = JSON.parse(ai.aiSummary);
+          summary = cleanText(aiPayload.description || '');
+          if (Array.isArray(aiPayload.keywords)) {
+            for (var i = 0; i < aiPayload.keywords.length; i += 1) {
+              var keyword = aiPayload.keywords[i];
+              if (keyword && keyword.title) keywords.push(cleanText(((keyword.emoji || '') + ' ' + keyword.title).trim()));
+            }
+          }
+        } catch {}
+      }
+      return [true, title, content, summary, keywords.join(' | '), contentData.ct || null, contentData.sz || null, hasContentField, rawContent.length, window.location.href];
+    })()
+  `;
+}
+
+function normalizeExtractionResult(payload, sourceUrl) {
+  const data = unwrapEvaluateResult(payload);
+  if (!Array.isArray(data)) {
+    throw new CommandExecutionError('Youdao note extractor returned a malformed payload');
+  }
+  const ok = data[0] === true;
+  if (!ok) {
+    const reason = typeof data[1] === 'string' && data[1].trim() ? data[1].trim() : 'unknown_parser_failure';
+    if (reason === 'auth') {
+      throw new AuthRequiredError('note.youdao.com', 'Youdao shared note requires login or additional permission');
+    }
+    if (reason === 'not_found') {
+      throw new EmptyResultError('youdao note', 'The shared note is missing, expired, cancelled, or inaccessible.');
+    }
+    throw new CommandExecutionError(`Youdao note parser failed: ${reason}`);
+  }
+  const title = String(data[1] ?? '');
+  const content = String(data[2] ?? '');
+  const summary = String(data[3] ?? '');
+  const keywords = String(data[4] ?? '');
+  const createTime = data[5];
+  const fileSize = data[6];
+  const hasContentField = data[7] === true;
+  const rawContentLength = Number(data[8] ?? 0);
+  const finalUrl = String(data[9] || sourceUrl);
+  if (!title) {
+    throw new CommandExecutionError('Youdao note parser did not extract a title');
+  }
+  if (!hasContentField) {
+    throw new CommandExecutionError('Youdao note parser did not find full note content in the page store');
+  }
+  if (rawContentLength > 0 && !content) {
+    throw new CommandExecutionError('Youdao note parser found note content but extracted no readable text');
+  }
+  const row = {};
+  row.title = title;
+  row.content = content;
+  row.summary = summary;
+  row.keywords = keywords;
+  row.created_at = formatYoudaoTimestamp(createTime);
+  row.file_size = fileSize == null ? '' : String(fileSize);
+  row.url = finalUrl;
+  return row;
+}
+
+var command = cli({
+  site: 'youdao',
+  name: 'note',
+  access: 'read',
+  description: 'Read a public shared Youdao Note',
+  domain: 'share.note.youdao.com',
+  strategy: Strategy.PUBLIC,
+  browser: true,
+  args: [
+    { name: 'url', positional: true, required: true, help: 'Full share URL of the Youdao Note' },
+  ],
+  columns: ['title', 'content', 'summary', 'keywords', 'created_at', 'file_size', 'url'],
+  func: async function(page, kwargs) {
+    const url = normalizeShareUrl(kwargs.url);
+    try {
+      await page.goto(url);
+    } catch (error) {
+      throw new CommandExecutionError(`Failed to open Youdao Note URL: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    try {
+      await page.wait({ selector: '#root, .file-name, body', timeout: 10 });
+    } catch {
+      await page.wait(3).catch(function() {});
+    }
+    await page.wait(2).catch(function() {});
+    let payload;
+    try {
+      payload = await page.evaluate(buildExtractorJs());
+    } catch (error) {
+      throw new CommandExecutionError(`Youdao note extractor failed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return [normalizeExtractionResult(payload, url)];
+  },
+});
+
+export var __test__ = {
+  buildExtractorJs: buildExtractorJs,
+  command: command,
+  formatYoudaoTimestamp: formatYoudaoTimestamp,
+  normalizeExtractionResult: normalizeExtractionResult,
+  normalizeShareUrl: normalizeShareUrl,
+};

package/clis/youdao/note.test.js

@@ -0,0 +1,99 @@
+import { describe, it, expect, vi } from 'vitest';
+import { ArgumentError, AuthRequiredError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
+
+const { __test__ } = await import('./note.js');
+const command = __test__.command;
+
+function makePage(evaluatePayload) {
+  return {
+    goto: vi.fn().mockResolvedValue(undefined),
+    wait: vi.fn().mockResolvedValue(undefined),
+    evaluate: vi.fn().mockResolvedValue(evaluatePayload),
+  };
+}
+
+describe('youdao note', () => {
+  it('registers as a public browser read command', () => {
+    expect(command).toBeDefined();
+    expect(command.site).toBe('youdao');
+    expect(command.name).toBe('note');
+    expect(command.access).toBe('read');
+    expect(command.browser).toBe(true);
+    expect(command.strategy).toBe('public');
+    expect(command.domain).toBe('share.note.youdao.com');
+    expect(command.columns).toEqual(['title', 'content', 'summary', 'keywords', 'created_at', 'file_size', 'url']);
+  });
+
+  it('strictly validates share URL before navigation', async () => {
+    const page = makePage({});
+    await expect(command.func(page, { url: '' })).rejects.toBeInstanceOf(ArgumentError);
+    await expect(command.func(page, { url: 'https://share.note.youdao.com.evil/ynoteshare/index.html?id=1&type=note' })).rejects.toBeInstanceOf(ArgumentError);
+    await expect(command.func(page, { url: 'javascript:alert(1)' })).rejects.toBeInstanceOf(ArgumentError);
+    await expect(command.func(page, { url: 'https://share.note.youdao.com/ynoteshare/index.html?type=note' })).rejects.toBeInstanceOf(ArgumentError);
+    await expect(command.func(page, { url: 'https://share.note.youdao.com/ynoteshare/index.html?id=1&type=notebook' })).rejects.toBeInstanceOf(ArgumentError);
+    expect(page.goto).not.toHaveBeenCalled();
+  });
+
+  it('accepts canonical youdao share URLs', () => {
+    expect(__test__.normalizeShareUrl('https://share.note.youdao.com/ynoteshare/index.html?id=abc&type=note#/')).toBe('https://share.note.youdao.com/ynoteshare/index.html?id=abc&type=note#/');
+    expect(__test__.normalizeShareUrl('https://note.youdao.cn/ynoteshare/index.html?id=abc')).toBe('https://note.youdao.cn/ynoteshare/index.html?id=abc');
+  });
+
+  it('unwraps Browser Bridge envelopes and returns full note rows', async () => {
+    const page = makePage({
+      session: 'site:youdao:test',
+      data: [true, 'Expert call', 'Question\nAnswer', 'Short summary', 'PCB | ABF', 1715750400000, 1234, true, 42, 'https://share.note.youdao.com/ynoteshare/index.html?id=abc&type=note#/'],
+    });
+    await expect(command.func(page, { url: 'https://share.note.youdao.com/ynoteshare/index.html?id=abc&type=note#/' }))
+      .resolves.toEqual([{
+        title: 'Expert call',
+        content: 'Question\nAnswer',
+        summary: 'Short summary',
+        keywords: 'PCB | ABF',
+        created_at: '2024-05-15T05:20:00.000Z',
+        file_size: '1234',
+        url: 'https://share.note.youdao.com/ynoteshare/index.html?id=abc&type=note#/',
+      }]);
+  });
+
+  it('maps missing or expired shares to EmptyResultError', async () => {
+    const page = makePage([false, 'not_found']);
+    await expect(command.func(page, { url: 'https://share.note.youdao.com/ynoteshare/index.html?id=missing&type=note' }))
+      .rejects.toBeInstanceOf(EmptyResultError);
+  });
+
+  it('maps permission/login pages to AuthRequiredError', async () => {
+    const page = makePage([false, 'auth']);
+    await expect(command.func(page, { url: 'https://share.note.youdao.com/ynoteshare/index.html?id=private&type=note' }))
+      .rejects.toBeInstanceOf(AuthRequiredError);
+  });
+
+  it('treats parser drift as CommandExecutionError instead of an empty success row', async () => {
+    await expect(command.func(makePage([false, 'store_missing']), { url: 'https://share.note.youdao.com/ynoteshare/index.html?id=abc&type=note' }))
+      .rejects.toBeInstanceOf(CommandExecutionError);
+    await expect(command.func(makePage([true, 'Only title', '', '', '', null, null, false, 0, '']), { url: 'https://share.note.youdao.com/ynoteshare/index.html?id=abc&type=note' }))
+      .rejects.toBeInstanceOf(CommandExecutionError);
+    await expect(command.func(makePage([true, 'Bad body', '', '', '', null, null, true, 100, '']), { url: 'https://share.note.youdao.com/ynoteshare/index.html?id=abc&type=note' }))
+      .rejects.toBeInstanceOf(CommandExecutionError);
+  });
+
+  it('wraps navigation and evaluate failures as CommandExecutionError', async () => {
+    const navPage = makePage({});
+    navPage.goto.mockRejectedValueOnce(new Error('network down'));
+    await expect(command.func(navPage, { url: 'https://share.note.youdao.com/ynoteshare/index.html?id=abc&type=note' }))
+      .rejects.toBeInstanceOf(CommandExecutionError);
+
+    const evalPage = makePage({});
+    evalPage.evaluate.mockRejectedValueOnce(new Error('bad script'));
+    await expect(command.func(evalPage, { url: 'https://share.note.youdao.com/ynoteshare/index.html?id=abc&type=note' }))
+      .rejects.toBeInstanceOf(CommandExecutionError);
+  });
+
+  it('keeps the full-content React store extractor contract in source', () => {
+    const js = __test__.buildExtractorJs();
+    expect(js).toContain('store.content');
+    expect(js).toContain('contentData.content');
+    expect(js).toContain('__reactContainer$');
+    expect(js).toContain('walkText');
+  });
+});