@sovovs/bycli 2.1.39 → 2.1.40

package/cli-manifest.json

@@ -13570,7 +13570,30 @@
       "title",
       "url",
       "contentType",
-      "addedDate"
+      "addedDate",
+      "mediaId",
+      "mediaType",
+      "mediaState",
+      "mediaAuditStatus",
+      "mediaTypeInfo",
+      "sourcePath",
+      "jumpUrl",
+      "createTime",
+      "updateTime",
+      "lastModifyTime",
+      "lastOpenTime",
+      "fileSize",
+      "abstract",
+      "introduction",
+      "tags",
+      "isTop",
+      "accessStatus",
+      "accessStatusUpdateTs",
+      "parseProgress",
+      "parseErrInfo",
+      "summaryState",
+      "coverUrls",
+      "logo"
     ],
     "defaultFormat": "json",
     "type": "js",
@@ -13578,6 +13601,28 @@
     "sourceFile": "ima/knowledge.js",
     "navigateBefore": false
   },
+  {
+    "site": "ima",
+    "name": "knowledge-list",
+    "description": "获取全部 ima 知识库的常用字段与原始元数据",
+    "access": "read",
+    "domain": "ima.qq.com",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [],
+    "columns": [
+      "id",
+      "name",
+      "type",
+      "typeName",
+      "raw"
+    ],
+    "defaultFormat": "json",
+    "type": "js",
+    "modulePath": "ima/knowledge-list.js",
+    "sourceFile": "ima/knowledge-list.js",
+    "navigateBefore": false
+  },
   {
     "site": "imdb",
     "name": "person",

package/clis/ima/knowledge-list.js

@@ -0,0 +1,48 @@
+import { cli, Strategy } from '@sovovs/bycli/registry';
+import { CommandExecutionError, ConfigError } from '@sovovs/bycli/errors';
+
+import { readKnowledgeBasesFromChrome } from './native-client.js';
+
+const COMMAND = 'ima knowledge-list';
+
+function throwDriverError(error) {
+    if (error?.code === 'IMA_CHROME_AUTH_REQUIRED') {
+        throw new ConfigError(
+            error.message || 'ima reader authentication is required',
+            'Open https://ima.qq.com/wikis in Chrome, sign in, then retry with the latest bycli Browser Bridge extension.',
+        );
+    }
+    throw new CommandExecutionError(
+        error?.message || `${COMMAND} failed to read knowledge bases`,
+    );
+}
+
+export async function runKnowledgeListCommand(read) {
+    try {
+        const items = await read();
+        if (!Array.isArray(items)) {
+            throw new CommandExecutionError(`${COMMAND} returned malformed knowledge-base rows`);
+        }
+        return items;
+    } catch (error) {
+        if (error instanceof ConfigError || error instanceof CommandExecutionError) throw error;
+        throwDriverError(error);
+    }
+}
+
+export const knowledgeListCommand = cli({
+    site: 'ima',
+    name: 'knowledge-list',
+    access: 'read',
+    description: '获取全部 ima 知识库的常用字段与原始元数据',
+    domain: 'ima.qq.com',
+    defaultFormat: 'json',
+    args: [],
+    columns: ['id', 'name', 'type', 'typeName', 'raw'],
+    strategy: Strategy.COOKIE,
+    browser: true,
+    navigateBefore: false,
+    func: async (page) => runKnowledgeListCommand(
+        () => readKnowledgeBasesFromChrome(page),
+    ),
+});

package/clis/ima/knowledge.js

@@ -84,6 +84,29 @@ export const knowledgeCommand = cli({
         'url',
         'contentType',
         'addedDate',
+        'mediaId',
+        'mediaType',
+        'mediaState',
+        'mediaAuditStatus',
+        'mediaTypeInfo',
+        'sourcePath',
+        'jumpUrl',
+        'createTime',
+        'updateTime',
+        'lastModifyTime',
+        'lastOpenTime',
+        'fileSize',
+        'abstract',
+        'introduction',
+        'tags',
+        'isTop',
+        'accessStatus',
+        'accessStatusUpdateTs',
+        'parseProgress',
+        'parseErrInfo',
+        'summaryState',
+        'coverUrls',
+        'logo',
     ],
     strategy: Strategy.COOKIE,
     browser: true,

package/clis/ima/native-api.js

@@ -4,6 +4,10 @@ const MEDIA_TYPE_NAMES = new Map([
     [12, '问答'], [13, 'TXT'], [14, 'XMIND'], [15, '音频'], [16, '视频网站'],
     [19, '播客'], [20, 'HTML'], [21, 'EPUB'], [98, '源代码'], [99, '文件夹'],
 ]);
+const KNOWLEDGE_BASE_TYPE_NAMES = new Map([
+    [1001, '我的知识库'], [1002, '共享知识库'],
+    [1004, '团队知识库'], [1005, '其他知识库'],
+]);
 function field(value, camelName, snakeName) {
     return value?.[camelName] ?? value?.[snakeName];
 }
@@ -20,6 +24,15 @@ function knowledgeBaseFromRaw(raw) {
     };
 }
 
+function knowledgeBaseRow(raw, type) {
+    return {
+        ...knowledgeBaseFromRaw(raw),
+        type,
+        typeName: KNOWLEDGE_BASE_TYPE_NAMES.get(type) ?? String(type),
+        raw,
+    };
+}
+
 function basesFromGroups(response) {
     const groups = field(response, 'results', 'results');
     if (!Array.isArray(groups)) throw new Error('ima API returned malformed knowledge-base groups');
@@ -29,7 +42,17 @@ function basesFromGroups(response) {
     });
 }
 
-export async function findKnowledgeBase(query, request) {
+function entriesFromGroups(response) {
+    const groups = field(response, 'results', 'results');
+    if (!Array.isArray(groups)) throw new Error('ima API returned malformed knowledge-base groups');
+    return groups.flatMap((group) => {
+        const list = field(group, 'knowledgeBaseList', 'knowledge_base_list');
+        const type = Number(field(group, 'type', 'type'));
+        return Array.isArray(list) ? list.map((raw) => ({ raw, type })) : [];
+    });
+}
+
+async function collectKnowledgeBaseEntries(request) {
     const initialGroups = [
         { type: 1001, limit: 20 },
         { type: 1002, limit: 20 },
@@ -47,7 +70,7 @@ export async function findKnowledgeBase(query, request) {
         if (Number(response?.code) !== 0) {
             throw new Error(response?.msg || `ima API error ${response?.code ?? 'unknown'}`);
         }
-        all.push(...basesFromGroups(response));
+        all.push(...entriesFromGroups(response));
         const groups = field(response, 'results', 'results');
         for (const group of groups) {
             const cursor = field(group, 'nextCursor', 'next_cursor');
@@ -61,19 +84,29 @@ export async function findKnowledgeBase(query, request) {
                     throw new Error(`ima API returned a repeated cursor for knowledge-base group ${type}`);
                 }
                 queuedPages.add(pageKey);
-                pendingPages.push({
-                    type,
-                    cursor: String(cursor),
-                    limit: 10,
-                });
+                pendingPages.push({ type, cursor: String(cursor), limit: 10 });
             }
         }
         const next = pendingPages.shift();
         if (!next) break;
-        response = await request('/get_knowledge_base_list', {
-            params: [next],
-        });
+        response = await request('/get_knowledge_base_list', { params: [next] });
     }
+    return all;
+}
+
+export async function listKnowledgeBases(request) {
+    const entries = await collectKnowledgeBaseEntries(request);
+    const unique = new Map();
+    for (const { raw, type } of entries) {
+        const row = knowledgeBaseRow(raw, type);
+        if (!unique.has(row.id)) unique.set(row.id, row);
+    }
+    return [...unique.values()];
+}
+
+export async function findKnowledgeBase(query, request) {
+    const all = (await collectKnowledgeBaseEntries(request))
+        .map(({ raw }) => knowledgeBaseFromRaw(raw));
 
     const matches = all.filter((base) => base.id === query || base.name === query);
     if (matches.length === 0) {
@@ -100,6 +133,30 @@ function articleFromRaw(raw, knowledgeBaseId, knowledgeBaseName, folderPath) {
         addedDate: field(raw, 'timeWording', 'time_wording')
             || field(raw, 'createTime', 'create_time')
             || null,
+        mediaId: field(raw, 'mediaId', 'media_id') ?? null,
+        mediaType,
+        mediaState: field(raw, 'mediaState', 'media_state') ?? null,
+        mediaAuditStatus: field(raw, 'mediaAuditStatus', 'media_audit_status') ?? null,
+        mediaTypeInfo: field(raw, 'mediaTypeInfo', 'media_type_info') ?? null,
+        sourcePath: sourcePath ?? null,
+        jumpUrl: jumpUrl ?? null,
+        createTime: field(raw, 'createTime', 'create_time') ?? null,
+        updateTime: field(raw, 'updateTime', 'update_time') ?? null,
+        lastModifyTime: field(raw, 'lastModifyTime', 'last_modify_time') ?? null,
+        lastOpenTime: field(raw, 'lastOpenTime', 'last_open_time') ?? null,
+        fileSize: field(raw, 'fileSize', 'file_size') ?? null,
+        abstract: field(raw, 'abstract', 'abstract') ?? null,
+        introduction: field(raw, 'introduction', 'introduction') ?? null,
+        tags: Array.isArray(field(raw, 'tags', 'tags')) ? field(raw, 'tags', 'tags') : [],
+        isTop: field(raw, 'isTop', 'is_top') ?? null,
+        accessStatus: field(raw, 'accessStatus', 'access_status') ?? null,
+        accessStatusUpdateTs: field(raw, 'accessStatusUpdateTs', 'access_status_update_ts') ?? null,
+        parseProgress: field(raw, 'parseProgress', 'parse_progress') ?? null,
+        parseErrInfo: field(raw, 'parseErrInfo', 'parse_err_info') ?? null,
+        summaryState: field(raw, 'summaryState', 'summary_state') ?? null,
+        coverUrls: Array.isArray(field(raw, 'coverUrls', 'cover_urls'))
+            ? field(raw, 'coverUrls', 'cover_urls') : [],
+        logo: field(raw, 'logo', 'logo') ?? null,
     };
 }
 

package/clis/ima/native-client.js

@@ -1,4 +1,4 @@
-import { readKnowledgeBaseFromApi } from './native-api.js';
+import { listKnowledgeBases, readKnowledgeBaseFromApi } from './native-api.js';
 
 const IMA_WIKIS_URL = 'https://ima.qq.com/wikis';
 
@@ -33,7 +33,7 @@ async function triggerImaAuthRequest(page, query) {
     }, query);
 }
 
-export async function readKnowledgeBaseFromChrome(page, query, dependencies = {}) {
+async function acquireImaChromeAuth(page, query, dependencies = {}) {
     if (!page || typeof page.startImaAuthCapture !== 'function'
         || typeof page.readImaAuth !== 'function' || typeof page.requestImaReader !== 'function'
         || typeof page.evaluate !== 'function') {
@@ -44,12 +44,11 @@ export async function readKnowledgeBaseFromChrome(page, query, dependencies = {}
     }
     const timeoutMs = dependencies.timeoutMs ?? 30_000;
     const sleep = dependencies.sleep ?? wait;
-    let authId;
     try {
         await page.startImaAuthCapture();
         await page.goto(IMA_WIKIS_URL);
         await triggerImaAuthRequest(page, query);
-        authId = await waitForImaAuth(page, timeoutMs, sleep);
+        return await waitForImaAuth(page, timeoutMs, sleep);
     } catch (error) {
         if (error?.code === 'IMA_CHROME_AUTH_REQUIRED') throw error;
         throw codedError(
@@ -57,14 +56,31 @@ export async function readKnowledgeBaseFromChrome(page, query, dependencies = {}
             `Chrome Browser Bridge could not acquire ima reader authentication: ${error instanceof Error ? error.message : String(error)}`,
         );
     }
+}
+
+async function releaseImaAuth(page, authId) {
+    if (typeof page.releaseImaAuth === 'function') {
+        await page.releaseImaAuth(authId).catch(() => {});
+    }
+}
+
+export async function readKnowledgeBasesFromChrome(page, dependencies = {}) {
+    const authId = await acquireImaChromeAuth(page, undefined, dependencies);
+    try {
+        return await listKnowledgeBases((path, body) => page.requestImaReader(authId, path, body));
+    } finally {
+        await releaseImaAuth(page, authId);
+    }
+}
+
+export async function readKnowledgeBaseFromChrome(page, query, dependencies = {}) {
+    const authId = await acquireImaChromeAuth(page, query, dependencies);
     try {
         return await readKnowledgeBaseFromApi(
             query,
             (path, body) => page.requestImaReader(authId, path, body),
         );
     } finally {
-        if (typeof page.releaseImaAuth === 'function') {
-            await page.releaseImaAuth(authId).catch(() => {});
-        }
+        await releaseImaAuth(page, authId);
     }
 }

package/clis/ima/utils.js

@@ -37,6 +37,7 @@ export function normalizeArticleUrl(value) {
 
 export function toKnowledgeRow(item) {
     return {
+        ...item,
         knowledgeBaseId: item.knowledgeBaseId || null,
         knowledgeBase: item.knowledgeBase,
         folderPath: Array.isArray(item.folderPath) ? item.folderPath : [],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sovovs/bycli",
-  "version": "2.1.39",
+  "version": "2.1.40",
   "publishConfig": {
     "access": "public"
   },