trending-knowledge 0.1.0

package/README.md

@@ -0,0 +1,206 @@
+# youKnow
+
+`youKnow` 是一个在终端中获取热门信息的命令行工具。目前支持 GitHub Trending，
+可以按开发语言和时间范围筛选热门仓库，并输出 JSON 或 Markdown。
+
+## 环境要求
+
+- Node.js 20.18.1 或更高版本
+- 能够访问 `github.com`
+
+## 安装
+
+### 全局安装
+
+```bash
+npm install --global trending-knowledge
+```
+
+安装后可以使用 `youKnow` 或小写形式 `youknow`：
+
+```bash
+youKnow github
+```
+
+### 使用 npx
+
+无需全局安装即可运行：
+
+```bash
+npx trending-knowledge github
+```
+
+例如获取 Python 今日热门前 5 名：
+
+```bash
+npx trending-knowledge github --since daily --language python --limit 5
+```
+
+## 获取 GitHub Trending
+
+不带参数时，默认获取 TypeScript 本周热门仓库，最多返回 20 条，并输出 JSON：
+
+```bash
+youKnow github
+```
+
+常用示例：
+
+```bash
+# Python 今日热门前 5 名
+youKnow github --since daily --language python --limit 5
+
+# 中文项目月榜
+youKnow github --since monthly --spoken-language zh
+
+# 输出 Markdown
+youKnow github --format md
+
+# 输出 Markdown，并保存到指定文件
+youKnow github --format md --output output/github.md
+
+# 将请求超时时间调整为 30 秒
+youKnow github --timeout 30000
+```
+
+### 参数
+
+| 参数                       | 简写 | 说明                                   | 默认值       |
+| -------------------------- | ---- | -------------------------------------- | ------------ |
+| `--language <language>`    | `-l` | 开发语言，例如 `typescript`、`python`  | `typescript` |
+| `--since <since>`          | `-s` | 时间范围：`daily`、`weekly`、`monthly` | `weekly`     |
+| `--spoken-language <code>` | —    | 项目自然语言代码，例如 `zh`、`en`      | 不限制       |
+| `--limit <number>`         | `-n` | 返回条数，必须大于 0                   | `20`         |
+| `--format <format>`        | `-f` | 输出格式：`json` 或 `md`               | `json`       |
+| `--output <path>`          | `-o` | 将结果同时保存到文件                   | 不保存       |
+| `--timeout <ms>`           | —    | 请求超时时间，单位为毫秒               | `20000`      |
+
+查看完整帮助：
+
+```bash
+youKnow github --help
+```
+
+## 输出格式
+
+### JSON
+
+默认输出包含筛选条件、采集时间和仓库列表：
+
+```json
+{
+  "source": "github treeding",
+  "period": "weekly",
+  "language": "typescript",
+  "spokenLanguage": null,
+  "collectedAt": "2026-08-30T02:08:44.881Z",
+  "total": 1,
+  "items": [
+    {
+      "source": "github",
+      "type": "repository",
+      "rank": 1,
+      "id": "owner/repository",
+      "title": "owner/repository",
+      "url": "https://github.com/owner/repository",
+      "summary": "Repository description",
+      "author": "owner",
+      "language": "TypeScript",
+      "metrics": {
+        "stars": 1234,
+        "forks": 56,
+        "periodStars": 78
+      },
+      "contributors": ["owner"],
+      "period": "weekly",
+      "collectedAt": "2026-08-30T02:08:44.881Z"
+    }
+  ]
+}
+```
+
+`periodStars` 表示所选时间范围内新增的 Star 数量。
+
+### Markdown
+
+使用 `--format md` 可以生成适合保存、分享或粘贴到文档中的 Markdown 表格。
+搭配 `--output` 时，结果会输出到终端并写入文件。
+
+## 网络代理
+
+`youKnow` 会自动使用以下代理环境变量：
+
+- `HTTPS_PROXY` / `https_proxy`
+- `HTTP_PROXY` / `http_proxy`
+- `ALL_PROXY` / `all_proxy`，仅作为 HTTP/HTTPS 代理后备
+- `NO_PROXY` / `no_proxy`
+
+无需在命令前添加 `NODE_USE_ENV_PROXY=1`。
+
+在 macOS 上，如果终端没有代理环境变量，`youKnow` 会继续读取系统网络代理。
+未检测到代理时使用直连。
+
+## 错误输出
+
+请求失败时，错误会写入标准错误流，并保持固定 JSON 结构：
+
+```json
+{
+  "name": "TimeoutError",
+  "message": "The operation was aborted due to timeout",
+  "code": 23
+}
+```
+
+如果底层错误没有错误码，`code` 为 `"UNKNOWN_ERROR"`。
+
+## 排查请求超时
+
+先确认 GitHub 是否可以通过当前网络或代理访问：
+
+```bash
+curl -L -sS \
+  -o /dev/null \
+  -w 'HTTP %{http_code}\n耗时 %{time_total}s\n' \
+  --max-time 20 \
+  'https://github.com/trending/typescript?since=weekly'
+```
+
+正常情况下应返回 `HTTP 200`。如果 `curl` 也超时，请检查网络或代理软件；如果
+`curl` 成功但 `youKnow` 失败，可以增加超时时间后重试：
+
+```bash
+youKnow github --timeout 30000
+```
+
+## 查看数据源
+
+查看已支持及规划中的数据源：
+
+```bash
+youKnow sources
+```
+
+GitHub Trending 数据来自 GitHub 的公开 Trending 页面，不需要 GitHub Token。
+如果 GitHub 调整页面结构，仓库字段可能暂时无法解析。
+
+## 从源码运行
+
+```bash
+git clone https://github.com/wanglsh97/trending-knowledge.git
+cd trending-knowledge
+npm install
+npm run dev -- github
+```
+
+开发时如需创建直接指向源码的全局命令：
+
+```bash
+npm run link
+```
+
+移除源码软链：
+
+```bash
+npm run unlink
+```

package/dist/banner.d.ts

@@ -0,0 +1 @@
+export declare function renderBanner(color?: boolean): string;

package/dist/banner.js

@@ -0,0 +1,14 @@
+import { Chalk } from 'chalk';
+const bannerLines = [
+    '██╗   ██╗ ██████╗ ██╗   ██╗██╗  ██╗███╗   ██╗ ██████╗ ██╗    ██╗',
+    '╚██╗ ██╔╝██╔═══██╗██║   ██║██║ ██╔╝████╗  ██║██╔═══██╗██║    ██║',
+    ' ╚████╔╝ ██║   ██║██║   ██║█████╔╝ ██╔██╗ ██║██║   ██║██║ █╗ ██║',
+    '  ╚██╔╝  ██║   ██║██║   ██║██╔═██╗ ██║╚██╗██║██║   ██║██║███╗██║',
+    '   ██║   ╚██████╔╝╚██████╔╝██║  ██╗██║ ╚████║╚██████╔╝╚███╔███╔╝',
+    '   ╚═╝    ╚═════╝  ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═══╝ ╚═════╝  ╚══╝╚══╝',
+];
+export function renderBanner(color = Boolean(process.stdout.isTTY)) {
+    const paint = new Chalk({ level: color ? 1 : 0 });
+    return bannerLines.map((line) => paint.magenta.bold(line)).join('\n');
+}
+//# sourceMappingURL=banner.js.map

package/dist/banner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.js","sourceRoot":"","sources":["../src/banner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAE9B,MAAM,WAAW,GAAG;IAClB,kEAAkE;IAClE,kEAAkE;IAClE,kEAAkE;IAClE,kEAAkE;IAClE,kEAAkE;IAClE,iEAAiE;CAClE,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IAChE,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAClD,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxE,CAAC"}

package/dist/channels/github/action.d.ts

@@ -0,0 +1,18 @@
+import { type GitHubTrendingResult } from './fetch.js';
+export type GitHubOutputFormat = 'json' | 'md';
+export declare const githubDefaults: {
+    readonly language: "typescript";
+    readonly period: "weekly";
+};
+export interface GitHubCommandOptions {
+    language: string;
+    since: string;
+    spokenLanguage?: string;
+    limit: number;
+    format: GitHubOutputFormat;
+    output?: string;
+    timeout: number;
+}
+export declare function formatGitHubJson(result: GitHubTrendingResult): string;
+export declare function formatGitHubMarkdown(result: GitHubTrendingResult): string;
+export declare function runGitHubCommand(options: GitHubCommandOptions): Promise<void>;

package/dist/channels/github/action.js

@@ -0,0 +1,79 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import chalk from 'chalk';
+import { fetchTrending } from './fetch.js';
+export const githubDefaults = {
+    language: 'typescript',
+    period: 'weekly',
+};
+const periodLabels = {
+    daily: '今日新增',
+    weekly: '本周新增',
+    monthly: '本月新增',
+};
+function escapeMarkdown(value) {
+    return (value ?? '—')
+        .replaceAll('\\', '\\\\')
+        .replaceAll('|', '\\|')
+        .replaceAll('\r', ' ')
+        .replaceAll('\n', ' ')
+        .trim();
+}
+function escapeLinkText(value) {
+    return escapeMarkdown(value).replaceAll('[', '\\[').replaceAll(']', '\\]');
+}
+export function formatGitHubJson(result) {
+    return JSON.stringify(result, null, 2);
+}
+export function formatGitHubMarkdown(result) {
+    const gainedLabel = periodLabels[result.period] ?? '周期新增';
+    const metadata = [
+        `- 开发语言：${escapeMarkdown(result.language)}`,
+        `- 时间范围：${escapeMarkdown(result.period)}`,
+        `- 采集时间：${escapeMarkdown(result.collectedAt)}`,
+        `- 仓库数量：${result.total}`,
+    ];
+    const header = `| # | 仓库 | 语言 | Stars | ${gainedLabel} | 简介 |`;
+    const divider = '|---:|---|---|---:|---:|---|';
+    const rows = result.items.map((item) => {
+        const repository = `[${escapeLinkText(item.title)}](${item.url})`;
+        return `| ${item.rank} | ${repository} | ${escapeMarkdown(item.language)} | ${item.metrics.stars} | ${item.metrics.periodStars} | ${escapeMarkdown(item.summary)} |`;
+    });
+    return [
+        `# ${escapeMarkdown(result.source)}`,
+        '',
+        ...metadata,
+        '',
+        header,
+        divider,
+        ...rows,
+    ].join('\n');
+}
+function formatGitHubResult(result, format) {
+    return format === 'md'
+        ? formatGitHubMarkdown(result)
+        : formatGitHubJson(result);
+}
+async function saveGitHubOutput(path, content) {
+    const absolutePath = resolve(path);
+    await mkdir(dirname(absolutePath), { recursive: true });
+    await writeFile(absolutePath, `${content}\n`, 'utf8');
+    return absolutePath;
+}
+export async function runGitHubCommand(options) {
+    const result = await fetchTrending({
+        period: options.since,
+        language: options.language,
+        spokenLanguage: options.spokenLanguage,
+        timeout: options.timeout,
+    });
+    result.items = result.items.slice(0, options.limit);
+    result.total = result.items.length;
+    const content = formatGitHubResult(result, options.format);
+    process.stdout.write(`${content}\n`);
+    if (options.output) {
+        const savedTo = await saveGitHubOutput(options.output, content);
+        process.stderr.write(`${chalk.green('✓')} 已保存到 ${chalk.magenta(savedTo)}\n`);
+    }
+}
+//# sourceMappingURL=action.js.map

package/dist/channels/github/action.js.map

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

package/dist/channels/github/fetch.d.ts

@@ -0,0 +1,42 @@
+export interface GitHubTrendingMetrics {
+    stars: number;
+    forks: number;
+    periodStars: number;
+}
+export interface GitHubTrendingItem {
+    source: 'github';
+    type: 'repository';
+    rank: number;
+    id: string;
+    title: string;
+    url: string;
+    summary: string;
+    author: string;
+    language: string | null;
+    metrics: GitHubTrendingMetrics;
+    contributors: string[];
+    period: string;
+    collectedAt: string;
+}
+export interface GitHubTrendingResult {
+    source: 'github treeding';
+    period: string;
+    language: string | null;
+    spokenLanguage: string | null;
+    collectedAt: string;
+    total: number;
+    items: GitHubTrendingItem[];
+}
+export interface GitHubFetchOptions {
+    period?: string;
+    language?: string;
+    spokenLanguage?: string;
+    timeout?: number;
+}
+export interface GitHubFetchContext {
+    fetch?: typeof globalThis.fetch;
+}
+export declare function parseCount(value?: string): number;
+export declare function parseTrendingHtml(html: string, { period }?: Pick<GitHubFetchOptions, 'period'>): GitHubTrendingItem[];
+export declare function buildTrendingUrl({ period, language, spokenLanguage, }?: GitHubFetchOptions): URL;
+export declare function fetchTrending(options?: GitHubFetchOptions): Promise<GitHubTrendingResult>;

package/dist/channels/github/fetch.js

@@ -0,0 +1,109 @@
+import * as cheerio from 'cheerio';
+const githubDefaults = {
+    language: 'typescript',
+    period: 'weekly',
+};
+const GITHUB_ROOT = 'https://github.com';
+const VALID_PERIODS = new Set(['daily', 'weekly', 'monthly']);
+export function parseCount(value = '') {
+    const normalized = value.trim().toLowerCase().replaceAll(',', '');
+    const match = normalized.match(/([0-9]+(?:\.[0-9]+)?)\s*([km]?)/);
+    if (!match)
+        return 0;
+    const numericValue = match[1];
+    const suffix = match[2] ?? '';
+    if (!numericValue)
+        return 0;
+    const multipliers = { '': 1, k: 1_000, m: 1_000_000 };
+    return Math.round(Number.parseFloat(numericValue) * (multipliers[suffix] ?? 1));
+}
+function normalizedText(element) {
+    return element.text().replace(/\s+/g, ' ').trim();
+}
+export function parseTrendingHtml(html, { period = githubDefaults.period } = {}) {
+    const $ = cheerio.load(html);
+    const collectedAt = new Date().toISOString();
+    const items = [];
+    $('article.Box-row').each((_, article) => {
+        const repoLink = $(article).find('h2 a[href]').first();
+        const path = repoLink.attr('href')?.trim() ?? '';
+        const [author, repository] = path.split('/').filter(Boolean);
+        if (!author || !repository)
+            return;
+        const language = normalizedText($(article).find('[itemprop="programmingLanguage"]').first());
+        const contributorNames = $(article)
+            .find('span:contains("Built by") a img[alt]')
+            .map((__, image) => ($(image).attr('alt') ?? '').replace(/^@/, '').trim())
+            .get()
+            .filter(Boolean);
+        items.push({
+            source: 'github',
+            type: 'repository',
+            rank: items.length + 1,
+            id: `${author}/${repository}`,
+            title: `${author}/${repository}`,
+            url: `${GITHUB_ROOT}${path}`,
+            summary: normalizedText($(article).find('p').first()),
+            author,
+            language: language || null,
+            metrics: {
+                stars: parseCount(normalizedText($(article).find('a[href$="/stargazers"]').first())),
+                forks: parseCount(normalizedText($(article).find('a[href$="/forks"]').first())),
+                periodStars: parseCount(normalizedText($(article).find('span.d-inline-block.float-sm-right').first())),
+            },
+            contributors: contributorNames,
+            period,
+            collectedAt,
+        });
+    });
+    return items;
+}
+export function buildTrendingUrl({ period = githubDefaults.period, language = githubDefaults.language, spokenLanguage, } = {}) {
+    if (!VALID_PERIODS.has(period)) {
+        throw new Error('--since 仅支持 daily、weekly 或 monthly');
+    }
+    const languagePath = language
+        ? `/${encodeURIComponent(language.toLowerCase())}`
+        : '';
+    const url = new URL(`/trending${languagePath}`, GITHUB_ROOT);
+    url.searchParams.set('since', period);
+    if (spokenLanguage) {
+        url.searchParams.set('spoken_language_code', spokenLanguage.toLowerCase());
+    }
+    return url;
+}
+export async function fetchTrending(options = {}) {
+    const request = globalThis.fetch;
+    const url = buildTrendingUrl(options);
+    const response = await request(url, {
+        headers: {
+            accept: 'text/html,application/xhtml+xml',
+            'accept-language': 'en-US,en;q=0.8',
+            'user-agent': 'TrendingKnowledge/0.1 (+https://github.com/trending)',
+        },
+        signal: AbortSignal.timeout(options.timeout ?? 20_000),
+    });
+    if (!response.ok) {
+        throw new Error(`GitHub 请求失败：HTTP ${response.status}`);
+    }
+    const items = parseTrendingHtml(await response.text(), {
+        period: options.period,
+    });
+    if (items.length === 0) {
+        throw new Error('GitHub 页面已返回，但没有解析到热门仓库；页面结构可能已变化');
+    }
+    const firstItem = items[0];
+    if (!firstItem) {
+        throw new Error('GitHub Trending 没有可用数据');
+    }
+    return {
+        source: 'github treeding',
+        period: options.period ?? githubDefaults.period,
+        language: options.language ?? githubDefaults.language,
+        spokenLanguage: options.spokenLanguage ?? null,
+        collectedAt: firstItem.collectedAt,
+        total: items.length,
+        items,
+    };
+}
+//# sourceMappingURL=fetch.js.map

package/dist/channels/github/fetch.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function printCliError(error: unknown): void;
+export declare function main(argv?: string[]): Promise<void>;

package/dist/cli.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+import { realpathSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { fileURLToPath } from 'node:url';
+import { formatErrorResponse } from './errors.js';
+import { configureNetwork } from './network.js';
+import { createProgram } from './program.js';
+const require = createRequire(import.meta.url);
+const packageJson = require('../package.json');
+export function printCliError(error) {
+    process.stderr.write(`${formatErrorResponse(error)}\n`);
+    process.exitCode = 1;
+}
+export async function main(argv = process.argv.slice(2)) {
+    configureNetwork();
+    const program = createProgram(packageJson.version);
+    if (argv.length === 0) {
+        program.outputHelp();
+        return;
+    }
+    await program.parseAsync(argv, { from: 'user' });
+}
+function isCliEntrypoint() {
+    if (!process.argv[1])
+        return false;
+    try {
+        return (realpathSync(process.argv[1]) ===
+            realpathSync(fileURLToPath(import.meta.url)));
+    }
+    catch {
+        return false;
+    }
+}
+if (isCliEntrypoint()) {
+    main().catch(printCliError);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAEtE,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,OAAiB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAEtC,gBAAgB,EAAE,CAAC;IACnB,MAAM,OAAO,GAAG,aAAa,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACnD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,UAAU,EAAE,CAAC;QACrB,OAAO;IACT,CAAC;IACD,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,eAAe;IACtB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,IAAI,CAAC;QACH,OAAO,CACL,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC7B,YAAY,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAC7C,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,IAAI,eAAe,EAAE,EAAE,CAAC;IACtB,IAAI,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;AAC9B,CAAC"}

package/dist/commands/sources.d.ts

@@ -0,0 +1 @@
+export declare function runSourcesCommand(): void;

package/dist/commands/sources.js

@@ -0,0 +1,40 @@
+import chalk from 'chalk';
+const sourceCatalog = [
+    {
+        key: 'github',
+        name: 'GitHub Trending',
+        status: 'active',
+        description: 'GitHub 社区每日、每周和每月热门仓库',
+    },
+    {
+        key: 'openai',
+        name: 'OpenAI 官网',
+        status: 'planned',
+        description: '新闻、研究和产品更新',
+    },
+    {
+        key: 'claude',
+        name: 'Claude 官网',
+        status: 'planned',
+        description: 'Anthropic 新闻和产品更新',
+    },
+    {
+        key: 'x',
+        name: 'X',
+        status: 'planned',
+        description: '指定账号和话题热度',
+    },
+];
+export function runSourcesCommand() {
+    const lines = sourceCatalog.map((source) => {
+        const active = source.status === 'active';
+        const marker = active ? chalk.green('●') : chalk.gray('○');
+        const key = active
+            ? chalk.magenta.bold(source.key.padEnd(8))
+            : chalk.gray(source.key.padEnd(8));
+        const name = active ? chalk.white(source.name) : chalk.gray(source.name);
+        return `${marker} ${key} ${name}  ${chalk.dim(source.description)}`;
+    });
+    process.stdout.write(`${chalk.magenta.bold('数据源')}\n\n${lines.join('\n')}\n`);
+}
+//# sourceMappingURL=sources.js.map

package/dist/commands/sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.js","sourceRoot":"","sources":["../../src/commands/sources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAS1B,MAAM,aAAa,GAAwB;IACzC;QACE,GAAG,EAAE,QAAQ;QACb,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,QAAQ;QAChB,WAAW,EAAE,uBAAuB;KACrC;IACD;QACE,GAAG,EAAE,QAAQ;QACb,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,SAAS;QACjB,WAAW,EAAE,YAAY;KAC1B;IACD;QACE,GAAG,EAAE,QAAQ;QACb,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,SAAS;QACjB,WAAW,EAAE,mBAAmB;KACjC;IACD;QACE,GAAG,EAAE,GAAG;QACR,IAAI,EAAE,GAAG;QACT,MAAM,EAAE,SAAS;QACjB,WAAW,EAAE,WAAW;KACzB;CACF,CAAC;AAEF,MAAM,UAAU,iBAAiB;IAC/B,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACzC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3D,MAAM,GAAG,GAAG,MAAM;YAChB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC1C,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzE,OAAO,GAAG,MAAM,IAAI,GAAG,IAAI,IAAI,KAAK,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CACxD,CAAC;AACJ,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,7 @@
+export interface SerializedError {
+    name: string;
+    message: string;
+    code: string | number;
+}
+export declare function serializeError(error: unknown): SerializedError;
+export declare function formatErrorResponse(error: unknown): string;

package/dist/errors.js

@@ -0,0 +1,45 @@
+function errorProperty(error, property) {
+    try {
+        return Reflect.get(error, property);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function serializeError(error) {
+    const seen = new WeakSet();
+    let current = error;
+    while (typeof current === 'object' && current !== null) {
+        if (seen.has(current))
+            break;
+        seen.add(current);
+        const cause = errorProperty(current, 'cause');
+        if (cause === undefined)
+            break;
+        current = cause;
+    }
+    const rootCause = current;
+    if (typeof rootCause !== 'object' || rootCause === null) {
+        return {
+            name: 'Error',
+            message: String(rootCause),
+            code: 'UNKNOWN_ERROR',
+        };
+    }
+    const rawName = errorProperty(rootCause, 'name');
+    const rawMessage = errorProperty(rootCause, 'message');
+    const rawCode = errorProperty(rootCause, 'code');
+    return {
+        name: typeof rawName === 'string' && rawName ? rawName : 'Error',
+        message: typeof rawMessage === 'string' && rawMessage
+            ? rawMessage
+            : String(rootCause),
+        code: typeof rawCode === 'string' || typeof rawCode === 'number'
+            ? rawCode
+            : 'UNKNOWN_ERROR',
+    };
+}
+export function formatErrorResponse(error) {
+    return JSON.stringify(serializeError(error), null, 2);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAMA,SAAS,aAAa,CACpB,KAAa,EACb,QAA+C;IAE/C,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,MAAM,IAAI,GAAG,IAAI,OAAO,EAAU,CAAC;IACnC,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACvD,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,MAAM;QAC7B,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAElB,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9C,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM;QAC/B,OAAO,GAAG,KAAK,CAAC;IAClB,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC;IAC1B,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACxD,OAAO;YACL,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC;YAC1B,IAAI,EAAE,eAAe;SACtB,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,aAAa,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACjD,OAAO;QACL,IAAI,EAAE,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO;QAChE,OAAO,EACL,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU;YAC1C,CAAC,CAAC,UAAU;YACZ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC;QACvB,IAAI,EACF,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,OAAO,KAAK,QAAQ;YACxD,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,eAAe;KACtB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACxD,CAAC"}

package/dist/network.d.ts

@@ -0,0 +1,7 @@
+import { type Dispatcher } from 'undici';
+type NetworkEnvironment = Partial<Pick<NodeJS.ProcessEnv, 'HTTP_PROXY' | 'http_proxy' | 'HTTPS_PROXY' | 'https_proxy' | 'ALL_PROXY' | 'all_proxy' | 'NO_PROXY' | 'no_proxy'>>;
+type DispatcherSetter = (dispatcher: Dispatcher) => void;
+export declare function parseMacOSProxySettings(output: string): NetworkEnvironment;
+export declare function configureNetworkFromEnvironment(environment?: NetworkEnvironment, setDispatcher?: DispatcherSetter): boolean;
+export declare function configureNetwork(): boolean;
+export {};

package/dist/network.js

@@ -0,0 +1,65 @@
+import { execFileSync } from 'node:child_process';
+import { EnvHttpProxyAgent, setGlobalDispatcher, } from 'undici';
+let proxyAgent;
+function firstValue(...values) {
+    return values.find((value) => value !== undefined && value.length > 0);
+}
+function httpCompatibleProxy(value) {
+    if (!value)
+        return undefined;
+    try {
+        const protocol = new URL(value).protocol;
+        return protocol === 'http:' || protocol === 'https:' ? value : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function macOSProxyUrl(output, kind) {
+    const enabled = new RegExp(`^\\s*${kind}Enable\\s*:\\s*1\\s*$`, 'm').test(output);
+    if (!enabled)
+        return undefined;
+    const host = output.match(new RegExp(`^\\s*${kind}Proxy\\s*:\\s*(\\S+)\\s*$`, 'm'))?.[1];
+    const port = output.match(new RegExp(`^\\s*${kind}Port\\s*:\\s*(\\d+)\\s*$`, 'm'))?.[1];
+    if (!host || !port)
+        return undefined;
+    const urlHost = host.includes(':') ? `[${host}]` : host;
+    return `http://${urlHost}:${port}`;
+}
+export function parseMacOSProxySettings(output) {
+    return {
+        HTTP_PROXY: macOSProxyUrl(output, 'HTTP'),
+        HTTPS_PROXY: macOSProxyUrl(output, 'HTTPS'),
+    };
+}
+export function configureNetworkFromEnvironment(environment = process.env, setDispatcher = setGlobalDispatcher) {
+    const allProxy = httpCompatibleProxy(firstValue(environment.all_proxy, environment.ALL_PROXY));
+    const httpProxy = firstValue(environment.http_proxy, environment.HTTP_PROXY, allProxy);
+    const httpsProxy = firstValue(environment.https_proxy, environment.HTTPS_PROXY, allProxy);
+    if (!httpProxy && !httpsProxy)
+        return false;
+    proxyAgent = new EnvHttpProxyAgent({
+        httpProxy,
+        httpsProxy,
+        noProxy: firstValue(environment.no_proxy, environment.NO_PROXY),
+    });
+    setDispatcher(proxyAgent);
+    return true;
+}
+export function configureNetwork() {
+    if (configureNetworkFromEnvironment())
+        return true;
+    if (process.platform !== 'darwin')
+        return false;
+    try {
+        const output = execFileSync('/usr/sbin/scutil', ['--proxy'], {
+            encoding: 'utf8',
+            timeout: 1_000,
+        });
+        return configureNetworkFromEnvironment(parseMacOSProxySettings(output));
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=network.js.map

package/dist/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../src/network.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EACL,iBAAiB,EACjB,mBAAmB,GAEpB,MAAM,QAAQ,CAAC;AAkBhB,IAAI,UAAyC,CAAC;AAE9C,SAAS,UAAU,CAAC,GAAG,MAAiC;IACtD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAyB;IACpD,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC;QACzC,OAAO,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CACpB,MAAc,EACd,IAAsB;IAEtB,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,QAAQ,IAAI,uBAAuB,EAAE,GAAG,CAAC,CAAC,IAAI,CACvE,MAAM,CACP,CAAC;IACF,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAE/B,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CACvB,IAAI,MAAM,CAAC,QAAQ,IAAI,2BAA2B,EAAE,GAAG,CAAC,CACzD,EAAE,CAAC,CAAC,CAAC,CAAC;IACP,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CACvB,IAAI,MAAM,CAAC,QAAQ,IAAI,0BAA0B,EAAE,GAAG,CAAC,CACxD,EAAE,CAAC,CAAC,CAAC,CAAC;IACP,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAErC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IACxD,OAAO,UAAU,OAAO,IAAI,IAAI,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAc;IACpD,OAAO;QACL,UAAU,EAAE,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC;QACzC,WAAW,EAAE,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC;KAC5C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,cAAkC,OAAO,CAAC,GAAyB,EACnE,gBAAkC,mBAAmB;IAErD,MAAM,QAAQ,GAAG,mBAAmB,CAClC,UAAU,CAAC,WAAW,CAAC,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC,CACzD,CAAC;IACF,MAAM,SAAS,GAAG,UAAU,CAC1B,WAAW,CAAC,UAAU,EACtB,WAAW,CAAC,UAAU,EACtB,QAAQ,CACT,CAAC;IACF,MAAM,UAAU,GAAG,UAAU,CAC3B,WAAW,CAAC,WAAW,EACvB,WAAW,CAAC,WAAW,EACvB,QAAQ,CACT,CAAC;IAEF,IAAI,CAAC,SAAS,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAE5C,UAAU,GAAG,IAAI,iBAAiB,CAAC;QACjC,SAAS;QACT,UAAU;QACV,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC;KAChE,CAAC,CAAC;IACH,aAAa,CAAC,UAAU,CAAC,CAAC;IAC1B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,IAAI,+BAA+B,EAAE;QAAE,OAAO,IAAI,CAAC;IACnD,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAEhD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,YAAY,CAAC,kBAAkB,EAAE,CAAC,SAAS,CAAC,EAAE;YAC3D,QAAQ,EAAE,MAAM;YAChB,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;QACH,OAAO,+BAA+B,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/program.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function createProgram(version: string): Command;

package/dist/program.js

@@ -0,0 +1,60 @@
+import chalk from 'chalk';
+import { Command, InvalidArgumentError, Option } from 'commander';
+import { renderBanner } from './banner.js';
+import { githubDefaults, runGitHubCommand } from './channels/github/action.js';
+import { runSourcesCommand } from './commands/sources.js';
+function positiveInteger(value) {
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isInteger(parsed) || parsed < 1) {
+        throw new InvalidArgumentError('必须是大于 0 的整数');
+    }
+    return parsed;
+}
+const examples = `
+示例:
+  ${chalk.magenta('youKnow github')}
+  ${chalk.magenta('youKnow github --since daily --language python --limit 5')}
+  ${chalk.magenta('youKnow github --format md --output output/github.md')}
+`;
+function localizeHelp(message) {
+    return message
+        .replace(/^Usage:/gm, chalk.magenta.bold('用法:'))
+        .replace(/^Options:/gm, chalk.magenta.bold('选项:'))
+        .replace(/^Commands:/gm, chalk.magenta.bold('命令:'));
+}
+export function createProgram(version) {
+    const program = new Command()
+        .name('youKnow')
+        .description('从多个渠道发现值得关注的热点信号')
+        .version(version, '-v, --version', '显示版本')
+        .helpOption('-h, --help', '显示帮助')
+        .helpCommand('help [command]', '显示指定命令的帮助')
+        .showHelpAfterError('(运行 youKnow --help 查看完整用法)')
+        .configureOutput({
+        writeOut: (message) => process.stdout.write(localizeHelp(message)),
+        writeErr: (message) => process.stderr.write(chalk.red(message)),
+    });
+    program.addHelpText('before', `${renderBanner()}\n`);
+    program
+        .command('github')
+        .description('获取 GitHub Trending 热门仓库')
+        .option('-l, --language <language>', '开发语言', githubDefaults.language)
+        .addOption(new Option('-s, --since <since>', '时间范围')
+        .choices(['daily', 'weekly', 'monthly'])
+        .default(githubDefaults.period))
+        .option('--spoken-language <code>', '项目自然语言代码，如 zh、en')
+        .option('-n, --limit <number>', '返回条数', positiveInteger, 20)
+        .addOption(new Option('-f, --format <format>', '输出格式')
+        .choices(['json', 'md'])
+        .default('json'))
+        .option('-o, --output <path>', '同时写入文件')
+        .option('--timeout <ms>', '请求超时毫秒数', positiveInteger, 20_000)
+        .action(runGitHubCommand);
+    program
+        .command('sources')
+        .description('查看当前与规划中的数据源')
+        .action(runSourcesCommand);
+    program.addHelpText('after', examples);
+    return program;
+}
+//# sourceMappingURL=program.js.map

package/dist/program.js.map

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

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "trending-knowledge",
+  "version": "0.1.0",
+  "description": "在终端获取 GitHub Trending 热门仓库，支持 JSON 和 Markdown 输出",
+  "type": "module",
+  "bin": {
+    "trending-knowledge": "dist/cli.js",
+    "youKnow": "dist/cli.js",
+    "youknow": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "clean": "node scripts/clean.mjs",
+    "build": "npm run clean && tsc -p tsconfig.json",
+    "dev": "tsx src/cli.ts",
+    "link": "node scripts/link-src.mjs",
+    "unlink": "node scripts/link-src.mjs --unlink",
+    "start": "node dist/cli.js",
+    "test": "node --import tsx --test tests/*.test.ts",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "check": "npm run format:check && tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json && node --check src/youKnow.mjs && node --check scripts/link-src.mjs",
+    "prepublishOnly": "npm test && npm run check",
+    "prepare": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wanglsh97/trending-knowledge.git"
+  },
+  "homepage": "https://github.com/wanglsh97/trending-knowledge#readme",
+  "bugs": {
+    "url": "https://github.com/wanglsh97/trending-knowledge/issues"
+  },
+  "keywords": [
+    "github",
+    "trending",
+    "cli",
+    "typescript",
+    "markdown"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.18.1"
+  },
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "cheerio": "1.1.2",
+    "commander": "^14.0.3",
+    "undici": "^7.29.0"
+  },
+  "devDependencies": {
+    "@types/node": "24.3.0",
+    "prettier": "3.6.2",
+    "tsx": "4.20.5",
+    "typescript": "5.9.2"
+  }
+}