@kadaliao/geektime-downloader 1.0.0 → 1.0.1

package/README.md

@@ -186,6 +186,27 @@ npx @kadaliao/geektime-downloader \
 
 ## 🐛 常见问题
 
+### Playwright 浏览器未安装？
+
+如果遇到 "Executable doesn't exist" 错误，说明 Playwright 浏览器未安装。
+
+**方式一：自动安装（推荐）**
+```bash
+# 全局安装会自动安装浏览器
+npm install -g @kadaliao/geektime-downloader
+```
+
+**方式二：手动安装浏览器**
+```bash
+# 只安装 Chromium
+npx playwright install chromium
+
+# 或安装浏览器及系统依赖（Linux/Mac）
+npx playwright install chromium --with-deps
+```
+
+**注意**：使用 `npx` 直接运行时，可能需要先手动安装浏览器。为了更好的体验，建议全局安装。
+
 ### Cookie 和 URL 必须通过命令行传吗？
 
 不是。三种方式任选：

package/download.js

@@ -885,9 +885,26 @@ async function main(options) {
     console.log(chalk.gray(`📁 输出目录: ${outputDir}\n`));
 
     // 启动浏览器
-    const browser = await chromium.launch({
-        headless: options.headless !== false
-    });
+    let browser;
+    try {
+        browser = await chromium.launch({
+            headless: options.headless !== false
+        });
+    } catch (error) {
+        // 检查是否是浏览器未安装的错误
+        if (error.message.includes("Executable doesn't exist") || error.message.includes('browsers')) {
+            console.error(chalk.red('\n❌ Playwright 浏览器未安装！\n'));
+            console.log(chalk.yellow('请运行以下命令安装浏览器：'));
+            console.log(chalk.cyan('  npx playwright install chromium\n'));
+            console.log(chalk.gray('或者使用 --with-deps 参数安装系统依赖：'));
+            console.log(chalk.gray('  npx playwright install chromium --with-deps\n'));
+            console.log(chalk.gray('提示：如果你是通过 npx 运行的，建议先全局安装：'));
+            console.log(chalk.gray('  npm install -g @kadaliao/geektime-downloader\n'));
+            process.exit(1);
+        }
+        // 其他错误直接抛出
+        throw error;
+    }
 
     // 保存到全局变量，用于信号处理
     globalBrowser = browser;
@@ -996,7 +1013,7 @@ async function main(options) {
 program
     .name('geektime-dl')
     .description('批量下载极客时间专栏文章为PDF')
-    .version('1.0.0')
+    .version('1.0.1')
     .option('-u, --url <url>', '专栏文章URL（任意一篇）')
     .option('-c, --cookie <cookie>', 'Cookie字符串（用于认证）')
     .option('-o, --output <dir>', '输出目录', './downloads')

package/package.json

@@ -1,15 +1,16 @@
 {
   "name": "@kadaliao/geektime-downloader",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "极客时间专栏文章批量下载工具 - 支持一键下载整个专栏为PDF",
   "type": "module",
   "main": "download.js",
   "bin": {
-    "geektime-dl": "./download.js"
+    "geektime-dl": "download.js"
   },
   "scripts": {
     "start": "node download.js",
-    "test": "node download.js --dry-run"
+    "test": "node download.js --dry-run",
+    "postinstall": "npx playwright install chromium --with-deps || echo '⚠️  Playwright安装失败，请手动运行: npx playwright install chromium'"
   },
   "keywords": [
     "geektime",
@@ -22,7 +23,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/yourusername/geektime-downloader.git"
+    "url": "git+https://github.com/kadaliao/geektime-downloader.git"
   },
   "engines": {
     "node": ">=16.0.0"