@jackwener/opencli 1.7.11 → 1.7.13

package/clis/yuanbao/send.js

@@ -0,0 +1,57 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { ArgumentError, CommandExecutionError } from '@jackwener/opencli/errors';
+import {
+    YUANBAO_DOMAIN,
+    authRequired,
+    ensureYuanbaoPage,
+    hasLoginGate,
+    normalizeBooleanFlag,
+    sendYuanbaoMessage,
+    startNewYuanbaoChat,
+} from './shared.js';
+
+cli({
+    site: 'yuanbao',
+    name: 'send',
+    access: 'write',
+    description: 'Fire-and-forget: send a prompt to Yuanbao without waiting for the reply',
+    domain: YUANBAO_DOMAIN,
+    strategy: Strategy.COOKIE,
+    browser: true,
+    browserSession: { reuse: 'site' },
+    navigateBefore: false,
+    args: [
+        { name: 'prompt', positional: true, required: true, help: 'Prompt to send to Yuanbao' },
+        { name: 'new', type: 'boolean', default: false, help: 'Start a new chat before sending' },
+    ],
+    columns: ['Status', 'Prompt'],
+    func: async (page, kwargs) => {
+        const prompt = String(kwargs.prompt || '').trim();
+        if (!prompt) throw new ArgumentError('prompt', 'is required');
+        const startFresh = normalizeBooleanFlag(kwargs.new, false);
+
+        await ensureYuanbaoPage(page);
+        if (await hasLoginGate(page)) {
+            throw authRequired('Yuanbao opened a login gate before sending the prompt.');
+        }
+        if (startFresh) {
+            const action = await startNewYuanbaoChat(page);
+            if (action === 'blocked') {
+                throw authRequired('Yuanbao opened a login gate while starting a new chat.');
+            }
+        }
+        const send = await sendYuanbaoMessage(page, prompt);
+        if (!send?.ok) {
+            if (await hasLoginGate(page)) {
+                throw authRequired('Yuanbao opened a login gate instead of accepting the prompt.');
+            }
+            throw new CommandExecutionError(
+                send?.reason || 'Failed to send Yuanbao prompt',
+                send?.detail
+                    ? `Detail: ${send.detail}`
+                    : 'Make sure the Yuanbao chat composer is visible and not in a disabled state.',
+            );
+        }
+        return [{ Status: 'sent', Prompt: prompt }];
+    },
+});

package/clis/yuanbao/shared.js

@@ -1,7 +1,12 @@
-import { AuthRequiredError } from '@jackwener/opencli/errors';
+import { ArgumentError, AuthRequiredError } from '@jackwener/opencli/errors';
+
 export const YUANBAO_DOMAIN = 'yuanbao.tencent.com';
 export const YUANBAO_URL = 'https://yuanbao.tencent.com/';
 const SESSION_HINT = 'Likely login/auth/challenge/session issue in the existing yuanbao.tencent.com browser session.';
+
+const AGENT_ID_RE = /^[A-Za-z0-9_-]{4,40}$/;
+const CONV_ID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+
 /**
  * Reusable visibility check for injected browser scripts.
  * Embed in page.evaluate strings via `${IS_VISIBLE_JS}`.
@@ -15,27 +20,36 @@ export const IS_VISIBLE_JS = `const isVisible = (node) => {
     && style.display !== 'none'
     && style.visibility !== 'hidden';
 };`;
+
 export function authRequired(message) {
     return new AuthRequiredError(YUANBAO_DOMAIN, `${message} ${SESSION_HINT}`);
 }
+
+export function normalizeBooleanFlag(value, fallback = false) {
+    if (typeof value === 'boolean') return value;
+    if (value == null || value === '') return fallback;
+    const normalized = String(value).trim().toLowerCase();
+    return normalized === 'true' || normalized === '1' || normalized === 'yes' || normalized === 'on';
+}
+
 export async function isOnYuanbao(page) {
     const url = await page.evaluate('window.location.href').catch(() => '');
-    if (typeof url !== 'string' || !url)
-        return false;
+    if (typeof url !== 'string' || !url) return false;
     try {
         const hostname = new URL(url).hostname;
         return hostname === YUANBAO_DOMAIN || hostname.endsWith(`.${YUANBAO_DOMAIN}`);
-    }
-    catch {
+    } catch {
         return false;
     }
 }
+
 export async function ensureYuanbaoPage(page) {
     if (!(await isOnYuanbao(page))) {
         await page.goto(YUANBAO_URL, { waitUntil: 'load', settleMs: 2500 });
         await page.wait(1);
     }
 }
+
 export async function hasLoginGate(page) {
     const result = await page.evaluate(`(() => {
     const bodyText = document.body.innerText || '';
@@ -47,3 +61,281 @@ export async function hasLoginGate(page) {
   })()`);
     return Boolean(result);
 }
+
+export async function isLoggedIn(page) {
+    return !(await hasLoginGate(page));
+}
+
+/**
+ * Extract Yuanbao session identity from a raw input.
+ *
+ * Yuanbao chat URLs are `/chat/<agentId>/<convId>`. Both parts are required
+ * to navigate — there is no stable default agentId we can fall back to. So we
+ * only accept inputs that resolve a complete `{agentId, convId}` pair:
+ *   - full `https://yuanbao.tencent.com/chat/<agentId>/<convId>` URL
+ *   - bare slash form `<agentId>/<convId>`
+ *
+ * A bare convId UUID is rejected with an actionable message — opening the
+ * wrong agent silently is a much worse failure mode than throwing.
+ *
+ * The trailing `(?:[/?#]|$)` boundary in the URL regex prevents over-long
+ * suffixes (e.g. `<id>extra`) from silently truncating to a valid-looking ID.
+ */
+export function parseYuanbaoSessionId(input) {
+    const raw = String(input ?? '').trim();
+    if (!raw) {
+        throw new ArgumentError(
+            'id',
+            'must be a non-empty Yuanbao chat URL or "<agentId>/<convId>" pair',
+        );
+    }
+    const urlMatch = raw.match(/yuanbao\.tencent\.com\/chat\/([A-Za-z0-9_-]+)\/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})(?:[/?#]|$)/i);
+    if (urlMatch) {
+        const [, agentId, convId] = urlMatch;
+        if (!AGENT_ID_RE.test(agentId) || !CONV_ID_RE.test(convId)) {
+            throw new ArgumentError(
+                'id',
+                `not a valid Yuanbao chat URL (got "${input}"); expected https://yuanbao.tencent.com/chat/<agentId>/<convId>`,
+            );
+        }
+        return { agentId, convId: convId.toLowerCase() };
+    }
+    const slashMatch = raw.match(/^([A-Za-z0-9_-]+)\/([0-9a-f-]{36})$/i);
+    if (slashMatch) {
+        const [, agentId, convId] = slashMatch;
+        if (!AGENT_ID_RE.test(agentId) || !CONV_ID_RE.test(convId)) {
+            throw new ArgumentError(
+                'id',
+                `not a valid Yuanbao "<agentId>/<convId>" pair (got "${input}"); agentId must be 4-40 word chars, convId must be a UUID`,
+            );
+        }
+        return { agentId, convId: convId.toLowerCase() };
+    }
+    throw new ArgumentError(
+        'id',
+        `not a valid Yuanbao session reference (got "${input}"); pass either a full https://yuanbao.tencent.com/chat/<agentId>/<convId> URL or a bare "<agentId>/<convId>" pair. A UUID alone is not enough — Yuanbao requires the agentId.`,
+    );
+}
+
+export async function getCurrentYuanbaoSessionId(page) {
+    const url = await page.evaluate('window.location.href').catch(() => '');
+    if (typeof url !== 'string') return null;
+    const match = url.match(/yuanbao\.tencent\.com\/chat\/([A-Za-z0-9_-]+)\/([0-9a-f-]{36})(?:[/?#]|$)/i);
+    if (!match) return null;
+    const [, agentId, convId] = match;
+    if (!AGENT_ID_RE.test(agentId) || !CONV_ID_RE.test(convId)) return null;
+    return { agentId, convId: convId.toLowerCase() };
+}
+
+export async function getYuanbaoModelLabel(page) {
+    const result = await page.evaluate(`(() => {
+    const btn = document.querySelector('[dt-button-id="model_switch"]');
+    if (!(btn instanceof HTMLElement)) return null;
+    const label = (btn.querySelector('.t-button__text')?.textContent || btn.textContent || '').trim();
+    const modelId = btn.getAttribute('dt-model-id') || '';
+    return { label, modelId };
+  })()`);
+    if (!result || typeof result !== 'object') return { label: null, modelId: null };
+    return {
+        label: typeof result.label === 'string' && result.label ? result.label : null,
+        modelId: typeof result.modelId === 'string' && result.modelId ? result.modelId : null,
+    };
+}
+
+/**
+ * Read the current conversation transcript as `{id, role, text, html}` rows.
+ *
+ * Each `.agent-chat__list__item` carries `data-conv-id` (`<convId>_<idx>`),
+ * `data-conv-speaker` (`human`/`ai`), and `data-conv-idx`. We use those as the
+ * stable per-turn identity so polling/dedup logic in `ask` stays correct after
+ * future re-renders.
+ *
+ * Image-only assistant turns may have empty visible text; we keep them when
+ * `html` is non-empty so callers can render images downstream.
+ */
+export async function getYuanbaoMessageBubbles(page) {
+    const result = await page.evaluate(`(() => {
+    ${IS_VISIBLE_JS}
+    const items = Array.from(document.querySelectorAll('.agent-chat__list__item--human, .agent-chat__list__item--ai'))
+      .filter((node) => isVisible(node));
+    return items.map((node, positional) => {
+      const isAi = node.classList.contains('agent-chat__list__item--ai');
+      const role = isAi ? 'Assistant' : 'User';
+      const id = node.getAttribute('data-conv-id') || ('pos-' + positional + (isAi ? '-ai' : '-human'));
+      const idx = Number(node.getAttribute('data-conv-idx') || positional + 1);
+      const contentNode = isAi
+        ? (node.querySelector('.hyc-content-md-done')
+          || node.querySelector('.hyc-content-md')
+          || node.querySelector('.agent-chat__speech-text')
+          || node.querySelector('.agent-chat__bubble__content'))
+        : (node.querySelector('.hyc-component-text .hyc-content-text')
+          || node.querySelector('.hyc-content-text')
+          || node.querySelector('.agent-chat__bubble__content'));
+      const html = contentNode instanceof HTMLElement ? (contentNode.innerHTML || '') : '';
+      const rawText = contentNode instanceof HTMLElement
+        ? (contentNode.innerText || contentNode.textContent || '')
+        : ((node.innerText || node.textContent) || '');
+      return {
+        id,
+        idx,
+        role,
+        text: String(rawText || '').replace(/\\u00a0/g, ' ').trim(),
+        html,
+      };
+    });
+  })()`);
+    if (!Array.isArray(result)) return [];
+    return result
+        .map((item) => ({
+            id: String(item?.id || ''),
+            idx: Number.isInteger(item?.idx) ? item.idx : 0,
+            role: item?.role === 'Assistant' ? 'Assistant' : 'User',
+            text: String(item?.text || '').trim(),
+            html: String(item?.html || ''),
+        }))
+        .filter((item) => item.id && (item.text || item.html));
+}
+
+/**
+ * Enumerate sidebar conversation entries.
+ *
+ * Each `.yb-recent-conv-list__item` exposes:
+ *   - `dt-cid`     — conversation UUID
+ *   - `dt-agent-id`— agent slug
+ *   - `[data-item-name]` — display title
+ *
+ * We do NOT trigger sidebar virtual scroll here — Yuanbao loads the visible
+ * window only, so callers requesting a higher `limit` than the rendered count
+ * get whatever is currently rendered. That matches Yuanbao's own UX.
+ */
+export async function getYuanbaoSessionList(page, limit) {
+    const cap = Number(limit ?? 20);
+    if (!Number.isInteger(cap) || cap <= 0) {
+        throw new ArgumentError('limit', 'must be a positive integer');
+    }
+    const result = await page.evaluate(`(() => {
+    ${IS_VISIBLE_JS}
+    const nodes = Array.from(document.querySelectorAll('.yb-recent-conv-list__item'))
+      .filter((node) => isVisible(node));
+    return nodes.map((node) => {
+      const cid = node.getAttribute('dt-cid') || '';
+      const agentId = node.getAttribute('dt-agent-id') || '';
+      const titleEl = node.querySelector('[data-item-name]');
+      const title = (titleEl?.getAttribute('data-item-name') || titleEl?.textContent || '').trim();
+      return { cid, agentId, title };
+    });
+  })()`);
+    if (!Array.isArray(result)) return [];
+    return result
+        .map((item) => ({
+            cid: String(item?.cid || '').toLowerCase(),
+            agentId: String(item?.agentId || ''),
+            title: String(item?.title || '').trim(),
+        }))
+        .filter((item) => CONV_ID_RE.test(item.cid) && AGENT_ID_RE.test(item.agentId))
+        .slice(0, cap);
+}
+
+export async function startNewYuanbaoChat(page) {
+    await ensureYuanbaoPage(page);
+    if (await hasLoginGate(page)) return 'blocked';
+    const beforeUrl = await page.evaluate('window.location.href').catch(() => '');
+    const action = await page.evaluate(`(() => {
+    ${IS_VISIBLE_JS}
+    const trigger = Array.from(document.querySelectorAll('.yb-common-nav__trigger[data-desc="new-chat"], [dt-button-id="new_temp_chat"]'))
+      .find((node) => isVisible(node));
+    if (trigger instanceof HTMLElement) {
+      trigger.click();
+      return 'clicked';
+    }
+    return 'navigate';
+  })()`);
+    if (action === 'navigate') {
+        await page.goto(YUANBAO_URL, { waitUntil: 'load', settleMs: 2500 });
+        await page.wait(1);
+        return (await hasLoginGate(page)) ? 'blocked' : 'navigate';
+    }
+    await page.wait(1);
+    if (await hasLoginGate(page)) return 'blocked';
+    const afterUrl = await page.evaluate('window.location.href').catch(() => '');
+    if (typeof afterUrl === 'string' && typeof beforeUrl === 'string' && afterUrl !== beforeUrl) {
+        return 'clicked';
+    }
+    // Click had no observable effect — fall back to homepage navigation.
+    await page.goto(YUANBAO_URL, { waitUntil: 'load', settleMs: 2500 });
+    await page.wait(1);
+    return 'navigate';
+}
+
+/**
+ * Drive the Quill composer to insert `prompt` and click the send button.
+ *
+ * Yuanbao toggles the send button between `style__send-btn___*` (enabled) and
+ * `style__send-btn--disabled___*` based on a debounced React re-render after
+ * the composer's input event. A naive 200ms wait races that re-render — the
+ * button is still `--disabled` at click time, the click is a no-op, and
+ * Enter-key fallback in Quill does not always submit. We poll the
+ * disabled-state for up to ~3s and only fall back to Enter when the React
+ * update never arrives.
+ *
+ * Returns `{ok: true, action}` or `{ok: false, reason, detail?}`.
+ */
+export async function sendYuanbaoMessage(page, prompt) {
+    return await page.evaluate(`(async () => {
+    const waitFor = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+    ${IS_VISIBLE_JS}
+
+    const composer = Array.from(document.querySelectorAll('.ql-editor[contenteditable="true"], .ql-editor, [contenteditable="true"]'))
+      .find(isVisible);
+
+    if (!(composer instanceof HTMLElement)) {
+      return {
+        ok: false,
+        reason: 'Yuanbao composer was not found.',
+      };
+    }
+
+    try {
+      composer.focus();
+      const selection = window.getSelection();
+      const range = document.createRange();
+      range.selectNodeContents(composer);
+      range.collapse(false);
+      selection?.removeAllRanges();
+      selection?.addRange(range);
+      composer.textContent = '';
+      document.execCommand('insertText', false, ${JSON.stringify(prompt)});
+      composer.dispatchEvent(new InputEvent('input', { bubbles: true, data: ${JSON.stringify(prompt)}, inputType: 'insertText' }));
+    } catch (error) {
+      return {
+        ok: false,
+        reason: 'Failed to insert the prompt into the Yuanbao composer.',
+        detail: error instanceof Error ? error.message : String(error),
+      };
+    }
+
+    const findEnabledSubmit = () => Array.from(document.querySelectorAll('a[class*="send-btn"], button[class*="send-btn"]'))
+      .find((node) => {
+        if (!(node instanceof HTMLElement) || !isVisible(node)) return false;
+        const className = typeof node.className === 'string' ? node.className : '';
+        return !className.includes('send-btn--disabled') && !className.includes('disabled');
+      });
+
+    let submit = null;
+    const deadline = Date.now() + 3_000;
+    while (Date.now() < deadline) {
+      submit = findEnabledSubmit();
+      if (submit) break;
+      await waitFor(150);
+    }
+
+    if (submit instanceof HTMLElement) {
+      submit.click();
+      return { ok: true, action: 'click' };
+    }
+
+    composer.dispatchEvent(new KeyboardEvent('keydown', { key: 'Enter', code: 'Enter', keyCode: 13, bubbles: true }));
+    composer.dispatchEvent(new KeyboardEvent('keyup', { key: 'Enter', code: 'Enter', keyCode: 13, bubbles: true }));
+    return { ok: true, action: 'enter' };
+  })()`);
+}

package/clis/yuanbao/shared.test.js

@@ -0,0 +1,80 @@
+import { describe, expect, it } from 'vitest';
+import { ArgumentError } from '@jackwener/opencli/errors';
+import { normalizeBooleanFlag, parseYuanbaoSessionId } from './shared.js';
+
+describe('yuanbao parseYuanbaoSessionId', () => {
+    const agentId = 'naQivTmsDa';
+    const convId = 'b1118732-15ca-42cc-bc9a-e40090ccfb8c';
+
+    it('extracts agent + conv from a full chat URL', () => {
+        expect(parseYuanbaoSessionId(`https://yuanbao.tencent.com/chat/${agentId}/${convId}`))
+            .toEqual({ agentId, convId });
+    });
+
+    it('extracts agent + conv from URL with query string or fragment', () => {
+        expect(parseYuanbaoSessionId(`https://yuanbao.tencent.com/chat/${agentId}/${convId}?ref=share`))
+            .toEqual({ agentId, convId });
+        expect(parseYuanbaoSessionId(`https://yuanbao.tencent.com/chat/${agentId}/${convId}#anchor`))
+            .toEqual({ agentId, convId });
+    });
+
+    it('lowercases the conv UUID', () => {
+        expect(parseYuanbaoSessionId(`https://yuanbao.tencent.com/chat/${agentId}/${convId.toUpperCase()}`))
+            .toEqual({ agentId, convId });
+    });
+
+    it('accepts a bare "<agentId>/<convId>" pair', () => {
+        expect(parseYuanbaoSessionId(`${agentId}/${convId}`)).toEqual({ agentId, convId });
+    });
+
+    it('throws on empty / blank input', () => {
+        expect(() => parseYuanbaoSessionId('')).toThrow(ArgumentError);
+        expect(() => parseYuanbaoSessionId('   ')).toThrow(ArgumentError);
+        expect(() => parseYuanbaoSessionId(null)).toThrow(ArgumentError);
+        expect(() => parseYuanbaoSessionId(undefined)).toThrow(ArgumentError);
+    });
+
+    it('rejects a bare conv UUID (Yuanbao requires the agent slug)', () => {
+        expect(() => parseYuanbaoSessionId(convId)).toThrow(ArgumentError);
+    });
+
+    it('rejects a URL with a 37+ char conv tail (no silent truncation)', () => {
+        // Boundary regression: without `(?:[/?#]|$)` the regex would happily
+        // match the first 36 chars and silently open a different conversation.
+        expect(() => parseYuanbaoSessionId(`https://yuanbao.tencent.com/chat/${agentId}/${convId}extra`))
+            .toThrow(ArgumentError);
+        expect(() => parseYuanbaoSessionId(`https://yuanbao.tencent.com/chat/${agentId}/${convId}0000`))
+            .toThrow(ArgumentError);
+    });
+
+    it('rejects malformed shapes with actionable messages', () => {
+        expect(() => parseYuanbaoSessionId('abc')).toThrow(ArgumentError);
+        expect(() => parseYuanbaoSessionId('https://yuanbao.tencent.com/somewhere/else')).toThrow(ArgumentError);
+        // agent slug too short to be valid
+        expect(() => parseYuanbaoSessionId(`abc/${convId}`)).toThrow(ArgumentError);
+        // conv part not a UUID
+        expect(() => parseYuanbaoSessionId(`${agentId}/not-a-uuid-at-all`)).toThrow(ArgumentError);
+    });
+});
+
+describe('yuanbao normalizeBooleanFlag', () => {
+    it('passes through real booleans', () => {
+        expect(normalizeBooleanFlag(true, false)).toBe(true);
+        expect(normalizeBooleanFlag(false, true)).toBe(false);
+    });
+
+    it('returns fallback for null/empty', () => {
+        expect(normalizeBooleanFlag(undefined, true)).toBe(true);
+        expect(normalizeBooleanFlag(null, false)).toBe(false);
+        expect(normalizeBooleanFlag('', true)).toBe(true);
+    });
+
+    it('parses common truthy / falsy strings', () => {
+        for (const v of ['true', 'TRUE', '1', 'yes', 'on']) {
+            expect(normalizeBooleanFlag(v, false)).toBe(true);
+        }
+        for (const v of ['false', '0', 'no', 'off', 'unknown']) {
+            expect(normalizeBooleanFlag(v, true)).toBe(false);
+        }
+    });
+});

package/clis/yuanbao/status.js

@@ -0,0 +1,44 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import {
+    YUANBAO_DOMAIN,
+    ensureYuanbaoPage,
+    isLoggedIn,
+    getCurrentYuanbaoSessionId,
+    getYuanbaoModelLabel,
+} from './shared.js';
+
+cli({
+    site: 'yuanbao',
+    name: 'status',
+    access: 'read',
+    description: 'Check Yuanbao page availability, login state, current session and model',
+    domain: YUANBAO_DOMAIN,
+    strategy: Strategy.COOKIE,
+    browser: true,
+    browserSession: { reuse: 'site' },
+    navigateBefore: false,
+    args: [],
+    columns: ['Status', 'Login', 'Model', 'ModelId', 'AgentId', 'SessionId', 'Url'],
+    func: async (page) => {
+        await ensureYuanbaoPage(page);
+        await page.wait(1.5);
+        const [loggedIn, session, model, url] = await Promise.all([
+            isLoggedIn(page),
+            getCurrentYuanbaoSessionId(page),
+            getYuanbaoModelLabel(page),
+            page.evaluate('window.location.href').catch(() => ''),
+        ]);
+        // Surface unknown values as `null` (typed unknown) rather than '-' / ''
+        // sentinels — sentinels look like real labels and silently break filters
+        // built on these columns.
+        return [{
+            Status: 'Connected',
+            Login: loggedIn ? 'Yes' : 'No (login gate)',
+            Model: model.label,
+            ModelId: model.modelId,
+            AgentId: session?.agentId ?? null,
+            SessionId: session?.convId ?? null,
+            Url: typeof url === 'string' ? url : '',
+        }];
+    },
+});

package/clis/zhihu/answer.js

@@ -5,6 +5,7 @@ import { buildResultRow, requireExecute, resolveCurrentUserIdentity, resolvePayl
 cli({
     site: 'zhihu',
     name: 'answer',
+    access: 'write',
     description: 'Answer a Zhihu question',
     domain: 'www.zhihu.com',
     strategy: Strategy.COOKIE,

package/clis/zhihu/collection.js

@@ -104,6 +104,7 @@ function mapCollectionItem(item, rank) {
 cli({
   site: 'zhihu',
   name: 'collection',
+    access: 'read',
   description: '知乎收藏夹内容列表（需要登录）',
   domain: 'www.zhihu.com',
   strategy: Strategy.COOKIE,

package/clis/zhihu/collections.js

@@ -39,6 +39,7 @@ function collectionKey(item) {
 cli({
   site: 'zhihu',
   name: 'collections',
+    access: 'read',
   description: '知乎收藏夹列表（需要登录）',
   domain: 'www.zhihu.com',
   strategy: Strategy.COOKIE,

package/clis/zhihu/comment.js

@@ -5,6 +5,7 @@ import { buildResultRow, requireExecute, resolveCurrentUserIdentity, resolvePayl
 cli({
     site: 'zhihu',
     name: 'comment',
+    access: 'write',
     description: 'Create a top-level comment on a Zhihu answer or article',
     domain: 'zhihu.com',
     strategy: Strategy.COOKIE,

package/clis/zhihu/download.js

@@ -9,6 +9,7 @@ import { downloadArticle } from '@jackwener/opencli/download/article-download';
 cli({
     site: 'zhihu',
     name: 'download',
+    access: 'read',
     description: '导出知乎文章为 Markdown 格式',
     domain: 'zhuanlan.zhihu.com',
     strategy: Strategy.COOKIE,

package/clis/zhihu/favorite.js

@@ -12,6 +12,7 @@ function normalizeCollectionName(value) {
 cli({
     site: 'zhihu',
     name: 'favorite',
+    access: 'write',
     description: 'Favorite a Zhihu answer or article into a specific collection',
     domain: 'zhihu.com',
     strategy: Strategy.COOKIE,

package/clis/zhihu/follow.js

@@ -5,6 +5,7 @@ import { buildResultRow, requireExecute } from './write-shared.js';
 cli({
     site: 'zhihu',
     name: 'follow',
+    access: 'write',
     description: 'Follow a Zhihu user or question',
     domain: 'www.zhihu.com',
     strategy: Strategy.COOKIE,

package/clis/zhihu/hot.js

@@ -2,6 +2,7 @@ import { cli } from '@jackwener/opencli/registry';
 cli({
     site: 'zhihu',
     name: 'hot',
+    access: 'read',
     description: '知乎热榜',
     domain: 'www.zhihu.com',
     args: [

package/clis/zhihu/like.js

@@ -5,6 +5,7 @@ import { buildResultRow, requireExecute } from './write-shared.js';
 cli({
     site: 'zhihu',
     name: 'like',
+    access: 'write',
     description: 'Like a Zhihu answer or article',
     domain: 'zhihu.com',
     strategy: Strategy.COOKIE,

package/clis/zhihu/question.js

@@ -12,6 +12,7 @@ function stripHtml(html) {
 cli({
     site: 'zhihu',
     name: 'question',
+    access: 'read',
     description: '知乎问题详情和回答',
     domain: 'www.zhihu.com',
     strategy: Strategy.COOKIE,

package/clis/zhihu/search.js

@@ -2,6 +2,7 @@ import { cli } from '@jackwener/opencli/registry';
 cli({
     site: 'zhihu',
     name: 'search',
+    access: 'read',
     description: '知乎搜索',
     domain: 'www.zhihu.com',
     args: [

package/clis/zlibrary/commands.test.js

@@ -7,18 +7,8 @@ import {
 } from './utils.js';
 import './search.js';
 import './info.js';
+import { createPageMock } from '../test-utils.js';
 
-function createPageMock(evaluateResults = []) {
-  const evaluate = vi.fn();
-  for (const result of evaluateResults) {
-    evaluate.mockResolvedValueOnce(result);
-  }
-  return {
-    goto: vi.fn().mockResolvedValue(undefined),
-    wait: vi.fn().mockResolvedValue(undefined),
-    evaluate,
-  };
-}
 
 describe('zlibrary commands', () => {
   it('registers search and info commands', () => {

package/clis/zlibrary/info.js

@@ -5,6 +5,7 @@ import { ZLIBRARY_DOMAIN, extractBookTitle, extractFormats, normalizeZlibraryBoo
 cli({
   site: 'zlibrary',
   name: 'info',
+    access: 'read',
   description: 'Get book details and available download formats from a Z-Library book page',
   domain: ZLIBRARY_DOMAIN,
   strategy: Strategy.COOKIE,

package/clis/zlibrary/search.js

@@ -5,6 +5,7 @@ import { ZLIBRARY_DOMAIN, buildSearchUrl, extractSearchResults } from './utils.j
 cli({
   site: 'zlibrary',
   name: 'search',
+    access: 'read',
   description: 'Search Z-Library for books by title, author, ISBN, or keyword',
   domain: ZLIBRARY_DOMAIN,
   strategy: Strategy.COOKIE,

package/clis/zsxq/dynamics.js

@@ -3,6 +3,7 @@ import { ensureZsxqAuth, ensureZsxqPage, fetchFirstJson, getTopicText, getTopicA
 cli({
     site: 'zsxq',
     name: 'dynamics',
+    access: 'read',
     description: '获取所有星球的最新动态',
     domain: 'wx.zsxq.com',
     strategy: Strategy.COOKIE,