@jackwener/opencli 1.7.21 → 1.7.22

package/README.md

@@ -14,7 +14,7 @@ OpenCLI gives you one surface for three different kinds of automation:
 - **Let AI Agents operate any website** — install the `opencli-adapter-author` skill in your AI agent (Claude Code, Cursor, etc.), and it can navigate, click, type/fill, extract, and inspect any page through your logged-in browser via `opencli browser` primitives.
 - **Write new adapters** end-to-end with `opencli browser` + the `opencli-adapter-author` skill, which guides from first recon through field decoding, code, and `opencli browser verify`.
 
-It also works as a **CLI hub** for local tools such as `gh`, `docker`, `tg`, `discord`, `wx`, `ntn` (Notion), and other binaries you register yourself, plus **desktop app adapters** for Electron apps like Cursor, Codex, Antigravity, and ChatGPT.
+It also works as a **CLI hub** for local tools such as `gh`, `docker`, `longbridge`, `tg`, `discord`, `wx`, `ntn` (Notion), and other binaries you register yourself, plus **desktop app adapters** for Electron apps like Cursor, Codex, Antigravity, and ChatGPT.
 
 ## Highlights
 
@@ -290,6 +290,7 @@ OpenCLI acts as a universal hub for your existing command-line tools — unified
 | **gh** | GitHub CLI | `opencli gh pr list --limit 5` |
 | **obsidian** | Obsidian vault management | `opencli obsidian search query="AI"` |
 | **docker** | Docker | `opencli docker ps` |
+| **longbridge** | Longbridge CLI — market data, account management, and trading via Longbridge OpenAPI | `opencli longbridge quote TSLA.US --format json` |
 | **ntn** | Notion CLI — official Notion API CLI for pages, databases, blocks, search, comments | `opencli ntn pages list` |
 | **lark-cli** | Lark/Feishu — messages, docs, calendar, tasks, 200+ commands | `opencli lark-cli calendar +agenda` |
 | **dws** | DingTalk — cross-platform CLI for DingTalk's full suite, designed for humans and AI agents | `opencli dws msg send --to user "hello"` |

package/README.zh-CN.md

@@ -14,7 +14,7 @@ OpenCLI 可以用同一套 CLI 做三类事情：
 - **让 AI Agent 操作任意网站**：在你的 AI Agent（Claude Code、Cursor 等）中安装 `opencli-adapter-author` skill，Agent 就能用你的已登录浏览器导航、点击、输入/填充、提取任意网页内容。
 - **把新网站写成 CLI**：用 `opencli browser` 原语 + `opencli-adapter-author` skill，从站点侦察、API 发现、字段解码到 `opencli browser verify` 一条龙。
 
-除了网站能力，OpenCLI 还是一个 **CLI 枢纽**：你可以把 `gh`、`docker`、`tg`、`discord`、`wx`、`ntn`（Notion）等本地工具统一注册到 `opencli` 下，也可以通过桌面端适配器控制 Cursor、Codex、Antigravity、ChatGPT 等 Electron 应用。
+除了网站能力，OpenCLI 还是一个 **CLI 枢纽**：你可以把 `gh`、`docker`、`longbridge`、`tg`、`discord`、`wx`、`ntn`（Notion）等本地工具统一注册到 `opencli` 下，也可以通过桌面端适配器控制 Cursor、Codex、Antigravity、ChatGPT 等 Electron 应用。
 
 ## 亮点
 
@@ -332,6 +332,7 @@ OpenCLI 也可以作为你现有命令行工具的统一入口，负责发现、
 | **gh** | GitHub CLI | `opencli gh pr list --limit 5` |
 | **obsidian** | Obsidian 仓库管理 | `opencli obsidian search query="AI"` |
 | **docker** | Docker 命令行工具 | `opencli docker ps` |
+| **longbridge** | Longbridge CLI — 通过 Longbridge OpenAPI 获取行情、账户和交易能力 | `opencli longbridge quote TSLA.US --format json` |
 | **ntn** | Notion CLI — 基于官方 Notion API 的页面、数据库、块、搜索、评论命令 | `opencli ntn pages list` |
 | **lark-cli** | 飞书 CLI — 消息、文档、日历、任务，200+ 命令 | `opencli lark-cli calendar +agenda` |
 | **dws** | 钉钉 CLI — 钉钉全套产品能力的跨平台命令行工具，支持人类和 AI Agent 使用 | `opencli dws msg send --to user "hello"` |

package/clis/boss/utils.js

@@ -5,6 +5,7 @@ const BOSS_DOMAIN = 'www.zhipin.com';
 const CHAT_URL = `https://${BOSS_DOMAIN}/web/chat/index`;
 const COOKIE_EXPIRED_CODES = new Set([7, 37]);
 const COOKIE_EXPIRED_MSG = 'Cookie 已过期！请在当前 Chrome 浏览器中重新登录 BOSS 直聘。';
+const RECRUITER_ONLY_MSG = '该命令仅支持招聘端（BOSS 端）账号，请使用招聘者账号登录后重试。';
 const DEFAULT_TIMEOUT = 15_000;
 // ── Core helpers ────────────────────────────────────────────────────────────
 /**
@@ -55,9 +56,23 @@ export function checkAuth(data) {
         throw new AuthRequiredError(BOSS_DOMAIN, COOKIE_EXPIRED_MSG);
     }
 }
+/**
+ * Map BOSS code=24 ("请切换身份后再试") to a typed AuthRequiredError.
+ * Recruiter-only commands (recommend, joblist, stats, resume, mark,
+ * exchange, invite, greet, batchgreet) have no geek-side equivalent;
+ * surfacing this as a generic COMMAND_EXEC hides what the user must do.
+ * chatlist / chatmsg avoid this path by using `allowNonZero: true` and
+ * branching to the geek-side fetch when they see code 24.
+ */
+function checkRecruiterSide(data) {
+    if (data.code === IDENTITY_MISMATCH_CODE) {
+        throw new AuthRequiredError(BOSS_DOMAIN, RECRUITER_ONLY_MSG);
+    }
+}
 /**
  * Throw if the API response is not code 0.
- * Checks for cookie expiry first, then throws with the provided message.
+ * Checks for cookie expiry first, then identity mismatch, then throws
+ * with the provided message.
  */
 export function assertOk(data, errorPrefix) {
     if (!data || typeof data !== 'object') {
@@ -66,6 +81,7 @@ export function assertOk(data, errorPrefix) {
     if (data.code === 0)
         return;
     checkAuth(data);
+    checkRecruiterSide(data);
     const prefix = errorPrefix ? `${errorPrefix}: ` : '';
     throw new CommandExecutionError(`${prefix}${data.message || 'Unknown error'} (code=${data.code})`);
 }

package/clis/boss/utils.test.js

@@ -0,0 +1,34 @@
+import { describe, expect, it } from 'vitest';
+import { AuthRequiredError, CommandExecutionError } from '@jackwener/opencli/errors';
+import { assertOk } from './utils.js';
+
+describe('assertOk', () => {
+    it('returns silently on code 0', () => {
+        expect(() => assertOk({ code: 0 })).not.toThrow();
+    });
+
+    it('maps expired cookie codes (7, 37) to AuthRequiredError', () => {
+        expect(() => assertOk({ code: 7, message: 'expired' })).toThrow(AuthRequiredError);
+        expect(() => assertOk({ code: 37, message: 'expired' })).toThrow(AuthRequiredError);
+    });
+
+    it('maps code 24 (identity mismatch) to AuthRequiredError with recruiter-only hint', () => {
+        try {
+            assertOk({ code: 24, message: '请切换身份后再试' });
+            throw new Error('assertOk should have thrown');
+        } catch (err) {
+            expect(err).toBeInstanceOf(AuthRequiredError);
+            expect(String(err.message)).toContain('招聘端');
+        }
+    });
+
+    it('falls through to CommandExecutionError for other non-zero codes', () => {
+        expect(() => assertOk({ code: 99, message: 'something else' }))
+            .toThrow(CommandExecutionError);
+    });
+
+    it('throws CommandExecutionError on malformed (non-object) response', () => {
+        expect(() => assertOk(null)).toThrow(CommandExecutionError);
+        expect(() => assertOk('not-an-object')).toThrow(CommandExecutionError);
+    });
+});

package/clis/weibo/comments.js

@@ -2,6 +2,7 @@
  * Weibo comments — get comments on a post.
  */
 import { cli, Strategy } from '@jackwener/opencli/registry';
+import { requireArrayEvaluateResult, unwrapEvaluateResult } from './utils.js';
 cli({
     site: 'weibo',
     name: 'comments',
@@ -19,7 +20,7 @@ cli({
         await page.goto('https://weibo.com');
         await page.wait(2);
         const id = String(kwargs.id);
-        const data = await page.evaluate(`
+        const data = requireArrayEvaluateResult(unwrapEvaluateResult(await page.evaluate(`
       (async () => {
         const id = ${JSON.stringify(id)};
         const count = ${count};
@@ -46,9 +47,7 @@ cli({
           return item;
         });
       })()
-    `);
-        if (!Array.isArray(data))
-            return [];
+    `)), 'weibo comments');
         return data;
     },
 });

package/clis/weibo/envelope.test.js

@@ -0,0 +1,85 @@
+import { describe, expect, it, vi } from 'vitest';
+import { CommandExecutionError } from '@jackwener/opencli/errors';
+import { getRegistry } from '@jackwener/opencli/registry';
+import './comments.js';
+import './favorites.js';
+import './feed.js';
+import './hot.js';
+import './me.js';
+import './post.js';
+import './search.js';
+import './user.js';
+
+function envelope(data) {
+  return { session: 'site:weibo:test', data };
+}
+
+function makePage(evaluateResults = []) {
+  const queue = [...evaluateResults];
+  return {
+    goto: vi.fn().mockResolvedValue(undefined),
+    wait: vi.fn().mockResolvedValue(undefined),
+    evaluate: vi.fn(async (script) => {
+      if (String(script).includes('window.scrollBy')) return undefined;
+      return queue.length ? queue.shift() : undefined;
+    }),
+  };
+}
+
+describe('weibo read adapters Browser Bridge envelopes', () => {
+  it('unwraps comments, feed, hot, search, and favorites array payloads', async () => {
+    await expect(getRegistry().get('weibo/comments').func(
+      makePage([envelope([{ rank: 1, author: 'a', text: 't', likes: 0, replies: 0, time: '' }])]),
+      { id: '123', limit: 1 },
+    )).resolves.toHaveLength(1);
+
+    await expect(getRegistry().get('weibo/feed').func(
+      makePage([envelope('123456'), envelope([{ id: 'm1', author: 'a', text: 't', reposts: 0, comments: 0, likes: 0, time: '', url: 'https://weibo.com/1/m1' }])]),
+      { type: 'for-you', limit: 1 },
+    )).resolves.toHaveLength(1);
+
+    await expect(getRegistry().get('weibo/hot').func(
+      makePage([envelope([{ rank: 1, word: 'opencli', hot_value: 1, category: '', label: '', url: 'https://s.weibo.com/weibo?q=opencli' }])]),
+      { limit: 1 },
+    )).resolves.toHaveLength(1);
+
+    await expect(getRegistry().get('weibo/search').func(
+      makePage([envelope([{ id: 'm1', title: 'OpenCLI', author: 'a', time: '', url: 'https://weibo.com/1/m1' }])]),
+      { keyword: 'opencli', limit: 1 },
+    )).resolves.toEqual([{ rank: 1, id: 'm1', title: 'OpenCLI', author: 'a', time: '', url: 'https://weibo.com/1/m1' }]);
+
+    await expect(getRegistry().get('weibo/favorites').func(
+      makePage([envelope('123456'), envelope([{ text: '作者A\n这是一条收藏微博', url: 'https://weibo.com/123/AbCd1' }])]),
+      { limit: 1 },
+    )).resolves.toHaveLength(1);
+  });
+
+  it('unwraps me, post, and user object payloads', async () => {
+    await expect(getRegistry().get('weibo/me').func(
+      makePage([envelope('123456'), envelope({ screen_name: 'me', uid: '123456' })]),
+      {},
+    )).resolves.toMatchObject({ screen_name: 'me', uid: '123456' });
+
+    await expect(getRegistry().get('weibo/post').func(
+      makePage([envelope({ id: '1', text: 'post' })]),
+      { id: '1' },
+    )).resolves.toContainEqual({ field: 'text', value: 'post' });
+
+    await expect(getRegistry().get('weibo/user').func(
+      makePage([envelope({ screen_name: 'alice', uid: '42' })]),
+      { id: '42' },
+    )).resolves.toMatchObject({ screen_name: 'alice', uid: '42' });
+  });
+
+  it('fails typed instead of returning empty rows for malformed post-unwrap payloads', async () => {
+    await expect(getRegistry().get('weibo/hot').func(
+      makePage([envelope({ error: 'API error' })]),
+      { limit: 1 },
+    )).rejects.toBeInstanceOf(CommandExecutionError);
+
+    await expect(getRegistry().get('weibo/user').func(
+      makePage([envelope([{ screen_name: 'wrong shape' }])]),
+      { id: '42' },
+    )).rejects.toBeInstanceOf(CommandExecutionError);
+  });
+});

package/clis/weibo/favorites.js

@@ -1,6 +1,6 @@
 import { cli, Strategy } from '@jackwener/opencli/registry';
 import { ArgumentError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
-import { getSelfUid } from './utils.js';
+import { getSelfUid, requireArrayEvaluateResult, unwrapEvaluateResult } from './utils.js';
 
 const DEFAULT_LIMIT = 20;
 const MAX_LIMIT = 50;
@@ -123,7 +123,7 @@ cli({
       await page.wait(1);
     }
 
-    const rawData = await page.evaluate(`
+    const rawData = requireArrayEvaluateResult(unwrapEvaluateResult(await page.evaluate(`
       (() => {
         const scrollers = document.querySelectorAll('.wbpro-scroller-item, .vue-recycle-scroller__item-view');
         const out = [];
@@ -145,9 +145,9 @@ cli({
         }
         return out;
       })()
-    `);
+    `)), 'weibo favorites');
 
-    if (!Array.isArray(rawData) || rawData.length === 0) {
+    if (rawData.length === 0) {
       throw new EmptyResultError('weibo favorites', 'No favorites were visible on the favorites page');
     }
 

package/clis/weibo/feed.js

@@ -2,7 +2,7 @@
  * Weibo feed — for-you or following timeline.
  */
 import { cli, Strategy } from '@jackwener/opencli/registry';
-import { getSelfUid } from './utils.js';
+import { getSelfUid, requireArrayEvaluateResult, unwrapEvaluateResult } from './utils.js';
 const TIMELINE_ENDPOINTS = {
     'for-you': 'unreadfriendstimeline',
     following: 'friendstimeline',
@@ -31,7 +31,7 @@ cli({
         await page.goto('https://weibo.com');
         await page.wait(2);
         const uid = await getSelfUid(page);
-        const data = await page.evaluate(`
+        const data = requireArrayEvaluateResult(unwrapEvaluateResult(await page.evaluate(`
       (async () => {
         const uid = ${JSON.stringify(uid)};
         const count = ${count};
@@ -63,9 +63,7 @@ cli({
           return item;
         });
       })()
-    `);
-        if (!Array.isArray(data))
-            return [];
+    `)), 'weibo feed');
         return data;
     },
 });

package/clis/weibo/hot.js

@@ -2,6 +2,7 @@
  * Weibo hot search — browser cookie API.
  */
 import { cli, Strategy } from '@jackwener/opencli/registry';
+import { requireArrayEvaluateResult, unwrapEvaluateResult } from './utils.js';
 cli({
     site: 'weibo',
     name: 'hot',
@@ -16,7 +17,7 @@ cli({
     func: async (page, kwargs) => {
         const count = Math.min(kwargs.limit || 30, 50);
         await page.goto('https://weibo.com');
-        const data = await page.evaluate(`
+        const data = requireArrayEvaluateResult(unwrapEvaluateResult(await page.evaluate(`
       (async () => {
         const resp = await fetch('/ajax/statuses/hot_band', {credentials: 'include'});
         if (!resp.ok) return {error: 'HTTP ' + resp.status};
@@ -32,9 +33,7 @@ cli({
           url: 'https://s.weibo.com/weibo?q=' + encodeURIComponent('#' + item.word + '#')
         }));
       })()
-    `);
-        if (!Array.isArray(data))
-            return [];
+    `)), 'weibo hot');
         return data.slice(0, count);
     },
 });

package/clis/weibo/me.js

@@ -3,7 +3,7 @@
  */
 import { cli, Strategy } from '@jackwener/opencli/registry';
 import { CommandExecutionError } from '@jackwener/opencli/errors';
-import { getSelfUid } from './utils.js';
+import { getSelfUid, requireObjectEvaluateResult, unwrapEvaluateResult } from './utils.js';
 cli({
     site: 'weibo',
     name: 'me',
@@ -17,7 +17,7 @@ cli({
         await page.goto('https://weibo.com');
         await page.wait(2);
         const uid = await getSelfUid(page);
-        const data = await page.evaluate(`
+        const data = requireObjectEvaluateResult(unwrapEvaluateResult(await page.evaluate(`
       (async () => {
         const uid = ${JSON.stringify(uid)};
 
@@ -67,9 +67,7 @@ cli({
           profile_url: 'https://weibo.com' + (p.profile_url || '/u/' + p.id),
         };
       })()
-    `);
-        if (!data || typeof data !== 'object')
-            throw new CommandExecutionError('Failed to fetch profile');
+    `)), 'weibo me');
         if (data.error)
             throw new CommandExecutionError(String(data.error));
         return data;

package/clis/weibo/post.js

@@ -3,6 +3,7 @@
  */
 import { cli, Strategy } from '@jackwener/opencli/registry';
 import { CommandExecutionError } from '@jackwener/opencli/errors';
+import { requireObjectEvaluateResult, unwrapEvaluateResult } from './utils.js';
 cli({
     site: 'weibo',
     name: 'post',
@@ -18,7 +19,7 @@ cli({
         await page.goto('https://weibo.com');
         await page.wait(2);
         const id = String(kwargs.id);
-        const data = await page.evaluate(`
+        const data = requireObjectEvaluateResult(unwrapEvaluateResult(await page.evaluate(`
       (async () => {
         const id = ${JSON.stringify(id)};
         const strip = (html) => (html || '').replace(/<[^>]+>/g, '').replace(/&nbsp;/g, ' ').replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&amp;/g, '&').trim();
@@ -63,9 +64,7 @@ cli({
 
         return result;
       })()
-    `);
-        if (!data || typeof data !== 'object')
-            throw new CommandExecutionError('Failed to fetch post');
+    `)), 'weibo post');
         if (data.error)
             throw new CommandExecutionError(String(data.error));
         return Object.entries(data).map(([field, value]) => ({

package/clis/weibo/search.js

@@ -3,6 +3,7 @@
  */
 import { cli, Strategy } from '@jackwener/opencli/registry';
 import { CliError } from '@jackwener/opencli/errors';
+import { requireArrayEvaluateResult, unwrapEvaluateResult } from './utils.js';
 cli({
     site: 'weibo',
     name: 'search',
@@ -21,7 +22,7 @@ cli({
         const keyword = encodeURIComponent(String(kwargs.keyword ?? '').trim());
         await page.goto(`https://s.weibo.com/weibo?q=${keyword}`);
         await page.wait(2);
-        const data = await page.evaluate(`
+        const data = requireArrayEvaluateResult(unwrapEvaluateResult(await page.evaluate(`
       (() => {
         const clean = (value) => (value || '').replace(/\\s+/g, ' ').trim();
         const absoluteUrl = (href) => {
@@ -67,8 +68,8 @@ cli({
 
         return rows;
       })()
-    `);
-        if (!Array.isArray(data) || data.length === 0) {
+    `)), 'weibo search');
+        if (data.length === 0) {
             throw new CliError('NOT_FOUND', 'No Weibo search results found', 'Try a different keyword or ensure you are logged into weibo.com');
         }
         return data.slice(0, limit).map((item, index) => ({

package/clis/weibo/user.js

@@ -3,6 +3,7 @@
  */
 import { cli, Strategy } from '@jackwener/opencli/registry';
 import { CommandExecutionError } from '@jackwener/opencli/errors';
+import { requireObjectEvaluateResult, unwrapEvaluateResult } from './utils.js';
 cli({
     site: 'weibo',
     name: 'user',
@@ -18,7 +19,7 @@ cli({
         await page.goto('https://weibo.com');
         await page.wait(2);
         const id = String(kwargs.id);
-        const data = await page.evaluate(`
+        const data = requireObjectEvaluateResult(unwrapEvaluateResult(await page.evaluate(`
       (async () => {
         const id = ${JSON.stringify(id)};
         const isUid = /^\\d+$/.test(id);
@@ -54,9 +55,7 @@ cli({
           ip_location: d.ip_location || '',
         };
       })()
-    `);
-        if (!data || typeof data !== 'object')
-            throw new CommandExecutionError('Failed to fetch user profile');
+    `)), 'weibo user');
         if (data.error)
             throw new CommandExecutionError(String(data.error));
         return data;

package/clis/weibo/utils.js

@@ -1,10 +1,39 @@
 /**
  * Shared Weibo utilities — uid extraction.
  */
-import { AuthRequiredError } from '@jackwener/opencli/errors';
+import { AuthRequiredError, CommandExecutionError } from '@jackwener/opencli/errors';
+/**
+ * `page.evaluate` may return either the raw IIFE value or a
+ * `{ session, data }` envelope depending on the browser-bridge version.
+ * Adapter code that inspected the payload directly (e.g. `Array.isArray`,
+ * truthiness checks on uid strings) silently received the envelope wrapper
+ * instead of the inner value. This helper normalizes both shapes so callers
+ * can keep their existing checks unchanged.
+ */
+export function unwrapEvaluateResult(payload) {
+    if (payload && !Array.isArray(payload) && typeof payload === 'object' && 'session' in payload && 'data' in payload) {
+        return payload.data;
+    }
+    return payload;
+}
+export function requireArrayEvaluateResult(payload, label) {
+    if (!Array.isArray(payload)) {
+        if (payload && typeof payload === 'object' && 'error' in payload) {
+            throw new CommandExecutionError(`${label}: ${String(payload.error)}`);
+        }
+        throw new CommandExecutionError(`${label} returned malformed extraction payload`);
+    }
+    return payload;
+}
+export function requireObjectEvaluateResult(payload, label) {
+    if (!payload || Array.isArray(payload) || typeof payload !== 'object') {
+        throw new CommandExecutionError(`${label} returned malformed extraction payload`);
+    }
+    return payload;
+}
 /** Get the currently logged-in user's uid from Vue store or config API. */
 export async function getSelfUid(page) {
-    const uid = await page.evaluate(`
+    const uid = unwrapEvaluateResult(await page.evaluate(`
     (() => {
       const app = document.querySelector('#app')?.__vue_app__;
       const store = app?.config?.globalProperties?.$store;
@@ -12,18 +41,18 @@ export async function getSelfUid(page) {
       if (uid) return String(uid);
       return null;
     })()
-  `);
+  `));
     if (uid)
         return uid;
     // Fallback: config API
-    const config = await page.evaluate(`
+    const config = unwrapEvaluateResult(await page.evaluate(`
     (async () => {
       const resp = await fetch('/ajax/config/get_config', {credentials: 'include'});
       if (!resp.ok) return null;
       const data = await resp.json();
       return data.ok && data.data?.uid ? String(data.data.uid) : null;
     })()
-  `);
+  `));
     if (config)
         return config;
     throw new AuthRequiredError('weibo.com');

package/clis/weibo/utils.test.js

@@ -0,0 +1,36 @@
+import { describe, expect, it } from 'vitest';
+import { CommandExecutionError } from '@jackwener/opencli/errors';
+import { requireArrayEvaluateResult, requireObjectEvaluateResult, unwrapEvaluateResult } from './utils.js';
+
+describe('unwrapEvaluateResult (browser-bridge envelope normalization)', () => {
+    it('returns the raw array unchanged when payload is already an array', () => {
+        const arr = [{ id: '1' }, { id: '2' }];
+        expect(unwrapEvaluateResult(arr)).toBe(arr);
+    });
+    it('unwraps { session, data: [...] } envelope to the inner array', () => {
+        const arr = [{ id: '1' }];
+        const env = { session: 'site:weibo:abc', data: arr };
+        expect(unwrapEvaluateResult(env)).toBe(arr);
+    });
+    it('unwraps primitive data (e.g. uid string) from Browser Bridge envelopes', () => {
+        expect(unwrapEvaluateResult({ session: 'site:weibo:abc', data: '1234567890' })).toBe('1234567890');
+    });
+    it('unwraps null payload data so getSelfUid fallback can trigger', () => {
+        expect(unwrapEvaluateResult({ session: 'site:weibo:abc', data: null })).toBe(null);
+    });
+    it('passes non-envelope objects through unchanged (e.g. profile result)', () => {
+        const obj = { screen_name: 'alice', uid: '42' };
+        expect(unwrapEvaluateResult(obj)).toBe(obj);
+    });
+    it('handles null and undefined safely', () => {
+        expect(unwrapEvaluateResult(null)).toBe(null);
+        expect(unwrapEvaluateResult(undefined)).toBe(undefined);
+    });
+    it('keeps malformed array/object payloads as typed command failures after unwrap', () => {
+        expect(requireArrayEvaluateResult([{ id: '1' }], 'weibo feed')).toEqual([{ id: '1' }]);
+        expect(() => requireArrayEvaluateResult({ error: 'API error' }, 'weibo feed')).toThrow(CommandExecutionError);
+        expect(() => requireArrayEvaluateResult({ error: 'API error' }, 'weibo feed')).toThrow('weibo feed: API error');
+        expect(requireObjectEvaluateResult({ uid: '42' }, 'weibo me')).toEqual({ uid: '42' });
+        expect(() => requireObjectEvaluateResult([{ uid: '42' }], 'weibo me')).toThrow(CommandExecutionError);
+    });
+});

package/dist/src/cli.js

@@ -545,7 +545,7 @@ export function createProgram(BUILTIN_CLIS, USER_CLIS) {
             for (const ext of externalClis) {
                 const isInstalled = isBinaryInstalled(ext.binary);
                 const tag = isInstalled ? '[installed]' : '[auto-install]';
-                console.log(`    ${ext.name} ${tag}${ext.description ? ` — ${ext.description}` : ''}`);
+                console.log(`    ${formatExternalCliLabel(ext)} ${tag}${ext.description ? ` — ${ext.description}` : ''}`);
             }
             console.log();
         }

package/dist/src/external-clis.yaml

@@ -16,6 +16,7 @@
 
 - name: ntn
   binary: ntn
+  package: notion
   description: "Notion CLI — official Notion API CLI for pages, databases, blocks, search, comments"
   homepage: "https://ntn.dev"
   tags: [notion, notes, knowledge, productivity]
@@ -36,8 +37,18 @@
   install:
     default: "npm install -g @larksuite/cli"
 
+- name: longbridge
+  binary: longbridge
+  description: "Longbridge CLI — AI-native market data, account management and trading commands for Longbridge OpenAPI"
+  homepage: "https://open.longbridge.com/zh-CN/docs/cli/"
+  tags: [longbridge, finance, trading, market-data, openapi, ai-agent]
+  install:
+    mac: "brew install --cask longbridge/tap/longbridge-terminal"
+    windows: "scoop install https://open.longbridge.com/longbridge/longbridge-terminal/longbridge.json"
+
 - name: dws
   binary: dws
+  package: DingTalk Workspace
   description: "DingTalk Workspace CLI — messages, docs, calendar, contacts and more for humans and AI agents"
   homepage: "https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli"
   tags: [dingtalk, collaboration, productivity, ai-agent]
@@ -47,6 +58,7 @@
 
 - name: wecom-cli
   binary: wecom-cli
+  package: 企业微信
   description: "WeCom/企业微信 CLI — contacts, todos, meetings, messages, calendar, docs and smart sheets for AI agents"
   homepage: "https://github.com/WecomTeam/wecom-cli"
   tags: [wecom, wechat-work, collaboration, productivity, ai-agent]

package/dist/src/external.d.ts

@@ -8,7 +8,12 @@ export interface ExternalCliConfig {
     /** User-facing OpenCLI subcommand and, by default, the executable name. */
     name: string;
     binary: string;
-    /** Distribution/project name when it differs from the executable name. */
+    /**
+     * Display alias rendered alongside `name` in help/listing as `name(package)`.
+     * Use either the upstream distribution/project name (e.g. `tg-cli`, `discord-cli`)
+     * or a human-readable brand label (e.g. `notion`, `企业微信`) when the bare
+     * executable name is ambiguous.
+     */
     package?: string;
     description?: string;
     homepage?: string;

package/dist/src/external.test.js

@@ -44,6 +44,21 @@ describe('parseCommand', () => {
             }
         }
     });
+    it('registers Longbridge with safe package-manager installers only', () => {
+        const raw = fs.readFileSync(path.join(__dirname, 'external-clis.yaml'), 'utf8');
+        const entries = (yaml.load(raw) || []);
+        const longbridge = entries.find((entry) => entry.name === 'longbridge');
+        expect(longbridge).toMatchObject({
+            binary: 'longbridge',
+            homepage: 'https://open.longbridge.com/zh-CN/docs/cli/',
+            install: {
+                mac: 'brew install --cask longbridge/tap/longbridge-terminal',
+                windows: 'scoop install https://open.longbridge.com/longbridge/longbridge-terminal/longbridge.json',
+            },
+        });
+        expect(longbridge?.install?.linux).toBeUndefined();
+        expect(longbridge?.install?.default).toBeUndefined();
+    });
 });
 describe('formatExternalCliLabel', () => {
     it('shows the package name when the executable name differs', () => {
@@ -52,6 +67,10 @@ describe('formatExternalCliLabel', () => {
     it('keeps the label compact when package and name match', () => {
         expect(formatExternalCliLabel({ name: 'docker', binary: 'docker', package: 'docker' })).toBe('docker');
     });
+    it('renders a human-readable brand alias for ambiguous executable names', () => {
+        expect(formatExternalCliLabel({ name: 'ntn', binary: 'ntn', package: 'notion' })).toBe('ntn(notion)');
+        expect(formatExternalCliLabel({ name: 'wecom-cli', binary: 'wecom-cli', package: '企业微信' })).toBe('wecom-cli(企业微信)');
+    });
 });
 describe('installExternalCli', () => {
     const cli = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jackwener/opencli",
-  "version": "1.7.21",
+  "version": "1.7.22",
   "publishConfig": {
     "access": "public"
   },