@jackwener/opencli 0.9.5 → 0.9.8

package/src/clis/notion/status.ts

@@ -0,0 +1,18 @@
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const statusCommand = cli({
+  site: 'notion',
+  name: 'status',
+  description: 'Check active CDP connection to Notion Desktop',
+  domain: 'localhost',
+  strategy: Strategy.UI,
+  browser: true,
+  args: [],
+  columns: ['Status', 'Url', 'Title'],
+  func: async (page: IPage) => {
+    const url = await page.evaluate('window.location.href');
+    const title = await page.evaluate('document.title');
+    return [{ Status: 'Connected', Url: url, Title: title }];
+  },
+});

package/src/clis/notion/write.ts

@@ -0,0 +1,45 @@
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const writeCommand = cli({
+  site: 'notion',
+  name: 'write',
+  description: 'Append text content to the currently open Notion page',
+  domain: 'localhost',
+  strategy: Strategy.UI,
+  browser: true,
+  args: [{ name: 'text', required: true, positional: true, help: 'Text to append to the page' }],
+  columns: ['Status'],
+  func: async (page: IPage, kwargs: any) => {
+    const text = kwargs.text as string;
+
+    // Focus the page body and move to the end
+    await page.evaluate(`
+      (function(text) {
+        // Find the editable area in Notion
+        const editables = document.querySelectorAll('.notion-page-content [contenteditable="true"], [class*="page-content"] [contenteditable="true"]');
+        let target = editables.length > 0 ? editables[editables.length - 1] : null;
+        
+        if (!target) {
+          // Fallback: just find any contenteditable
+          const all = document.querySelectorAll('[contenteditable="true"]');
+          target = all.length > 0 ? all[all.length - 1] : null;
+        }
+        
+        if (!target) throw new Error('Could not find editable area in Notion page');
+        
+        target.focus();
+        // Move to end
+        const sel = window.getSelection();
+        sel.selectAllChildren(target);
+        sel.collapseToEnd();
+        
+        document.execCommand('insertText', false, text);
+      })(${JSON.stringify(text)})
+    `);
+
+    await page.wait(0.5);
+
+    return [{ Status: 'Text appended successfully' }];
+  },
+});

package/src/clis/twitter/download.ts

@@ -0,0 +1,227 @@
+/**
+ * Twitter/X download — download images and videos from tweets.
+ *
+ * Usage:
+ *   opencli twitter download --username elonmusk --limit 10 --output ./twitter
+ *   opencli twitter download --tweet-url https://x.com/xxx/status/123 --output ./twitter
+ */
+
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { cli, Strategy } from '../../registry.js';
+import {
+  httpDownload,
+  ytdlpDownload,
+  checkYtdlp,
+  sanitizeFilename,
+  getTempDir,
+  exportCookiesToNetscape,
+} from '../../download/index.js';
+import { DownloadProgressTracker, formatBytes } from '../../download/progress.js';
+
+cli({
+  site: 'twitter',
+  name: 'download',
+  description: '下载 Twitter/X 媒体（图片和视频）',
+  domain: 'x.com',
+  strategy: Strategy.COOKIE,
+  args: [
+    { name: 'username', help: 'Twitter username (downloads from media tab)' },
+    { name: 'tweet-url', help: 'Single tweet URL to download' },
+    { name: 'limit', type: 'int', default: 10, help: 'Number of tweets to scan' },
+    { name: 'output', default: './twitter-downloads', help: 'Output directory' },
+  ],
+  columns: ['index', 'type', 'status', 'size'],
+  func: async (page, kwargs) => {
+    const username = kwargs.username;
+    const tweetUrl = kwargs['tweet-url'];
+    const limit = kwargs.limit;
+    const output = kwargs.output;
+
+    if (!username && !tweetUrl) {
+      return [{
+        index: 0,
+        type: '-',
+        status: 'failed',
+        size: 'Must provide --username or --tweet-url',
+      }];
+    }
+
+    // Navigate to the appropriate page
+    if (tweetUrl) {
+      await page.goto(tweetUrl);
+    } else {
+      await page.goto(`https://x.com/${username}/media`);
+    }
+    await page.wait(3);
+
+    // Scroll to load more content
+    if (!tweetUrl) {
+      await page.autoScroll({ times: Math.ceil(limit / 5) });
+    }
+
+    // Extract media URLs
+    const data = await page.evaluate(`
+      (() => {
+        const media = [];
+
+        // Find images (high quality)
+        document.querySelectorAll('img[src*="pbs.twimg.com/media"]').forEach(img => {
+          let src = img.src || '';
+          // Get large version
+          src = src.replace(/&name=\\w+$/, '&name=large');
+          src = src.replace(/\\?format=/, '?format=');
+          if (!src.includes('&name=')) {
+            src = src + '&name=large';
+          }
+          media.push({ type: 'image', url: src });
+        });
+
+        // Find videos
+        document.querySelectorAll('video').forEach(video => {
+          const src = video.src || '';
+          if (src) {
+            media.push({ type: 'video', url: src, poster: video.poster || '' });
+          }
+        });
+
+        // Find video tweets (for yt-dlp)
+        document.querySelectorAll('[data-testid="videoPlayer"]').forEach(player => {
+          const tweetLink = player.closest('article')?.querySelector('a[href*="/status/"]');
+          const href = tweetLink?.getAttribute('href') || '';
+          if (href) {
+            const tweetUrl = 'https://x.com' + href;
+            media.push({ type: 'video-tweet', url: tweetUrl });
+          }
+        });
+
+        return media;
+      })()
+    `);
+
+    if (!data || data.length === 0) {
+      return [{
+        index: 0,
+        type: '-',
+        status: 'failed',
+        size: 'No media found',
+      }];
+    }
+
+    // Extract cookies
+    const cookieString = await page.evaluate(`(() => document.cookie)()`);
+
+    // Create output directory
+    const outputDir = tweetUrl
+      ? path.join(output, 'tweets')
+      : path.join(output, username || 'media');
+    fs.mkdirSync(outputDir, { recursive: true });
+
+    // Export cookies for yt-dlp
+    let cookiesFile: string | undefined;
+    if (typeof cookieString === 'string' && cookieString) {
+      const tempDir = getTempDir();
+      fs.mkdirSync(tempDir, { recursive: true });
+      cookiesFile = path.join(tempDir, `twitter_cookies_${Date.now()}.txt`);
+
+      const cookies = cookieString.split(';').map((c) => {
+        const [name, ...rest] = c.trim().split('=');
+        return {
+          name: name || '',
+          value: rest.join('=') || '',
+          domain: '.x.com',
+          path: '/',
+          secure: true,
+          httpOnly: false,
+        };
+      }).filter((c) => c.name);
+
+      exportCookiesToNetscape(cookies, cookiesFile);
+    }
+
+    // Deduplicate media
+    const seen = new Set<string>();
+    const uniqueMedia = data.filter((m: any) => {
+      if (seen.has(m.url)) return false;
+      seen.add(m.url);
+      return true;
+    }).slice(0, limit);
+
+    const tracker = new DownloadProgressTracker(uniqueMedia.length, true);
+    const results: any[] = [];
+
+    for (let i = 0; i < uniqueMedia.length; i++) {
+      const media = uniqueMedia[i];
+      const ext = media.type === 'image' ? 'jpg' : 'mp4';
+      const filename = `${username || 'tweet'}_${i + 1}.${ext}`;
+      const destPath = path.join(outputDir, filename);
+
+      const progressBar = tracker.onFileStart(filename, i);
+
+      try {
+        let result: { success: boolean; size: number; error?: string };
+
+        if (media.type === 'video-tweet' && checkYtdlp()) {
+          // Use yt-dlp for video tweets
+          result = await ytdlpDownload(media.url, destPath, {
+            cookiesFile,
+            extraArgs: ['--merge-output-format', 'mp4'],
+            onProgress: (percent) => {
+              if (progressBar) progressBar.update(percent, 100);
+            },
+          });
+        } else if (media.type === 'image') {
+          // Direct HTTP download for images
+          result = await httpDownload(media.url, destPath, {
+            cookies: typeof cookieString === 'string' ? cookieString : '',
+            timeout: 30000,
+            onProgress: (received, total) => {
+              if (progressBar) progressBar.update(received, total);
+            },
+          });
+        } else {
+          // Direct HTTP download for direct video URLs
+          result = await httpDownload(media.url, destPath, {
+            cookies: typeof cookieString === 'string' ? cookieString : '',
+            timeout: 60000,
+            onProgress: (received, total) => {
+              if (progressBar) progressBar.update(received, total);
+            },
+          });
+        }
+
+        if (progressBar) {
+          progressBar.complete(result.success, result.success ? formatBytes(result.size) : undefined);
+        }
+
+        tracker.onFileComplete(result.success);
+
+        results.push({
+          index: i + 1,
+          type: media.type === 'video-tweet' ? 'video' : media.type,
+          status: result.success ? 'success' : 'failed',
+          size: result.success ? formatBytes(result.size) : (result.error || 'unknown error'),
+        });
+      } catch (err: any) {
+        if (progressBar) progressBar.fail(err.message);
+        tracker.onFileComplete(false);
+
+        results.push({
+          index: i + 1,
+          type: media.type,
+          status: 'failed',
+          size: err.message,
+        });
+      }
+    }
+
+    tracker.finish();
+
+    // Cleanup cookies file
+    if (cookiesFile && fs.existsSync(cookiesFile)) {
+      fs.unlinkSync(cookiesFile);
+    }
+
+    return results;
+  },
+});

package/src/clis/wechat/README.md

@@ -0,0 +1,28 @@
+# WeChat (微信) Desktop Adapter
+
+Control **WeChat Mac Desktop** from the terminal via AppleScript + Accessibility API.
+
+> **Note:** WeChat is a native macOS app (not Electron), so CDP is not available. This adapter uses AppleScript keyboard simulation and clipboard operations.
+
+## Prerequisites
+
+1. WeChat must be running and logged in
+2. Terminal must have **Accessibility permission** (System Settings → Privacy & Security → Accessibility)
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `wechat status` | Check if WeChat is running |
+| `wechat send "msg"` | Send message in the active chat (clipboard paste + Enter) |
+| `wechat read` | Read current chat content (Cmd+A → Cmd+C) |
+| `wechat search "keyword"` | Open search and type a query (Cmd+F) |
+| `wechat chats` | Switch to Chats tab (Cmd+1) |
+| `wechat contacts` | Switch to Contacts tab (Cmd+2) |
+
+## Limitations
+
+- **No CDP support** — WeChat is native Cocoa, not Electron
+- `send` requires the correct conversation to be already open
+- `read` captures whatever is visible via select-all + copy
+- `search` types the query but cannot programmatically click results

package/src/clis/wechat/README.zh-CN.md

@@ -0,0 +1,28 @@
+# 微信桌面端适配器
+
+通过 AppleScript + Accessibility API 在终端中控制**微信 Mac 桌面端**。
+
+> **注意：** 微信是原生 macOS 应用（非 Electron），因此无法使用 CDP。此适配器使用 AppleScript 键盘模拟和剪贴板操作。
+
+## 前置条件
+
+1. 微信必须正在运行且已登录
+2. Terminal 需要 **辅助功能权限**（系统设置 → 隐私与安全性 → 辅助功能）
+
+## 命令
+
+| 命令 | 说明 |
+|------|------|
+| `wechat status` | 检查微信是否在运行 |
+| `wechat send "消息"` | 发送消息（剪贴板粘贴 + 回车） |
+| `wechat read` | 读取当前聊天内容（Cmd+A → Cmd+C） |
+| `wechat search "关键词"` | 打开搜索并输入关键词（Cmd+F） |
+| `wechat chats` | 切换到聊天列表（Cmd+1） |
+| `wechat contacts` | 切换到通讯录（Cmd+2） |
+
+## 限制
+
+- **不支持 CDP** — 微信是原生 Cocoa 应用
+- `send` 需要先手动打开正确的会话
+- `read` 通过全选+复制来获取可见内容
+- `search` 可以输入关键词但无法自动点击结果

package/src/clis/wechat/chats.ts

@@ -0,0 +1,33 @@
+import { execSync } from 'node:child_process';
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const chatsCommand = cli({
+  site: 'wechat',
+  name: 'chats',
+  description: 'Open the WeChat chats panel (conversation list)',
+  domain: 'localhost',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [],
+  columns: ['Status'],
+  func: async (page: IPage | null) => {
+    try {
+      // Activate WeChat
+      execSync("osascript -e 'tell application \"WeChat\" to activate'");
+      execSync("osascript -e 'delay 0.3'");
+
+      // Cmd+1 switches to Chats tab in WeChat Mac
+      execSync(
+        "osascript " +
+        "-e 'tell application \"System Events\"' " +
+        "-e 'keystroke \"1\" using command down' " +
+        "-e 'end tell'"
+      );
+
+      return [{ Status: 'Chats panel opened (Cmd+1)' }];
+    } catch (err: any) {
+      return [{ Status: 'Error: ' + err.message }];
+    }
+  },
+});

package/src/clis/wechat/contacts.ts

@@ -0,0 +1,33 @@
+import { execSync } from 'node:child_process';
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const contactsCommand = cli({
+  site: 'wechat',
+  name: 'contacts',
+  description: 'Open the WeChat contacts panel',
+  domain: 'localhost',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [],
+  columns: ['Status'],
+  func: async (page: IPage | null) => {
+    try {
+      // Activate WeChat
+      execSync("osascript -e 'tell application \"WeChat\" to activate'");
+      execSync("osascript -e 'delay 0.3'");
+
+      // Cmd+2 switches to Contacts tab in WeChat Mac
+      execSync(
+        "osascript " +
+        "-e 'tell application \"System Events\"' " +
+        "-e 'keystroke \"2\" using command down' " +
+        "-e 'end tell'"
+      );
+
+      return [{ Status: 'Contacts panel opened (Cmd+2)' }];
+    } catch (err: any) {
+      return [{ Status: 'Error: ' + err.message }];
+    }
+  },
+});

package/src/clis/wechat/read.ts

@@ -0,0 +1,72 @@
+import { execSync, spawnSync } from 'node:child_process';
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const readCommand = cli({
+  site: 'wechat',
+  name: 'read',
+  description: 'Read the current chat content by selecting all and copying',
+  domain: 'localhost',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [],
+  columns: ['Content'],
+  func: async (page: IPage | null) => {
+    try {
+      // Backup clipboard
+      let clipBackup = '';
+      try {
+        clipBackup = execSync('pbpaste', { encoding: 'utf-8' });
+      } catch { /* empty */ }
+
+      // Activate WeChat
+      execSync("osascript -e 'tell application \"WeChat\" to activate'");
+      execSync("osascript -e 'delay 0.3'");
+
+      // Click on the chat area first, then select all and copy
+      execSync(
+        "osascript " +
+        "-e 'tell application \"System Events\"' " +
+        "-e 'tell application process \"WeChat\"' " +
+        // Click in the message area (center-right of the window)
+        "-e 'set frontWin to front window' " +
+        "-e 'set winPos to position of frontWin' " +
+        "-e 'set winSize to size of frontWin' " +
+        "-e 'end tell' " +
+        "-e 'end tell'"
+      );
+
+      execSync("osascript -e 'delay 0.2'");
+
+      // Select all text in chat area and copy
+      execSync(
+        "osascript " +
+        "-e 'tell application \"System Events\"' " +
+        "-e 'keystroke \"a\" using command down' " +
+        "-e 'delay 0.2' " +
+        "-e 'keystroke \"c\" using command down' " +
+        "-e 'delay 0.2' " +
+        "-e 'end tell'"
+      );
+
+      const content = execSync('pbpaste', { encoding: 'utf-8' }).trim();
+
+      // Restore clipboard
+      if (clipBackup) {
+        spawnSync('pbcopy', { input: clipBackup });
+      }
+
+      // Press Escape to deselect
+      execSync(
+        "osascript " +
+        "-e 'tell application \"System Events\"' " +
+        "-e 'key code 53' " + // Escape
+        "-e 'end tell'"
+      );
+
+      return [{ Content: content || '(no content captured)' }];
+    } catch (err: any) {
+      return [{ Content: 'Error: ' + err.message }];
+    }
+  },
+});

package/src/clis/wechat/search.ts

@@ -0,0 +1,36 @@
+import { execSync } from 'node:child_process';
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const searchCommand = cli({
+  site: 'wechat',
+  name: 'search',
+  description: 'Open WeChat search and type a query (find contacts or messages)',
+  domain: 'localhost',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [{ name: 'query', required: true, positional: true, help: 'Search query (contact name or keyword)' }],
+  columns: ['Status'],
+  func: async (page: IPage | null, kwargs: any) => {
+    const query = kwargs.query as string;
+    try {
+      // Activate WeChat
+      execSync("osascript -e 'tell application \"WeChat\" to activate'");
+      execSync("osascript -e 'delay 0.3'");
+
+      // Cmd+F to open search (WeChat Mac uses Cmd+F for search)
+      execSync(
+        "osascript " +
+        "-e 'tell application \"System Events\"' " +
+        "-e 'keystroke \"f\" using command down' " +
+        "-e 'delay 0.5' " +
+        `-e 'keystroke ${JSON.stringify(query)}' ` +
+        "-e 'end tell'"
+      );
+
+      return [{ Status: `Searching for: ${query}` }];
+    } catch (err: any) {
+      return [{ Status: 'Error: ' + err.message }];
+    }
+  },
+});

package/src/clis/wechat/send.ts

@@ -0,0 +1,49 @@
+import { execSync, spawnSync } from 'node:child_process';
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const sendCommand = cli({
+  site: 'wechat',
+  name: 'send',
+  description: 'Send a message in the active WeChat conversation via clipboard paste',
+  domain: 'localhost',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [{ name: 'text', required: true, positional: true, help: 'Message to send' }],
+  columns: ['Status'],
+  func: async (page: IPage | null, kwargs: any) => {
+    const text = kwargs.text as string;
+    try {
+      // Backup clipboard
+      let clipBackup = '';
+      try {
+        clipBackup = execSync('pbpaste', { encoding: 'utf-8' });
+      } catch { /* clipboard may be empty */ }
+
+      // Copy text to clipboard
+      spawnSync('pbcopy', { input: text });
+
+      // Activate WeChat and paste
+      execSync("osascript -e 'tell application \"WeChat\" to activate'");
+      execSync("osascript -e 'delay 0.5'");
+
+      execSync(
+        "osascript " +
+        "-e 'tell application \"System Events\"' " +
+        "-e 'keystroke \"v\" using command down' " +
+        "-e 'delay 0.2' " +
+        "-e 'keystroke return' " +
+        "-e 'end tell'"
+      );
+
+      // Restore clipboard
+      if (clipBackup) {
+        spawnSync('pbcopy', { input: clipBackup });
+      }
+
+      return [{ Status: 'Success' }];
+    } catch (err: any) {
+      return [{ Status: 'Error: ' + err.message }];
+    }
+  },
+});

package/src/clis/wechat/status.ts

@@ -0,0 +1,35 @@
+import { execSync } from 'node:child_process';
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const statusCommand = cli({
+  site: 'wechat',
+  name: 'status',
+  description: 'Check if WeChat Desktop is running on macOS',
+  domain: 'localhost',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [],
+  columns: ['Status', 'Detail'],
+  func: async (page: IPage | null) => {
+    try {
+      const running = execSync("osascript -e 'application \"WeChat\" is running'", { encoding: 'utf-8' }).trim();
+      if (running !== 'true') {
+        return [{ Status: 'Stopped', Detail: 'WeChat is not running' }];
+      }
+
+      // Get window count to check if logged in
+      const windowCount = execSync(
+        "osascript -e 'tell application \"System Events\" to count windows of application process \"WeChat\"'",
+        { encoding: 'utf-8' }
+      ).trim();
+
+      return [{
+        Status: 'Running',
+        Detail: `${windowCount} window(s) open`,
+      }];
+    } catch (err: any) {
+      return [{ Status: 'Error', Detail: err.message }];
+    }
+  },
+});