@jackwener/opencli 1.7.8 → 1.7.10

package/clis/zhihu/collections.js

@@ -0,0 +1,127 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { ArgumentError, AuthRequiredError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
+import { log } from '@jackwener/opencli/logger';
+
+function validatePositiveInt(value, name) {
+  const n = Number(value);
+  if (!Number.isInteger(n) || n <= 0) {
+    throw new ArgumentError(`zhihu collections --${name} must be a positive integer`, 'Example: opencli zhihu collections --limit 20');
+  }
+  return n;
+}
+
+async function fetchJson(page, url, errorLabel) {
+  const data = await page.evaluate(`
+    (async () => {
+      const r = await fetch(${JSON.stringify(url)}, { credentials: 'include' });
+      if (!r.ok) return { __httpError: r.status };
+      return await r.json();
+    })()
+  `);
+
+  if (!data || data.__httpError) {
+    const status = data?.__httpError;
+    if (status === 401 || status === 403) {
+      throw new AuthRequiredError('www.zhihu.com', `${errorLabel} from Zhihu failed. Please ensure you are logged in.`);
+    }
+    throw new CommandExecutionError(
+      status ? `${errorLabel} from Zhihu failed (HTTP ${status})` : `${errorLabel} from Zhihu failed`,
+      'Try again later or rerun with -v for more detail',
+    );
+  }
+  return data;
+}
+
+function collectionKey(item) {
+  return String(item?.id || item?.url || item?.title || '');
+}
+
+cli({
+  site: 'zhihu',
+  name: 'collections',
+  description: '知乎收藏夹列表（需要登录）',
+  domain: 'www.zhihu.com',
+  strategy: Strategy.COOKIE,
+  browser: true,
+  args: [
+    { name: 'limit', type: 'int', default: 20, help: '每页数量（最大 20）' },
+  ],
+  columns: ['rank', 'title', 'item_count', 'description', 'collection_id'],
+  func: async (page, kwargs) => {
+    const { limit = 20 } = kwargs;
+    const requestedLimit = validatePositiveInt(limit, 'limit');
+
+    // 先访问知乎主页建立 session
+    await page.goto('https://www.zhihu.com');
+    // 获取当前用户的 url_token
+    const meData = await fetchJson(page, 'https://www.zhihu.com/api/v4/me?include=url_token', 'Zhihu user info request');
+
+    const urlToken = meData.url_token;
+    if (!urlToken) {
+      throw new CommandExecutionError('Failed to get user url_token from Zhihu', 'Please ensure you are logged in.');
+    }
+
+    const collected = [];
+    const seen = new Set();
+    let totals = 0;
+    let offset = 0;
+    const pageLimit = Math.min(requestedLimit, 20);
+    const maxPages = Math.ceil(requestedLimit / pageLimit) + 2;
+
+    for (let pageIndex = 0; pageIndex < maxPages && collected.length < requestedLimit; pageIndex += 1) {
+      const currentFetchLimit = Math.min(pageLimit, requestedLimit - collected.length);
+      const url = `https://www.zhihu.com/api/v4/people/${urlToken}/collections?include=data%5B*%5D.updated_time&offset=${offset}&limit=${currentFetchLimit}`;
+      const data = await fetchJson(page, url, 'Zhihu favorite collections request');
+      const items = Array.isArray(data.data) ? data.data : [];
+      const paging = data.paging || {};
+      totals = Number(paging.totals || totals || 0);
+
+      for (const item of items) {
+        const key = collectionKey(item);
+        if (key && !seen.has(key)) {
+          seen.add(key);
+          collected.push(item);
+        }
+        if (collected.length >= requestedLimit) break;
+      }
+
+      if (items.length === 0 || paging.is_end || collected.length >= requestedLimit) break;
+      if (typeof paging.next === 'string') {
+        try {
+          const nextUrl = new URL(paging.next);
+          const parsedOffset = Number(nextUrl.searchParams.get('offset'));
+          if (Number.isInteger(parsedOffset) && parsedOffset > offset) {
+            offset = parsedOffset;
+            continue;
+          }
+        } catch {}
+      }
+      if (items.length < currentFetchLimit) break;
+      const fallbackOffset = offset + items.length;
+      if (fallbackOffset <= offset) break;
+      offset = fallbackOffset;
+      if (totals && offset >= totals) break;
+    }
+
+    if (totals > 0) {
+      log.info(`共有 ${totals} 个收藏夹`);
+    }
+
+    if (collected.length === 0) {
+      throw new EmptyResultError('zhihu collections', 'No favorite collections were returned for the logged-in user.');
+    }
+
+    return collected.slice(0, requestedLimit).map((item, i) => ({
+      rank: i + 1,
+      title: item.title || '未命名',
+      item_count: item.item_count ?? item.answer_count ?? 0,
+      description: item.description || '',
+      collection_id: String(item.id || ''),
+    }));
+  },
+});
+
+export const __test__ = {
+  validatePositiveInt,
+  collectionKey,
+};

package/clis/zhihu/collections.test.js

@@ -0,0 +1,182 @@
+import { describe, expect, it, vi } from 'vitest';
+import { getRegistry } from '@jackwener/opencli/registry';
+import { ArgumentError, AuthRequiredError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
+
+// Mock logger
+vi.mock('@jackwener/opencli/logger', () => ({
+  log: {
+    info: vi.fn(),
+    status: vi.fn(),
+    success: vi.fn(),
+    warn: vi.fn(),
+    error: vi.fn(),
+    verbose: vi.fn(),
+    debug: vi.fn(),
+    step: vi.fn(),
+    stepResult: vi.fn(),
+  },
+}));
+
+import './collections.js';
+
+describe('zhihu collections', () => {
+  it('returns list of collections', async () => {
+    const cmd = getRegistry().get('zhihu/collections');
+    expect(cmd?.func).toBeTypeOf('function');
+
+    const goto = vi.fn().mockResolvedValue(undefined);
+    let callCount = 0;
+    const evaluate = vi.fn().mockImplementation(async (js) => {
+      callCount++;
+      if (callCount === 1) {
+        expect(js).toContain('api/v4/me');
+        return { url_token: 'testuser', id: 'abc123' };
+      }
+      expect(js).toContain('people/testuser/collections');
+      return {
+        data: [
+          { id: 123456, title: '我的收藏夹', item_count: 42, description: '待读' },
+          { id: 789012, title: '技术文章', item_count: 100, description: '' },
+        ],
+        paging: { totals: 2 },
+      };
+    });
+
+    const page = { goto, evaluate };
+    const result = await cmd.func(page, { limit: 20 });
+
+    expect(result).toHaveLength(2);
+    expect(result[0]).toMatchObject({
+      rank: 1,
+      title: '我的收藏夹',
+      item_count: 42,
+      description: '待读',
+      collection_id: '123456',
+    });
+    expect(result[1]).toMatchObject({
+      rank: 2,
+      title: '技术文章',
+      item_count: 100,
+      description: '',
+      collection_id: '789012',
+    });
+    expect(evaluate).toHaveBeenCalledTimes(2);
+  });
+
+  it('returns list of collections with answer_count fallback', async () => {
+    const cmd = getRegistry().get('zhihu/collections');
+    let callCount = 0;
+    const evaluate = vi.fn().mockImplementation(async () => {
+      callCount++;
+      if (callCount === 1) {
+        return { url_token: 'testuser', id: 'abc123' };
+      }
+      return {
+        data: [{ id: 111, title: '默认收藏夹', answer_count: 15, description: 'test desc' }],
+        paging: { totals: 1 },
+      };
+    });
+
+    const page = { goto: vi.fn().mockResolvedValue(undefined), evaluate };
+    const result = await cmd.func(page, { limit: 20 });
+
+    expect(result).toHaveLength(1);
+    expect(result[0]).toMatchObject({
+      title: '默认收藏夹',
+      item_count: 15,
+      description: 'test desc',
+      collection_id: '111',
+    });
+  });
+
+  it('maps auth failures to AuthRequiredError', async () => {
+    const cmd = getRegistry().get('zhihu/collections');
+    const page = {
+      goto: vi.fn().mockResolvedValue(undefined),
+      evaluate: vi.fn().mockResolvedValue({ __httpError: 401 }),
+    };
+
+    await expect(cmd.func(page, { limit: 20 }))
+      .rejects.toBeInstanceOf(AuthRequiredError);
+  });
+
+  it('handles missing url_token', async () => {
+    const cmd = getRegistry().get('zhihu/collections');
+    let callCount = 0;
+    const page = {
+      goto: vi.fn().mockResolvedValue(undefined),
+      evaluate: vi.fn().mockImplementation(async () => {
+        callCount++;
+        if (callCount === 1) return { id: 'abc123' };
+        return {};
+      }),
+    };
+
+    await expect(cmd.func(page, { limit: 20 }))
+      .rejects.toBeInstanceOf(CommandExecutionError);
+  });
+
+  it('respects limit parameter', async () => {
+    const cmd = getRegistry().get('zhihu/collections');
+    let callCount = 0;
+    const evaluate = vi.fn().mockImplementation(async (js) => {
+      callCount++;
+      if (callCount === 1) {
+        return { url_token: 'testuser', id: 'abc123' };
+      }
+      expect(js).toContain('limit=10');
+      return {
+        data: [{ id: 1, title: 'Test', answer_count: 0, description: '' }],
+        paging: { totals: 1 },
+      };
+    });
+
+    const page = { goto: vi.fn().mockResolvedValue(undefined), evaluate };
+    const result = await cmd.func(page, { limit: 10 });
+
+    expect(result).toHaveLength(1);
+    expect(evaluate).toHaveBeenCalledTimes(2);
+  });
+
+  it('rejects invalid limits before navigation', async () => {
+    const cmd = getRegistry().get('zhihu/collections');
+    const page = { goto: vi.fn(), evaluate: vi.fn() };
+
+    await expect(cmd.func(page, { limit: 0 })).rejects.toBeInstanceOf(ArgumentError);
+    expect(page.goto).not.toHaveBeenCalled();
+  });
+
+  it('paginates collection list and deduplicates by collection id', async () => {
+    const cmd = getRegistry().get('zhihu/collections');
+    const evaluate = vi.fn()
+      .mockResolvedValueOnce({ url_token: 'testuser', id: 'abc123' })
+      .mockResolvedValueOnce({
+        data: [{ id: 1, title: 'A', item_count: 1, description: '' }],
+        paging: { totals: 3, is_end: false, next: 'https://www.zhihu.com/api/v4/people/testuser/collections?offset=1&limit=1' },
+      })
+      .mockResolvedValueOnce({
+        data: [
+          { id: 1, title: 'A duplicate', item_count: 1, description: '' },
+          { id: 2, title: 'B', item_count: 2, description: '' },
+        ],
+        paging: { totals: 3, is_end: true },
+      });
+    const page = { goto: vi.fn().mockResolvedValue(undefined), evaluate };
+
+    const result = await cmd.func(page, { limit: 2 });
+
+    expect(result.map((row) => row.title)).toEqual(['A', 'B']);
+    expect(evaluate).toHaveBeenCalledTimes(3);
+    expect(evaluate.mock.calls[2][0]).toContain('offset=1');
+  });
+
+  it('throws EmptyResultError when no collections are returned', async () => {
+    const cmd = getRegistry().get('zhihu/collections');
+    const evaluate = vi.fn()
+      .mockResolvedValueOnce({ url_token: 'testuser', id: 'abc123' })
+      .mockResolvedValueOnce({ data: [], paging: { totals: 0, is_end: true } });
+    const page = { goto: vi.fn().mockResolvedValue(undefined), evaluate };
+
+    await expect(cmd.func(page, { limit: 20 })).rejects.toBeInstanceOf(EmptyResultError);
+  });
+});

package/clis/zhihu/comment.js

@@ -2,13 +2,12 @@ import { CliError, CommandExecutionError } from '@jackwener/opencli/errors';
 import { cli, Strategy } from '@jackwener/opencli/registry';
 import { assertAllowedKinds, parseTarget } from './target.js';
 import { buildResultRow, requireExecute, resolveCurrentUserIdentity, resolvePayload } from './write-shared.js';
-const COMMENT_AUTHOR_SCOPE_SELECTOR = '.CommentItemV2-head, .CommentItem-head, .CommentItemV2-meta, .CommentItem-meta, .CommentItemV2-metaSibling, [data-comment-author], [itemprop="author"]';
 cli({
     site: 'zhihu',
     name: 'comment',
     description: 'Create a top-level comment on a Zhihu answer or article',
     domain: 'zhihu.com',
-    strategy: Strategy.UI,
+    strategy: Strategy.COOKIE,
     browser: true,
     args: [
         { name: 'target', positional: true, required: true, help: 'Zhihu target URL or typed target' },
@@ -16,7 +15,7 @@ cli({
         { name: 'file', help: 'Comment text file path' },
         { name: 'execute', type: 'boolean', help: 'Actually perform the write action' },
     ],
-    columns: ['status', 'outcome', 'message', 'target_type', 'target', 'author_identity', 'created_url', 'created_proof'],
+    columns: ['status', 'outcome', 'message', 'target_type', 'target', 'author_identity', 'created_url'],
     func: async (page, kwargs) => {
         if (!page)
             throw new CommandExecutionError('Browser session required for zhihu comment');
@@ -25,311 +24,31 @@ cli({
         const target = assertAllowedKinds('comment', parseTarget(rawTarget));
         const payload = await resolvePayload(kwargs);
         await page.goto(target.url);
+        await page.wait(3);
         const authorIdentity = await resolveCurrentUserIdentity(page);
-        const entryPath = await page.evaluate(`(() => {
-      const targetKind = ${JSON.stringify(target.kind)};
-      const targetQuestionId = ${JSON.stringify(target.kind === 'answer' ? target.questionId : null)};
-      const targetAnswerId = ${JSON.stringify(target.kind === 'answer' ? target.id : null)};
-      const restoredDraft = !!document.querySelector('[contenteditable="true"][data-draft-restored], textarea[data-draft-restored]');
-      let scope = document;
-      if (targetKind === 'answer') {
-        const block = Array.from(document.querySelectorAll('article, .AnswerItem, [data-zop-question-answer]')).find((node) => {
-          const dataAnswerId = node.getAttribute('data-answerid') || node.getAttribute('data-zop-question-answer') || '';
-          if (dataAnswerId && dataAnswerId.includes(targetAnswerId)) return true;
-          return Array.from(node.querySelectorAll('a[href*="/answer/"]')).some((link) => {
-            const href = link.getAttribute('href') || '';
-            return href.includes('/question/' + targetQuestionId + '/answer/' + targetAnswerId);
-          });
-        });
-        if (!block) return { entryPathSafe: false, wrongAnswer: true };
-        scope = block;
-      } else {
-        scope =
-          document.querySelector('article')
-          || document.querySelector('.Post-Main')
-          || document.querySelector('[itemprop="articleBody"]')
-          || document;
-      }
-      const topLevelCandidates = Array.from(scope.querySelectorAll('[contenteditable="true"], textarea')).map((editor) => {
-        const container = editor.closest('form, .CommentEditor, .CommentForm, .CommentsV2-footer, [data-comment-editor]') || editor.parentElement;
-        const replyHint = editor.getAttribute('data-reply-to') || '';
-        const text = 'value' in editor ? editor.value || '' : (editor.textContent || '');
-        const nestedReply = Boolean(container?.closest('[data-comment-id], .CommentItem'));
-        return { editor, container, replyHint, text, nestedReply };
-      }).filter((candidate) => candidate.container && !candidate.nestedReply);
-      return {
-        entryPathSafe: topLevelCandidates.length === 1
-          && !restoredDraft
-          && !topLevelCandidates[0].replyHint
-          && !String(topLevelCandidates[0].text || '').trim(),
-        wrongAnswer: false,
-      };
-    })()`);
-        if (entryPath.wrongAnswer) {
-            throw new CliError('TARGET_NOT_FOUND', 'Resolved answer target no longer matches the requested answer:<questionId>:<answerId>');
-        }
-        if (!entryPath.entryPathSafe) {
-            throw new CliError('ACTION_NOT_AVAILABLE', 'Comment entry path was not proven side-effect free');
-        }
-        const beforeSubmitSnapshot = await page.evaluate(`(() => {
-      const normalize = (value) => value.replace(/\\s+/g, ' ').trim();
-      const targetKind = ${JSON.stringify(target.kind)};
-      const targetQuestionId = ${JSON.stringify(target.kind === 'answer' ? target.questionId : null)};
-      const targetAnswerId = ${JSON.stringify(target.kind === 'answer' ? target.id : null)};
-      let scope = document;
-      if (targetKind === 'answer') {
-        const block = Array.from(document.querySelectorAll('article, .AnswerItem, [data-zop-question-answer]')).find((node) => {
-          const dataAnswerId = node.getAttribute('data-answerid') || node.getAttribute('data-zop-question-answer') || '';
-          if (dataAnswerId && dataAnswerId.includes(targetAnswerId)) return true;
-          return Array.from(node.querySelectorAll('a[href*="/answer/"]')).some((link) => {
-            const href = link.getAttribute('href') || '';
-            return href.includes('/question/' + targetQuestionId + '/answer/' + targetAnswerId);
-          });
-        });
-        if (!block) return { wrongAnswer: true, rows: [], commentLinks: [] };
-        scope = block;
-      } else {
-        scope =
-          document.querySelector('article')
-          || document.querySelector('.Post-Main')
-          || document.querySelector('[itemprop="articleBody"]')
-          || document;
-      }
-      return {
-        wrongAnswer: false,
-        rows: Array.from(scope.querySelectorAll('[data-comment-id], .CommentItem')).map((node) => ({
-          id: node.getAttribute('data-comment-id') || '',
-          text: normalize(node.textContent || ''),
-        })),
-        commentLinks: Array.from(scope.querySelectorAll('a[href*="/comment/"]'))
-          .map((node) => node.getAttribute('href') || '')
-          .filter(Boolean),
-      };
-    })()`);
-        if (beforeSubmitSnapshot.wrongAnswer) {
-            throw new CliError('TARGET_NOT_FOUND', 'Resolved answer target no longer matches the requested answer:<questionId>:<answerId>');
-        }
-        const composer = await page.evaluate(`(async () => {
-      const targetKind = ${JSON.stringify(target.kind)};
-      const targetQuestionId = ${JSON.stringify(target.kind === 'answer' ? target.questionId : null)};
-      const targetAnswerId = ${JSON.stringify(target.kind === 'answer' ? target.id : null)};
-      let scope = document;
-      if (targetKind === 'answer') {
-        const block = Array.from(document.querySelectorAll('article, .AnswerItem, [data-zop-question-answer]')).find((node) => {
-          const dataAnswerId = node.getAttribute('data-answerid') || node.getAttribute('data-zop-question-answer') || '';
-          if (dataAnswerId && dataAnswerId.includes(targetAnswerId)) return true;
-          return Array.from(node.querySelectorAll('a[href*="/answer/"]')).some((link) => {
-            const href = link.getAttribute('href') || '';
-            return href.includes('/question/' + targetQuestionId + '/answer/' + targetAnswerId);
-          });
-        });
-        if (!block) return { composerState: 'wrong_answer' };
-        scope = block;
-      } else {
-        scope =
-          document.querySelector('article')
-          || document.querySelector('.Post-Main')
-          || document.querySelector('[itemprop="articleBody"]')
-          || document;
-      }
-      const topLevelCandidates = Array.from(scope.querySelectorAll('[contenteditable="true"], textarea')).map((editor) => {
-        const container = editor.closest('form, .CommentEditor, .CommentForm, .CommentsV2-footer, [data-comment-editor]') || editor.parentElement;
-        const replyHint = editor.getAttribute('data-reply-to') || '';
-        const text = 'value' in editor ? editor.value || '' : (editor.textContent || '');
-        const nestedReply = Boolean(container?.closest('[data-comment-id], .CommentItem'));
-        return { editor, container, replyHint, text, nestedReply };
-      }).filter((candidate) => candidate.container && !candidate.nestedReply);
-      if (topLevelCandidates.length !== 1) return { composerState: 'unsafe' };
-      return {
-        composerState: !topLevelCandidates[0].replyHint && !topLevelCandidates[0].text.trim() ? 'fresh_top_level' : 'unsafe',
-      };
-    })()`);
-        if (composer.composerState === 'wrong_answer') {
-            throw new CliError('TARGET_NOT_FOUND', 'Resolved answer target no longer matches the requested answer:<questionId>:<answerId>');
-        }
-        if (composer.composerState !== 'fresh_top_level') {
-            throw new CliError('ACTION_NOT_AVAILABLE', 'Comment composer was not a fresh top-level composer');
-        }
-        const editorCheck = await page.evaluate(`(async () => {
-      const textToInsert = ${JSON.stringify(payload)};
-      const targetKind = ${JSON.stringify(target.kind)};
-      const targetQuestionId = ${JSON.stringify(target.kind === 'answer' ? target.questionId : null)};
-      const targetAnswerId = ${JSON.stringify(target.kind === 'answer' ? target.id : null)};
-      let scope = document;
-      if (targetKind === 'answer') {
-        const block = Array.from(document.querySelectorAll('article, .AnswerItem, [data-zop-question-answer]')).find((node) => {
-          const dataAnswerId = node.getAttribute('data-answerid') || node.getAttribute('data-zop-question-answer') || '';
-          if (dataAnswerId && dataAnswerId.includes(targetAnswerId)) return true;
-          return Array.from(node.querySelectorAll('a[href*="/answer/"]')).some((link) => {
-            const href = link.getAttribute('href') || '';
-            return href.includes('/question/' + targetQuestionId + '/answer/' + targetAnswerId);
-          });
-        });
-        if (!block) return { editorContent: '', mode: 'wrong_answer' };
-        scope = block;
-      } else {
-        scope =
-          document.querySelector('article')
-          || document.querySelector('.Post-Main')
-          || document.querySelector('[itemprop="articleBody"]')
-          || document;
-      }
-      const topLevelCandidates = Array.from(scope.querySelectorAll('[contenteditable="true"], textarea')).map((editor) => {
-        const container = editor.closest('form, .CommentEditor, .CommentForm, .CommentsV2-footer, [data-comment-editor]') || editor.parentElement;
-        const nestedReply = Boolean(container?.closest('[data-comment-id], .CommentItem'));
-        return { editor, container, nestedReply };
-      }).filter((candidate) => candidate.container && !candidate.nestedReply);
-      if (topLevelCandidates.length !== 1) return { editorContent: '', mode: 'missing' };
-      const { editor } = topLevelCandidates[0];
-      editor.focus();
-      if ('value' in editor) {
-        editor.value = '';
-        editor.dispatchEvent(new Event('input', { bubbles: true }));
-        editor.value = textToInsert;
-        editor.dispatchEvent(new Event('input', { bubbles: true }));
-      } else {
-        editor.textContent = '';
-        document.execCommand('insertText', false, textToInsert);
-        editor.dispatchEvent(new InputEvent('input', { bubbles: true, data: textToInsert, inputType: 'insertText' }));
-      }
-      await new Promise((resolve) => setTimeout(resolve, 200));
-      const content = 'value' in editor ? editor.value : (editor.textContent || '');
-      const replyHint = editor.getAttribute('data-reply-to') || '';
-      return { editorContent: content, mode: replyHint ? 'reply' : 'top_level' };
-    })()`);
-        if (editorCheck.mode === 'wrong_answer') {
-            throw new CliError('TARGET_NOT_FOUND', 'Resolved answer target no longer matches the requested answer:<questionId>:<answerId>');
-        }
-        if (editorCheck.mode !== 'top_level' || editorCheck.editorContent !== payload) {
-            throw new CliError('OUTCOME_UNKNOWN', 'Comment editor content did not exactly match the requested payload before submit');
-        }
-        const proof = await page.evaluate(`(async () => {
-      const normalize = (value) => value.replace(/\\s+/g, ' ').trim();
-      const commentAuthorScopeSelector = ${JSON.stringify(COMMENT_AUTHOR_SCOPE_SELECTOR)};
-      const readCommentAuthorSlug = (node) => {
-        const authorScopes = Array.from(node.querySelectorAll(commentAuthorScopeSelector));
-        const slugs = Array.from(new Set(authorScopes
-          .flatMap((scope) => Array.from(scope.querySelectorAll('a[href^="/people/"]')))
-          .map((link) => (link.getAttribute('href') || '').match(/^\\/people\\/([A-Za-z0-9_-]+)/)?.[1] || null)
-          .filter(Boolean)));
-        return slugs.length === 1 ? slugs[0] : null;
-      };
-      const targetKind = ${JSON.stringify(target.kind)};
-      const targetQuestionId = ${JSON.stringify(target.kind === 'answer' ? target.questionId : null)};
-      const targetAnswerId = ${JSON.stringify(target.kind === 'answer' ? target.id : null)};
-      let scope = document;
-      if (targetKind === 'answer') {
-        const block = Array.from(document.querySelectorAll('article, .AnswerItem, [data-zop-question-answer]')).find((node) => {
-          const dataAnswerId = node.getAttribute('data-answerid') || node.getAttribute('data-zop-question-answer') || '';
-          if (dataAnswerId && dataAnswerId.includes(targetAnswerId)) return true;
-          return Array.from(node.querySelectorAll('a[href*="/answer/"]')).some((link) => {
-            const href = link.getAttribute('href') || '';
-            return href.includes('/question/' + targetQuestionId + '/answer/' + targetAnswerId);
-          });
-        });
-        if (!block) return { proofType: 'wrong_answer' };
-        scope = block;
-      } else {
-        scope =
-          document.querySelector('article')
-          || document.querySelector('.Post-Main')
-          || document.querySelector('[itemprop="articleBody"]')
-          || document;
-      }
-
-      const topLevelCandidates = Array.from(scope.querySelectorAll('[contenteditable="true"], textarea')).map((editor) => {
-        const container = editor.closest('form, [role="dialog"], .CommentEditor, .CommentForm, .CommentsV2-footer, [data-comment-editor]') || editor.parentElement;
-        const nestedReply = Boolean(container?.closest('[data-comment-id], .CommentItem'));
-        return { editor, container, nestedReply };
-      }).filter((candidate) => candidate.container && !candidate.nestedReply);
-      if (topLevelCandidates.length !== 1) return { proofType: 'unknown' };
-      const submitScope = topLevelCandidates[0].container || scope;
-      const submit = Array.from(submitScope.querySelectorAll('button')).find((node) => /发布|评论|发送/.test(node.textContent || ''));
-      submit && submit.click();
-      await new Promise((resolve) => setTimeout(resolve, 1200));
-      const createdLink = Array.from(scope.querySelectorAll('a[href*="/comment/"]')).find((node) => {
-        const href = node.getAttribute('href') || '';
-        return href.includes('/comment/') && !${JSON.stringify(beforeSubmitSnapshot.commentLinks ?? [])}.includes(href);
-      });
-
-      if (createdLink) {
-        const card = createdLink.closest('[data-comment-id], .CommentItem, li');
-        const authorSlug = card ? readCommentAuthorSlug(card) : null;
-        const contentNode =
-          card?.querySelector('[data-comment-content], .RichContent-inner, .CommentItemV2-content, .CommentContent')
-          || card;
-        const text = normalize(contentNode?.textContent || '');
-        const nestedReply = Boolean(card?.closest('ul ul, ol ol, li li') || card?.parentElement?.closest('[data-comment-id], .CommentItem'));
-        return {
-          proofType: 'stable_url',
-          createdUrl: new URL(createdLink.getAttribute('href') || '', location.origin).href,
-          commentScope: nestedReply ? 'nested_reply' : 'top_level_only',
-          authorIdentity: authorSlug,
-          targetMatches: text === normalize(${JSON.stringify(payload)}),
-        };
-      }
-
-      const currentUserSlug = ${JSON.stringify(authorIdentity)};
-      const beforeIds = new Set(${JSON.stringify((beforeSubmitSnapshot.rows ?? []).map((row) => row.id).filter(Boolean))});
-      const beforeTexts = new Set(${JSON.stringify((beforeSubmitSnapshot.rows ?? []).map((row) => row.text).filter(Boolean))});
-      const normalizedPayload = normalize(${JSON.stringify(payload)});
-      const after = Array.from(scope.querySelectorAll('[data-comment-id], .CommentItem')).map((node) => {
-        return {
-          id: node.getAttribute('data-comment-id') || '',
-          text: normalize(node.textContent || ''),
-          authorSlug: readCommentAuthorSlug(node),
-          topLevel: !node.closest('ul ul, ol ol, li li') && !node.parentElement?.closest('[data-comment-id], .CommentItem'),
-        };
-      });
-
-      const matching = after.filter((row) =>
-        !beforeIds.has(row.id)
-        && row.authorSlug === currentUserSlug
-        && row.topLevel
-        && row.text === normalizedPayload
-        && !beforeTexts.has(row.text)
-      );
-
-      return matching.length === 1
-        ? {
-            proofType: 'fallback',
-            createdProof: {
-              proof_type: 'comment_fallback',
-              author_scope: 'current_user',
-              target_scope: 'requested_target',
-              comment_scope: 'top_level_only',
-              content_match: 'exact_normalized',
-              observed_after_submit: true,
-              present_in_pre_submit_snapshot: false,
-              new_matching_entries: 1,
-              post_submit_matching_entries: after.filter((row) =>
-                row.authorSlug === currentUserSlug && row.topLevel && row.text === normalizedPayload
-              ).length,
-              snapshot_scope: ${JSON.stringify(target.kind === 'answer'
-            ? 'stabilized_expanded_target_answer_comment_list'
-            : 'stabilized_expanded_target_article_comment_list')},
-            },
-          }
-        : { proofType: 'unknown' };
-    })()`);
-        if (proof.proofType === 'wrong_answer') {
-            throw new CliError('TARGET_NOT_FOUND', 'Resolved answer target no longer matches the requested answer:<questionId>:<answerId>');
-        }
-        if (proof.proofType === 'fallback') {
-            return buildResultRow(`Commented on ${target.kind}`, target.kind, rawTarget, 'created', {
-                author_identity: authorIdentity,
-                created_proof: proof.createdProof,
+        const apiResult = await page.evaluate(`(async () => {
+            var targetKind = ${JSON.stringify(target.kind)};
+            var targetId = ${JSON.stringify(target.id)};
+            var content = ${JSON.stringify(payload)};
+            var resourceType = targetKind === 'answer' ? 'answers' : 'articles';
+            var url = 'https://www.zhihu.com/api/v4/' + resourceType + '/' + targetId + '/comments';
+            var resp = await fetch(url, {
+                method: 'POST',
+                credentials: 'include',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ content: content }),
             });
-        }
-        if (proof.proofType !== 'stable_url') {
-            throw new CliError('OUTCOME_UNKNOWN', 'Comment submit was dispatched, but the created object could not be proven safely');
-        }
-        if (proof.commentScope !== 'top_level_only' || proof.authorIdentity !== authorIdentity || !proof.targetMatches) {
-            throw new CliError('OUTCOME_UNKNOWN', 'Stable comment URL was found, but authorship or top-level scope could not be proven safely');
-        }
-        return buildResultRow(`Commented on ${target.kind}`, target.kind, rawTarget, 'created', {
+            var data = await resp.json();
+            if (!resp.ok) return { ok: false, status: resp.status, message: data.error ? data.error.message : 'unknown error' };
+            if (!data || !data.id) return { ok: false, status: resp.status, message: 'Comment API response did not include a created comment id' };
+            return { ok: true, id: data.id, url: data.url };
+        })()`);
+        if (!apiResult?.ok) {
+            throw new CliError('COMMAND_EXEC', apiResult?.message || 'Failed to create comment');
+        }
+        return buildResultRow(`Commented on ${target.kind} ${target.id}`, target.kind, rawTarget, 'created', {
             author_identity: authorIdentity,
-            created_url: proof.createdUrl,
+            created_url: apiResult.url || '',
         });
     },
 });