@jackwener/opencli 1.0.6 → 1.1.1

package/src/clis/cursor/model.ts

@@ -9,11 +9,11 @@ export const modelCommand = cli({
   strategy: Strategy.UI,
   browser: true,
   args: [
-    { name: 'model_name', required: false, positional: true, help: 'The ID of the model to switch to (e.g. claude-3.5-sonnet)' }
+    { name: 'model-name', required: false, positional: true, help: 'The ID of the model to switch to (e.g. claude-3.5-sonnet)' }
   ],
   columns: ['Status', 'Model'],
   func: async (page: IPage, kwargs: any) => {
-    const desiredModel = kwargs.model_name as string | undefined;
+    const desiredModel = kwargs['model-name'] as string | undefined;
 
     if (!desiredModel) {
       // Just read the current model

package/src/clis/cursor/screenshot.ts

@@ -11,7 +11,7 @@ function makeScreenshotCommand(site: string) {
     strategy: Strategy.UI,
     browser: true,
     args: [
-      { name: 'output', required: false, positional: true, help: `Output file path (default: /tmp/${site}-snapshot.txt)` },
+      { name: 'output', required: false,  help: `Output file path (default: /tmp/${site}-snapshot.txt)` },
     ],
     columns: ['Status', 'File'],
     func: async (page: IPage, kwargs: any) => {

package/src/clis/jike/comment.ts

@@ -15,13 +15,12 @@ cli({
   strategy: Strategy.UI,
   browser: true,
   args: [
-    { name: 'id', type: 'string', required: true, help: '帖子 ID' },
-    { name: 'text', type: 'string', required: true, help: '评论内容' },
+    { name: 'id', type: 'string', required: true, positional: true, help: '帖子 ID' },
+    { name: 'text', type: 'string', required: true, positional: true, help: '评论内容' },
   ],
   columns: ['status', 'message'],
   func: async (page, kwargs) => {
     await page.goto(`https://web.okjike.com/originalPost/${kwargs.id}`);
-    await page.wait(5);
 
     // 1. 找到评论输入框并填入文本
     const inputResult = await page.evaluate(`(async () => {

package/src/clis/jike/create.ts

@@ -15,13 +15,12 @@ cli({
   strategy: Strategy.UI,
   browser: true,
   args: [
-    { name: 'text', type: 'string', required: true, help: '动态正文内容' },
+    { name: 'text', type: 'string', required: true, positional: true, help: '动态正文内容' },
   ],
   columns: ['status', 'message'],
   func: async (page, kwargs) => {
     // 1. 导航到首页（有内联发帖框）
     await page.goto('https://web.okjike.com');
-    await page.wait(5);
 
     // 2. 在发帖框中输入文本
     const textResult = await page.evaluate(`(async () => {

package/src/clis/jike/feed.ts

@@ -24,7 +24,6 @@ cli({
 
     // 1. 导航到即刻首页，等待 SPA 重定向到 /following
     await page.goto('https://web.okjike.com');
-    await page.wait(5);
 
     // 2. 通过 React fiber 提取帖子数据
     const extract = async (): Promise<JikePost[]> => {

package/src/clis/jike/like.ts

@@ -15,13 +15,12 @@ cli({
   strategy: Strategy.UI,
   browser: true,
   args: [
-    { name: 'id', type: 'string', required: true, help: '帖子 ID' },
+    { name: 'id', type: 'string', required: true, positional: true, help: '帖子 ID' },
   ],
   columns: ['status', 'message'],
   func: async (page, kwargs) => {
     // 1. 导航到帖子详情页
     await page.goto(`https://web.okjike.com/originalPost/${kwargs.id}`);
-    await page.wait(5);
 
     // 2. 找到点赞按钮并点击
     const result = await page.evaluate(`(async () => {

package/src/clis/jike/notifications.ts

@@ -44,7 +44,6 @@ cli({
 
     // 1. 直接导航到通知页
     await page.goto('https://web.okjike.com/notification');
-    await page.wait(5);
 
     // 3. 优先用 React fiber 提取通知数据
     //    通知 fiber 数据结构与帖子不同，需查找含 type + user 字段的 props

package/src/clis/jike/post.yaml

@@ -6,6 +6,7 @@ browser: true
 
 args:
   id:
+    positional: true
     type: string
     required: true
     description: Post ID (from post URL)

package/src/clis/jike/repost.ts

@@ -16,13 +16,12 @@ cli({
   strategy: Strategy.UI,
   browser: true,
   args: [
-    { name: 'id', type: 'string', required: true, help: '帖子 ID' },
+    { name: 'id', type: 'string', required: true, positional: true, help: '帖子 ID' },
     { name: 'text', type: 'string', required: false, help: '转发附言（可选）' },
   ],
   columns: ['status', 'message'],
   func: async (page, kwargs) => {
     await page.goto(`https://web.okjike.com/originalPost/${kwargs.id}`);
-    await page.wait(5);
 
     // 1. 点击操作栏中的转发按钮（第三个子元素）
     const clickResult = await page.evaluate(`(async () => {

package/src/clis/jike/search.ts

@@ -16,18 +16,17 @@ cli({
   strategy: Strategy.COOKIE,
   browser: true,
   args: [
-    { name: 'keyword', type: 'string', required: true },
+    { name: 'query', type: 'string', required: true, positional: true },
     { name: 'limit', type: 'int', default: 20 },
   ],
   columns: ['author', 'content', 'likes', 'comments', 'time', 'url'],
   func: async (page, kwargs) => {
-    const keyword = kwargs.keyword as string;
+    const keyword = kwargs.query as string;
     const limit = (kwargs.limit as number) || 20;
 
     // 1. 直接导航到搜索页
     const encodedKeyword = encodeURIComponent(keyword);
     await page.goto(`https://web.okjike.com/search?q=${encodedKeyword}`);
-    await page.wait(5);
 
     // 2. 通过 React fiber 提取帖子数据
     const extract = async (): Promise<JikePost[]> => {

package/src/clis/jike/topic.yaml

@@ -6,6 +6,7 @@ browser: true
 
 args:
   id:
+    positional: true
     type: string
     required: true
     description: Topic ID (from topic URL, e.g. 553870e8e4b0cafb0a1bef68)

package/src/clis/jike/user.yaml

@@ -6,6 +6,7 @@ browser: true
 
 args:
   username:
+    positional: true
     type: string
     required: true
     description: Username from profile URL (e.g. wenhao1996)

package/src/clis/jimeng/history.yaml

@@ -14,7 +14,6 @@ columns: [prompt, model, status, image_url, created_at]
 
 pipeline:
   - navigate: https://jimeng.jianying.com/ai-tool/generate?type=image&workspace=0
-  - wait: 3
   - evaluate: |
       (async () => {
         const limit = ${{ args.limit }};

package/src/clis/linkedin/search.ts

@@ -368,15 +368,15 @@ cli({
   strategy: Strategy.HEADER,
   browser: true,
   args: [
-    { name: 'query', type: 'string', required: true, help: 'Job search keywords' },
+    { name: 'query', type: 'string', required: true, positional: true, help: 'Job search keywords' },
     { name: 'location', type: 'string', required: false, help: 'Location text such as San Francisco Bay Area' },
     { name: 'limit', type: 'int', default: 10, help: 'Number of jobs to return (max 100)' },
     { name: 'start', type: 'int', default: 0, help: 'Result offset for pagination' },
     { name: 'details', type: 'bool', default: false, help: 'Include full job description and apply URL (slower)' },
     { name: 'company', type: 'string', required: false, help: 'Comma-separated company names or LinkedIn company IDs' },
-    { name: 'experience_level', type: 'string', required: false, help: 'Comma-separated: internship, entry, associate, mid-senior, director, executive' },
-    { name: 'job_type', type: 'string', required: false, help: 'Comma-separated: full-time, part-time, contract, temporary, volunteer, internship, other' },
-    { name: 'date_posted', type: 'string', required: false, help: 'One of: any, month, week, 24h' },
+    { name: 'experience-level', type: 'string', required: false, help: 'Comma-separated: internship, entry, associate, mid-senior, director, executive' },
+    { name: 'job-type', type: 'string', required: false, help: 'Comma-separated: full-time, part-time, contract, temporary, volunteer, internship, other' },
+    { name: 'date-posted', type: 'string', required: false, help: 'One of: any, month, week, 24h' },
     { name: 'remote', type: 'string', required: false, help: 'Comma-separated: on-site, hybrid, remote' },
   ],
   columns: ['rank', 'title', 'company', 'location', 'listed', 'salary', 'url'],
@@ -402,9 +402,9 @@ cli({
       limit,
       start,
       companyIds,
-      experienceLevels: mapFilterValues(kwargs.experience_level, EXPERIENCE_LEVELS, 'experience_level'),
-      jobTypes: mapFilterValues(kwargs.job_type, JOB_TYPES, 'job_type'),
-      datePostedValues: mapFilterValues(kwargs.date_posted, DATE_POSTED, 'date_posted'),
+      experienceLevels: mapFilterValues(kwargs['experience-level'], EXPERIENCE_LEVELS, 'experience_level'),
+      jobTypes: mapFilterValues(kwargs['job-type'], JOB_TYPES, 'job_type'),
+      datePostedValues: mapFilterValues(kwargs['date-posted'], DATE_POSTED, 'date_posted'),
       remoteTypes: mapFilterValues(kwargs.remote, REMOTE_TYPES, 'remote'),
     };
 

package/src/clis/linux-do/category.yaml

@@ -10,6 +10,7 @@ args:
     required: true
     description: Category slug (use 'categories' command to find)
   id:
+    positional: true
     type: int
     required: true
     description: Category ID (use 'categories' command to find)

package/src/clis/linux-do/search.yaml

@@ -5,10 +5,11 @@ domain: linux.do
 browser: true
 
 args:
-  keyword:
+  query:
+    positional: true
     type: str
     required: true
-    description: Search keyword
+    description: Search query
   limit:
     type: int
     default: 20
@@ -19,7 +20,7 @@ pipeline:
 
   - evaluate: |
       (async () => {
-        const keyword = ${{ args.keyword | json }};
+        const keyword = ${{ args.query | json }};
         const res = await fetch('/search.json?q=' + encodeURIComponent(keyword), { credentials: 'include' });
         if (!res.ok) throw new Error('HTTP ' + res.status + ' - 请先登录 linux.do');
         let data;

package/src/clis/linux-do/topic.yaml

@@ -6,6 +6,7 @@ browser: true
 
 args:
   id:
+    positional: true
     type: int
     required: true
     description: Topic ID

package/src/clis/notion/export.ts

@@ -10,7 +10,7 @@ export const exportCommand = cli({
   strategy: Strategy.UI,
   browser: true,
   args: [
-    { name: 'output', required: false, positional: true, help: 'Output file (default: /tmp/notion-export.md)' },
+    { name: 'output', required: false,  help: 'Output file (default: /tmp/notion-export.md)' },
   ],
   columns: ['Status', 'File'],
   func: async (page: IPage, kwargs: any) => {

package/src/clis/reddit/comment.ts

@@ -8,19 +8,18 @@ cli({
   strategy: Strategy.COOKIE,
   browser: true,
   args: [
-    { name: 'post_id', type: 'string', required: true, help: 'Post ID (e.g. 1abc123) or fullname (t3_xxx)' },
-    { name: 'text', type: 'string', required: true, help: 'Comment text' },
+    { name: 'post-id', type: 'string', required: true, help: 'Post ID (e.g. 1abc123) or fullname (t3_xxx)' },
+    { name: 'text', type: 'string', required: true, positional: true, help: 'Comment text' },
   ],
   columns: ['status', 'message'],
   func: async (page, kwargs) => {
     if (!page) throw new Error('Requires browser');
 
     await page.goto('https://www.reddit.com');
-    await page.wait(3);
 
     const result = await page.evaluate(`(async () => {
       try {
-        let postId = ${JSON.stringify(kwargs.post_id)};
+        let postId = ${JSON.stringify(kwargs['post-id'])};
         const urlMatch = postId.match(/comments\\/([a-z0-9]+)/);
         if (urlMatch) postId = urlMatch[1];
         const fullname = postId.startsWith('t3_') || postId.startsWith('t1_')

package/src/clis/reddit/read.ts

@@ -15,12 +15,12 @@ cli({
   domain: 'reddit.com',
   strategy: Strategy.COOKIE,
   args: [
-    { name: 'post_id', required: true, help: 'Post ID (e.g. 1abc123) or full URL' },
+    { name: 'post-id', required: true, help: 'Post ID (e.g. 1abc123) or full URL' },
     { name: 'sort', default: 'best', help: 'Comment sort: best, top, new, controversial, old, qa' },
     { name: 'limit', type: 'int', default: 25, help: 'Number of top-level comments' },
     { name: 'depth', type: 'int', default: 2, help: 'Max reply depth (1=no replies, 2=one level of replies, etc.)' },
     { name: 'replies', type: 'int', default: 5, help: 'Max replies shown per comment at each level (sorted by score)' },
-    { name: 'max_length', type: 'int', default: 2000, help: 'Max characters per comment body (min 100)' },
+    { name: 'max-length', type: 'int', default: 2000, help: 'Max characters per comment body (min 100)' },
   ],
   columns: ['type', 'author', 'score', 'text'],
   func: async (page, kwargs) => {
@@ -28,14 +28,13 @@ cli({
     const limit = Math.max(1, kwargs.limit ?? 25);
     const maxDepth = Math.max(1, kwargs.depth ?? 2);
     const maxReplies = Math.max(1, kwargs.replies ?? 5);
-    const maxLength = Math.max(100, kwargs.max_length ?? 2000);
+    const maxLength = Math.max(100, kwargs['max-length'] ?? 2000);
 
     await page.goto('https://www.reddit.com');
-    await page.wait(2);
 
     const data = await page.evaluate(`
       (async function() {
-        var postId = ${JSON.stringify(kwargs.post_id)};
+        var postId = ${JSON.stringify(kwargs['post-id'])};
         var urlMatch = postId.match(/comments\\/([a-z0-9]+)/);
         if (urlMatch) postId = urlMatch[1];
 

package/src/clis/reddit/save.ts

@@ -8,7 +8,7 @@ cli({
   strategy: Strategy.COOKIE,
   browser: true,
   args: [
-    { name: 'post_id', type: 'string', required: true, help: 'Post ID (e.g. 1abc123) or fullname (t3_xxx)' },
+    { name: 'post-id', type: 'string', required: true, help: 'Post ID (e.g. 1abc123) or fullname (t3_xxx)' },
     { name: 'undo', type: 'boolean', default: false, help: 'Unsave instead of save' },
   ],
   columns: ['status', 'message'],
@@ -16,11 +16,10 @@ cli({
     if (!page) throw new Error('Requires browser');
 
     await page.goto('https://www.reddit.com');
-    await page.wait(3);
 
     const result = await page.evaluate(`(async () => {
       try {
-        let postId = ${JSON.stringify(kwargs.post_id)};
+        let postId = ${JSON.stringify(kwargs['post-id'])};
         const urlMatch = postId.match(/comments\\/([a-z0-9]+)/);
         if (urlMatch) postId = urlMatch[1];
         const fullname = postId.startsWith('t3_') || postId.startsWith('t1_')

package/src/clis/reddit/saved.ts

@@ -15,7 +15,6 @@ cli({
     if (!page) throw new Error('Requires browser');
 
     await page.goto('https://www.reddit.com');
-    await page.wait(3);
 
     const result = await page.evaluate(`(async () => {
       try {

package/src/clis/reddit/search.yaml

@@ -7,6 +7,7 @@ browser: true
 
 args:
   query:
+    positional: true
     type: string
     required: true
   subreddit:

package/src/clis/reddit/subscribe.ts

@@ -16,7 +16,6 @@ cli({
     if (!page) throw new Error('Requires browser');
 
     await page.goto('https://www.reddit.com');
-    await page.wait(3);
 
     const result = await page.evaluate(`(async () => {
       try {

package/src/clis/reddit/upvote.ts

@@ -8,7 +8,7 @@ cli({
   strategy: Strategy.COOKIE,
   browser: true,
   args: [
-    { name: 'post_id', type: 'string', required: true, help: 'Post ID (e.g. 1abc123) or fullname (t3_xxx)' },
+    { name: 'post-id', type: 'string', required: true, help: 'Post ID (e.g. 1abc123) or fullname (t3_xxx)' },
     { name: 'direction', type: 'string', default: 'up', help: 'Vote direction: up, down, none' },
   ],
   columns: ['status', 'message'],
@@ -16,11 +16,10 @@ cli({
     if (!page) throw new Error('Requires browser');
 
     await page.goto('https://www.reddit.com');
-    await page.wait(3);
 
     const result = await page.evaluate(`(async () => {
       try {
-        let postId = ${JSON.stringify(kwargs.post_id)};
+        let postId = ${JSON.stringify(kwargs['post-id'])};
         // Extract ID from URL if needed
         const urlMatch = postId.match(/comments\\/([a-z0-9]+)/);
         if (urlMatch) postId = urlMatch[1];

package/src/clis/reddit/upvoted.ts

@@ -15,7 +15,6 @@ cli({
     if (!page) throw new Error('Requires browser');
 
     await page.goto('https://www.reddit.com');
-    await page.wait(3);
 
     const result = await page.evaluate(`(async () => {
       try {

package/src/clis/reddit/user-comments.yaml

@@ -7,6 +7,7 @@ browser: true
 
 args:
   username:
+    positional: true
     type: string
     required: true
   limit:

package/src/clis/reddit/user-posts.yaml

@@ -7,6 +7,7 @@ browser: true
 
 args:
   username:
+    positional: true
     type: string
     required: true
   limit:

package/src/clis/reddit/user.yaml

@@ -7,6 +7,7 @@ browser: true
 
 args:
   username:
+    positional: true
     type: string
     required: true
 

package/src/clis/reuters/search.ts

@@ -11,7 +11,7 @@ cli({
   domain: 'www.reuters.com',
   strategy: Strategy.COOKIE,
   args: [
-    { name: 'query', required: true, help: 'Search query' },
+    { name: 'query', required: true, positional: true, help: 'Search query' },
     { name: 'limit', type: 'int', default: 10, help: 'Number of results (max 40)' },
   ],
   columns: ['rank', 'title', 'date', 'section', 'url'],

package/src/clis/sinafinance/news.ts

@@ -0,0 +1,76 @@
+/**
+ * Sina Finance 7x24 live news feed.
+ *
+ * Uses the public CJ API — no key or browser required.
+ * https://app.cj.sina.com.cn/api/news/pc
+ */
+
+import { cli, Strategy } from '../../registry.js';
+import { CliError } from '../../errors.js';
+
+// User-facing type (0-9) → Sina API tag ID
+const TYPE_MAP = [
+  0,   // 0: 全部
+  10,  // 1: A股
+  1,   // 2: 宏观
+  3,   // 3: 公司
+  4,   // 4: 数据
+  5,   // 5: 市场
+  102, // 6: 国际
+  6,   // 7: 观点
+  6,   // 8: 央行
+  8,   // 9: 其它
+] as const;
+
+interface SinaNewsItem {
+  id?: string;
+  create_time?: string;
+  rich_text?: string;
+  view_num?: number;
+}
+
+function stripHtml(html: string): string {
+  return html.replace(/<[^>]+>/g, '').trim();
+}
+
+cli({
+  site: 'sinafinance',
+  name: 'news',
+  description: '新浪财经 7x24 小时实时快讯',
+  domain: 'app.cj.sina.com.cn',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'limit', type: 'int', default: 20, help: 'Max results (max 50)' },
+    { name: 'type', type: 'int', default: 0, help: 'News type: 0=全部 1=A股 2=宏观 3=公司 4=数据 5=市场 6=国际 7=观点 8=央行 9=其它' },
+  ],
+  columns: ['id', 'time', 'content', 'views'],
+  func: async (_page, args) => {
+    const limit = Math.max(1, Math.min(Number(args.limit), 50));
+    const apiTag = TYPE_MAP[args.type as number] ?? 0;
+
+    const params = new URLSearchParams({
+      page: '1',
+      size: String(limit),
+      tag: String(apiTag),
+    });
+
+    const res = await fetch(`https://app.cj.sina.com.cn/api/news/pc?${params}`);
+    if (!res.ok) {
+      throw new CliError('FETCH_ERROR', `Sina Finance API HTTP ${res.status}`, 'Check your network connection');
+    }
+    const json = await res.json() as { result?: { data?: { feed?: { list?: SinaNewsItem[] } } } };
+    const list = json?.result?.data?.feed?.list ?? [];
+
+    if (!list.length) {
+      throw new CliError('NOT_FOUND', 'No news found', 'Try a different type or increase limit');
+    }
+
+    return list.map((item) => ({
+      id: item.id ?? '',
+      time: item.create_time ?? '',
+      content: stripHtml(item.rich_text ?? ''),
+      views: item.view_num ?? 0,
+    }));
+  },
+});

package/src/clis/smzdm/search.ts

@@ -14,17 +14,16 @@ cli({
   domain: 'www.smzdm.com',
   strategy: Strategy.COOKIE,
   args: [
-    { name: 'keyword', required: true, help: 'Search keyword' },
+    { name: 'query', required: true, positional: true, help: 'Search keyword' },
     { name: 'limit', type: 'int', default: 20, help: 'Number of results' },
   ],
   columns: ['rank', 'title', 'price', 'mall', 'comments', 'url'],
   func: async (page, kwargs) => {
-    const q = encodeURIComponent(kwargs.keyword);
+    const q = encodeURIComponent(kwargs.query);
     const limit = kwargs.limit || 20;
 
     // Navigate directly to search results page
     await page.goto(`https://search.smzdm.com/?c=home&s=${q}&v=b`);
-    await page.wait(2);
 
     const data = await page.evaluate(`
       (() => {

package/src/clis/stackoverflow/search.yaml

@@ -7,6 +7,7 @@ browser: false
 
 args:
   query:
+    positional: true
     type: string
     required: true
     description: Search query

package/src/clis/steam/top-sellers.yaml

@@ -0,0 +1,29 @@
+site: steam
+name: top-sellers
+description: Steam top selling games
+domain: store.steampowered.com
+strategy: public
+browser: false
+
+args:
+  limit:
+    type: int
+    default: 10
+    description: Number of games
+
+pipeline:
+  - fetch:
+      url: https://store.steampowered.com/api/featuredcategories/
+
+  - select: top_sellers.items
+
+  - map:
+      rank: ${{ index + 1 }}
+      name: ${{ item.name }}
+      price: ${{ item.final_price }}
+      discount: ${{ item.discount_percent }}
+      url: https://store.steampowered.com/app/${{ item.id }}
+
+  - limit: ${{ args.limit }}
+
+columns: [rank, name, price, discount, url]

package/src/clis/twitter/accept.ts

@@ -10,14 +10,14 @@ cli({
   browser: true,
   timeoutSeconds: 600, // 10 min — batch operation iterating many conversations
   args: [
-    { name: 'keyword', type: 'string', required: true, help: 'Keywords to match (comma-separated for OR, e.g. "群,微信")' },
+    { name: 'query', type: 'string', required: true, positional: true, help: 'Keywords to match (comma-separated for OR, e.g. "群,微信")' },
     { name: 'max', type: 'int', required: false, default: 20, help: 'Maximum number of requests to accept (default: 20)' },
   ],
   columns: ['index', 'status', 'user', 'message'],
   func: async (page: IPage | null, kwargs: any) => {
     if (!page) throw new Error('Requires browser');
 
-    const keywords: string[] = kwargs.keyword.split(',').map((k: string) => k.trim()).filter(Boolean);
+    const keywords: string[] = kwargs.query.split(',').map((k: string) => k.trim()).filter(Boolean);
     const maxAccepts: number = kwargs.max ?? 20;
     const results: Array<{ index: number; status: string; user: string; message: string }> = [];
     let acceptCount = 0;

package/src/clis/twitter/article.ts

@@ -8,12 +8,12 @@ cli({
   strategy: Strategy.COOKIE,
   browser: true,
   args: [
-    { name: 'tweet_id', type: 'string', positional: true, required: true, help: 'Tweet ID or URL containing the article' },
+    { name: 'tweet-id', type: 'string', positional: true, required: true, help: 'Tweet ID or URL containing the article' },
   ],
   columns: ['title', 'author', 'content', 'url'],
   func: async (page, kwargs) => {
     // Extract tweet ID from URL if needed
-    let tweetId = kwargs.tweet_id;
+    let tweetId = kwargs['tweet-id'];
     const urlMatch = tweetId.match(/\/(?:status|article)\/(\d+)/);
     if (urlMatch) tweetId = urlMatch[1];