publishport-opencli 1.8.5-pp.2 → 1.8.5-pp.21

package/clis/dockerhub/utils.js

@@ -1,100 +1 @@
-// Shared helpers for the Docker Hub adapters.
-//
-// Hits the public, unauthenticated `hub.docker.com/v2` REST endpoints. Anonymous
-// pulls are throttled but search / metadata reads are friendly enough for
-// ad-hoc CLI use. Image names follow `[<owner>/]<name>` with `library` as the
-// implicit owner for Docker official images.
-import { ArgumentError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
-
-export const HUB_BASE = 'https://hub.docker.com/v2';
-const UA = 'opencli-dockerhub-adapter (+https://github.com/jackwener/opencli)';
-
-// Docker Hub repository slugs are 2-255 chars, lowercase alphanumerics + `_.-`,
-// optionally prefixed with a Docker Hub user/org of the same charset.
-const SLUG = /^[a-z0-9][a-z0-9._-]*$/;
-
-export function requireString(value, label) {
-    const s = String(value ?? '').trim();
-    if (!s) throw new ArgumentError(`dockerhub ${label} cannot be empty`);
-    return s;
-}
-
-export function requireBoundedInt(value, defaultValue, maxValue, label = 'limit') {
-    const raw = value ?? defaultValue;
-    const n = typeof raw === 'number' ? raw : Number(raw);
-    if (!Number.isInteger(n) || n <= 0) {
-        throw new ArgumentError(`dockerhub ${label} must be a positive integer`);
-    }
-    if (n > maxValue) {
-        throw new ArgumentError(`dockerhub ${label} must be <= ${maxValue}`);
-    }
-    return n;
-}
-
-/**
- * Split an image identifier into `{owner, name}`. Bare names use the implicit
- * `library` owner that Docker Hub uses for official images (`nginx` →
- * `library/nginx`).
- */
-export function parseImage(input) {
-    const raw = String(input ?? '').trim().toLowerCase();
-    if (!raw) {
-        throw new ArgumentError('dockerhub image name is required (e.g. "nginx", "library/nginx", "bitnami/redis")');
-    }
-    const slash = raw.indexOf('/');
-    let owner;
-    let name;
-    if (slash >= 0) {
-        owner = raw.slice(0, slash);
-        name = raw.slice(slash + 1);
-    }
-    else {
-        owner = 'library';
-        name = raw;
-    }
-    if (!SLUG.test(owner) || !SLUG.test(name)) {
-        throw new ArgumentError(
-            `dockerhub image "${input}" is not a valid repository slug`,
-            'Use lowercase letters / digits / "._-", optionally prefixed with "<owner>/".',
-        );
-    }
-    if (name.length < 2 || name.length > 255) {
-        throw new ArgumentError(
-            `dockerhub image "${input}" name must be 2-255 chars`,
-        );
-    }
-    return { owner, name };
-}
-
-export async function hubFetch(url, label) {
-    let resp;
-    try {
-        resp = await fetch(url, { headers: { 'user-agent': UA, accept: 'application/json' } });
-    }
-    catch (err) {
-        throw new CommandExecutionError(
-            `${label} request failed: ${err?.message ?? err}`,
-            'Check that hub.docker.com is reachable from this network.',
-        );
-    }
-    if (resp.status === 404) {
-        throw new EmptyResultError(label, `Docker Hub returned 404 for ${url}.`);
-    }
-    if (resp.status === 429) {
-        throw new CommandExecutionError(
-            `${label} returned HTTP 429 (rate limited)`,
-            'Docker Hub throttles anonymous traffic; wait a few seconds and retry.',
-        );
-    }
-    if (!resp.ok) {
-        throw new CommandExecutionError(`${label} returned HTTP ${resp.status}`);
-    }
-    let body;
-    try {
-        body = await resp.json();
-    }
-    catch (err) {
-        throw new CommandExecutionError(`${label} returned malformed JSON: ${err?.message ?? err}`);
-    }
-    return body;
-}
+import{ArgumentError as K,CommandExecutionError as N,EmptyResultError as P}from"@jackwener/opencli/errors";export const HUB_BASE="https://hub.docker.com/v2";const Q="opencli-dockerhub-adapter (+https://github.com/jackwener/opencli)",O=/^[a-z0-9][a-z0-9._-]*$/;export function requireString(I,F){const q=String(I??"").trim();if(!q)throw new K(`dockerhub ${F} cannot be empty`);return q}export function requireBoundedInt(I,F,q,J="limit"){const z=I??F,M=typeof z==="number"?z:Number(z);if(!Number.isInteger(M)||M<=0)throw new K(`dockerhub ${J} must be a positive integer`);if(M>q)throw new K(`dockerhub ${J} must be <= ${q}`);return M}export function parseImage(I){const F=String(I??"").trim().toLowerCase();if(!F)throw new K('dockerhub image name is required (e.g. "nginx", "library/nginx", "bitnami/redis")');const q=F.indexOf("/");let J,z;if(q>=0){J=F.slice(0,q);z=F.slice(q+1)}else{J="library";z=F}if(!O.test(J)||!O.test(z))throw new K(`dockerhub image "${I}" is not a valid repository slug`,'Use lowercase letters / digits / "._-", optionally prefixed with "<owner>/".');if(z.length<2||z.length>255)throw new K(`dockerhub image "${I}" name must be 2-255 chars`);return{owner:J,name:z}}export async function hubFetch(I,F){let q;try{q=await fetch(I,{headers:{"user-agent":Q,accept:"application/json"}})}catch(z){throw new N(`${F} request failed: ${z?.message??z}`,"Check that hub.docker.com is reachable from this network.")}if(q.status===404)throw new P(F,`Docker Hub returned 404 for ${I}.`);if(q.status===429)throw new N(`${F} returned HTTP 429 (rate limited)`,"Docker Hub throttles anonymous traffic; wait a few seconds and retry.");if(!q.ok)throw new N(`${F} returned HTTP ${q.status}`);let J;try{J=await q.json()}catch(z){throw new N(`${F} returned malformed JSON: ${z?.message??z}`)}return J}

package/clis/dongchedi/koubei.js

@@ -1,85 +1 @@
-/**
- * dongchedi koubei — owner reviews (口碑) for a car series.
- *
- * Reads `pageProps.reviewListData.review_list` from the SSR score page
- * `https://www.dongchedi.com/auto/series/score/<id>-x-x-x-x-x`. Each entry
- * is a real owner write-up: rating, the trim/year they bought, likes,
- * comment count, and the full review body (snippetted for the table; the
- * `url` column links to the complete article).
- */
-
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { EmptyResultError } from '@jackwener/opencli/errors';
-import {
-    DCD_BASE,
-    KOUBEI_COLUMNS,
-    clean,
-    dcdFetchPageProps,
-    normalizeSeriesId,
-    parseScore,
-    requireArray,
-    requireStableId,
-    requireText,
-    requireLimit,
-    snippet,
-} from './utils.js';
-
-/**
- * Pure parser: reviewListData → review rows. Exported for unit testing.
- */
-export function parseKoubei(reviewListData, limit) {
-    const list = reviewListData?.review_list;
-    requireArray(list, 'dongchedi reviewListData.review_list');
-    const rows = [];
-    for (const [index, it] of list.entries()) {
-        const buy = it?.buy_car_info || {};
-        const carName = clean(buy.car_name || it?.car_name);
-        const year = buy.year || it?.year;
-        const car = [year ? String(year) : '', carName].filter(Boolean).join(' ');
-        const gid = requireStableId(it?.gid_str || it?.gid, `dongchedi koubei row ${index + 1}`);
-        rows.push({
-            rank: rows.length + 1,
-            user: requireText(it?.user_info?.name, `dongchedi koubei row ${index + 1} user`),
-            car,
-            score: parseScore(it?.score_info?.score),
-            likes: Number.isFinite(Number(it?.digg_count_en)) ? Number(it.digg_count_en) : 0,
-            comments: Number.isFinite(Number(it?.comment_count_en)) ? Number(it.comment_count_en) : 0,
-            content: snippet(requireText(it?.content, `dongchedi koubei row ${index + 1} content`), 180),
-            url: `${DCD_BASE}/ugc/article/${gid}`,
-        });
-        if (rows.length >= limit) break;
-    }
-    return rows;
-}
-
-cli({
-    site: 'dongchedi',
-    name: 'koubei',
-    access: 'read',
-    aliases: ['reviews'],
-    description: '懂车帝车系口碑/车主评价（评分 / 购车款型 / 点赞 / 评论 / 正文摘要）',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'series_id', required: true, positional: true, help: '车系 ID（来自 search 的 series_id，或 /auto/series/<id> URL）' },
-        { name: 'limit', type: 'int', default: 10, help: '返回的口碑条数（最多 15，单页 SSR 上限）' },
-    ],
-    columns: KOUBEI_COLUMNS,
-    func: async (args) => {
-        const seriesId = normalizeSeriesId(args.series_id);
-        const limit = requireLimit(args.limit, 10, 15);
-        // The score page carries the SSR-rendered owner-review list.
-        const pp = await dcdFetchPageProps(
-            `/auto/series/score/${seriesId}-x-x-x-x-x`,
-            `koubei ${seriesId}`,
-        );
-        const rows = parseKoubei(pp.reviewListData, limit);
-        if (rows.length === 0) {
-            throw new EmptyResultError(
-                `dongchedi koubei ${seriesId}`,
-                'This series has no owner reviews yet.',
-            );
-        }
-        return rows;
-    },
-});
+import{cli as F,Strategy as M}from"@jackwener/opencli/registry";import{EmptyResultError as k}from"@jackwener/opencli/errors";import{DCD_BASE as A,KOUBEI_COLUMNS as B,clean as C,dcdFetchPageProps as K,normalizeSeriesId as N,parseScore as O,requireArray as P,requireStableId as R,requireText as Y,requireLimit as U,snippet as _}from"./utils.js";export function parseKoubei(Q,J){const V=Q?.review_list;P(V,"dongchedi reviewListData.review_list");const G=[];for(const[H,f]of V.entries()){const W=f?.buy_car_info||{},Z=C(W.car_name||f?.car_name),X=W.year||f?.year,$=[X?String(X):"",Z].filter(Boolean).join(" "),z=R(f?.gid_str||f?.gid,`dongchedi koubei row ${H+1}`);G.push({rank:G.length+1,user:Y(f?.user_info?.name,`dongchedi koubei row ${H+1} user`),car:$,score:O(f?.score_info?.score),likes:Number.isFinite(Number(f?.digg_count_en))?Number(f.digg_count_en):0,comments:Number.isFinite(Number(f?.comment_count_en))?Number(f.comment_count_en):0,content:_(Y(f?.content,`dongchedi koubei row ${H+1} content`),180),url:`${A}/ugc/article/${z}`});if(G.length>=J)break}return G}F({site:"dongchedi",name:"koubei",access:"read",aliases:["reviews"],description:"懂车帝车系口碑/车主评价（评分 / 购车款型 / 点赞 / 评论 / 正文摘要）",strategy:M.PUBLIC,browser:!1,args:[{name:"series_id",required:!0,positional:!0,help:"车系 ID（来自 search 的 series_id，或 /auto/series/<id> URL）"},{name:"limit",type:"int",default:10,help:"返回的口碑条数（最多 15，单页 SSR 上限）"}],columns:B,func:async(Q)=>{const J=N(Q.series_id),V=U(Q.limit,10,15),G=await K(`/auto/series/score/${J}-x-x-x-x-x`,`koubei ${J}`),H=parseKoubei(G.reviewListData,V);if(H.length===0)throw new k(`dongchedi koubei ${J}`,"This series has no owner reviews yet.");return H}});

package/clis/dongchedi/models.js

@@ -1,91 +1 @@
-/**
- * dongchedi models — the trims (款型) of a car series with prices.
- *
- * Reads `pageProps.carModelsData.tab_list` from the SSR series page. Each
- * tab ("在售" / a model-year / "停售") holds trim rows; rows carry a real
- * `info.car_id`. Year-group header rows (no car_id) are skipped.
- */
-
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { ArgumentError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
-import {
-    MODELS_COLUMNS,
-    clean,
-    dcdFetchPageProps,
-    normalizeSeriesId,
-    requireArray,
-    requireStableId,
-    requireText,
-} from './utils.js';
-
-/** Normalize a price field that may be a number (59.8) or a string ("51.00万"). */
-function priceStr(v) {
-    if (v == null || v === '') return '';
-    if (typeof v === 'number') return Number.isFinite(v) && v > 0 ? `${v}万` : '';
-    return clean(v);
-}
-
-/**
- * Pure parser: carModelsData + status → trim rows. Exported for unit tests.
- * status: 'online' (在售, default) or 'offline' (停售).
- */
-export function parseModels(carModelsData, status) {
-    const tabs = carModelsData?.tab_list;
-    requireArray(tabs, 'dongchedi carModelsData.tab_list');
-    if (tabs.length === 0) return [];
-    const wantKey = status === 'offline' ? 'offline' : 'online_all';
-    const tab = tabs.find((t) => t?.tab_key === wantKey)
-        || (status === 'offline' ? tabs.find((t) => /停售/.test(t?.tab_text || '')) : tabs[0]);
-    if (!tab) return [];
-    const data = tab?.data;
-    requireArray(data, `dongchedi models ${status} data`);
-
-    const rows = [];
-    for (const [index, d] of data.entries()) {
-        const info = d?.info || {};
-        const carId = info.car_id ?? info.id;
-        if (!carId) continue; // skip model-year header rows
-        rows.push({
-            car_id: requireStableId(carId, `dongchedi models row ${index + 1}`),
-            name: requireText(info.name || info.car_name, `dongchedi models row ${index + 1} name`),
-            year: info.year != null ? String(info.year) : '',
-            official_price: priceStr(info.official_price),
-            dealer_price: priceStr(info.dealer_price),
-            owner_price: priceStr(info.owner_price),
-        });
-    }
-    return rows;
-}
-
-cli({
-    site: 'dongchedi',
-    name: 'models',
-    access: 'read',
-    aliases: ['trims'],
-    description: '懂车帝车系款型列表（car_id / 名称 / 年款 / 指导价 / 经销商价 / 车主成交价）',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'series_id', required: true, positional: true, help: '车系 ID（来自 search 的 series_id，或 /auto/series/<id> URL）' },
-        { name: 'status', default: 'online', help: '在售 online（默认）或停售 offline' },
-    ],
-    columns: MODELS_COLUMNS,
-    func: async (args) => {
-        const seriesId = normalizeSeriesId(args.series_id);
-        const status = String(args.status || 'online').trim().toLowerCase();
-        if (status !== 'online' && status !== 'offline') {
-            throw new ArgumentError('status', "must be 'online' (在售) or 'offline' (停售)");
-        }
-        const pp = await dcdFetchPageProps(`/auto/series/${seriesId}`, `models ${seriesId}`);
-        const rows = parseModels(pp.carModelsData, status);
-        if (rows.length === 0) {
-            const message = status === 'offline' ? 'No discontinued trims listed for this series.' : 'No on-sale trims listed for this series.';
-            const ErrorCtor = status === 'offline' ? EmptyResultError : CommandExecutionError;
-            throw new ErrorCtor(
-                `dongchedi models ${seriesId} (${status})`,
-                message,
-            );
-        }
-        return rows;
-    },
-});
+import{cli as K,Strategy as N}from"@jackwener/opencli/registry";import{ArgumentError as R,CommandExecutionError as T,EmptyResultError as U}from"@jackwener/opencli/errors";import{MODELS_COLUMNS as _,clean as h,dcdFetchPageProps as C,normalizeSeriesId as L,requireArray as z,requireStableId as O,requireText as j}from"./utils.js";function Z(B){if(B==null||B==="")return"";if(typeof B==="number")return Number.isFinite(B)&&B>0?`${B}万`:"";return h(B)}export function parseModels(B,J){const G=B?.tab_list;z(G,"dongchedi carModelsData.tab_list");if(G.length===0)return[];const X=J==="offline"?"offline":"online_all",V=G.find((Q)=>Q?.tab_key===X)||(J==="offline"?G.find((Q)=>/停售/.test(Q?.tab_text||"")):G[0]);if(!V)return[];const W=V?.data;z(W,`dongchedi models ${J} data`);const Y=[];for(const[Q,F]of W.entries()){const H=F?.info||{},$=H.car_id??H.id;if(!$)continue;Y.push({car_id:O($,`dongchedi models row ${Q+1}`),name:j(H.name||H.car_name,`dongchedi models row ${Q+1} name`),year:H.year!=null?String(H.year):"",official_price:Z(H.official_price),dealer_price:Z(H.dealer_price),owner_price:Z(H.owner_price)})}return Y}K({site:"dongchedi",name:"models",access:"read",aliases:["trims"],description:"懂车帝车系款型列表（car_id / 名称 / 年款 / 指导价 / 经销商价 / 车主成交价）",strategy:N.PUBLIC,browser:!1,args:[{name:"series_id",required:!0,positional:!0,help:"车系 ID（来自 search 的 series_id，或 /auto/series/<id> URL）"},{name:"status",default:"online",help:"在售 online（默认）或停售 offline"}],columns:_,func:async(B)=>{const J=L(B.series_id),G=String(B.status||"online").trim().toLowerCase();if(G!=="online"&&G!=="offline")throw new R("status","must be 'online' (在售) or 'offline' (停售)");const X=await C(`/auto/series/${J}`,`models ${J}`),V=parseModels(X.carModelsData,G);if(V.length===0){const W=G==="offline"?"No discontinued trims listed for this series.":"No on-sale trims listed for this series.";throw new(G==="offline"?U:T)(`dongchedi models ${J} (${G})`,W)}return V}});

package/clis/dongchedi/score.js

@@ -1,83 +1 @@
-/**
- * dongchedi score — 懂车分 rating breakdown for a car series.
- *
- * Reads `pageProps.scoreSimpleInfo` (the series' 8-axis owner rating) and
- * `pageProps.reviewData.same_level_review` (the same-class average) from the
- * SSR series page, so each axis can be shown next to its segment benchmark.
- * Scores are rescaled from x100 ints to /5 floats (422 -> 4.22).
- */
-
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { EmptyResultError } from '@jackwener/opencli/errors';
-import {
-    SCORE_COLUMNS,
-    dcdFetchPageProps,
-    normalizeSeriesId,
-    parseScore,
-    requireArray,
-} from './utils.js';
-
-/** Dongchedi's 8 rating axes, in display order: [field, 中文 label]. */
-const AXES = [
-    ['score', '综合'],
-    ['space_score', '空间'],
-    ['power_score', '动力'],
-    ['control_score', '操控'],
-    ['comfort_score', '舒适性'],
-    ['appearance_score', '外观'],
-    ['interiors_score', '内饰'],
-    ['configuration_score', '配置'],
-];
-
-/**
- * Pure parser: scoreSimpleInfo + same-level average → rows. Exported for tests.
- */
-export function parseScoreBreakdown(scoreSimpleInfo, sameLevelAvg) {
-    if (!scoreSimpleInfo || typeof scoreSimpleInfo !== 'object' || Array.isArray(scoreSimpleInfo)) {
-        throw new EmptyResultError(
-            'dongchedi score',
-            'This series has no 懂车分 rating yet (too few owner reviews).',
-        );
-    }
-    const ssi = scoreSimpleInfo || {};
-    const avg = sameLevelAvg || {};
-    return AXES.map(([key, label]) => ({
-        dimension: label,
-        score: parseScore(ssi[key]),
-        same_level_avg: parseScore(avg[key]),
-    }));
-}
-
-/** Pick the "同级车均值" row out of reviewData.same_level_review. */
-function sameLevelAverage(reviewData) {
-    const list = reviewData?.same_level_review;
-    if (list == null) return reviewData?.average_series_review || {};
-    requireArray(list, 'dongchedi same_level_review');
-    return list.find((r) => String(r?.series_id) === '0') || list[0] || {};
-}
-
-cli({
-    site: 'dongchedi',
-    name: 'score',
-    access: 'read',
-    aliases: ['rating'],
-    description: '懂车帝车系评分（懂车分 8 维度 + 同级车均值对比）',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'series_id', required: true, positional: true, help: '车系 ID（来自 search 的 series_id，或 /auto/series/<id> URL）' },
-    ],
-    columns: SCORE_COLUMNS,
-    func: async (args) => {
-        const seriesId = normalizeSeriesId(args.series_id);
-        const pp = await dcdFetchPageProps(`/auto/series/${seriesId}`, `score ${seriesId}`);
-        const rows = parseScoreBreakdown(pp.scoreSimpleInfo, sameLevelAverage(pp.reviewData));
-        if (rows.every((r) => r.score == null)) {
-            throw new EmptyResultError(
-                `dongchedi score ${seriesId}`,
-                'This series has no 懂车分 rating yet (too few owner reviews).',
-            );
-        }
-        return rows;
-    },
-});
+import{cli as W,Strategy as Y}from"@jackwener/opencli/registry";import{EmptyResultError as Q}from"@jackwener/opencli/errors";import{SCORE_COLUMNS as Z,dcdFetchPageProps as $,normalizeSeriesId as q,parseScore as T,requireArray as z}from"./utils.js";const B=[["score","综合"],["space_score","空间"],["power_score","动力"],["control_score","操控"],["comfort_score","舒适性"],["appearance_score","外观"],["interiors_score","内饰"],["configuration_score","配置"]];export function parseScoreBreakdown(G,x){if(!G||typeof G!=="object"||Array.isArray(G))throw new Q("dongchedi score","This series has no 懂车分 rating yet (too few owner reviews).");const H=G||{},J=x||{};return B.map(([K,V])=>({dimension:V,score:T(H[K]),same_level_avg:T(J[K])}))}function F(G){const x=G?.same_level_review;if(x==null)return G?.average_series_review||{};z(x,"dongchedi same_level_review");return x.find((H)=>String(H?.series_id)==="0")||x[0]||{}}W({site:"dongchedi",name:"score",access:"read",aliases:["rating"],description:"懂车帝车系评分（懂车分 8 维度 + 同级车均值对比）",strategy:Y.PUBLIC,browser:!1,args:[{name:"series_id",required:!0,positional:!0,help:"车系 ID（来自 search 的 series_id，或 /auto/series/<id> URL）"}],columns:Z,func:async(G)=>{const x=q(G.series_id),H=await $(`/auto/series/${x}`,`score ${x}`),J=parseScoreBreakdown(H.scoreSimpleInfo,F(H.reviewData));if(J.every((K)=>K.score==null))throw new Q(`dongchedi score ${x}`,"This series has no 懂车分 rating yet (too few owner reviews).");return J}});

package/clis/dongchedi/search.js

@@ -1,83 +1 @@
-/**
- * dongchedi search — find car series (车系) by keyword.
- *
- * Hits the SSR search page `https://www.dongchedi.com/search?keyword=...`
- * and reads `pageProps.searchData.data`. That list mixes cards (series,
- * videos, news, dealers); we keep only car-series cards (cell_type 26 with
- * a real series_id) and surface name / brand / official + dealer price.
- */
-
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { ArgumentError, EmptyResultError } from '@jackwener/opencli/errors';
-import {
-    DCD_BASE,
-    SEARCH_COLUMNS,
-    clean,
-    requireArray,
-    requireStableId,
-    requireText,
-    dcdFetchPageProps,
-    requireLimit,
-} from './utils.js';
-
-/** cell_type for a car-series result card. */
-const SERIES_CELL_TYPE = 26;
-
-/**
- * Pure parser: searchData → series rows. Exported for unit testing against
- * the frozen fixture so shape drift is caught without a live fetch.
- */
-export function parseSearchRows(searchData, limit) {
-    const data = requireArray(searchData?.data, 'dongchedi searchData.data');
-    const rows = [];
-    for (const [index, item] of data.entries()) {
-        if (item?.cell_type !== SERIES_CELL_TYPE) continue;
-        const seriesId = requireStableId(item?.series_id, `dongchedi search row ${index + 1}`);
-        const d = item.display || {};
-        const name = requireText(d.series_name || d.title, `dongchedi search row ${index + 1} name`);
-        rows.push({
-            rank: rows.length + 1,
-            series_id: seriesId,
-            name,
-            brand: clean(d.sub_brand_name),
-            official_price: clean(d.official_price),
-            dealer_price: clean(d.agent_price),
-            pictures: Number.isFinite(Number(d.picture_num)) ? Number(d.picture_num) : null,
-            url: `${DCD_BASE}/auto/series/${seriesId}`,
-        });
-        if (rows.length >= limit) break;
-    }
-    return rows;
-}
-
-cli({
-    site: 'dongchedi',
-    name: 'search',
-    access: 'read',
-    description: '懂车帝车系搜索（按关键词，返回车系 + 指导价/经销商价）',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'keyword', required: true, positional: true, help: '搜索关键词，例如 "宝马X5" 或 "汉兰达"' },
-        { name: 'limit', type: 'int', default: 15, help: '返回的车系数量（最多 30）' },
-    ],
-    columns: SEARCH_COLUMNS,
-    func: async (args) => {
-        const keyword = String(args.keyword || '').trim();
-        if (!keyword) throw new ArgumentError('keyword', 'must be a non-empty string');
-        const limit = requireLimit(args.limit, 15, 30);
-
-        const pp = await dcdFetchPageProps(
-            `/search?keyword=${encodeURIComponent(keyword)}`,
-            `search "${keyword}"`,
-        );
-        const rows = parseSearchRows(pp.searchData, limit);
-        if (rows.length === 0) {
-            throw new EmptyResultError(
-                `dongchedi search "${keyword}"`,
-                'No car series matched. Try the model name, e.g. "宝马X5" or "汉兰达".',
-            );
-        }
-        return rows;
-    },
-});
+import{cli as v,Strategy as z}from"@jackwener/opencli/registry";import{ArgumentError as B,EmptyResultError as F}from"@jackwener/opencli/errors";import{DCD_BASE as H,SEARCH_COLUMNS as M,clean as Z,requireArray as N,requireStableId as O,requireText as U,dcdFetchPageProps as Y,requireLimit as T}from"./utils.js";const j=26;export function parseSearchRows(V,J){const W=N(V?.data,"dongchedi searchData.data"),K=[];for(const[Q,X]of W.entries()){if(X?.cell_type!==j)continue;const $=O(X?.series_id,`dongchedi search row ${Q+1}`),G=X.display||{},b=U(G.series_name||G.title,`dongchedi search row ${Q+1} name`);K.push({rank:K.length+1,series_id:$,name:b,brand:Z(G.sub_brand_name),official_price:Z(G.official_price),dealer_price:Z(G.agent_price),pictures:Number.isFinite(Number(G.picture_num))?Number(G.picture_num):null,url:`${H}/auto/series/${$}`});if(K.length>=J)break}return K}v({site:"dongchedi",name:"search",access:"read",description:"懂车帝车系搜索（按关键词，返回车系 + 指导价/经销商价）",strategy:z.PUBLIC,browser:!1,args:[{name:"keyword",required:!0,positional:!0,help:'搜索关键词，例如 "宝马X5" 或 "汉兰达"'},{name:"limit",type:"int",default:15,help:"返回的车系数量（最多 30）"}],columns:M,func:async(V)=>{const J=String(V.keyword||"").trim();if(!J)throw new B("keyword","must be a non-empty string");const W=T(V.limit,15,30),K=await Y(`/search?keyword=${encodeURIComponent(J)}`,`search "${J}"`),Q=parseSearchRows(K.searchData,W);if(Q.length===0)throw new F(`dongchedi search "${J}"`,'No car series matched. Try the model name, e.g. "宝马X5" or "汉兰达".');return Q}});

package/clis/dongchedi/series.js

@@ -1,87 +1 @@
-/**
- * dongchedi series — one car series at a glance.
- *
- * Reads the SSR series page `https://www.dongchedi.com/auto/series/<id>`
- * (`pageProps.seriesHomeHead` + `scoreSimpleInfo` + `rankData` +
- * `carModelsData`) into a key/value sheet: brand, official/dealer/used
- * price ranges, 懂车分 score + review count, sales rank, and trim count.
- */
-
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import {
-    DCD_BASE,
-    SERIES_COLUMNS,
-    assertPlainObject,
-    clean,
-    dcdFetchPageProps,
-    normalizeSeriesId,
-    parseScore,
-    requireText,
-} from './utils.js';
-
-/** Count on-sale trims (info.car_id present) in the carModelsData tabs. */
-function countOnSaleModels(carModelsData) {
-    const tabs = carModelsData?.tab_list;
-    if (!Array.isArray(tabs)) return null;
-    const tab = tabs.find((t) => t?.tab_key === 'online_all') || tabs[0];
-    const data = tab?.data;
-    if (!Array.isArray(data)) return null;
-    return data.filter((d) => (d?.info?.car_id ?? d?.info?.id)).length;
-}
-
-/** Format a rank entry "懂车分榜 第1名" from a rankData section. */
-function formatRank(section) {
-    const top = section?.list?.[0];
-    if (!top || !top.rank) return '';
-    const name = clean(section.rank_name || top.rank_name);
-    return name ? `${name} 第${top.rank}名` : `第${top.rank}名`;
-}
-
-/**
- * Pure parser: series pageProps → field/value rows. Exported for unit tests.
- */
-export function parseSeries(pp, seriesId) {
-    const head = assertPlainObject(pp?.seriesHomeHead, 'dongchedi seriesHomeHead');
-    const score = pp.scoreSimpleInfo || {};
-    const rank = pp.rankData || {};
-
-    const usedPrice = (head.sh_low_Price || head.sh_high_price)
-        ? `${head.sh_low_Price ?? '?'}-${head.sh_high_price ?? '?'}万`
-        : '';
-
-    const fields = [
-        ['series_id', seriesId],
-        ['name', requireText(head.series_name, 'dongchedi series name')],
-        ['brand', requireText(head.brand_name, 'dongchedi series brand')],
-        ['sub_brand', clean(head.sub_brand_name)],
-        ['official_price', head.has_official_price ? clean(head.official_price) : ''],
-        ['dealer_price', head.has_dealer_price ? clean(head.dealer_price) : ''],
-        ['used_price', usedPrice],
-        ['score', parseScore(score.score)],
-        ['review_count', Number.isFinite(Number(score.total_review_count)) ? Number(score.total_review_count) : null],
-        ['sale_rank', formatRank(rank.sale)],
-        ['score_rank', formatRank(rank.score)],
-        ['models', countOnSaleModels(pp.carModelsData)],
-        ['url', `${DCD_BASE}/auto/series/${seriesId}`],
-    ];
-    return fields.map(([field, value]) => ({ field, value }));
-}
-
-cli({
-    site: 'dongchedi',
-    name: 'series',
-    access: 'read',
-    aliases: ['detail'],
-    description: '懂车帝车系概览（品牌 / 指导价 / 二手价 / 懂车分 / 销量排名 / 在售款型数）',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'series_id', required: true, positional: true, help: '车系 ID（来自 search 的 series_id，或 /auto/series/<id> URL）' },
-    ],
-    columns: SERIES_COLUMNS,
-    func: async (args) => {
-        const seriesId = normalizeSeriesId(args.series_id);
-        const pp = await dcdFetchPageProps(`/auto/series/${seriesId}`, `series ${seriesId}`);
-        return parseSeries(pp, seriesId);
-    },
-});
+import{cli as z,Strategy as A}from"@jackwener/opencli/registry";import{DCD_BASE as B,SERIES_COLUMNS as F,assertPlainObject as L,clean as V,dcdFetchPageProps as N,normalizeSeriesId as U,parseScore as q,requireText as W}from"./utils.js";function w(J){const H=J?.tab_list;if(!Array.isArray(H))return null;const Q=(H.find((K)=>K?.tab_key==="online_all")||H[0])?.data;if(!Array.isArray(Q))return null;return Q.filter((K)=>K?.info?.car_id??K?.info?.id).length}function X(J){const H=J?.list?.[0];if(!H||!H.rank)return"";const G=V(J.rank_name||H.rank_name);return G?`${G} 第${H.rank}名`:`第${H.rank}名`}export function parseSeries(J,H){const G=L(J?.seriesHomeHead,"dongchedi seriesHomeHead"),Q=J.scoreSimpleInfo||{},K=J.rankData||{},Y=G.sh_low_Price||G.sh_high_price?`${G.sh_low_Price??"?"}-${G.sh_high_price??"?"}万`:"";return[["series_id",H],["name",W(G.series_name,"dongchedi series name")],["brand",W(G.brand_name,"dongchedi series brand")],["sub_brand",V(G.sub_brand_name)],["official_price",G.has_official_price?V(G.official_price):""],["dealer_price",G.has_dealer_price?V(G.dealer_price):""],["used_price",Y],["score",q(Q.score)],["review_count",Number.isFinite(Number(Q.total_review_count))?Number(Q.total_review_count):null],["sale_rank",X(K.sale)],["score_rank",X(K.score)],["models",w(J.carModelsData)],["url",`${B}/auto/series/${H}`]].map(([Z,$])=>({field:Z,value:$}))}z({site:"dongchedi",name:"series",access:"read",aliases:["detail"],description:"懂车帝车系概览（品牌 / 指导价 / 二手价 / 懂车分 / 销量排名 / 在售款型数）",strategy:A.PUBLIC,browser:!1,args:[{name:"series_id",required:!0,positional:!0,help:"车系 ID（来自 search 的 series_id，或 /auto/series/<id> URL）"}],columns:F,func:async(J)=>{const H=U(J.series_id),G=await N(`/auto/series/${H}`,`series ${H}`);return parseSeries(G,H)}});