@jackwener/opencli 1.5.0 → 1.5.1

package/src/clis/v2ex/hot.yaml

@@ -3,7 +3,7 @@ name: hot
 description: V2EX 热门话题
 domain: www.v2ex.com
 strategy: public
-browser: false
+browser: true
 
 args:
   limit:
@@ -12,8 +12,22 @@ args:
     description: Number of topics
 
 pipeline:
-  - fetch:
-      url: https://www.v2ex.com/api/topics/hot.json
+  - navigate: https://www.v2ex.com/
+
+  - evaluate: |
+      (async () => {
+        const response = await fetch('/api/topics/hot.json', {
+          credentials: 'include',
+          headers: {
+            accept: 'application/json, text/plain, */*',
+            'x-requested-with': 'XMLHttpRequest',
+          },
+        });
+        if (!response.ok) {
+          throw new Error(`V2EX hot API request failed: ${response.status}`);
+        }
+        return await response.json();
+      })()
 
   - map:
       rank: ${{ index + 1 }}

package/src/clis/xiaohongshu/publish.test.ts

@@ -51,9 +51,10 @@ describe('xiaohongshu publish', () => {
     const page = createPageMock([
       'https://creator.xiaohongshu.com/publish/publish?from=menu_left',
       { ok: true, target: '上传图文', text: '上传图文' },
-      { hasTitleInput: true, hasImageInput: true, hasVideoSurface: false },
+      { state: 'editor_ready', hasTitleInput: true, hasImageInput: true, hasVideoSurface: false },
       { ok: true, count: 1 },
       false,
+      true, // waitForEditForm: editor appeared
       { ok: true, sel: 'input[maxlength="20"]' },
       { ok: true, sel: '[contenteditable="true"][class*="content"]' },
       true,
@@ -84,18 +85,23 @@ describe('xiaohongshu publish', () => {
     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: false, visibleTexts: ['上传视频', '上传图文'] },
-      { hasTitleInput: false, hasImageInput: false, hasVideoSurface: true },
-      { hasTitleInput: false, hasImageInput: false, hasVideoSurface: true },
-      { hasTitleInput: false, hasImageInput: false, hasVideoSurface: true },
-      { hasTitleInput: false, hasImageInput: false, hasVideoSurface: true },
+      { state: 'video_surface', hasTitleInput: false, hasImageInput: false, hasVideoSurface: true },
+      { state: 'video_surface', hasTitleInput: false, hasImageInput: false, hasVideoSurface: true },
+      { state: 'video_surface', hasTitleInput: false, hasImageInput: false, hasVideoSurface: true },
+      { state: 'video_surface', hasTitleInput: false, hasImageInput: false, hasVideoSurface: true },
     ]);
 
     await expect(cmd!.func!(page, {
       title: 'DeepSeek别乱问',
       content: '一篇真实一点的小红书正文',
+      images: imagePath,
       topics: '',
       draft: false,
     })).rejects.toThrow('Still on the video publish page after trying to select 图文');
@@ -107,11 +113,18 @@ describe('xiaohongshu publish', () => {
     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: '上传图文' },
-      { hasTitleInput: false, hasImageInput: false, hasVideoSurface: true },
-      { hasTitleInput: true, hasImageInput: true, hasVideoSurface: false },
+      { state: 'video_surface', hasTitleInput: false, hasImageInput: false, hasVideoSurface: true },
+      { state: 'editor_ready', hasTitleInput: true, hasImageInput: true, hasVideoSurface: false },
+      { ok: true, count: 1 }, // injectImages
+      false, // waitForUploads: no progress indicator
+      true, // waitForEditForm: editor appeared
       { ok: true, sel: 'input[maxlength="20"]' },
       { ok: true, sel: '[contenteditable="true"][class*="content"]' },
       true,
@@ -122,6 +135,7 @@ describe('xiaohongshu publish', () => {
     const result = await cmd!.func!(page, {
       title: '延迟切换也能过',
       content: '图文页切换慢一点也继续等',
+      images: imagePath,
       topics: '',
       draft: false,
     });
@@ -130,7 +144,7 @@ describe('xiaohongshu publish', () => {
     expect(result).toEqual([
       {
         status: '✅ 发布成功',
-        detail: '"延迟切换也能过" · 无图 · 发布成功',
+        detail: '"延迟切换也能过" · 1张图片 · 发布成功',
       },
     ]);
   });

package/src/clis/xiaohongshu/publish.ts

@@ -27,6 +27,22 @@ const MAX_IMAGES = 9;
 const MAX_TITLE_LEN = 20;
 const UPLOAD_SETTLE_MS = 3000;
 
+/** Selectors for the title field, ordered by priority (new UI first). */
+const TITLE_SELECTORS = [
+  // New creator center (2026-03) uses contenteditable for the title field.
+  // Placeholder observed: "填写标题会有更多赞哦"
+  '[contenteditable="true"][placeholder*="标题"]',
+  '[contenteditable="true"][placeholder*="赞"]',
+  '[contenteditable="true"][class*="title"]',
+  'input[maxlength="20"]',
+  'input[class*="title"]',
+  'input[placeholder*="标题"]',
+  'input[placeholder*="title" i]',
+  '.title-input input',
+  '.note-title input',
+  'input[maxlength]',
+];
+
 type ImagePayload = { name: string; mimeType: string; base64: string };
 
 /**
@@ -205,12 +221,19 @@ async function selectImageTextTab(
   return result;
 }
 
-async function inspectPublishSurface(
-  page: IPage,
-): Promise<{ hasTitleInput: boolean; hasImageInput: boolean; hasVideoSurface: boolean }> {
+type PublishSurfaceState = 'video_surface' | 'image_surface' | 'editor_ready';
+
+type PublishSurfaceInspection = {
+  state: PublishSurfaceState;
+  hasTitleInput: boolean;
+  hasImageInput: boolean;
+  hasVideoSurface: boolean;
+};
+
+async function inspectPublishSurfaceState(page: IPage): Promise<PublishSurfaceInspection> {
   return page.evaluate(`
     () => {
-      const text = (document.body?.innerText || '').replace(/\\s+/g, ' ').trim();
+      const text = (document.body?.innerText || '').replace(/\s+/g, ' ').trim();
       const hasTitleInput = !!Array.from(document.querySelectorAll('input, textarea')).find((el) => {
         if (!el || el.offsetParent === null) return false;
         const placeholder = (el.getAttribute('placeholder') || '').trim();
@@ -234,36 +257,57 @@ async function inspectPublishSurface(
           accept.includes('.webp')
         );
       });
-      return {
-        hasTitleInput,
-        hasImageInput,
-        hasVideoSurface: text.includes('拖拽视频到此处点击上传') || text.includes('上传视频'),
-      };
+      const hasVideoSurface = text.includes('拖拽视频到此处点击上传') || text.includes('上传视频');
+      const state = hasTitleInput ? 'editor_ready' : hasImageInput || !hasVideoSurface ? 'image_surface' : 'video_surface';
+      return { state, hasTitleInput, hasImageInput, hasVideoSurface };
     }
   `);
 }
 
-async function waitForImageTextSurface(
+async function waitForPublishSurfaceState(
   page: IPage,
   maxWaitMs = 5_000,
-): Promise<{ hasTitleInput: boolean; hasImageInput: boolean; hasVideoSurface: boolean }> {
+): Promise<PublishSurfaceInspection> {
   const pollMs = 500;
   const maxAttempts = Math.max(1, Math.ceil(maxWaitMs / pollMs));
-  let surface = await inspectPublishSurface(page);
+  let surface = await inspectPublishSurfaceState(page);
 
   for (let i = 0; i < maxAttempts; i++) {
-    if (surface.hasTitleInput || surface.hasImageInput || !surface.hasVideoSurface) {
+    if (surface.state !== 'video_surface') {
       return surface;
     }
     if (i < maxAttempts - 1) {
       await page.wait({ time: pollMs / 1_000 });
-      surface = await inspectPublishSurface(page);
+      surface = await inspectPublishSurfaceState(page);
     }
   }
 
   return surface;
 }
 
+/**
+ * Poll until the title/content editing form appears on the page.
+ * The new creator center UI only renders the editor after images are uploaded.
+ */
+async function waitForEditForm(page: IPage, maxWaitMs = 10_000): Promise<boolean> {
+  const pollMs = 1_000;
+  const maxAttempts = Math.ceil(maxWaitMs / pollMs);
+  for (let i = 0; i < maxAttempts; i++) {
+    const found: boolean = await page.evaluate(`
+      (() => {
+        const sels = ${JSON.stringify(TITLE_SELECTORS)};
+        for (const sel of sels) {
+          const el = document.querySelector(sel);
+          if (el && el.offsetParent !== null) return true;
+        }
+        return false;
+      })()`);
+    if (found) return true;
+    if (i < maxAttempts - 1) await page.wait({ time: pollMs / 1_000 });
+  }
+  return false;
+}
+
 cli({
   site: 'xiaohongshu',
   name: 'publish',
@@ -274,7 +318,7 @@ cli({
   args: [
     { name: 'title', required: true, help: '笔记标题 (最多20字)' },
     { name: 'content', required: true, positional: true, help: '笔记正文' },
-    { name: 'images', required: false, help: '图片路径，逗号分隔，最多9张 (jpg/png/gif/webp)' },
+    { name: 'images', required: true, help: '图片路径，逗号分隔，最多9张 (jpg/png/gif/webp)' },
     { name: 'topics', required: false, help: '话题标签，逗号分隔，不含 # 号' },
     { name: 'draft', type: 'bool', default: false, help: '保存为草稿，不直接发布' },
   ],
@@ -297,6 +341,8 @@ cli({
     if (title.length > MAX_TITLE_LEN)
       throw new Error(`Title is ${title.length} chars — must be ≤ ${MAX_TITLE_LEN}`);
     if (!content) throw new Error('Positional argument <content> is required');
+    if (imagePaths.length === 0)
+      throw new Error('At least one --images path is required. The creator center now requires images before showing the editor.');
     if (imagePaths.length > MAX_IMAGES)
       throw new Error(`Too many images: ${imagePaths.length} (max ${MAX_IMAGES})`);
 
@@ -318,8 +364,8 @@ cli({
 
     // ── Step 2: Select 图文 (image+text) note type if tabs are present ─────────
     const tabResult = await selectImageTextTab(page);
-    const surface = await waitForImageTextSurface(page, tabResult?.ok ? 5_000 : 2_000);
-    if (!surface.hasTitleInput && !surface.hasImageInput && surface.hasVideoSurface) {
+    const surface = await waitForPublishSurfaceState(page, tabResult?.ok ? 5_000 : 2_000);
+    if (surface.state === 'video_surface') {
       await page.screenshot({ path: '/tmp/xhs_publish_tab_debug.png' });
       const detail = tabResult?.ok
         ? `clicked "${tabResult.text}"`
@@ -331,35 +377,30 @@ cli({
     }
 
     // ── Step 3: Upload images ──────────────────────────────────────────────────
-    if (imageData.length > 0) {
-      const upload = await injectImages(page, imageData);
-      if (!upload.ok) {
-        await page.screenshot({ path: '/tmp/xhs_publish_upload_debug.png' });
-        throw new Error(
-          `Image injection failed: ${upload.error ?? 'unknown'}. ` +
-          'Debug screenshot: /tmp/xhs_publish_upload_debug.png'
-        );
-      }
-      // Allow XHS to process and upload images to its CDN
-      await page.wait({ time: UPLOAD_SETTLE_MS / 1_000 });
-      await waitForUploads(page);
+    const upload = await injectImages(page, imageData);
+    if (!upload.ok) {
+      await page.screenshot({ path: '/tmp/xhs_publish_upload_debug.png' });
+      throw new Error(
+        `Image injection failed: ${upload.error ?? 'unknown'}. ` +
+        'Debug screenshot: /tmp/xhs_publish_upload_debug.png'
+      );
+    }
+    // Allow XHS to process and upload images to its CDN
+    await page.wait({ time: UPLOAD_SETTLE_MS / 1_000 });
+    await waitForUploads(page);
+
+    // ── Step 3b: Wait for editor form to render ───────────────────────────────
+    const formReady = await waitForEditForm(page);
+    if (!formReady) {
+      await page.screenshot({ path: '/tmp/xhs_publish_form_debug.png' });
+      throw new Error(
+        'Editing form did not appear after image upload. The page layout may have changed. ' +
+        'Debug screenshot: /tmp/xhs_publish_form_debug.png'
+      );
     }
 
     // ── Step 4: Fill title ─────────────────────────────────────────────────────
-    await fillField(
-      page,
-      [
-        'input[maxlength="20"]',
-        'input[class*="title"]',
-        'input[placeholder*="标题"]',
-        'input[placeholder*="title" i]',
-        '.title-input input',
-        '.note-title input',
-        'input[maxlength]',
-      ],
-      title,
-      'title'
-    );
+    await fillField(page, TITLE_SELECTORS, title, 'title');
     await page.wait({ time: 0.5 });
 
     // ── Step 5: Fill content / body ────────────────────────────────────────────
@@ -374,7 +415,7 @@ cli({
         '.note-content [contenteditable="true"]',
         '.editor-content [contenteditable="true"]',
         // Broad fallback — last resort; filter out any title contenteditable
-        '[contenteditable="true"]:not([placeholder*="标题"]):not([placeholder*="title" i])',
+        '[contenteditable="true"]:not([placeholder*="标题"]):not([placeholder*="赞"]):not([placeholder*="title" i])',
       ],
       content,
       'content'
@@ -438,14 +479,14 @@ cli({
     }
 
     // ── Step 7: Publish or save draft ─────────────────────────────────────────
-    const actionLabel = isDraft ? '存草稿' : '发布';
+    const actionLabels = isDraft ? ['暂存离开', '存草稿'] : ['发布', '发布笔记'];
     const btnClicked: boolean = await page.evaluate(`
-      (label => {
+      (labels => {
         const buttons = document.querySelectorAll('button, [role="button"]');
         for (const btn of buttons) {
           const text = (btn.innerText || btn.textContent || '').trim();
           if (
-            (text === label || text.includes(label) || text === '发布笔记') &&
+            labels.some(l => text === l || text.includes(l)) &&
             btn.offsetParent !== null &&
             !btn.disabled
           ) {
@@ -454,13 +495,13 @@ cli({
           }
         }
         return false;
-      })(${JSON.stringify(actionLabel)})
+      })(${JSON.stringify(actionLabels)})
     `);
 
     if (!btnClicked) {
       await page.screenshot({ path: '/tmp/xhs_publish_submit_debug.png' });
       throw new Error(
-        `Could not find "${actionLabel}" button. ` +
+        `Could not find "${actionLabels[0]}" button. ` +
         'Debug screenshot: /tmp/xhs_publish_submit_debug.png'
       );
     }
@@ -475,7 +516,7 @@ cli({
           const text = (el.innerText || '').trim();
           if (
             el.children.length === 0 &&
-            (text.includes('发布成功') || text.includes('草稿已保存') || text.includes('上传成功'))
+            (text.includes('发布成功') || text.includes('草稿已保存') || text.includes('暂存成功') || text.includes('上传成功'))
           ) return text;
         }
         return '';
@@ -484,14 +525,14 @@ cli({
 
     const navigatedAway = !finalUrl.includes('/publish/publish');
     const isSuccess = successMsg.length > 0 || navigatedAway;
-    const verb = isDraft ? '草稿已保存' : '发布成功';
+    const verb = isDraft ? '暂存成功' : '发布成功';
 
     return [
       {
         status: isSuccess ? `✅ ${verb}` : '⚠️ 操作完成，请在浏览器中确认',
         detail: [
           `"${title}"`,
-          imageData.length ? `${imageData.length}张图片` : '无图',
+          `${imageData.length}张图片`,
           topics.length ? `话题: ${topics.join(' ')}` : '',
           successMsg || finalUrl || '',
         ]

package/src/clis/xiaohongshu/search.test.ts

@@ -1,7 +1,7 @@
 import { describe, expect, it, vi } from 'vitest';
 import type { IPage } from '../../types.js';
 import { getRegistry } from '../../registry.js';
-import './search.js';
+import { noteIdToDate } from './search.js';
 
 function createPageMock(evaluateResults: any[]): IPage {
   const evaluate = vi.fn();
@@ -86,6 +86,7 @@ describe('xiaohongshu search', () => {
         title: '某鱼买FSD被坑了4万',
         author: '随风',
         likes: '261',
+        published_at: '2025-10-10',
         url: detailUrl,
         author_url: authorUrl,
       },
@@ -132,3 +133,40 @@ describe('xiaohongshu search', () => {
     expect(result[0]).toMatchObject({ rank: 1, title: 'Result A' });
   });
 });
+
+describe('noteIdToDate (ObjectID timestamp parsing)', () => {
+  it('parses a known note ID to the correct China-timezone date', () => {
+    // 0x697f6c74 = 1769958516 → 2026-02-01 in UTC+8
+    expect(noteIdToDate('https://www.xiaohongshu.com/search_result/697f6c74000000002103de17')).toBe('2026-02-01');
+    // 0x68e90be8 → 2025-10-10 in UTC+8
+    expect(noteIdToDate('https://www.xiaohongshu.com/explore/68e90be80000000004022e66')).toBe('2025-10-10');
+  });
+
+  it('returns China date when UTC+8 crosses into the next day', () => {
+    // 0x69b739f0 = 2026-03-15 23:00 UTC = 2026-03-16 07:00 CST
+    // Without UTC+8 offset this would incorrectly return 2026-03-15
+    expect(noteIdToDate('https://www.xiaohongshu.com/search_result/69b739f00000000000000000')).toBe('2026-03-16');
+  });
+
+  it('handles /note/ path variant', () => {
+    expect(noteIdToDate('https://www.xiaohongshu.com/note/697f6c74000000002103de17')).toBe('2026-02-01');
+  });
+
+  it('handles URL with query parameters', () => {
+    expect(noteIdToDate('https://www.xiaohongshu.com/search_result/697f6c74000000002103de17?xsec_token=abc')).toBe('2026-02-01');
+  });
+
+  it('returns empty string for non-matching URLs', () => {
+    expect(noteIdToDate('https://www.xiaohongshu.com/user/profile/635a9c720000000018028b40')).toBe('');
+    expect(noteIdToDate('https://www.xiaohongshu.com/')).toBe('');
+  });
+
+  it('returns empty string for IDs shorter than 24 hex chars', () => {
+    expect(noteIdToDate('https://www.xiaohongshu.com/search_result/abcdef')).toBe('');
+  });
+
+  it('returns empty string when timestamp is out of range', () => {
+    // All zeros → ts = 0
+    expect(noteIdToDate('https://www.xiaohongshu.com/search_result/000000000000000000000000')).toBe('');
+  });
+});

package/src/clis/xiaohongshu/search.ts

@@ -9,6 +9,23 @@
 import { cli, Strategy } from '../../registry.js';
 import { AuthRequiredError } from '../../errors.js';
 
+/**
+ * Extract approximate publish date from a Xiaohongshu note URL.
+ * XHS note IDs follow MongoDB ObjectID format where the first 8 hex
+ * characters encode a Unix timestamp (the moment the ID was generated,
+ * which closely matches publish time but is not an official API field).
+ * e.g. "697f6c74..." → 0x697f6c74 = 1769958516 → 2026-02-01
+ */
+export function noteIdToDate(url: string): string {
+  const match = url.match(/\/(?:search_result|explore|note)\/([0-9a-f]{24})(?=[?#/]|$)/i);
+  if (!match) return '';
+  const hex = match[1].substring(0, 8);
+  const ts = parseInt(hex, 16);
+  if (!ts || ts < 1_000_000_000 || ts > 4_000_000_000) return '';
+  // Offset by UTC+8 (China Standard Time) so the date matches what XHS users see
+  return new Date((ts + 8 * 3600) * 1000).toISOString().slice(0, 10);
+}
+
 cli({
   site: 'xiaohongshu',
   name: 'search',
@@ -19,7 +36,7 @@ cli({
     { name: 'query', required: true, positional: true, help: 'Search keyword' },
     { name: 'limit', type: 'int', default: 20, help: 'Number of results' },
   ],
-  columns: ['rank', 'title', 'author', 'likes', 'url'],
+  columns: ['rank', 'title', 'author', 'likes', 'published_at', 'url'],
   func: async (page, kwargs) => {
     const keyword = encodeURIComponent(kwargs.query);
     await page.goto(
@@ -97,6 +114,7 @@ cli({
       .map((item: any, i: number) => ({
         rank: i + 1,
         ...item,
+        published_at: noteIdToDate(item.url),
       }));
   },
 });

package/src/discovery.ts

@@ -127,24 +127,20 @@ async function discoverClisFromFs(dir: string): Promise<void> {
       const site = entry.name;
       const siteDir = path.join(dir, site);
       const files = await fs.promises.readdir(siteDir);
-      const filePromises: Promise<unknown>[] = [];
-      for (const file of files) {
+      await Promise.all(files.map(async (file) => {
         const filePath = path.join(siteDir, file);
         if (file.endsWith('.yaml') || file.endsWith('.yml')) {
-          filePromises.push(registerYamlCli(filePath, site));
+          await registerYamlCli(filePath, site);
         } else if (
           (file.endsWith('.js') && !file.endsWith('.d.js')) ||
           (file.endsWith('.ts') && !file.endsWith('.d.ts') && !file.endsWith('.test.ts'))
         ) {
-          if (!(await isCliModule(filePath))) continue;
-          filePromises.push(
-            import(pathToFileURL(filePath).href).catch((err) => {
-              log.warn(`Failed to load module ${filePath}: ${getErrorMessage(err)}`);
-            })
-          );
+          if (!(await isCliModule(filePath))) return;
+          await import(pathToFileURL(filePath).href).catch((err) => {
+            log.warn(`Failed to load module ${filePath}: ${getErrorMessage(err)}`);
+          });
         }
-      }
-      await Promise.all(filePromises);
+      }));
     });
   await Promise.all(sitePromises);
 }
@@ -195,10 +191,11 @@ async function registerYamlCli(filePath: string, defaultSite: string): Promise<v
 export async function discoverPlugins(): Promise<void> {
   try { await fs.promises.access(PLUGINS_DIR); } catch { return; }
   const entries = await fs.promises.readdir(PLUGINS_DIR, { withFileTypes: true });
-  for (const entry of entries) {
-    if (!entry.isDirectory()) continue;
-    await discoverPluginDir(path.join(PLUGINS_DIR, entry.name), entry.name);
-  }
+  await Promise.all(entries.map(async (entry) => {
+    const pluginDir = path.join(PLUGINS_DIR, entry.name);
+    if (!(await isDiscoverablePluginDir(entry, pluginDir))) return;
+    await discoverPluginDir(pluginDir, entry.name);
+  }));
 }
 
 /**
@@ -208,33 +205,29 @@ export async function discoverPlugins(): Promise<void> {
 async function discoverPluginDir(dir: string, site: string): Promise<void> {
   const files = await fs.promises.readdir(dir);
   const fileSet = new Set(files);
-  const promises: Promise<unknown>[] = [];
-  for (const file of files) {
+  await Promise.all(files.map(async (file) => {
     const filePath = path.join(dir, file);
     if (file.endsWith('.yaml') || file.endsWith('.yml')) {
-      promises.push(registerYamlCli(filePath, site));
+      await registerYamlCli(filePath, site);
     } else if (file.endsWith('.js') && !file.endsWith('.d.js')) {
-      if (!(await isCliModule(filePath))) continue;
-      promises.push(
-        import(pathToFileURL(filePath).href).catch((err) => {
-          log.warn(`Plugin ${site}/${file}: ${getErrorMessage(err)}`);
-        })
-      );
+      if (!(await isCliModule(filePath))) return;
+      await import(pathToFileURL(filePath).href).catch((err) => {
+        log.warn(`Plugin ${site}/${file}: ${getErrorMessage(err)}`);
+      });
     } else if (
       file.endsWith('.ts') && !file.endsWith('.d.ts') && !file.endsWith('.test.ts')
     ) {
-      // Skip .ts if a compiled .js sibling exists (production mode can't load .ts)
       const jsFile = file.replace(/\.ts$/, '.js');
-      if (fileSet.has(jsFile)) continue;
-      if (!(await isCliModule(filePath))) continue;
-      promises.push(
-        import(pathToFileURL(filePath).href).catch((err) => {
-          log.warn(`Plugin ${site}/${file}: ${getErrorMessage(err)}`);
-        })
+      // Prefer compiled .js — skip the .ts source file
+      if (fileSet.has(jsFile)) return;
+      // No compiled .js found — cannot import raw .ts in production Node.js.
+      // This typically means esbuild transpilation failed during plugin install.
+      log.warn(
+        `Plugin ${site}/${file}: no compiled .js found. ` +
+        `Run "opencli plugin update ${site}" to re-transpile, or install esbuild.`
       );
     }
-  }
-  await Promise.all(promises);
+  }));
 }
 
 async function isCliModule(filePath: string): Promise<boolean> {
@@ -246,3 +239,18 @@ async function isCliModule(filePath: string): Promise<boolean> {
     return false;
   }
 }
+
+async function isDiscoverablePluginDir(entry: fs.Dirent, pluginDir: string): Promise<boolean> {
+  if (entry.isDirectory()) return true;
+  if (!entry.isSymbolicLink()) return false;
+
+  try {
+    return (await fs.promises.stat(pluginDir)).isDirectory();
+  } catch (err) {
+    const code = (err as NodeJS.ErrnoException).code;
+    if (code !== 'ENOENT' && code !== 'ENOTDIR') {
+      log.warn(`Failed to inspect plugin link ${pluginDir}: ${getErrorMessage(err)}`);
+    }
+    return false;
+  }
+}

package/src/doctor.ts

@@ -1,5 +1,5 @@
 /**
- * opencli doctor — diagnose and fix browser connectivity.
+ * opencli doctor — diagnose browser connectivity.
  *
  * Simplified for the daemon-based architecture. No more token management,
  * MCP path discovery, or config file scanning.
@@ -14,7 +14,6 @@ import { getErrorMessage } from './errors.js';
 import { getRuntimeLabel } from './runtime-detect.js';
 
 export type DoctorOptions = {
-  fix?: boolean;
   yes?: boolean;
   live?: boolean;
   sessions?: boolean;
@@ -87,7 +86,7 @@ export async function runBrowserDoctor(opts: DoctorOptions = {}): Promise<Doctor
     issues.push(
       'Daemon is running but the Chrome extension is not connected.\n' +
       'Please install the opencli Browser Bridge extension:\n' +
-      '  1. Download from GitHub Releases\n' +
+      '  1. Download from https://github.com/jackwener/opencli/releases\n' +
       '  2. Open chrome://extensions/ → Enable Developer Mode\n' +
       '  3. Click "Load unpacked" → select the extension folder',
     );