@sovovs/bycli 1.8.0

package/clis/hf/spaces.js

@@ -0,0 +1,101 @@
+// hf spaces — list top Hugging Face Spaces (gradio / streamlit / static demos).
+//
+// Hits `https://huggingface.co/api/spaces?sort=…&full=true`. Mirrors the shape
+// of `hf models` / `hf datasets`. The Spaces API does not expose `trending` as
+// a sort key (verified live: returns "Invalid sort parameter"), so the allowed
+// sort set is narrower.
+import { cli, Strategy } from '@sovovs/bycli/registry';
+import { ArgumentError, CommandExecutionError, EmptyResultError } from '@sovovs/bycli/errors';
+
+const SORT_OPTIONS = ['likes', 'created_at', 'last_modified'];
+const SORT_ALIAS = { lastmodified: 'last_modified', createdat: 'created_at' };
+
+cli({
+    site: 'hf',
+    name: 'spaces',
+    access: 'read',
+    description: 'Top Hugging Face Spaces (likes / created_at / last_modified).',
+    domain: 'huggingface.co',
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        { name: 'sort', type: 'string', default: 'likes', help: `Sort key: ${SORT_OPTIONS.join(', ')}` },
+        { name: 'search', type: 'string', required: false, help: 'Optional name/owner substring filter (e.g. "stability", "openai/")' },
+        { name: 'sdk', type: 'string', required: false, help: 'Filter by Space SDK: gradio / streamlit / docker / static' },
+        { name: 'limit', type: 'int', default: 20, help: 'Max spaces (max 100; one API page).' },
+    ],
+    columns: ['rank', 'id', 'author', 'sdk', 'likes', 'tags', 'lastModified', 'url'],
+    func: async (args) => {
+        const sortRaw = String(args.sort ?? 'likes').toLowerCase();
+        const sort = SORT_ALIAS[sortRaw] ?? sortRaw;
+        if (!SORT_OPTIONS.includes(sort)) {
+            throw new ArgumentError(`hf spaces sort must be one of ${SORT_OPTIONS.join(', ')}`);
+        }
+        const limit = Number(args.limit ?? 20);
+        if (!Number.isInteger(limit) || limit <= 0) {
+            throw new ArgumentError('hf spaces limit must be a positive integer');
+        }
+        if (limit > 100) {
+            throw new ArgumentError('hf spaces limit must be <= 100');
+        }
+        const sdk = args.sdk == null ? '' : String(args.sdk).trim().toLowerCase();
+        const allowedSdks = new Set(['', 'gradio', 'streamlit', 'docker', 'static']);
+        if (!allowedSdks.has(sdk)) {
+            throw new ArgumentError(`hf spaces sdk must be one of gradio / streamlit / docker / static`);
+        }
+
+        const url = new URL('https://huggingface.co/api/spaces');
+        url.searchParams.set('sort', sort);
+        url.searchParams.set('direction', '-1');
+        url.searchParams.set('limit', String(limit));
+        url.searchParams.set('full', 'true');
+        if (args.search) url.searchParams.set('search', String(args.search));
+        if (sdk) url.searchParams.set('sdk', sdk);
+
+        let resp;
+        try {
+            resp = await fetch(url, {
+                headers: { Accept: 'application/json', 'User-Agent': 'bycli/1.0 (+https://github.com/sovovs/byCLI)' },
+            });
+        }
+        catch (err) {
+            throw new CommandExecutionError(`hf spaces request failed: ${err?.message ?? err}`);
+        }
+        if (resp.status === 429) {
+            throw new CommandExecutionError(
+                'hf spaces returned HTTP 429 (rate limited)',
+                'Hugging Face throttles unauthenticated traffic; wait a few seconds and retry.',
+            );
+        }
+        if (!resp.ok) {
+            throw new CommandExecutionError(`hf spaces failed: HTTP ${resp.status}`);
+        }
+        let data;
+        try {
+            data = await resp.json();
+        }
+        catch (err) {
+            throw new CommandExecutionError(`hf spaces returned malformed JSON: ${err?.message ?? err}`);
+        }
+        const list = Array.isArray(data) ? data : [];
+        if (!list.length) {
+            throw new EmptyResultError('hf spaces', 'No matching spaces on huggingface.co.');
+        }
+        return list.slice(0, limit).map((s, i) => {
+            const id = String(s.id ?? s._id ?? '');
+            const slash = id.indexOf('/');
+            const author = String(s.author ?? (slash > 0 ? id.slice(0, slash) : ''));
+            const tags = Array.isArray(s.tags) ? s.tags.filter((t) => !String(t).startsWith('license:')).slice(0, 10).join(', ') : '';
+            return {
+                rank: i + 1,
+                id,
+                author,
+                sdk: String(s.sdk ?? ''),
+                likes: s.likes != null ? Number(s.likes) : null,
+                tags,
+                lastModified: String(s.lastModified ?? '').slice(0, 10),
+                url: id ? `https://huggingface.co/spaces/${id}` : '',
+            };
+        });
+    },
+});

package/clis/hf/top.js

@@ -0,0 +1,121 @@
+import { cli, Strategy } from '@sovovs/bycli/registry';
+import { CliError } from '@sovovs/bycli/errors';
+function truncate(str, max = 60) {
+    return str.length > max ? str.slice(0, max - 3) + '...' : str;
+}
+function formatAuthors(authors, max = 3) {
+    const names = authors.map((a) => a.name);
+    if (names.length <= max)
+        return names.join(', ');
+    return names.slice(0, max).join(', ') + ' et al.';
+}
+const MONTH_ABBR = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+function getMonthRange() {
+    const now = new Date();
+    return `${MONTH_ABBR[now.getUTCMonth()]} ${now.getUTCFullYear()}`;
+}
+function getWeekRange() {
+    const now = new Date();
+    const day = now.getUTCDay(); // 0=Sun, 6=Sat
+    const daysToSat = day === 6 ? 0 : 6 - day;
+    const end = new Date(now);
+    end.setUTCDate(now.getUTCDate() + daysToSat);
+    const start = new Date(end);
+    start.setUTCDate(end.getUTCDate() - 6);
+    const sm = MONTH_ABBR[start.getUTCMonth()];
+    const em = MONTH_ABBR[end.getUTCMonth()];
+    const sd = start.getUTCDate();
+    const ed = end.getUTCDate();
+    return sm === em ? `${sm} ${sd}-${ed}` : `${sm} ${sd}-${em} ${ed}`;
+}
+cli({
+    site: 'hf',
+    name: 'top',
+    access: 'read',
+    description: 'Top upvoted Hugging Face papers',
+    domain: 'huggingface.co',
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        { name: 'limit', type: 'int', default: 20, help: 'Number of papers' },
+        { name: 'all', type: 'bool', default: false, help: 'Return all papers (ignore limit)' },
+        { name: 'date', type: 'str', required: false, help: 'Date (YYYY-MM-DD), defaults to most recent' },
+        { name: 'period', type: 'str', default: 'daily', choices: ['daily', 'weekly', 'monthly'], help: 'Time period: daily, weekly, or monthly' },
+    ],
+    columns: ['rank', 'id', 'title', 'upvotes', 'authors'],
+    footerExtra: (kwargs) => {
+        if (kwargs._footerDate)
+            return kwargs._footerDate;
+        if (kwargs.period === 'monthly')
+            return getMonthRange();
+        if (kwargs.period === 'weekly')
+            return getWeekRange();
+        return kwargs.date ?? new Date().toISOString().slice(0, 10);
+    },
+    func: async (kwargs) => {
+        const period = String(kwargs.period ?? 'daily');
+        const all = Boolean(kwargs.all);
+        const endpoint = process.env.HF_ENDPOINT?.replace(/\/+$/, '') || 'https://huggingface.co';
+        if (period === 'weekly' || period === 'monthly') {
+            if (kwargs.date) {
+                throw new CliError('INVALID_ARG', `--date is not supported for ${period} period`, `Omit --date when using --period ${period}`);
+            }
+            const url = `${endpoint}/api/papers?period=${period}`;
+            const res = await fetch(url);
+            if (!res.ok)
+                throw new CliError('FETCH_ERROR', `HF API error: ${res.status} ${res.statusText}`, 'Check HF_ENDPOINT or try again later');
+            const body = await res.json();
+            if (!Array.isArray(body))
+                throw new CliError('FETCH_ERROR', 'Unexpected HF API response', 'Check endpoint');
+            const data = body;
+            const dates = data.map((d) => d.publishedAt).filter(Boolean).sort();
+            if (dates.length > 0) {
+                if (period === 'monthly') {
+                    const d = new Date(dates[0]);
+                    kwargs._footerDate = `${MONTH_ABBR[d.getUTCMonth()]} ${d.getUTCFullYear()}`;
+                }
+                else {
+                    const start = new Date(dates[0]);
+                    const end = new Date(dates[dates.length - 1]);
+                    const sm = MONTH_ABBR[start.getUTCMonth()];
+                    const em = MONTH_ABBR[end.getUTCMonth()];
+                    const sd = start.getUTCDate();
+                    const ed = end.getUTCDate();
+                    kwargs._footerDate = sm === em ? `${sm} ${sd}-${ed}` : `${sm} ${sd}-${em} ${ed}`;
+                }
+            }
+            const sorted = [...data].sort((a, b) => (b.upvotes ?? 0) - (a.upvotes ?? 0));
+            const items = all ? sorted : sorted.slice(0, Number(kwargs.limit));
+            return items.map((item, i) => ({
+                rank: i + 1,
+                id: item.id ?? '',
+                title: truncate(item.title ?? ''),
+                upvotes: item.upvotes ?? 0,
+                authors: formatAuthors(item.authors ?? []),
+            }));
+        }
+        // daily
+        if (kwargs.date && !/^\d{4}-\d{2}-\d{2}$/.test(String(kwargs.date))) {
+            throw new CliError('INVALID_ARG', `Invalid date format: ${kwargs.date}`, 'Use YYYY-MM-DD');
+        }
+        const url = kwargs.date
+            ? `${endpoint}/api/daily_papers?date=${kwargs.date}`
+            : `${endpoint}/api/daily_papers`;
+        const res = await fetch(url);
+        if (!res.ok)
+            throw new CliError('FETCH_ERROR', `HF API error: ${res.status} ${res.statusText}`, 'Check HF_ENDPOINT or try again later');
+        const body = await res.json();
+        if (!Array.isArray(body))
+            throw new CliError('FETCH_ERROR', 'Unexpected HF API response', 'Check date format or endpoint');
+        const data = body;
+        const sorted = [...data].sort((a, b) => (b.paper?.upvotes ?? 0) - (a.paper?.upvotes ?? 0));
+        const items = all ? sorted : sorted.slice(0, Number(kwargs.limit));
+        return items.map((item, i) => ({
+            rank: i + 1,
+            id: item.paper?.id ?? '',
+            title: truncate(item.title ?? ''),
+            upvotes: item.paper?.upvotes ?? 0,
+            authors: formatAuthors(item.paper?.authors ?? []),
+        }));
+    },
+});

package/clis/homebrew/cask.js

@@ -0,0 +1,39 @@
+// homebrew cask — fetch a single Homebrew cask's metadata.
+//
+// Hits `https://formulae.brew.sh/api/cask/<token>.json`. Returns one row for
+// the macOS/.dmg-style package: canonical token, friendly name, version,
+// homepage, deprecated / disabled flags, download URL.
+import { cli, Strategy } from '@sovovs/bycli/registry';
+import { BREW_BASE, brewFetch, requireToken } from './utils.js';
+
+cli({
+    site: 'homebrew',
+    name: 'cask',
+    access: 'read',
+    description: 'Fetch a Homebrew cask\'s metadata (version, homepage, deprecation, download URL)',
+    domain: 'formulae.brew.sh',
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        { name: 'token', positional: true, required: true, help: 'Cask token (e.g. "firefox", "visual-studio-code", "google-chrome")' },
+    ],
+    columns: ['cask', 'tap', 'name', 'version', 'description', 'homepage', 'deprecated', 'disabled', 'download', 'url'],
+    func: async (args) => {
+        const token = requireToken(args.token, 'token');
+        const url = `${BREW_BASE}/cask/${encodeURIComponent(token)}.json`;
+        const body = await brewFetch(url, 'homebrew cask');
+        const friendly = Array.isArray(body?.name) ? body.name.filter(Boolean).join(', ') : String(body?.name ?? '').trim();
+        return [{
+            cask: String(body?.token ?? token).trim(),
+            tap: String(body?.tap ?? '').trim(),
+            name: friendly,
+            version: String(body?.version ?? '').trim(),
+            description: String(body?.desc ?? '').trim(),
+            homepage: String(body?.homepage ?? '').trim(),
+            deprecated: Boolean(body?.deprecated),
+            disabled: Boolean(body?.disabled),
+            download: String(body?.url ?? '').trim(),
+            url: `https://formulae.brew.sh/cask/${encodeURIComponent(token)}`,
+        }];
+    },
+});

package/clis/homebrew/formula.js

@@ -0,0 +1,41 @@
+// homebrew formula — fetch a single Homebrew core formula's metadata.
+//
+// Hits `https://formulae.brew.sh/api/formula/<name>.json`. Returns one row:
+// canonical name, latest stable version, license, dependencies, deprecated /
+// disabled flags, homepage, source tarball URL.
+import { cli, Strategy } from '@sovovs/bycli/registry';
+import { BREW_BASE, brewFetch, requireToken } from './utils.js';
+
+cli({
+    site: 'homebrew',
+    name: 'formula',
+    access: 'read',
+    description: 'Fetch a Homebrew formula\'s metadata (version, license, deps, deprecation, source)',
+    domain: 'formulae.brew.sh',
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        { name: 'name', positional: true, required: true, help: 'Formula name (e.g. "wget", "gcc@13", "imagemagick")' },
+    ],
+    columns: ['formula', 'tap', 'version', 'license', 'description', 'homepage', 'dependencies', 'deprecated', 'disabled', 'source', 'url'],
+    func: async (args) => {
+        const name = requireToken(args.name, 'formula');
+        const url = `${BREW_BASE}/formula/${encodeURIComponent(name)}.json`;
+        const body = await brewFetch(url, 'homebrew formula');
+        const deps = Array.isArray(body?.dependencies) ? body.dependencies.filter(Boolean) : [];
+        const stableUrl = String(body?.urls?.stable?.url ?? '').trim();
+        return [{
+            formula: String(body?.name ?? name).trim(),
+            tap: String(body?.tap ?? '').trim(),
+            version: String(body?.versions?.stable ?? '').trim(),
+            license: String(body?.license ?? '').trim(),
+            description: String(body?.desc ?? '').trim(),
+            homepage: String(body?.homepage ?? '').trim(),
+            dependencies: deps.join(', '),
+            deprecated: Boolean(body?.deprecated),
+            disabled: Boolean(body?.disabled),
+            source: stableUrl,
+            url: `https://formulae.brew.sh/formula/${encodeURIComponent(name)}`,
+        }];
+    },
+});

package/clis/homebrew/popular.js

@@ -0,0 +1,54 @@
+// homebrew popular — list the most-installed Homebrew formulae or casks.
+//
+// Hits `https://formulae.brew.sh/api/analytics/(install|cask-install)/<window>.json`.
+// Anonymous-aggregated install counts published by Homebrew themselves;
+// rows round-trip into `homebrew formula` / `homebrew cask` via the `token`
+// column. The 30/90/365-day windows are the only ones the analytics endpoint
+// publishes — anything else 404s upstream.
+import { cli, Strategy } from '@sovovs/bycli/registry';
+import { EmptyResultError } from '@sovovs/bycli/errors';
+import { BREW_BASE, brewFetch, parseInstallCount, requireBoundedInt, requireOneOf } from './utils.js';
+
+const TYPES = ['formula', 'cask'];
+const WINDOWS = ['30d', '90d', '365d'];
+
+cli({
+    site: 'homebrew',
+    name: 'popular',
+    access: 'read',
+    description: 'List most-installed Homebrew formulae or casks (Homebrew\'s analytics ranking)',
+    domain: 'formulae.brew.sh',
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        { name: 'type', default: 'formula', help: `Package type (${TYPES.join(' / ')})` },
+        { name: 'window', default: '30d', help: `Time window (${WINDOWS.join(' / ')})` },
+        { name: 'limit', type: 'int', default: 30, help: 'Max rows (1-500)' },
+    ],
+    columns: ['rank', 'token', 'type', 'installs', 'percent', 'window', 'url'],
+    func: async (args) => {
+        const type = requireOneOf(args.type, TYPES, 'type');
+        const window = requireOneOf(args.window, WINDOWS, 'window');
+        const limit = requireBoundedInt(args.limit, 30, 500);
+        const path = type === 'cask' ? 'cask-install' : 'install';
+        const url = `${BREW_BASE}/analytics/${path}/${window}.json`;
+        const body = await brewFetch(url, 'homebrew popular');
+        const items = Array.isArray(body?.items) ? body.items : [];
+        if (!items.length) {
+            throw new EmptyResultError('homebrew popular', `Homebrew analytics returned no items for ${type}/${window}.`);
+        }
+        return items.slice(0, limit).map((row, i) => {
+            const token = String(type === 'cask' ? row.cask : row.formula ?? '').trim();
+            const detailPath = type === 'cask' ? 'cask' : 'formula';
+            return {
+                rank: row.number != null ? Number(row.number) : i + 1,
+                token,
+                type,
+                installs: parseInstallCount(row.count),
+                percent: row.percent != null ? Number(row.percent) : null,
+                window,
+                url: token ? `https://formulae.brew.sh/${detailPath}/${encodeURIComponent(token)}` : '',
+            };
+        });
+    },
+});

package/clis/homebrew/utils.js

@@ -0,0 +1,100 @@
+// Shared helpers for the Homebrew adapters.
+//
+// Hits the public, unauthenticated `formulae.brew.sh/api` JSON endpoints
+// (served as static files from GitHub Pages, regenerated daily). No auth.
+// Formula / cask tokens are lowercase ASCII + `-_.+@` per Homebrew's own
+// validation; they round-trip into `homebrew formula` / `homebrew cask`.
+import { ArgumentError, CommandExecutionError, EmptyResultError } from '@sovovs/bycli/errors';
+
+export const BREW_BASE = 'https://formulae.brew.sh/api';
+const UA = 'bycli-homebrew-adapter (+https://github.com/sovovs/byCLI)';
+
+// Homebrew formula / cask tokens — letters / digits / `_-.+@` (`gcc@13`,
+// `imagemagick@6`, `c++`, `0-ad`, `php-cs-fixer`).
+const TOKEN = /^[A-Za-z0-9][A-Za-z0-9._+@-]*$/;
+
+export function requireString(value, label) {
+    const s = String(value ?? '').trim();
+    if (!s) throw new ArgumentError(`homebrew ${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(`homebrew ${label} must be a positive integer`);
+    }
+    if (n > maxValue) {
+        throw new ArgumentError(`homebrew ${label} must be <= ${maxValue}`);
+    }
+    return n;
+}
+
+export function requireToken(value, label) {
+    const s = String(value ?? '').trim();
+    if (!s) {
+        throw new ArgumentError(`homebrew ${label} is required (e.g. "wget", "gcc@13", "firefox")`);
+    }
+    if (s.length > 100 || !TOKEN.test(s)) {
+        throw new ArgumentError(
+            `homebrew ${label} "${value}" is not a valid token`,
+            'Use letters / digits / "_-.+@", starting with a letter or digit (max 100 chars).',
+        );
+    }
+    return s;
+}
+
+export function requireOneOf(value, allowed, label) {
+    const s = String(value ?? '').trim().toLowerCase();
+    if (!s) throw new ArgumentError(`homebrew ${label} is required`);
+    if (!allowed.includes(s)) {
+        throw new ArgumentError(
+            `homebrew ${label} "${value}" is not supported`,
+            `Allowed: ${allowed.join(', ')}.`,
+        );
+    }
+    return s;
+}
+
+export async function brewFetch(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 formulae.brew.sh is reachable from this network.',
+        );
+    }
+    if (resp.status === 404) {
+        throw new EmptyResultError(label, `Homebrew API returned 404 for ${url}.`);
+    }
+    if (resp.status === 429) {
+        throw new CommandExecutionError(
+            `${label} returned HTTP 429 (rate limited)`,
+            'Homebrew throttles bursts; 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;
+}
+
+/** Coerce a count value (which Homebrew analytics serves as `"139,972"`) to a plain number. */
+export function parseInstallCount(value) {
+    if (value == null) return null;
+    const s = String(value).replace(/,/g, '').trim();
+    if (!s) return null;
+    const n = Number(s);
+    return Number.isFinite(n) ? n : null;
+}

package/clis/hupu/__fixtures__/hot-home.html

@@ -0,0 +1,64 @@
+<!DOCTYPE html>
+<html lang="zh-CN"><head><title>虎扑社区</title></head><body>
+<div id="container"><div class="bbs-index-web">
+<nav>
+<a href="/639999999.html"><span class="t-title">导航里的 thread-shaped phantom 链接</span></a>
+</nav>
+<div class="text-list-model">
+<div class="list-item-wrap"><div class="list-title">步行街</div></div>
+
+<div class="list-item-wrap"><div class="list-wrap"><div class="list-item">
+<div class="t-info">
+<a href="/639088523.html" target="_blank" class=" hot"><span class="t-title">网友曝三亚4只皮皮虾收费1035，官方凌晨通报</span></a>
+<span class="t-lights">50亮</span>
+<span class="t-replies">359回复</span>
+</div>
+<div class="t-label"><a href="/forum">步行街主干道</a></div>
+</div></div></div>
+
+<div class="list-item-wrap"><div class="list-wrap"><div class="list-item">
+<div class="t-info">
+<a href="/639095236.html" target="_blank" class=" false"><span class="t-title">[流言板]市监局称4只皮皮虾1035元价格合规</span></a>
+<span class="t-lights">48亮</span>
+<span class="t-replies">128回复</span>
+</div>
+<div class="t-label"><a href="/forum">步行街主干道</a></div>
+</div></div></div>
+
+<div class="list-item-wrap"><div class="list-wrap"><div class="list-item">
+<div class="t-info">
+<a href="/639094866.html" target="_blank" class=" false"><span class="t-title">印度顶层婆罗门家庭的微奢晚餐，大家觉得怎么样？</span></a>
+<span class="t-lights">1.2万亮</span>
+<span class="t-replies">5.8万回复</span>
+</div>
+<div class="t-label"><a href="/forum">步行街主干道</a></div>
+</div></div></div>
+
+<div class="list-item-wrap"><div class="list-wrap"><div class="list-item">
+<div class="t-info">
+<a href="/639100001.html" target="_blank" class=" hot"><span class="t-title">湖人战胜勇士拿下连胜</span></a>
+<span class="t-lights">0亮</span>
+<span class="t-replies">0回复</span>
+</div>
+<div class="t-label"><a href="/forum">NBA湿乎乎的话题</a></div>
+</div></div></div>
+
+<div class="list-item-wrap"><div class="list-wrap"><div class="list-item">
+<div class="t-info">
+<a href="/639100002.html" target="_blank" class=" false"><span class="t-title">无 lights 的标题（少见但要兼容）</span></a>
+
+<span class="t-replies">20回复</span>
+</div>
+<div class="t-label"><a href="/forum">电竞</a></div>
+</div></div></div>
+
+<div class="list-item-wrap"><div class="list-wrap"><div class="list-item">
+<div class="t-info">
+<a href="/639100003.html" target="_blank" class=" hot"><span class="t-title">另一个 hot 帖子</span></a>
+<span class="t-lights">100亮</span>
+<span class="t-replies">200回复</span>
+</div>
+<div class="t-label"><a href="/forum">国际足球</a></div>
+</div></div></div>
+</div>
+</div></div></body></html>

package/clis/hupu/detail.js

@@ -0,0 +1,72 @@
+import { cli, Strategy } from '@sovovs/bycli/registry';
+import { getHupuThreadUrl, readHupuNextData, stripHtml } from './utils.js';
+cli({
+    site: 'hupu',
+    name: 'detail',
+    access: 'read',
+    description: '获取虎扑帖子详情 (使用Next.js JSON数据)',
+    domain: 'bbs.hupu.com',
+    strategy: Strategy.PUBLIC,
+    browser: true,
+    args: [
+        {
+            name: 'tid',
+            required: true,
+            positional: true,
+            help: '帖子ID（9位数字）'
+        },
+        {
+            name: 'replies',
+            type: 'boolean',
+            default: false,
+            help: '是否包含热门回复'
+        }
+    ],
+    columns: ['title', 'author', 'content', 'replies', 'lights', 'url'],
+    func: async (page, kwargs) => {
+        const { tid, replies: includeReplies = false } = kwargs;
+        const url = getHupuThreadUrl(tid).replace(/-1\.html$/, '.html');
+        const data = await readHupuNextData(page, url, 'Read Hupu thread detail', {
+            expectedTid: String(tid),
+        });
+        // 检查错误信息（只有当code不是200时才报错）
+        const errorInfo = data.props.pageProps.detail_error_info;
+        if (errorInfo && errorInfo.code !== 200) {
+            throw new Error(`帖子访问失败: ${errorInfo.message} (code: ${errorInfo.code})`);
+        }
+        // 获取帖子信息
+        const thread = data.props.pageProps.detail?.thread;
+        if (!thread) {
+            throw new Error('帖子不存在或已被删除');
+        }
+        const authorName = thread.author?.puname || '未知作者';
+        const content = stripHtml(thread.content);
+        const contentPreview = content.length > 300 ? content.substring(0, 300) + '...' : content;
+        // 构建结果
+        const result = {
+            title: thread.title,
+            author: authorName,
+            content: contentPreview,
+            replies: thread.replies || 0,
+            lights: thread.lights || 0,
+            url: `https://bbs.hupu.com/${tid}.html`
+        };
+        // 如果需要包含回复，添加回复信息到内容中
+        if (includeReplies) {
+            const replyList = data.props.pageProps.detail?.lights || [];
+            const topReplies = replyList.slice(0, 3);
+            if (topReplies.length > 0) {
+                let replyText = '\n\n【热门回复】\n';
+                topReplies.forEach((reply, index) => {
+                    const userName = reply.author?.puname || '未知用户';
+                    const replyContent = stripHtml(reply.content).substring(0, 100);
+                    const replyLights = reply.allLightCount || 0; // 修复：使用正确的字段名
+                    const replyTime = reply.created_at_format || '未知时间';
+                    replyText += `${index + 1}. ${userName} (亮${replyLights} ${replyTime}):\n   ${replyContent}\n\n`;
+                });
+                result.content = contentPreview + replyText;
+            }
+        }
+        return [result];
+    },
+});