wespy-ts 0.2.0

package/dist/sdk/fetch-article.js

@@ -0,0 +1,111 @@
+/**
+ * fetchArticle SDK API
+ */
+import { FetchArticleInputSchema } from '../core/types.js';
+import { HttpClient } from '../fetcher/http-client.js';
+import { detectPlatform } from '../utils/url.js';
+import { fetchWechatArticle } from '../platforms/wechat/wechat-article.extractor.js';
+import { fetchJuejinArticle } from '../platforms/juejin/juejin-article.extractor.js';
+import { fetchGenericArticle } from '../platforms/generic/generic-article.extractor.js';
+import { unsupportedUrlError, invalidInputError } from '../core/errors.js';
+import { fetchAlbum } from './fetch-album.js';
+/**
+ * 获取单篇文章
+ *
+ * @example
+ * ```ts
+ * import { fetchArticle } from 'wespy'
+ *
+ * const result = await fetchArticle({
+ *   url: 'https://mp.weixin.qq.com/s/xxxxx',
+ *   format: ['markdown', 'json'],
+ * })
+ *
+ * if (result.ok) {
+ *   console.log(result.article.title)
+ *   console.log(result.article.markdown)
+ * }
+ * ```
+ */
+export async function fetchArticle(input) {
+    // 输入校验
+    const parsed = FetchArticleInputSchema.safeParse(input);
+    if (!parsed.success) {
+        return failure(invalidInputError(parsed.error.issues.map((i) => i.message).join('; ')));
+    }
+    const { url, outputDir, format, timeoutMs, userAgent, headers, downloadImages } = parsed.data;
+    if (downloadImages) {
+        return failure(invalidInputError('downloadImages 尚未实现；Python 原版仅在 Markdown 中转换图片代理 URL'));
+    }
+    const httpClient = new HttpClient({ timeoutMs, userAgent, headers });
+    const platform = detectPlatform(url);
+    if (!platform) {
+        return failure(unsupportedUrlError(url));
+    }
+    try {
+        let result;
+        switch (platform) {
+            case 'wechat': {
+                const res = await fetchWechatArticle(url, httpClient, outputDir, format);
+                if (!res.ok)
+                    return failure(res.error);
+                result = res.value;
+                break;
+            }
+            case 'juejin': {
+                const res = await fetchJuejinArticle(url, httpClient, outputDir, format);
+                if (!res.ok)
+                    return failure(res.error);
+                result = res.value;
+                break;
+            }
+            case 'generic': {
+                const res = await fetchGenericArticle(url, httpClient, outputDir, format);
+                if (!res.ok)
+                    return failure(res.error);
+                result = res.value;
+                break;
+            }
+            case 'wechat-album': {
+                const albumResult = await fetchAlbum({ url, outputDir, format, timeoutMs, maxArticles: 10 });
+                if (!albumResult.ok)
+                    return failure(albumResult.error);
+                return albumSuccess(albumResult.articles, albumResult.artifacts, albumResult.warnings, albumResult.summaryFile, albumResult.failedCount);
+            }
+            default:
+                return failure(unsupportedUrlError(url));
+        }
+        return success(result.article, result.artifacts);
+    }
+    catch (e) {
+        const message = e instanceof Error ? e.message : String(e);
+        return failure({
+            code: 'UNKNOWN_ERROR',
+            message,
+            retryable: false,
+            details: { url },
+        });
+    }
+}
+function albumSuccess(articles, artifacts, warnings, summaryFile, failedCount) {
+    return {
+        ok: true,
+        articles,
+        artifacts,
+        warnings,
+        summaryFile,
+        failedCount,
+    };
+}
+function success(article, artifacts) {
+    return {
+        ok: true,
+        article,
+        artifacts,
+        warnings: article.warnings,
+    };
+}
+function failure(error) {
+    return { ok: false, error };
+}
+//# sourceMappingURL=fetch-article.js.map

package/dist/sdk/fetch-article.js.map

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

package/dist/utils/fs.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 文件系统工具函数
+ */
+/**
+ * 确保目录存在，不存在则递归创建
+ */
+export declare function ensureDir(dirPath: string): Promise<void>;
+/**
+ * 写入文件，自动创建父目录
+ */
+export declare function writeFileSafe(filePath: string, content: string): Promise<void>;
+/**
+ * 写入 JSON 文件，自动创建父目录
+ */
+export declare function writeJsonSafe(filePath: string, data: unknown, pretty?: boolean): Promise<void>;
+//# sourceMappingURL=fs.d.ts.map

package/dist/utils/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGpF;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,MAAM,UAAO,GACZ,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/utils/fs.js

@@ -0,0 +1,26 @@
+/**
+ * 文件系统工具函数
+ */
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+/**
+ * 确保目录存在，不存在则递归创建
+ */
+export async function ensureDir(dirPath) {
+    await mkdir(dirPath, { recursive: true });
+}
+/**
+ * 写入文件，自动创建父目录
+ */
+export async function writeFileSafe(filePath, content) {
+    await ensureDir(dirname(filePath));
+    await writeFile(filePath, content, 'utf-8');
+}
+/**
+ * 写入 JSON 文件，自动创建父目录
+ */
+export async function writeJsonSafe(filePath, data, pretty = true) {
+    const content = JSON.stringify(data, null, pretty ? 2 : undefined);
+    await writeFileSafe(filePath, content);
+}
+//# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAe;IAC7C,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAgB,EAAE,OAAe;IACnE,MAAM,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAA;IAClC,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAgB,EAChB,IAAa,EACb,MAAM,GAAG,IAAI;IAEb,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IAClE,MAAM,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;AACxC,CAAC"}

package/dist/utils/text.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 文本工具函数
+ */
+/**
+ * 清理文件名中的非法字符
+ */
+export declare function sanitizeFilename(title: string, maxLen?: number): string;
+/**
+ * 从 CSS class 列表中检测代码语言
+ */
+export declare function detectCodeLanguage(classes: string[]): string | null;
+/**
+ * 清理代码块内容：去除前导空行，保留缩进（与 Python 版一致，保留末尾空行）
+ */
+export declare function cleanCodeContent(code: string): string;
+/**
+ * 格式化本地时间: YYYY-MM-DD HH:MM:SS（与 Python time.strftime 一致）
+ */
+export declare function formatLocalTime(date?: Date): string;
+//# sourceMappingURL=text.d.ts.map

package/dist/utils/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/utils/text.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAK,GAAG,MAAM,CAMnE;AA6CD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAgBnE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASrD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,OAAa,GAAG,MAAM,CAGzD"}

package/dist/utils/text.js

@@ -0,0 +1,96 @@
+/**
+ * 文本工具函数
+ */
+/**
+ * 清理文件名中的非法字符
+ */
+export function sanitizeFilename(title, maxLen = 50) {
+    return title
+        .replace(/[<>:"/\\|?*]/g, '_')
+        .replace(/\s+/g, ' ')
+        .trim()
+        .slice(0, maxLen);
+}
+/**
+ * 语言 class 到语言名的映射表
+ */
+const LANGUAGE_MAPPING = {
+    'language-python': 'python',
+    'language-javascript': 'javascript',
+    'language-js': 'javascript',
+    'language-typescript': 'typescript',
+    'language-ts': 'typescript',
+    'language-java': 'java',
+    'language-cpp': 'cpp',
+    'language-c++': 'cpp',
+    'language-c': 'c',
+    'language-csharp': 'csharp',
+    'language-c#': 'csharp',
+    'language-go': 'go',
+    'language-rust': 'rust',
+    'language-php': 'php',
+    'language-ruby': 'ruby',
+    'language-python3': 'python',
+    'language-py': 'python',
+    'language-html': 'html',
+    'language-css': 'css',
+    'language-scss': 'scss',
+    'language-sass': 'sass',
+    'language-json': 'json',
+    'language-xml': 'xml',
+    'language-yaml': 'yaml',
+    'language-yml': 'yaml',
+    'language-sql': 'sql',
+    'language-bash': 'bash',
+    'language-shell': 'bash',
+    'language-sh': 'bash',
+    'language-markdown': 'markdown',
+    'language-md': 'markdown',
+    'language-dockerfile': 'dockerfile',
+    'language-docker': 'dockerfile',
+    'language-git': 'git',
+    'language-diff': 'diff',
+    'language-text': 'text',
+    'language-plain': 'text',
+};
+/**
+ * 从 CSS class 列表中检测代码语言
+ */
+export function detectCodeLanguage(classes) {
+    // 精确匹配
+    for (const cls of classes) {
+        if (cls in LANGUAGE_MAPPING) {
+            return LANGUAGE_MAPPING[cls];
+        }
+    }
+    // 部分匹配
+    for (const cls of classes) {
+        for (const [key, lang] of Object.entries(LANGUAGE_MAPPING)) {
+            if (cls.includes(key)) {
+                return lang;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * 清理代码块内容：去除前导空行，保留缩进（与 Python 版一致，保留末尾空行）
+ */
+export function cleanCodeContent(code) {
+    const lines = code.split('\n');
+    const cleaned = [];
+    for (const line of lines) {
+        if (line.trim() || cleaned.length > 0) {
+            cleaned.push(line);
+        }
+    }
+    return cleaned.join('\n');
+}
+/**
+ * 格式化本地时间: YYYY-MM-DD HH:MM:SS（与 Python time.strftime 一致）
+ */
+export function formatLocalTime(date = new Date()) {
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}`;
+}
+//# sourceMappingURL=text.js.map

package/dist/utils/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/utils/text.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,MAAM,GAAG,EAAE;IACzD,OAAO,KAAK;SACT,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC;SAC7B,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE;SACN,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,gBAAgB,GAA2B;IAC/C,iBAAiB,EAAE,QAAQ;IAC3B,qBAAqB,EAAE,YAAY;IACnC,aAAa,EAAE,YAAY;IAC3B,qBAAqB,EAAE,YAAY;IACnC,aAAa,EAAE,YAAY;IAC3B,eAAe,EAAE,MAAM;IACvB,cAAc,EAAE,KAAK;IACrB,cAAc,EAAE,KAAK;IACrB,YAAY,EAAE,GAAG;IACjB,iBAAiB,EAAE,QAAQ;IAC3B,aAAa,EAAE,QAAQ;IACvB,aAAa,EAAE,IAAI;IACnB,eAAe,EAAE,MAAM;IACvB,cAAc,EAAE,KAAK;IACrB,eAAe,EAAE,MAAM;IACvB,kBAAkB,EAAE,QAAQ;IAC5B,aAAa,EAAE,QAAQ;IACvB,eAAe,EAAE,MAAM;IACvB,cAAc,EAAE,KAAK;IACrB,eAAe,EAAE,MAAM;IACvB,eAAe,EAAE,MAAM;IACvB,eAAe,EAAE,MAAM;IACvB,cAAc,EAAE,KAAK;IACrB,eAAe,EAAE,MAAM;IACvB,cAAc,EAAE,MAAM;IACtB,cAAc,EAAE,KAAK;IACrB,eAAe,EAAE,MAAM;IACvB,gBAAgB,EAAE,MAAM;IACxB,aAAa,EAAE,MAAM;IACrB,mBAAmB,EAAE,UAAU;IAC/B,aAAa,EAAE,UAAU;IACzB,qBAAqB,EAAE,YAAY;IACnC,iBAAiB,EAAE,YAAY;IAC/B,cAAc,EAAE,KAAK;IACrB,eAAe,EAAE,MAAM;IACvB,eAAe,EAAE,MAAM;IACvB,gBAAgB,EAAE,MAAM;CACzB,CAAA;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAiB;IAClD,OAAO;IACP,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,GAAG,IAAI,gBAAgB,EAAE,CAAC;YAC5B,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAA;QAC9B,CAAC;IACH,CAAC;IACD,OAAO;IACP,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC3D,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtB,OAAO,IAAI,CAAA;YACb,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC9B,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,EAAE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACpB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAI,GAAG,IAAI,IAAI,EAAE;IAC/C,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IACrD,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,CAAA;AAC/J,CAAC"}

package/dist/utils/url.d.ts

@@ -0,0 +1,22 @@
+/**
+ * URL 工具函数
+ */
+/**
+ * 从 URL 中提取域名（不含 www. 前缀）
+ * URL 无效时返回 null
+ */
+export declare function extractDomain(url: string): string | null;
+/**
+ * 检测 URL 对应的平台
+ * URL 无效时返回 null（不静默路由到 generic）
+ */
+export declare function detectPlatform(url: string): 'wechat' | 'wechat-album' | 'juejin' | 'generic' | null;
+/**
+ * 移除 URL 末尾的 #rd 后缀（微信文章常见）
+ */
+export declare function stripHashSuffix(url: string): string;
+/**
+ * 构建代理图片 URL（使用 images.weserv.nl 绕过防盗链）
+ */
+export declare function buildProxyImageUrl(originalUrl: string): string;
+//# sourceMappingURL=url.d.ts.map

package/dist/utils/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQxD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,cAAc,GAAG,QAAQ,GAAG,SAAS,GAAG,IAAI,CAoBnG;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAiB9D"}

package/dist/utils/url.js

@@ -0,0 +1,63 @@
+/**
+ * URL 工具函数
+ */
+/**
+ * 从 URL 中提取域名（不含 www. 前缀）
+ * URL 无效时返回 null
+ */
+export function extractDomain(url) {
+    try {
+        const parsed = new URL(url);
+        const host = parsed.hostname.toLowerCase();
+        return host.startsWith('www.') ? host.slice(4) : host;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 检测 URL 对应的平台
+ * URL 无效时返回 null（不静默路由到 generic）
+ */
+export function detectPlatform(url) {
+    try {
+        const parsed = new URL(url);
+        const host = parsed.hostname.toLowerCase();
+        if (host.includes('mp.weixin.qq.com')) {
+            if (parsed.pathname.includes('/mp/appmsgalbum')) {
+                return 'wechat-album';
+            }
+            return 'wechat';
+        }
+        if (host.includes('juejin.cn')) {
+            return 'juejin';
+        }
+        return 'generic';
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 移除 URL 末尾的 #rd 后缀（微信文章常见）
+ */
+export function stripHashSuffix(url) {
+    return url.replace(/#rd$/, '');
+}
+/**
+ * 构建代理图片 URL（使用 images.weserv.nl 绕过防盗链）
+ */
+export function buildProxyImageUrl(originalUrl) {
+    if (!originalUrl || !originalUrl.startsWith('http')) {
+        return originalUrl;
+    }
+    const encodedUrl = encodeURIComponent(originalUrl);
+    let proxyUrl = `https://images.weserv.nl/?url=${encodedUrl}`;
+    // GIF 图片添加特殊参数
+    if (originalUrl.toLowerCase().includes('gif') ||
+        originalUrl.toLowerCase().includes('wx_fmt=gif')) {
+        proxyUrl += '&n=-1';
+    }
+    return proxyUrl;
+}
+//# sourceMappingURL=url.js.map

package/dist/utils/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;QAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAA;QAC1C,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;QAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAA;QAE1C,IAAI,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACtC,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;gBAChD,OAAO,cAAc,CAAA;YACvB,CAAC;YACD,OAAO,QAAQ,CAAA;QACjB,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAC/B,OAAO,QAAQ,CAAA;QACjB,CAAC;QAED,OAAO,SAAS,CAAA;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAmB;IACpD,IAAI,CAAC,WAAW,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACpD,OAAO,WAAW,CAAA;IACpB,CAAC;IAED,MAAM,UAAU,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAA;IAClD,IAAI,QAAQ,GAAG,iCAAiC,UAAU,EAAE,CAAA;IAE5D,eAAe;IACf,IACE,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;QACzC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,EAChD,CAAC;QACD,QAAQ,IAAI,OAAO,CAAA;IACrB,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "wespy-ts",
+  "version": "0.2.0",
+  "description": "WeSpy - 文章抓取与 Markdown 转换工具 (TypeScript 版)",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "wespy": "dist/cli/main.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "wechat",
+    "article",
+    "scraper",
+    "markdown",
+    "juejin",
+    "fetch",
+    "crawl"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Cuimc/WeSpy-TS.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Cuimc/WeSpy-TS/issues"
+  },
+  "homepage": "https://github.com/Cuimc/WeSpy-TS#readme",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "cheerio": "^1.0.0",
+    "commander": "^12.0.0",
+    "turndown": "^7.1.0",
+    "undici": "^6.0.0",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/turndown": "^5.0.1",
+    "typescript": "^5.4.0",
+    "vitest": "^1.0.0"
+  }
+}