@zenalexa/unicli 0.220.1 → 0.221.0

package/dist/adapters/yt-dlp/subtitles.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @owner   yt-dlp subtitle adapter.
+ * @does    Extracts subtitle files from any yt-dlp-supported video URL.
+ * @needs   Local yt-dlp binary and optional browser cookies for private or rate-limited videos.
+ * @feeds   Unified social video-text workflows across YouTube, Bilibili, TikTok, Douyin, X, Instagram, and other sites.
+ * @breaks  Returns an error when yt-dlp cannot produce subtitle files for the requested URL and languages.
+ */
+export {};
+//# sourceMappingURL=subtitles.d.ts.map

package/dist/adapters/yt-dlp/subtitles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtitles.d.ts","sourceRoot":"","sources":["../../../src/adapters/yt-dlp/subtitles.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/adapters/yt-dlp/subtitles.js

@@ -0,0 +1,41 @@
+/**
+ * @owner   yt-dlp subtitle adapter.
+ * @does    Extracts subtitle files from any yt-dlp-supported video URL.
+ * @needs   Local yt-dlp binary and optional browser cookies for private or rate-limited videos.
+ * @feeds   Unified social video-text workflows across YouTube, Bilibili, TikTok, Douyin, X, Instagram, and other sites.
+ * @breaks  Returns an error when yt-dlp cannot produce subtitle files for the requested URL and languages.
+ */
+import { cli, Strategy } from "../../registry.js";
+import { runVideoSubtitleExtraction } from "../../social/video-text.js";
+cli({
+    site: "yt-dlp",
+    name: "subtitles",
+    description: "Extract subtitles from any yt-dlp-supported video URL with optional browser-cookie reuse",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "url",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Video URL",
+            format: "uri",
+        },
+        {
+            name: "languages",
+            type: "str",
+            default: "zh-Hans,zh,en",
+            description: "Comma-separated subtitle languages",
+        },
+        {
+            name: "cookies-from-browser",
+            type: "str",
+            description: "Browser name for yt-dlp --cookies-from-browser",
+        },
+    ],
+    columns: ["language", "text", "path"],
+    socialCapabilities: ["read", "media", "subtitles"],
+    defaultFormat: "json",
+    func: async (_page, kwargs) => runVideoSubtitleExtraction(kwargs),
+});
+//# sourceMappingURL=subtitles.js.map

package/dist/adapters/yt-dlp/subtitles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtitles.js","sourceRoot":"","sources":["../../../src/adapters/yt-dlp/subtitles.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAExE,GAAG,CAAC;IACF,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,WAAW;IACjB,WAAW,EACT,0FAA0F;IAC5F,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,WAAW;YACxB,MAAM,EAAE,KAAK;SACd;QACD;YACE,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,eAAe;YACxB,WAAW,EAAE,oCAAoC;SAClD;QACD;YACE,IAAI,EAAE,sBAAsB;YAC5B,IAAI,EAAE,KAAK;YACX,WAAW,EAAE,gDAAgD;SAC9D;KACF;IACD,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC;IACrC,kBAAkB,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC;IAClD,aAAa,EAAE,MAAM;IACrB,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,0BAA0B,CAAC,MAAM,CAAC;CAClE,CAAC,CAAC"}

package/dist/adapters/zhihu/answer-detail.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @owner   src/adapters/zhihu/answer-detail.ts
+ * @does    Register full-content Zhihu answer detail reader.
+ * @needs   Logged-in Zhihu browser session, answer API payload, exact answer target parsing.
+ * @feeds   surface coverage ledger, long-form answer extraction workflows, reference parity checks.
+ * @breaks  Zhihu answer URL shape or API content field drift can block answer detail extraction.
+ */
+interface ZhihuAnswerTarget {
+    answerId: string;
+    questionId: string;
+}
+interface ZhihuAnswerPayload {
+    id?: unknown;
+    content?: unknown;
+    voteup_count?: unknown;
+    comment_count?: unknown;
+    created_time?: unknown;
+    updated_time?: unknown;
+    author?: {
+        name?: unknown;
+    };
+    question?: {
+        id?: unknown;
+        title?: unknown;
+        url?: unknown;
+    };
+    error?: {
+        message?: unknown;
+    };
+    error_msg?: unknown;
+    message?: unknown;
+}
+export declare function stripZhihuAnswerHtml(value: unknown): string;
+export declare function parseZhihuAnswerTarget(input: unknown): ZhihuAnswerTarget;
+export declare function extractQuestionIdFromZhihuUrl(input: unknown): string;
+export declare function parseMaxContent(value: unknown): number;
+export declare function mapZhihuAnswerDetail(payload: ZhihuAnswerPayload, target: ZhihuAnswerTarget, currentQuestionId: string, maxContent: number): Record<string, unknown>;
+export {};
+//# sourceMappingURL=answer-detail.d.ts.map

package/dist/adapters/zhihu/answer-detail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer-detail.d.ts","sourceRoot":"","sources":["../../../src/adapters/zhihu/answer-detail.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,UAAU,iBAAiB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,kBAAkB;IAC1B,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5D,KAAK,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC9B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA2BD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAa3D;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAiCxE;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAiBpE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMtD;AAoCD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE,iBAAiB,EACzB,iBAAiB,EAAE,MAAM,EACzB,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoCzB"}

package/dist/adapters/zhihu/answer-detail.js

@@ -0,0 +1,204 @@
+/**
+ * @owner   src/adapters/zhihu/answer-detail.ts
+ * @does    Register full-content Zhihu answer detail reader.
+ * @needs   Logged-in Zhihu browser session, answer API payload, exact answer target parsing.
+ * @feeds   surface coverage ledger, long-form answer extraction workflows, reference parity checks.
+ * @breaks  Zhihu answer URL shape or API content field drift can block answer detail extraction.
+ */
+import { cli, Strategy } from "../../registry.js";
+const ANSWER_ID_RE = /^\d+$/;
+const ANSWER_TYPED_RE = /^answer:(\d+):(\d+)$/;
+const ANSWER_PATH_RE = /^\/question\/(\d+)\/answer\/(\d+)\/?$/;
+const BARE_ANSWER_PATH_RE = /^\/answer\/(\d+)\/?$/;
+const QUESTION_PATH_RE = /^\/question\/(\d+)\/?$/;
+const QUESTION_API_PATH_RE = /^\/api\/v4\/questions\/(\d+)\/?$/;
+function stringField(value) {
+    return value === undefined || value === null ? "" : String(value);
+}
+function countField(value) {
+    const n = Number(value);
+    return Number.isInteger(n) && n >= 0 ? n : 0;
+}
+function isoFromUnixSeconds(value) {
+    const n = Number(value);
+    return Number.isFinite(n) && n > 0 ? new Date(n * 1000).toISOString() : "";
+}
+function pageOf(page) {
+    if (!page)
+        throw new Error("Zhihu answer-detail requires a browser page.");
+    return page;
+}
+export function stripZhihuAnswerHtml(value) {
+    return stringField(value)
+        .replace(/<br\s*\/?\s*>/gi, "\n")
+        .replace(/<\/(?:p|div|h[1-6]|li|blockquote)>/gi, "\n\n")
+        .replace(/<[^>]+>/g, "")
+        .replace(/&nbsp;/g, " ")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&amp;/g, "&")
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+}
+export function parseZhihuAnswerTarget(input) {
+    const value = stringField(input).trim();
+    if (!value) {
+        throw new Error("Zhihu answer target must be a numeric id, answer URL, or answer:<questionId>:<answerId>.");
+    }
+    if (ANSWER_ID_RE.test(value))
+        return { answerId: value, questionId: "" };
+    const typed = value.match(ANSWER_TYPED_RE);
+    if (typed)
+        return { questionId: typed[1], answerId: typed[2] };
+    try {
+        const url = new URL(value);
+        if (url.protocol !== "https:" ||
+            url.username ||
+            url.password ||
+            url.port ||
+            (url.hostname !== "www.zhihu.com" && url.hostname !== "zhihu.com")) {
+            throw new Error("invalid host");
+        }
+        let match = url.pathname.match(ANSWER_PATH_RE);
+        if (match)
+            return { questionId: match[1], answerId: match[2] };
+        match = url.pathname.match(BARE_ANSWER_PATH_RE);
+        if (match)
+            return { questionId: "", answerId: match[1] };
+    }
+    catch {
+        throw new Error("Zhihu answer target must be a numeric id, answer URL, or answer:<questionId>:<answerId>.");
+    }
+    throw new Error("Zhihu answer target must be a numeric id, answer URL, or answer:<questionId>:<answerId>.");
+}
+export function extractQuestionIdFromZhihuUrl(input) {
+    const value = stringField(input).trim();
+    if (!value)
+        return "";
+    if (!URL.canParse(value))
+        return "";
+    const url = new URL(value);
+    if (url.protocol !== "https:" ||
+        (url.hostname !== "www.zhihu.com" && url.hostname !== "zhihu.com")) {
+        return "";
+    }
+    return (url.pathname.match(ANSWER_PATH_RE)?.[1] ??
+        url.pathname.match(QUESTION_PATH_RE)?.[1] ??
+        url.pathname.match(QUESTION_API_PATH_RE)?.[1] ??
+        "");
+}
+export function parseMaxContent(value) {
+    const n = value === undefined || value === null ? 0 : Number(value);
+    if (!Number.isInteger(n) || n < 0) {
+        throw new Error("--max-content must be a non-negative integer.");
+    }
+    return n;
+}
+async function browserFetchJson(page, url) {
+    const raw = await page.evaluate(`(async () => {
+    const response = await fetch(${JSON.stringify(url)}, {
+      credentials: "include",
+      headers: { Accept: "application/json" }
+    });
+    const text = await response.text();
+    return JSON.stringify({ ok: response.ok, status: response.status, text });
+  })()`);
+    const result = JSON.parse(stringField(raw));
+    if (!result.ok) {
+        if (result.status === 401 || result.status === 403) {
+            throw new Error(`Zhihu answer-detail requires Zhihu cookies (HTTP ${result.status}).`);
+        }
+        if (result.status === 404) {
+            throw new Error("No Zhihu answer was found for the requested id.");
+        }
+        throw new Error(`Zhihu answer-detail request failed (HTTP ${result.status}).`);
+    }
+    try {
+        return JSON.parse(result.text);
+    }
+    catch (err) {
+        throw new Error(`Zhihu answer-detail returned malformed JSON: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+export function mapZhihuAnswerDetail(payload, target, currentQuestionId, maxContent) {
+    if (payload.error || payload.error_msg || payload.message) {
+        throw new Error(`Zhihu answer-detail returned an error payload: ${stringField(payload.error?.message ?? payload.error_msg ?? payload.message)}`);
+    }
+    if (!Object.prototype.hasOwnProperty.call(payload, "content")) {
+        throw new Error("Zhihu answer-detail payload did not include content.");
+    }
+    const question = payload.question ?? {};
+    const questionId = target.questionId ||
+        currentQuestionId ||
+        extractQuestionIdFromZhihuUrl(question.url) ||
+        stringField(question.id);
+    const stripped = stripZhihuAnswerHtml(payload.content);
+    const content = maxContent > 0 && stripped.length > maxContent
+        ? stripped.slice(0, maxContent)
+        : stripped;
+    return {
+        id: target.answerId || stringField(payload.id),
+        author: stringField(payload.author?.name) || "anonymous",
+        votes: countField(payload.voteup_count),
+        comments: countField(payload.comment_count),
+        question_id: questionId,
+        question_title: stringField(question.title),
+        url: questionId
+            ? `https://www.zhihu.com/question/${questionId}/answer/${target.answerId}`
+            : `https://www.zhihu.com/answer/${target.answerId}`,
+        created_at: isoFromUnixSeconds(payload.created_time),
+        updated_at: isoFromUnixSeconds(payload.updated_time),
+        content,
+    };
+}
+cli({
+    site: "zhihu",
+    name: "answer-detail",
+    description: "知乎单个回答完整内容（按 answer ID 获取）",
+    domain: "www.zhihu.com",
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [
+        {
+            name: "id",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Answer ID, full Zhihu answer URL, or typed target",
+        },
+        {
+            name: "max-content",
+            type: "int",
+            default: 0,
+            description: "Optional cap on stripped content length; 0 returns full content",
+        },
+    ],
+    columns: [
+        "id",
+        "author",
+        "votes",
+        "comments",
+        "question_id",
+        "question_title",
+        "url",
+        "created_at",
+        "updated_at",
+        "content",
+    ],
+    func: async (page, kwargs) => {
+        const browser = pageOf(page);
+        const target = parseZhihuAnswerTarget(kwargs.id);
+        const maxContent = parseMaxContent(kwargs["max-content"]);
+        await browser.goto(`https://www.zhihu.com/answer/${target.answerId}`);
+        const currentQuestionId = extractQuestionIdFromZhihuUrl(await browser.url());
+        const apiUrl = new URL(`https://www.zhihu.com/api/v4/answers/${target.answerId}`);
+        apiUrl.searchParams.set("include", "content,voteup_count,comment_count,author,created_time,updated_time,question");
+        const payload = (await browserFetchJson(browser, apiUrl.toString()));
+        return [
+            mapZhihuAnswerDetail(payload, target, currentQuestionId, maxContent),
+        ];
+    },
+});
+//# sourceMappingURL=answer-detail.js.map

package/dist/adapters/zhihu/answer-detail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer-detail.js","sourceRoot":"","sources":["../../../src/adapters/zhihu/answer-detail.ts"],"names":[],"mappings":"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"}

package/dist/adapters/zhihu/comment.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @owner   Zhihu comment adapter.
+ * @does    Reads Zhihu answer/article comments and normalizes nested child comments.
+ * @needs   Zhihu comment_v5 API and z_c0 cookie for authenticated access.
+ * @feeds   Social comment tree analysis for Zhihu answers and articles.
+ * @breaks  Zhihu API shape, auth cookie requirements, or anti-bot policy changes.
+ */
+export declare function extractZhihuCommentRows(response: unknown): Array<Record<string, unknown>>;
+//# sourceMappingURL=comment.d.ts.map

package/dist/adapters/zhihu/comment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment.d.ts","sourceRoot":"","sources":["../../../src/adapters/zhihu/comment.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0DH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,OAAO,GAChB,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAehC"}

package/dist/adapters/zhihu/comment.js

@@ -0,0 +1,149 @@
+/**
+ * @owner   Zhihu comment adapter.
+ * @does    Reads Zhihu answer/article comments and normalizes nested child comments.
+ * @needs   Zhihu comment_v5 API and z_c0 cookie for authenticated access.
+ * @feeds   Social comment tree analysis for Zhihu answers and articles.
+ * @breaks  Zhihu API shape, auth cookie requirements, or anti-bot policy changes.
+ */
+import { USER_AGENT } from "../../constants.js";
+import { loadCookiesWithCDP, formatCookieHeader, } from "../../engine/cookies.js";
+import { cli, Strategy } from "../../registry.js";
+import { normalizeCommentRows } from "../../social/comments.js";
+function stripHtml(value) {
+    return value
+        .replace(/<[^>]+>/g, "")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+function zhihuCreated(value) {
+    return value ? new Date(value * 1000).toISOString() : "";
+}
+function zhihuCommentToRow(item, parentId = "") {
+    const id = item.id === undefined ? "" : String(item.id);
+    return {
+        id,
+        parent_id: parentId,
+        author: item.author?.name ?? "",
+        content: stripHtml(item.content ?? ""),
+        text: stripHtml(item.content ?? ""),
+        likes: item.like_count ?? 0,
+        replies: item.child_comment_count ?? item.child_comments?.length ?? 0,
+        created: zhihuCreated(item.created_time),
+        reply_to: item.reply_to_author?.name ?? "",
+    };
+}
+export function extractZhihuCommentRows(response) {
+    const data = response.data;
+    if (!Array.isArray(data)) {
+        throw new Error("Unexpected Zhihu comments response");
+    }
+    const rows = [];
+    for (const root of data) {
+        const rootRow = zhihuCommentToRow(root);
+        rows.push(rootRow);
+        const rootId = String(rootRow.id ?? "");
+        for (const child of root.child_comments ?? []) {
+            rows.push(zhihuCommentToRow(child, rootId));
+        }
+    }
+    return rows;
+}
+async function zhihuHeaders() {
+    const headers = {
+        "User-Agent": USER_AGENT,
+        Accept: "application/json",
+        Referer: "https://www.zhihu.com/",
+    };
+    const cookies = await loadCookiesWithCDP("zhihu", "www.zhihu.com");
+    if (cookies)
+        headers.Cookie = formatCookieHeader(cookies);
+    return headers;
+}
+async function fetchZhihuJson(url, headers) {
+    const response = await fetch(url, { headers });
+    if (!response.ok) {
+        throw new Error(`Zhihu comments request failed: ${response.status}`);
+    }
+    return response.json();
+}
+cli({
+    site: "zhihu",
+    name: "comment",
+    description: "Get Zhihu comments with normalized nested reply hierarchy",
+    domain: "www.zhihu.com",
+    strategy: Strategy.COOKIE,
+    args: [
+        {
+            name: "type",
+            required: true,
+            positional: true,
+            description: "Content type: answer or article",
+            choices: ["answer", "article"],
+        },
+        {
+            name: "id",
+            required: true,
+            positional: true,
+            description: "Answer or article ID",
+            "x-unicli-kind": "id",
+        },
+        {
+            name: "limit",
+            type: "int",
+            default: 20,
+            description: "Number of root comments",
+        },
+        {
+            name: "with-replies",
+            type: "bool",
+            default: false,
+            description: "Fetch child replies for root comments that omit child_comments",
+        },
+    ],
+    columns: [
+        "platform",
+        "content_id",
+        "comment_id",
+        "parent_id",
+        "depth",
+        "path",
+        "author",
+        "text",
+        "likes",
+        "replies",
+        "created",
+        "content",
+        "reply_to",
+    ],
+    socialCapabilities: ["read", "comments", "comment_replies"],
+    func: async (_page, kwargs) => {
+        const type = String(kwargs.type);
+        const id = String(kwargs.id);
+        const limit = Number(kwargs.limit ?? 20);
+        const withReplies = Boolean(kwargs["with-replies"]);
+        const headers = await zhihuHeaders();
+        const rootUrl = `https://www.zhihu.com/api/v4/comment_v5/${encodeURIComponent(type)}s/${encodeURIComponent(id)}/root_comment?limit=${encodeURIComponent(String(limit))}&offset=0&order_by=score`;
+        const rootJson = await fetchZhihuJson(rootUrl, headers);
+        const rows = extractZhihuCommentRows(rootJson);
+        if (withReplies) {
+            const roots = rootJson.data ?? [];
+            for (const root of roots) {
+                const rootId = root.id === undefined ? "" : String(root.id);
+                if (!rootId || (root.child_comments?.length ?? 0) > 0)
+                    continue;
+                if ((root.child_comment_count ?? 0) <= 0)
+                    continue;
+                const childUrl = `https://www.zhihu.com/api/v4/comment_v5/comment/${encodeURIComponent(rootId)}/child_comment?limit=20&offset=0&order_by=score`;
+                const childJson = await fetchZhihuJson(childUrl, headers);
+                for (const child of childJson.data ?? []) {
+                    rows.push(zhihuCommentToRow(child, rootId));
+                }
+            }
+        }
+        return normalizeCommentRows(rows, {
+            platform: "zhihu",
+            contentId: `${type}:${id}`,
+        });
+    },
+});
+//# sourceMappingURL=comment.js.map

package/dist/adapters/zhihu/comment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment.js","sourceRoot":"","sources":["../../../src/adapters/zhihu/comment.ts"],"names":[],"mappings":"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"}

package/dist/adapters/zhihu/recommend.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @owner   src/adapters/zhihu/recommend.ts
+ * @does    Register paginated Zhihu home recommendation reader.
+ * @needs   Logged-in Zhihu browser session, topstory recommendation API, bounded page traversal.
+ * @feeds   surface coverage ledger, Zhihu discovery workflows, reference parity checks.
+ * @breaks  Zhihu recommendation API paging or target shape drift can block feed extraction.
+ */
+interface ZhihuRecommendItem {
+    id?: unknown;
+    type?: unknown;
+    target?: {
+        id?: unknown;
+        type?: unknown;
+        title?: unknown;
+        question?: {
+            id?: unknown;
+            title?: unknown;
+        };
+        author?: {
+            name?: unknown;
+        };
+        voteup_count?: unknown;
+        reaction?: {
+            statistics?: {
+                like_count?: unknown;
+            };
+        };
+    };
+}
+export declare function parseZhihuRecommendLimit(value: unknown): number;
+export declare function zhihuRecommendItemKey(item: ZhihuRecommendItem): string;
+export declare function normalizeZhihuRecommendTitle(item: ZhihuRecommendItem): string;
+export declare function normalizeZhihuRecommendUrl(item: ZhihuRecommendItem): string;
+export declare function mapZhihuRecommendItem(item: ZhihuRecommendItem, rank: number): Record<string, unknown>;
+export {};
+//# sourceMappingURL=recommend.d.ts.map

package/dist/adapters/zhihu/recommend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommend.d.ts","sourceRoot":"","sources":["../../../src/adapters/zhihu/recommend.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,UAAU,kBAAkB;IAC1B,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE;QACP,EAAE,CAAC,EAAE,OAAO,CAAC;QACb,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,QAAQ,CAAC,EAAE;YAAE,EAAE,CAAC,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;QAC7C,MAAM,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;QAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,QAAQ,CAAC,EAAE;YAAE,UAAU,CAAC,EAAE;gBAAE,UAAU,CAAC,EAAE,OAAO,CAAA;aAAE,CAAA;SAAE,CAAC;KACtD,CAAC;CACH;AA8BD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQ/D;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAStE;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAI7E;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAgB3E;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,kBAAkB,EACxB,IAAI,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzB"}