Files
jackwener__opencli/clis/tieba/utils.ts
jakevin 80eef46b4e refactor: monorepo adapter separation (clis/ at root) (#782)
* refactor: move adapters from src/clis/ to root clis/ for monorepo separation

Separates CLI adapters from the core runtime to prepare for independent
adapter distribution via postinstall fetch.

Key changes:
- Move src/clis/ → clis/ (adapters at repo root)
- Change tsconfig rootDir from "src" to "." so tsc compiles both
- Create root-level shim files (registry.ts, errors.ts, etc.) so adapter
  relative imports (../../registry.js) resolve correctly
- Update build-manifest.ts, main.ts paths for new dist/src/ structure
- Expand ensureUserCliCompatShims() to cover all adapter import targets
  (types, utils, logger, launcher, browser/*, download/*, pipeline/*)
- Add scripts/fetch-adapters.js postinstall for ~/.opencli/clis/ sync
- Update vitest.config.ts adapter test paths
- Add package.json files field to exclude adapters from npm package

Official adapter files are unconditionally overwritten on update;
user-created files not in the manifest are preserved.

* fix: add dist/clis/ and cli-manifest.json to npm files, harden fetch-adapters

- Add dist/clis/ and dist/cli-manifest.json to package.json files field
  so built-in adapters and manifest ship with the npm package
- Replace execSync with execFileSync to prevent command injection
- Add version check to skip redundant adapter fetches
- Track tmpRoot explicitly for reliable cleanup

* fix: address review blockers — manifest-based updates, global-only fetch, first-run fallback

1. Manifest-based update strategy:
   - Read old manifest to identify previously-official files
   - Clean up files removed upstream (in old manifest but not new)
   - User-created files (never in any manifest) remain untouched

2. Only run fetch-adapters on global install (npm_config_global=true)
   or explicit OPENCLI_FETCH=1, preventing heavy side effects for
   local/dev installs

3. First-run fallback in discovery.ts:
   - ensureUserAdapters() checks for adapter-manifest.json
   - If missing and ~/.opencli/clis/ is empty, spawns fetch-adapters.js
   - Guarantees adapters are available even with --ignore-scripts

* fix: remove OPENCLI_FETCH env var, use internal _OPENCLI_FIRST_RUN instead

* feat: also support OPENCLI_FETCH=1 for explicit adapter fetch trigger

* simplify: replace git clone with local copy from dist/clis/

Adapters already ship in the npm package (dist/clis/), so there's no
need to clone from GitHub. Copy directly from the installed package:

- Eliminates git, curl, tar dependencies
- No network calls in postinstall
- No timeout/offline issues
- Version always matches the installed CLI
- ~65 lines of clone/download code replaced by one cpSync loop
2026-04-05 01:46:36 +08:00

349 lines
12 KiB
TypeScript

import { createHash } from 'node:crypto';
/**
* Shared Tieba parsing helpers used by the browser adapters.
*/
export const MAX_TIEBA_LIMIT = 20;
const TIEBA_PC_SIGN_SALT = '36770b1f34c9bbf2e7d1a99d2b82fa9e';
const TIEBA_TIME_ZONE = 'Asia/Shanghai';
export interface RawTiebaPostCard {
title?: string;
author?: string;
descInfo?: string;
actionTexts?: string[];
commentCount?: unknown;
threadId?: unknown;
url?: unknown;
}
export interface RawTiebaPagePcFeedEntry {
layout?: string;
feed?: {
schema?: unknown;
log_param?: Array<{ key?: unknown; value?: unknown }>;
business_info_map?: Record<string, unknown>;
components?: Array<Record<string, unknown>>;
};
}
export interface TiebaPostItem {
rank: number;
title: string;
author: string;
replies: number;
last_reply: string;
id: string;
url: string;
}
export interface RawTiebaSearchItem {
title?: string;
forum?: string;
author?: string;
time?: string;
snippet?: string;
id?: string;
url?: string;
}
export interface TiebaSearchItem {
rank: number;
title: string;
forum: string;
author: string;
time: string;
snippet: string;
id: string;
url: string;
}
export interface RawTiebaMainPost {
title?: string;
author?: string;
fallbackAuthor?: string;
contentText?: string;
structuredText?: string;
visibleTime?: string;
structuredTime?: unknown;
hasMedia?: boolean;
}
export interface RawTiebaReply {
floor?: unknown;
author?: string;
content?: string;
time?: string;
}
export interface RawTiebaReadPayload {
mainPost?: RawTiebaMainPost | null;
replies?: RawTiebaReply[];
}
export interface TiebaReadItem {
floor: number;
author: string;
content: string;
time: string;
}
export interface TiebaReadBuildOptions {
limit?: unknown;
includeMainPost?: boolean;
}
/**
* Keep the public CLI limit contract aligned with the real implementation.
*/
export function normalizeTiebaLimit(value: unknown, fallback: number = MAX_TIEBA_LIMIT): number {
const parsed = Number(value ?? fallback);
if (!Number.isFinite(parsed) || parsed < 1) return fallback;
return Math.min(Math.trunc(parsed), MAX_TIEBA_LIMIT);
}
export function normalizeText(value: unknown): string {
return typeof value === 'string' ? value.replace(/\s+/g, ' ').trim() : '';
}
/**
* Match Tieba PC's signed request contract so forum list fetching stays stable.
*/
export function signTiebaPcParams(params: Record<string, string>): string {
const payload = Object.keys(params)
.sort((left, right) => left.localeCompare(right))
.map((key) => `${key}=${params[key]}`)
.join('') + TIEBA_PC_SIGN_SALT;
return createHash('md5').update(payload).digest('hex');
}
export function parseTiebaCount(text: string): number {
const value = normalizeText(text).toUpperCase();
if (!value) return 0;
const compact = value.replace(/[^\d.W万]/g, '');
if (compact.endsWith('万')) {
return Math.round(parseFloat(compact.slice(0, -1)) * 10000);
}
if (compact.endsWith('W')) {
return Math.round(parseFloat(compact.slice(0, -1)) * 10000);
}
return parseInt(compact.replace(/[^\d]/g, ''), 10) || 0;
}
export function parseTiebaLastReply(text: string): string {
const normalized = normalizeText(text).replace(/^回复于/, '').trim();
const match = normalized.match(/(刚刚|\d+\s*(?:分钟|小时|天)前|\d{2}-\d{2}(?:\s+\d{2}:\d{2})?|\d{4}-\d{2}-\d{2}(?:\s+\d{2}:\d{2})?)/);
return match ? match[1].trim() : normalized;
}
function buildTiebaThreadUrl(id: string, rawUrl?: unknown): string {
const explicitUrl = normalizeText(rawUrl);
if (explicitUrl) return explicitUrl;
return id ? `https://tieba.baidu.com/p/${id}` : '';
}
function resolveTiebaThreadId(raw: RawTiebaPostCard): string {
const direct = normalizeText(raw.threadId);
if (direct) return direct;
const fromUrl = normalizeText(raw.url).match(/\/p\/(\d+)/);
return fromUrl ? fromUrl[1] : '';
}
function getTiebaFeedComponent(feed: RawTiebaPagePcFeedEntry['feed'], name: string): Record<string, unknown> {
const components = Array.isArray(feed?.components) ? feed.components : [];
const match = components.find((entry) => normalizeText((entry as Record<string, unknown>).component) === name);
if (!match) return {};
const payload = (match as Record<string, unknown>)[name];
return payload && typeof payload === 'object' ? payload as Record<string, unknown> : {};
}
function extractTiebaFeedAuthor(feed: RawTiebaPagePcFeedEntry['feed']): string {
const head = getTiebaFeedComponent(feed, 'feed_head');
const mainData = Array.isArray(head.main_data) ? head.main_data : [];
for (const item of mainData) {
const textRecord = (item as Record<string, unknown>).text as Record<string, unknown> | undefined;
const author = normalizeText(textRecord?.text);
if (author) return author;
}
return '';
}
function extractTiebaFeedTitle(feed: RawTiebaPagePcFeedEntry['feed']): string {
const title = getTiebaFeedComponent(feed, 'feed_title');
const titleData = Array.isArray(title.data) ? title.data : [];
const firstTitle = titleData[0] as Record<string, unknown> | undefined;
const textInfo = firstTitle?.text_info as Record<string, unknown> | undefined;
return normalizeText(textInfo?.text) || normalizeText(feed?.business_info_map?.title);
}
function extractTiebaFeedCommentCount(feed: RawTiebaPagePcFeedEntry['feed']): number {
const social = getTiebaFeedComponent(feed, 'feed_social');
const commentCount = Number(social.comment_num ?? feed?.business_info_map?.comment_num ?? 0);
return Number.isFinite(commentCount) ? commentCount : 0;
}
function extractTiebaFeedThreadId(feed: RawTiebaPagePcFeedEntry['feed']): string {
const direct = normalizeText(feed?.business_info_map?.thread_id);
if (direct) return direct;
const logParams = Array.isArray(feed?.log_param) ? feed.log_param : [];
const fromLog = normalizeText(logParams.find((item) => normalizeText(item?.key) === 'tid')?.value);
if (fromLog) return fromLog;
const fromSchema = normalizeText(feed?.schema).match(/[?&]tid=(\d+)/);
return fromSchema ? fromSchema[1] : '';
}
function extractTiebaFeedLastReply(feed: RawTiebaPagePcFeedEntry['feed']): string {
const head = getTiebaFeedComponent(feed, 'feed_head');
const extraData = Array.isArray(head.extra_data) ? head.extra_data : [];
const first = extraData[0] as Record<string, unknown> | undefined;
const prefix = normalizeText((first?.business_info_map as Record<string, unknown> | undefined)?.time_prefix);
const textRecord = first?.text as Record<string, unknown> | undefined;
const rawTime = normalizeText(textRecord?.text);
const formattedTime = /^\d+$/.test(rawTime) ? formatTiebaUnixTime(rawTime) : rawTime;
return [prefix, formattedTime].filter(Boolean).join('');
}
/**
* Convert Tieba's signed `page_pc` feed entries into the stable card shape used by the CLI.
*/
export function buildTiebaPostCardsFromPagePc(rawFeeds: RawTiebaPagePcFeedEntry[]): RawTiebaPostCard[] {
return rawFeeds
.filter((entry) => normalizeText(entry.layout) === 'feed' && entry.feed)
.map((entry) => {
const feed = entry.feed;
const threadId = extractTiebaFeedThreadId(feed);
return {
title: extractTiebaFeedTitle(feed),
author: extractTiebaFeedAuthor(feed),
descInfo: extractTiebaFeedLastReply(feed),
commentCount: extractTiebaFeedCommentCount(feed),
actionTexts: [],
threadId,
url: buildTiebaThreadUrl(threadId),
};
})
.filter((entry) => normalizeText(entry.title));
}
export function buildTiebaPostItems(rawCards: RawTiebaPostCard[], requestedLimit: unknown): TiebaPostItem[] {
const limit = normalizeTiebaLimit(requestedLimit);
return rawCards
.map((raw) => {
const title = normalizeText(raw.title);
const id = resolveTiebaThreadId(raw);
const actionTexts = Array.isArray(raw.actionTexts) ? raw.actionTexts.map(normalizeText).filter(Boolean) : [];
const commentText = actionTexts.find((text) => /评论/.test(text)) || actionTexts[actionTexts.length - 1] || '';
return {
title,
author: normalizeText(raw.author),
replies: Number.isFinite(Number(raw.commentCount))
? Number(raw.commentCount)
: parseTiebaCount(commentText),
last_reply: parseTiebaLastReply(String(raw.descInfo ?? '')),
id,
url: buildTiebaThreadUrl(id, raw.url),
};
})
.filter((item) => item.title)
.slice(0, limit)
.map((item, index) => ({ rank: index + 1, ...item }));
}
export function buildTiebaSearchItems(rawItems: RawTiebaSearchItem[], requestedLimit: unknown): TiebaSearchItem[] {
const limit = normalizeTiebaLimit(requestedLimit);
return rawItems
.map((raw) => {
const url = normalizeText(raw.url);
const directId = normalizeText(raw.id);
const idFromUrl = url.match(/\/p\/(\d+)/)?.[1] || '';
return {
title: normalizeText(raw.title),
forum: normalizeText(raw.forum),
author: normalizeText(raw.author),
time: normalizeText(raw.time),
snippet: normalizeText(raw.snippet).slice(0, 200),
id: directId || idFromUrl,
url,
};
})
.filter((item) => item.title)
.slice(0, limit)
.map((item, index) => ({ rank: index + 1, ...item }));
}
function formatTiebaUnixTime(value: unknown): string {
const ts = Number(value || 0);
if (!Number.isFinite(ts) || ts <= 0) return '';
const parts = new Intl.DateTimeFormat('sv-SE', {
timeZone: TIEBA_TIME_ZONE,
year: 'numeric',
month: '2-digit',
day: '2-digit',
hour: '2-digit',
minute: '2-digit',
hour12: false,
}).formatToParts(new Date(ts * 1000));
const values = Object.fromEntries(parts.map((part) => [part.type, part.value]));
return `${values.year}-${values.month}-${values.day} ${values.hour}:${values.minute}`;
}
function parseTiebaReplyTime(text: string): string {
const normalized = normalizeText(text);
const withoutFloor = normalized.replace(/^第\d+楼\s+/, '').trim();
const match = withoutFloor.match(/^(刚刚|昨天|前天|\d+\s*(?:分钟|小时|天)前|\d{2}-\d{2}(?:\s+\d{2}:\d{2})?|\d{4}-\d{2}-\d{2}(?:\s+\d{2}:\d{2})?)/);
return match ? match[1].trim() : withoutFloor;
}
function buildMainPostItem(mainPost?: RawTiebaMainPost | null): TiebaReadItem | null {
if (!mainPost) return null;
const title = normalizeText(mainPost.title);
const author = normalizeText(mainPost.author) || normalizeText(mainPost.fallbackAuthor);
const body = normalizeText(mainPost.contentText) || normalizeText(mainPost.structuredText);
const hasMedia = Boolean(mainPost.hasMedia);
const content = [title, body || (hasMedia ? '[media]' : '')].filter(Boolean).join(' ').trim();
if (!content) return null;
return {
floor: 1,
author,
content,
time: normalizeText(mainPost.visibleTime) || formatTiebaUnixTime(mainPost.structuredTime),
};
}
export function buildTiebaReadItems(payload: RawTiebaReadPayload, options: TiebaReadBuildOptions = {}): TiebaReadItem[] {
const fallback = Number.isFinite(Number(options.limit)) ? Number(options.limit) : 30;
const limit = Math.max(1, Math.trunc(fallback));
const includeMainPost = options.includeMainPost !== false;
const items: TiebaReadItem[] = [];
const mainPost = buildMainPostItem(payload.mainPost);
if (includeMainPost && mainPost) items.push(mainPost);
const replies = Array.isArray(payload.replies) ? payload.replies : [];
const replyItems: TiebaReadItem[] = [];
for (const reply of replies) {
const floor = Number(reply.floor || 0);
const content = normalizeText(reply.content);
if (!Number.isFinite(floor) || floor < 1 || !content) continue;
replyItems.push({
floor,
author: normalizeText(reply.author),
content,
time: parseTiebaReplyTime(String(reply.time ?? '')),
});
}
return items.concat(replyItems.slice(0, limit));
}