@jackwener/opencli 1.3.3 → 1.4.0

package/dist/record.js

@@ -17,7 +17,8 @@ import * as readline from 'node:readline';
 import chalk from 'chalk';
 import yaml from 'js-yaml';
 import { sendCommand } from './browser/daemon-client.js';
-import { VOLATILE_PARAMS, SEARCH_PARAMS, PAGINATION_PARAMS, FIELD_ROLES, } from './constants.js';
+import { SEARCH_PARAMS, PAGINATION_PARAMS, FIELD_ROLES } from './constants.js';
+import { urlToPattern, findArrayPath, inferCapabilityName, inferStrategy, detectAuthFromContent, classifyQueryParams, } from './analysis.js';
 // ── Interceptor JS ─────────────────────────────────────────────────────────
 /**
  * Generates a full-capture interceptor that stores {url, method, status, body}
@@ -110,92 +111,6 @@ function generateReadRecordedJs() {
   `;
 }
 // ── Analysis helpers ───────────────────────────────────────────────────────
-function urlToPattern(url) {
-    try {
-        const p = new URL(url);
-        const pathNorm = p.pathname
-            .replace(/\/\d+/g, '/{id}')
-            .replace(/\/[0-9a-fA-F]{8,}/g, '/{hex}')
-            .replace(/\/BV[a-zA-Z0-9]{10}/g, '/{bvid}');
-        const params = [];
-        p.searchParams.forEach((_v, k) => { if (!VOLATILE_PARAMS.has(k))
-            params.push(k); });
-        return `${p.host}${pathNorm}${params.length ? '?' + params.sort().map(k => `${k}={}`).join('&') : ''}`;
-    }
-    catch {
-        return url;
-    }
-}
-function detectAuthIndicators(url, body) {
-    const indicators = [];
-    // Heuristic: if body contains sign/w_rid fields, it's likely signed
-    if (body && typeof body === 'object') {
-        const keys = Object.keys(body).map(k => k.toLowerCase());
-        if (keys.some(k => k.includes('sign') || k === 'w_rid' || k.includes('token'))) {
-            indicators.push('signature');
-        }
-    }
-    // Check URL for common auth patterns
-    if (url.includes('/wbi/') || url.includes('w_rid='))
-        indicators.push('signature');
-    if (url.includes('bearer') || url.includes('access_token'))
-        indicators.push('bearer');
-    return indicators;
-}
-function findArrayPath(obj, depth = 0) {
-    if (depth > 5 || !obj || typeof obj !== 'object')
-        return null;
-    if (Array.isArray(obj)) {
-        if (obj.length >= 2 && obj.some(i => i && typeof i === 'object' && !Array.isArray(i))) {
-            return { path: '', items: obj };
-        }
-        return null;
-    }
-    let best = null;
-    for (const [key, val] of Object.entries(obj)) {
-        const found = findArrayPath(val, depth + 1);
-        if (found) {
-            const fullPath = found.path ? `${key}.${found.path}` : key;
-            const candidate = { path: fullPath, items: found.items };
-            if (!best || candidate.items.length > best.items.length)
-                best = candidate;
-        }
-    }
-    return best;
-}
-function inferCapabilityName(url) {
-    const u = url.toLowerCase();
-    if (u.includes('hot') || u.includes('popular') || u.includes('ranking') || u.includes('trending'))
-        return 'hot';
-    if (u.includes('search'))
-        return 'search';
-    if (u.includes('feed') || u.includes('timeline') || u.includes('dynamic'))
-        return 'feed';
-    if (u.includes('comment') || u.includes('reply'))
-        return 'comments';
-    if (u.includes('history'))
-        return 'history';
-    if (u.includes('profile') || u.includes('me'))
-        return 'me';
-    if (u.includes('favorite') || u.includes('collect') || u.includes('bookmark'))
-        return 'favorite';
-    try {
-        const segs = new URL(url).pathname
-            .split('/')
-            .filter(s => s && !s.match(/^\d+$/) && !s.match(/^[0-9a-f]{8,}$/i) && !s.match(/^v\d+$/));
-        if (segs.length)
-            return segs[segs.length - 1].replace(/[^a-z0-9]/gi, '_').toLowerCase();
-    }
-    catch { }
-    return 'data';
-}
-function inferStrategy(authIndicators) {
-    if (authIndicators.includes('signature'))
-        return 'intercept';
-    if (authIndicators.includes('bearer') || authIndicators.includes('csrf'))
-        return 'header';
-    return 'cookie';
-}
 function scoreRequest(req, arrayResult) {
     let s = 0;
     if (arrayResult) {
@@ -247,14 +162,7 @@ function buildRecordedYaml(site, pageUrl, req, capName, arrayResult, authIndicat
             ? ''
             : itemPath.split('.').map(p => `?.${p}`).join('');
     // Detect search/limit/page params (must be before fetch URL building to use hasSearch/hasPage)
-    const qp = [];
-    try {
-        new URL(req.url).searchParams.forEach((_v, k) => { if (!VOLATILE_PARAMS.has(k))
-            qp.push(k); });
-    }
-    catch { }
-    const hasSearch = qp.some(p => SEARCH_PARAMS.has(p));
-    const hasPage = qp.some(p => PAGINATION_PARAMS.has(p));
+    const { hasSearch, hasPagination: hasPage } = classifyQueryParams(req.url);
     // Build evaluate script
     const mapLines = Object.entries(detectedFields)
         .map(([role, field]) => `          ${role}: item?.${field}`)
@@ -363,10 +271,9 @@ export async function recordSession(opts) {
         let stopped = false;
         const stop = () => { stopped = true; };
         const { promise: enterPromise, cleanup: cleanupEnter } = waitForEnter();
-        const enterRace = enterPromise.then(stop);
+        enterPromise.then(stop);
         const timeoutPromise = new Promise(r => setTimeout(() => {
             stop();
-            cleanupEnter(); // close readline to prevent process from hanging
             r();
         }, timeoutMs));
         // Poll loop: drain captured data + inject interceptor into any new tabs
@@ -394,6 +301,7 @@ export async function recordSession(opts) {
             }
         }, pollMs);
         await Promise.race([enterPromise, timeoutPromise]);
+        cleanupEnter(); // Always clean up readline to prevent process from hanging
         clearInterval(pollInterval);
         // Final drain from all known tabs
         for (const tabId of injectedTabs) {
@@ -476,7 +384,7 @@ function analyzeAndWrite(site, pageUrl, requests, outDir) {
     const scored = [];
     for (const [pattern, req] of seen) {
         const arrayResult = findArrayPath(req.body);
-        const authIndicators = detectAuthIndicators(req.url, req.body);
+        const authIndicators = detectAuthFromContent(req.url, req.body);
         const score = scoreRequest(req, arrayResult);
         if (score > 0) {
             scored.push({ req, pattern, arrayResult, authIndicators, score });

package/dist/registry-api.d.ts

@@ -9,3 +9,5 @@
 export { cli, Strategy, getRegistry, fullName, registerCommand } from './registry.js';
 export type { CliCommand, Arg, CliOptions } from './registry.js';
 export type { IPage } from './types.js';
+export { onStartup, onBeforeExecute, onAfterExecute } from './hooks.js';
+export type { HookFn, HookContext, HookName } from './hooks.js';

package/dist/registry-api.js

@@ -7,3 +7,4 @@
  * plugins are dynamically imported during discoverPlugins().
  */
 export { cli, Strategy, getRegistry, fullName, registerCommand } from './registry.js';
+export { onStartup, onBeforeExecute, onAfterExecute } from './hooks.js';

package/dist/registry.d.ts

@@ -18,6 +18,10 @@ export interface Arg {
     help?: string;
     choices?: string[];
 }
+export interface RequiredEnv {
+    name: string;
+    help?: string;
+}
 export type CommandArgs = Record<string, any>;
 export interface CliCommand {
     site: string;
@@ -34,6 +38,7 @@ export interface CliCommand {
     /** Origin of this command: 'yaml', 'ts', or plugin name. */
     source?: string;
     footerExtra?: (kwargs: CommandArgs) => string | undefined;
+    requiredEnv?: RequiredEnv[];
     /**
      * Control pre-navigation for cookie/header context before command execution.
      *
@@ -65,5 +70,3 @@ export declare function getRegistry(): Map<string, CliCommand>;
 export declare function fullName(cmd: CliCommand): string;
 export declare function strategyLabel(cmd: CliCommand): string;
 export declare function registerCommand(cmd: CliCommand): void;
-export { serializeArg, serializeCommand, formatArgSummary, formatRegistryHelpText } from './serialization.js';
-export type { SerializedArg } from './serialization.js';

package/dist/registry.js

@@ -26,6 +26,7 @@ export function cli(opts) {
         pipeline: opts.pipeline,
         timeoutSeconds: opts.timeoutSeconds,
         footerExtra: opts.footerExtra,
+        requiredEnv: opts.requiredEnv,
         navigateBefore: opts.navigateBefore,
     };
     const key = fullName(cmd);
@@ -44,5 +45,3 @@ export function strategyLabel(cmd) {
 export function registerCommand(cmd) {
     _registry.set(fullName(cmd), cmd);
 }
-// Re-export serialization helpers from their dedicated module
-export { serializeArg, serializeCommand, formatArgSummary, formatRegistryHelpText } from './serialization.js';

package/dist/runtime.d.ts

@@ -7,7 +7,6 @@ export declare function getBrowserFactory(): new () => IBrowserFactory;
 export declare const DEFAULT_BROWSER_CONNECT_TIMEOUT: number;
 export declare const DEFAULT_BROWSER_COMMAND_TIMEOUT: number;
 export declare const DEFAULT_BROWSER_EXPLORE_TIMEOUT: number;
-export declare const DEFAULT_BROWSER_SMOKE_TIMEOUT: number;
 /**
  * Timeout with seconds unit. Used for high-level command timeouts.
  */

package/dist/runtime.js

@@ -7,10 +7,20 @@ import { TimeoutError } from './errors.js';
 export function getBrowserFactory() {
     return (process.env.OPENCLI_CDP_ENDPOINT ? CDPBridge : BrowserBridge);
 }
-export const DEFAULT_BROWSER_CONNECT_TIMEOUT = parseInt(process.env.OPENCLI_BROWSER_CONNECT_TIMEOUT ?? '30', 10);
-export const DEFAULT_BROWSER_COMMAND_TIMEOUT = parseInt(process.env.OPENCLI_BROWSER_COMMAND_TIMEOUT ?? '60', 10);
-export const DEFAULT_BROWSER_EXPLORE_TIMEOUT = parseInt(process.env.OPENCLI_BROWSER_EXPLORE_TIMEOUT ?? '120', 10);
-export const DEFAULT_BROWSER_SMOKE_TIMEOUT = parseInt(process.env.OPENCLI_BROWSER_SMOKE_TIMEOUT ?? '60', 10);
+function parseEnvTimeout(envVar, fallback) {
+    const raw = process.env[envVar];
+    if (raw === undefined)
+        return fallback;
+    const parsed = parseInt(raw, 10);
+    if (Number.isNaN(parsed) || parsed <= 0) {
+        console.error(`[runtime] Invalid ${envVar}="${raw}", using default ${fallback}s`);
+        return fallback;
+    }
+    return parsed;
+}
+export const DEFAULT_BROWSER_CONNECT_TIMEOUT = parseEnvTimeout('OPENCLI_BROWSER_CONNECT_TIMEOUT', 30);
+export const DEFAULT_BROWSER_COMMAND_TIMEOUT = parseEnvTimeout('OPENCLI_BROWSER_COMMAND_TIMEOUT', 60);
+export const DEFAULT_BROWSER_EXPLORE_TIMEOUT = parseEnvTimeout('OPENCLI_BROWSER_EXPLORE_TIMEOUT', 120);
 /**
  * Timeout with seconds unit. Used for high-level command timeouts.
  */

package/dist/snapshotFormatter.d.ts

@@ -1,18 +1,11 @@
 /**
  * Aria snapshot formatter: parses Playwright MCP snapshot text into clean format.
  *
- * Multi-pass pipeline:
- * 1. Parse & filter: strip annotations, metadata, noise roles, ads, decorators
- * 2. Deduplicate: generic/text child matching parent label
- * 3. Deduplicate: heading + link with identical labels
- * 4. Deduplicate: nested identical links
- * 5. Prune: empty containers (iterative bottom-up)
- * 6. Collapse: single-child containers
+ * 4-pass pipeline:
+ * 1. Parse & filter: strip annotations, metadata, noise, ads, boilerplate subtrees
+ * 2. Deduplicate: generic/text parent match, heading+link, nested identical links
+ * 3. Prune: empty containers (iterative bottom-up)
+ * 4. Collapse: single-child containers
  */
-export interface FormatOptions {
-    interactive?: boolean;
-    compact?: boolean;
-    maxDepth?: number;
-    maxTextLength?: number;
-}
-export declare function formatSnapshot(raw: string, opts?: FormatOptions): string;
+import type { SnapshotOptions } from './types.js';
+export declare function formatSnapshot(raw: string, opts?: SnapshotOptions): string;

package/dist/snapshotFormatter.js

@@ -1,13 +1,11 @@
 /**
  * Aria snapshot formatter: parses Playwright MCP snapshot text into clean format.
  *
- * Multi-pass pipeline:
- * 1. Parse & filter: strip annotations, metadata, noise roles, ads, decorators
- * 2. Deduplicate: generic/text child matching parent label
- * 3. Deduplicate: heading + link with identical labels
- * 4. Deduplicate: nested identical links
- * 5. Prune: empty containers (iterative bottom-up)
- * 6. Collapse: single-child containers
+ * 4-pass pipeline:
+ * 1. Parse & filter: strip annotations, metadata, noise, ads, boilerplate subtrees
+ * 2. Deduplicate: generic/text parent match, heading+link, nested identical links
+ * 3. Prune: empty containers (iterative bottom-up)
+ * 4. Collapse: single-child containers
  */
 const DEFAULT_MAX_TEXT_LENGTH = 200;
 // Roles that are pure noise and should always be filtered
@@ -174,88 +172,64 @@ export function formatSnapshot(raw, opts = {}) {
         return '';
     const maxTextLen = opts.maxTextLength ?? DEFAULT_MAX_TEXT_LENGTH;
     const lines = raw.split('\n');
-    // === Pass 1: Parse, filter, and collect entries ===
-    const entries = [];
+    // === Pass 1: Parse, filter, and collect entries (merged with ad/boilerplate subtree skip) ===
+    const parsed = [];
     let refCounter = 0;
-    let skipUntilDepth = -1; // When >= 0, skip all nodes at depth > this value
+    let skipUntilDepth = -1;
     for (let i = 0; i < lines.length; i++) {
         const line = lines[i];
         if (!line.trim())
             continue;
         const indent = line.length - line.trimStart().length;
         const depth = Math.floor(indent / 2);
-        // If we're in a subtree skip zone, check depth
+        // Subtree skip zone (noise roles, ads, boilerplate)
         if (skipUntilDepth >= 0) {
             if (depth > skipUntilDepth)
-                continue; // still inside subtree
-            skipUntilDepth = -1; // exited subtree
+                continue;
+            skipUntilDepth = -1;
         }
         let content = line.trimStart();
-        // Strip leading "- "
-        if (content.startsWith('- ')) {
+        if (content.startsWith('- '))
             content = content.slice(2);
-        }
-        // Skip metadata lines
         if (isMetadataLine(content))
             continue;
-        // Apply maxDepth filter
         if (opts.maxDepth !== undefined && depth > opts.maxDepth)
             continue;
         const { role, text, hasText, trailingText } = parseLine(content);
-        // Skip noise nodes
         if (isNoiseNode(role, hasText, text, trailingText))
             continue;
-        // Skip subtree noise roles (contentinfo footer, etc.) — skip entire subtree
+        // Subtree noise roles (contentinfo footer, etc.)
         if (SUBTREE_NOISE_ROLES.has(role)) {
             skipUntilDepth = depth;
             continue;
         }
-        // Strip annotations
+        // Ads and boilerplate — skip entire subtree (merged from old Pass 2)
+        if (isAdNode(text, trailingText) || isBoilerplateNode(text)) {
+            skipUntilDepth = depth;
+            continue;
+        }
         content = stripAnnotations(content);
-        // Check if node should trigger subtree skip (ads, boilerplate)
-        const isSubtreeSkip = isAdNode(text, trailingText) || isBoilerplateNode(text);
-        // Interactive mode filter
         const isInteractive = INTERACTIVE_ROLES.has(role);
         const isLandmark = LANDMARK_ROLES.has(role);
         if (opts.interactive && !isInteractive && !isLandmark && !hasText)
             continue;
-        // Compact mode
         if (opts.compact) {
-            content = content
-                .replace(/\s*\[.*?\]\s*/g, ' ')
-                .replace(/\s+/g, ' ')
-                .trim();
+            content = content.replace(/\s*\[.*?\]\s*/g, ' ').replace(/\s+/g, ' ').trim();
         }
-        // Text truncation
         if (maxTextLen > 0 && content.length > maxTextLen) {
             content = content.slice(0, maxTextLen) + '…';
         }
-        // Assign refs to interactive elements
         if (isInteractive) {
             refCounter++;
             content = `[@${refCounter}] ${content}`;
         }
-        entries.push({ depth, content, role, text, trailingText, isInteractive, isLandmark, isSubtreeSkip });
+        parsed.push({ depth, content, role, text, trailingText, isInteractive, isLandmark });
     }
-    // === Pass 2: Remove subtree-skip nodes (ads, boilerplate, contentinfo) ===
-    let noAds = [];
-    for (let i = 0; i < entries.length; i++) {
-        const entry = entries[i];
-        if (entry.isSubtreeSkip) {
-            const skipDepth = entry.depth;
-            i++;
-            while (i < entries.length && entries[i].depth > skipDepth) {
-                i++;
-            }
-            i--;
-            continue;
-        }
-        noAds.push(entry);
-    }
-    // === Pass 3: Deduplicate child generic/text matching parent label ===
-    let deduped = [];
-    for (let i = 0; i < noAds.length; i++) {
-        const entry = noAds[i];
+    // === Pass 2: Deduplicate (merged: generic/text parent match + heading+link + nested links) ===
+    const deduped = [];
+    for (let i = 0; i < parsed.length; i++) {
+        const entry = parsed[i];
+        // Dedup: generic/text child matching parent label
         if (entry.role === 'generic' || entry.role === 'text') {
             let parent;
             for (let j = deduped.length - 1; j >= 0; j--) {
@@ -268,43 +242,30 @@ export function formatSnapshot(raw, opts = {}) {
             }
             if (parent) {
                 const childText = entry.trailingText || entry.text;
-                if (childText && parent.text && childText === parent.text) {
+                if (childText && parent.text && childText === parent.text)
                     continue;
-                }
             }
         }
-        deduped.push(entry);
-    }
-    // === Pass 4: Deduplicate heading + child link with identical label ===
-    // Pattern: heading "Title": → link "Title": (same text) → skip the link
-    const deduped2 = [];
-    for (let i = 0; i < deduped.length; i++) {
-        const entry = deduped[i];
+        // Dedup: heading + child link with identical label
         if (entry.role === 'heading' && entry.text) {
-            const next = deduped[i + 1];
+            const next = parsed[i + 1];
             if (next && next.role === 'link' && next.text === entry.text && next.depth === entry.depth + 1) {
-                // Keep the heading, skip the link. But preserve link's children re-parented.
-                deduped2.push(entry);
-                i++; // skip the link
+                deduped.push(entry);
+                i++; // skip the link, preserve its children
                 continue;
             }
         }
-        deduped2.push(entry);
-    }
-    // === Pass 5: Deduplicate nested identical links ===
-    const deduped3 = [];
-    for (let i = 0; i < deduped2.length; i++) {
-        const entry = deduped2[i];
+        // Dedup: nested identical links (skip parent, keep child)
         if (entry.role === 'link' && entry.text) {
-            const next = deduped2[i + 1];
+            const next = parsed[i + 1];
             if (next && next.role === 'link' && next.text === entry.text && next.depth === entry.depth + 1) {
-                continue; // Skip parent, keep child
+                continue;
             }
         }
-        deduped3.push(entry);
+        deduped.push(entry);
     }
-    // === Pass 6: Iteratively prune empty containers (bottom-up) ===
-    let current = deduped3;
+    // === Pass 3: Iteratively prune empty containers (bottom-up) ===
+    let current = deduped;
     let changed = true;
     while (changed) {
         changed = false;
@@ -330,7 +291,7 @@ export function formatSnapshot(raw, opts = {}) {
         }
         current = next;
     }
-    // === Pass 7: Collapse single-child containers ===
+    // === Pass 4: Collapse single-child containers ===
     const collapsed = [];
     for (let i = 0; i < current.length; i++) {
         const entry = current[i];
@@ -358,10 +319,9 @@ export function formatSnapshot(raw, opts = {}) {
                     }
                 }
                 if (!hasGrandchildren) {
-                    const mergedContent = entry.content.replace(/:$/, '') + ' > ' + child.content;
                     collapsed.push({
                         ...entry,
-                        content: mergedContent,
+                        content: entry.content.replace(/:$/, '') + ' > ' + child.content,
                         role: child.role,
                         text: child.text,
                         trailingText: child.trailingText,

package/dist/utils.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared utility functions used across the codebase.
+ */
+/** Type guard: checks if a value is a non-null, non-array object. */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+/** Simple async concurrency limiter. */
+export declare function mapConcurrent<T, R>(items: T[], limit: number, fn: (item: T, index: number) => Promise<R>): Promise<R[]>;
+/** Save a base64-encoded string to a file, creating parent directories as needed. */
+export declare function saveBase64ToFile(base64: string, filePath: string): Promise<void>;

package/dist/utils.js

@@ -0,0 +1,29 @@
+/**
+ * Shared utility functions used across the codebase.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+/** Type guard: checks if a value is a non-null, non-array object. */
+export function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** Simple async concurrency limiter. */
+export async function mapConcurrent(items, limit, fn) {
+    const results = new Array(items.length);
+    let index = 0;
+    async function worker() {
+        while (index < items.length) {
+            const i = index++;
+            results[i] = await fn(items[i], i);
+        }
+    }
+    const workers = Array.from({ length: Math.min(limit, items.length) }, () => worker());
+    await Promise.all(workers);
+    return results;
+}
+/** Save a base64-encoded string to a file, creating parent directories as needed. */
+export async function saveBase64ToFile(base64, filePath) {
+    const dir = path.dirname(filePath);
+    await fs.promises.mkdir(dir, { recursive: true });
+    await fs.promises.writeFile(filePath, Buffer.from(base64, 'base64'));
+}

package/dist/validate.js

@@ -5,14 +5,12 @@ import yaml from 'js-yaml';
 import { getErrorMessage } from './errors.js';
 /** All recognized pipeline step names */
 const KNOWN_STEP_NAMES = new Set([
-    'navigate', 'click', 'type', 'wait', 'press', 'snapshot', 'scroll',
+    'navigate', 'click', 'type', 'wait', 'press', 'snapshot',
     'fetch', 'evaluate',
     'select', 'map', 'filter', 'sort', 'limit',
-    'intercept', 'tap',
+    'intercept', 'tap', 'download',
 ]);
-function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
+import { isRecord } from './utils.js';
 export function validateClisWithTarget(dirs, target) {
     const results = [];
     let errors = 0;

package/dist/yaml-schema.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Shared YAML CLI definition types.
+ * Used by both discovery.ts (runtime) and build-manifest.ts (build-time).
+ */
+export interface YamlArgDefinition {
+    type?: string;
+    default?: unknown;
+    required?: boolean;
+    positional?: boolean;
+    description?: string;
+    help?: string;
+    choices?: string[];
+}
+export interface YamlCliDefinition {
+    site?: string;
+    name?: string;
+    description?: string;
+    domain?: string;
+    strategy?: string;
+    browser?: boolean;
+    args?: Record<string, YamlArgDefinition>;
+    columns?: string[];
+    pipeline?: Record<string, unknown>[];
+    timeout?: number;
+    navigateBefore?: boolean | string;
+}

package/dist/yaml-schema.js

@@ -0,0 +1,5 @@
+/**
+ * Shared YAML CLI definition types.
+ * Used by both discovery.ts (runtime) and build-manifest.ts (build-time).
+ */
+export {};

package/docs/.vitepress/config.mts

@@ -29,6 +29,7 @@ export default defineConfig({
               items: [
                 { text: 'Getting Started', link: '/guide/getting-started' },
                 { text: 'Installation', link: '/guide/installation' },
+                { text: 'Comparison', link: '/comparison' },
                 { text: 'Browser Bridge', link: '/guide/browser-bridge' },
                 { text: 'Troubleshooting', link: '/guide/troubleshooting' },
                 { text: 'Plugins', link: '/guide/plugins' },
@@ -72,6 +73,7 @@ export default defineConfig({
                 { text: 'Douban', link: '/adapters/browser/douban' },
                 { text: 'Sina Blog', link: '/adapters/browser/sinablog' },
                 { text: 'Substack', link: '/adapters/browser/substack' },
+                { text: 'Pixiv', link: '/adapters/browser/pixiv' },
               ],
             },
             {
@@ -80,6 +82,7 @@ export default defineConfig({
               items: [
                 { text: 'HackerNews', link: '/adapters/browser/hackernews' },
                 { text: 'Dev.to', link: '/adapters/browser/devto' },
+                { text: 'Dictionary', link: '/adapters/browser/dictionary' },
                 { text: 'BBC', link: '/adapters/browser/bbc' },
                 { text: 'Apple Podcasts', link: '/adapters/browser/apple-podcasts' },
                 { text: 'Xiaoyuzhou', link: '/adapters/browser/xiaoyuzhou' },

package/docs/adapters/browser/dictionary.md

@@ -0,0 +1,27 @@
+# Dictionary
+
+**Mode**: 🌐 Public · **Domain**: `api.dictionaryapi.dev`
+
+Search the open dictionary to quickly fetch native definitions, part of speech contexts, and phonetic pronunciations directly in your IDE terminal.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli dictionary search` | Fetch the exact definition of a word |
+| `opencli dictionary synonyms` | Find related synonyms for a word |
+| `opencli dictionary examples` | Read real-world sentence usage examples |
+
+## Usage Examples
+
+```bash
+# Look up a complex term
+opencli dictionary search serendipity
+
+# Discover phonetics
+opencli dictionary search ephemeral
+```
+
+## Prerequisites
+
+- No browser required — utilizes the fast, open JSON definitions API.

package/docs/adapters/browser/jd.md

@@ -0,0 +1,27 @@
+# JD.com
+
+**Mode**: 🔐 Browser · **Domain**: `item.jd.com`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli jd item <sku>` | Fetch product details (price, images, specs) |
+
+## Usage Examples
+
+```bash
+# Get product details by SKU
+opencli jd item 100291143898
+
+# Limit detail images
+opencli jd item 100291143898 --images 5
+
+# JSON output
+opencli jd item 100291143898 -f json
+```
+
+## Prerequisites
+
+- Chrome running and **logged into** jd.com
+- [Browser Bridge extension](/guide/browser-bridge) installed