douyin-downloader 0.1.0

package/README.md

@@ -0,0 +1,114 @@
+# 抖音影片解析與下載工具 (douyin-downloader)
+
+[![NPM version](https://img.shields.io/npm/v/douyin-downloader.svg?style=flat)](https://www.npmjs.com/package/douyin-downloader)
+[![License](https://img.shields.io/npm/l/douyin-downloader.svg?style=flat)](https://github.com/gkctou/douyin-downloader/blob/main/LICENSE)
+
+一個基於 Node.js 和 Puppeteer 的命令列工具，用於解析和下載抖音 (Douyin) 影片，並獲取影片及用戶資訊。
+
+## ✨ 功能特性
+
+*   **影片下載**: 下載指定的單一抖音影片。
+*   **影片資訊**: 獲取影片的詳細資訊 (作者、標題、發布時間等)。
+*   **用戶影片列表**: 獲取指定用戶發布的所有影片連結列表。
+*   **登入與驗證**: 支援透過掃描 QR Code 登入抖音帳號，並驗證登入狀態。
+*   **自訂輸出**: 可指定下載目錄和檔案名稱，或將資訊輸出至檔案。
+*   **瀏覽器操作**: 可開啟已載入 Cookie 的瀏覽器實例。
+*   **詳細日誌**: 提供詳細模式 (`--verbose`) 以方便調試。
+
+## 🚀 安裝
+
+確保您的系統已安裝 Node.js (建議版本 >= 20.0.0) 和 npm。
+
+```bash
+npm install -g douyin-downloader
+```
+
+或者，如果您不想全域安裝，可以使用 `npx`:
+
+```bash
+npx dy-dl <命令> [選項]
+```
+
+## 🛠️ 使用說明
+
+`douyin-downloader` 提供了一個名為 `dy-dl` 的命令列介面。
+
+### 基本命令格式
+
+```bash
+dy-dl <命令> [選項] [參數]
+```
+
+### 可用命令
+
+*   **`login`**: 登入抖音帳號並儲存 Cookie。
+    ```bash
+    dy-dl login
+    ```
+    執行後會開啟瀏覽器顯示 QR Code，請使用抖音 App 掃描登入。Cookie 將儲存於預設路徑。
+
+*   **`check`**: 檢查已儲存的 Cookie 是否有效。
+    ```bash
+    dy-dl check
+    ```
+
+*   **`open`**: 開啟一個已載入 Cookie 的瀏覽器實例。
+    ```bash
+    dy-dl open
+    ```
+
+*   **`video <影片連結>`**: 下載單個影片。
+    ```bash
+    # 下載影片到目前目錄
+    dy-dl video https://v.douyin.com/xxxxxxx/
+
+    # 指定下載目錄
+    dy-dl video -d ./downloads https://v.douyin.com/xxxxxxx/
+
+    # 指定下載目錄和檔案名稱 (注意: -f 僅適用於單個影片下載)
+    dy-dl video -d ./downloads -f my_video.mp4 https://v.douyin.com/xxxxxxx/
+    ```
+
+*   **`info <影片連結>`**: 獲取影片資訊。
+    ```bash
+    # 輸出資訊到控制台
+    dy-dl info https://v.douyin.com/xxxxxxx/
+
+    # 輸出資訊到 JSON 檔案
+    dy-dl info -f video_info.json https://v.douyin.com/xxxxxxx/
+    ```
+
+*   **`list <用戶主頁連結>`**: 獲取用戶影片列表。
+    ```bash
+    # 獲取用戶所有影片列表並輸出到控制台
+    dy-dl list https://www.douyin.com/user/MS4wLjABAAAAxxxxxxxxxxxxxxxx
+
+    # 獲取用戶最新的 10 個影片列表
+    dy-dl list -n 10 https://www.douyin.com/user/MS4wLjABAAAAxxxxxxxxxxxxxxxx
+
+    # 獲取用戶影片列表並輸出到 JSON 檔案
+    dy-dl list -f user_videos.json https://www.douyin.com/user/MS4wLjABAAAAxxxxxxxxxxxxxxxx
+    ```
+
+### 全局選項
+
+*   **`-v, --verbose`**: 顯示詳細日誌輸出。
+*   **`-h, --help`**: 顯示幫助訊息。
+
+## 🔑 身份驗證 (Cookie)
+
+部分功能 (如下載某些受限影片或獲取完整的用戶列表) 可能需要登入狀態。使用 `dy-dl login` 命令登入後，Cookie 會被儲存。工具在執行需要驗證的操作時會自動載入儲存的 Cookie。您可以使用 `dy-dl check` 來確認 Cookie 的有效性。
+
+Cookie 預設儲存路徑會根據您的作業系統而有所不同 (通常在用戶設定或應用程式資料目錄下)。
+
+## 📄 授權條款
+
+本專案採用 [MIT](LICENSE) 授權條款。
+
+## 🤝 貢獻
+
+歡迎提交 Issue 或 Pull Request。
+
+---
+
+**免責聲明**: 本工具僅供學習和技術研究使用，請勿用於非法用途或侵犯版權。下載的內容版權歸原作者所有。

package/dist/bin/dydl.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/dydl.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cli_1 = require("../src/cli");
+// Logger level setting is now handled inside the Logger constructor
+// 運行 CLI 程序
+(async () => {
+    try {
+        await (0, cli_1.runCli)();
+    }
+    catch (error) {
+        console.error('CLI 執行錯誤:', error); // Keep error logging
+        process.exit(1);
+    }
+    // No finally block needed as logger level doesn't need explicit restoration for process exit
+})();
+//# sourceMappingURL=dydl.js.map

package/dist/bin/dydl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dydl.js","sourceRoot":"","sources":["../../bin/dydl.ts"],"names":[],"mappings":";;;AAEA,oCAAoC;AACpC,oEAAoE;AAEpE,YAAY;AACZ,CAAC,KAAK,IAAI,EAAE;IACV,IAAI,CAAC;QACH,MAAM,IAAA,YAAM,GAAE,CAAC;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,qBAAqB;QACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,6FAA6F;AAC/F,CAAC,CAAC,EAAE,CAAC"}

package/dist/src/cli/commands/check.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 檢查命令
+ * 提供 'dydl check' 命令的實現
+ */
+import { Command } from 'commander';
+/**
+ * 註冊檢查命令
+ * @param program Commander 實例
+ */
+export declare function registerCheckCommand(program: Command): void;

package/dist/src/cli/commands/check.js

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * 檢查命令
+ * 提供 'dydl check' 命令的實現
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCheckCommand = registerCheckCommand;
+// 使用 dynamic import 代替直接導入 ESM 模塊
+// import ora from 'ora';
+// import chalk from 'chalk';
+const fs_1 = __importDefault(require("fs"));
+const auth_1 = require("../../douyin/auth"); // Corrected path
+const logger_1 = require("../../utils/logger"); // Updated path to shared utils logger
+// import { cleanupBrowser } from '../../utils/browser'; // Removed old cleanup
+/**
+ * 註冊檢查命令
+ * @param program Commander 實例
+ */
+function registerCheckCommand(program) {
+    program
+        .command('check')
+        .description('檢查儲存的 Cookie 是否有效')
+        .argument('[cookie-path]', '要檢查的 cookie 檔案路徑', (0, auth_1.getDefaultCookiePath)())
+        .action(async (cookiePath) => {
+        logger_1.cliLogger.debug(`檢查命令執行，Cookie 路徑: ${cookiePath}`);
+        // 動態導入 ESM 模塊
+        const [{ default: ora }, { default: chalk }] = await Promise.all([
+            Promise.resolve().then(() => __importStar(require('ora'))),
+            Promise.resolve().then(() => __importStar(require('chalk')))
+        ]);
+        const spinner = ora('檢查 Cookie...').start();
+        try {
+            // 檢查檔案是否存在
+            if (!fs_1.default.existsSync(cookiePath)) {
+                spinner.fail(`Cookie 檔案不存在: ${cookiePath}`);
+                console.log(chalk.yellow(`請執行 ${chalk.cyan('dydl login')} 先登入抖音`));
+                return;
+            }
+            // 加載 Cookie
+            const cookie = await (0, auth_1.loadCookie)(cookiePath);
+            if (!cookie) {
+                spinner.fail(`Cookie 檔案為空: ${cookiePath}`);
+                return;
+            }
+            // 驗證 Cookie
+            spinner.text = '正在驗證 Cookie 有效性...';
+            const isValid = await (0, auth_1.isValidCookie)(cookie);
+            if (isValid) {
+                spinner.succeed(`Cookie 有效 (${cookiePath})`);
+            }
+            else {
+                spinner.fail(`Cookie 已過期或無效`);
+                console.log(chalk.yellow(`請執行 ${chalk.cyan('dydl login')} 重新登入抖音`));
+            }
+        }
+        catch (error) {
+            spinner.fail(`檢查 Cookie 時發生錯誤`);
+            const err = error instanceof Error ? error : new Error(String(error));
+            logger_1.cliLogger.error('檢查命令執行失敗:', err);
+            console.error(chalk.red(err.message));
+            process.exitCode = 1;
+        }
+        // Removed finally block with cleanupBrowser
+    });
+}
+//# sourceMappingURL=check.js.map

package/dist/src/cli/commands/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../../../src/cli/commands/check.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAeH,oDAkDC;AA9DD,kCAAkC;AAClC,yBAAyB;AACzB,6BAA6B;AAC7B,4CAAoB;AACpB,4CAAoF,CAAC,iBAAiB;AACtG,+CAAyD,CAAC,sCAAsC;AAChG,+EAA+E;AAE/E;;;GAGG;AACH,SAAgB,oBAAoB,CAAC,OAAgB;IACnD,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,mBAAmB,CAAC;SAChC,QAAQ,CAAC,eAAe,EAAE,kBAAkB,EAAE,IAAA,2BAAoB,GAAE,CAAC;SACrE,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE;QAC3B,kBAAM,CAAC,KAAK,CAAC,qBAAqB,UAAU,EAAE,CAAC,CAAC;QAEhD,cAAc;QACd,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;8DACxD,KAAK;8DACL,OAAO;SACf,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,GAAG,CAAC,cAAc,CAAC,CAAC,KAAK,EAAE,CAAC;QAE5C,IAAI,CAAC;YACH,WAAW;YACX,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC/B,OAAO,CAAC,IAAI,CAAC,iBAAiB,UAAU,EAAE,CAAC,CAAC;gBAC5C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACnE,OAAO;YACT,CAAC;YAED,YAAY;YACZ,MAAM,MAAM,GAAG,MAAM,IAAA,iBAAU,EAAC,UAAU,CAAC,CAAC;YAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,CAAC,IAAI,CAAC,gBAAgB,UAAU,EAAE,CAAC,CAAC;gBAC3C,OAAO;YACT,CAAC;YAED,YAAY;YACZ,OAAO,CAAC,IAAI,GAAG,oBAAoB,CAAC;YACpC,MAAM,OAAO,GAAG,MAAM,IAAA,oBAAa,EAAC,MAAM,CAAC,CAAC;YAE5C,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,OAAO,CAAC,cAAc,UAAU,GAAG,CAAC,CAAC;YAC/C,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;gBAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC;YACtE,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAChC,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACtE,kBAAM,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;YAC/B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;YACtC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;QACD,4CAA4C;IAC9C,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/src/cli/commands/info.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 資訊命令
+ * 提供 'dydl info' 命令的實現
+ */
+import { Command } from 'commander';
+/**
+ * 註冊資訊命令
+ * @param program Commander 實例
+ */
+export declare function registerInfoCommand(program: Command): void;

package/dist/src/cli/commands/info.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * 資訊命令
+ * 提供 'dydl info' 命令的實現
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerInfoCommand = registerInfoCommand;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const utils_1 = require("../utils");
+const manager_1 = require("../../douyin/browser/manager");
+const parser_1 = require("../../douyin/parser");
+const info_1 = require("../../douyin/info");
+/**
+ * 註冊資訊命令
+ * @param program Commander 實例
+ */
+function registerInfoCommand(program) {
+    program
+        .command('info')
+        .description('獲取抖音影片的詳細資訊')
+        .argument('<sources...>', '影片連結或包含連結的文本')
+        .option('-c, --cookie <path>', '指定包含有效 Cookie 的檔案路徑')
+        .option('--user-data-dir <path>', '指定 Puppeteer 使用者資料目錄')
+        .option('-f, --file <path>', '將結果輸出為 JSON 檔案的路徑')
+        .action(async (sources, options) => {
+        const outputFile = options.file;
+        const cookiePath = options.cookie;
+        const userDataDir = options.userDataDir;
+        // --- 輸出控制 ---
+        const isSilent = !outputFile; // Determine if silent mode is needed
+        // Silent logic for logger is now handled in logger constructor
+        let browser = null;
+        try {
+            // 1. 檢查 Cookie
+            // checkAndGetCookie will respect silent mode if console is overridden at entry point
+            const cookie = await (0, utils_1.checkAndGetCookie)(cookiePath, isSilent); // Pass isSilent
+            if (!cookie) {
+                // Error message is handled inside checkAndGetCookie (if not silent)
+                // or just exits silently if silent. We still need to set exit code.
+                // Use console.error directly as it's not overridden
+                console.error('錯誤：缺少有效的 Cookie，無法獲取資訊。');
+                console.error(`請執行 'dydl login' 登入抖音並取得 Cookie`);
+                process.exitCode = 1;
+                return;
+            }
+            // 2. 啟動瀏覽器
+            browser = await (0, manager_1.launchBrowser)({ headless: 'new', userDataDir });
+            const page = await (0, manager_1.newPage)(browser);
+            await (0, manager_1.setCookiesOnPage)(page, cookie, '.douyin.com');
+            // 3. 解析連結
+            const combinedText = sources.join(' ');
+            const parseResults = await (0, parser_1.parseDouyinLinks)(combinedText, { concurrency: 3 }); // Use default concurrency for now
+            if (parseResults.length === 0) {
+                console.error('錯誤：未在輸入中找到有效的抖音影片連結。');
+                process.exitCode = 1;
+                return; // Exit early
+            }
+            const videoUrls = parseResults.map(r => r.standardUrl);
+            // 4. 獲取影片資訊
+            const videoInfos = await (0, info_1.fetchVideosInfoUrls)(videoUrls, page, { concurrency: 3 }); // Use default concurrency
+            if (videoInfos.length === 0) {
+                console.error('錯誤：無法獲取任何影片的詳細資訊。');
+                process.exitCode = 1;
+                return;
+            }
+            // 5. 準備結果 (單個物件或陣列)
+            const result = videoInfos.length === 1 ? videoInfos[0] : videoInfos;
+            // 6. 輸出結果
+            if (outputFile) {
+                // 輸出到檔案
+                try {
+                    const outputDir = path_1.default.dirname(outputFile);
+                    await fs_extra_1.default.ensureDir(outputDir);
+                    await fs_extra_1.default.writeJson(outputFile, result, { spaces: 2 });
+                    // No console output if writing to file successfully
+                }
+                catch (error) {
+                    // Always output critical errors to stderr
+                    console.error(`錯誤：無法寫入 JSON 檔案 ${outputFile}:`, error);
+                    process.exitCode = 1;
+                }
+            }
+            else {
+                // 輸出到控制台
+                // Ensure only this JSON is printed
+                process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+            }
+        }
+        catch (error) {
+            // Always output critical errors to stderr
+            console.error('獲取影片資訊過程中發生錯誤:', error);
+            process.exitCode = 1;
+        }
+        finally {
+            if (browser) {
+                await (0, manager_1.closeBrowser)(browser);
+            }
+            // Console restore logic moved to bin/dydl.ts
+        }
+    });
+}
+//# sourceMappingURL=info.js.map

package/dist/src/cli/commands/info.js.map

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

package/dist/src/cli/commands/list.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 列表命令
+ * 提供 'dydl list' 命令的實現，用於獲取用戶影片列表
+ */
+import { Command } from 'commander';
+/**
+ * 註冊列表命令
+ * @param program Commander 實例
+ */
+export declare function registerListCommand(program: Command): void;

package/dist/src/cli/commands/list.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * 列表命令
+ * 提供 'dydl list' 命令的實現，用於獲取用戶影片列表
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerListCommand = registerListCommand;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const utils_1 = require("../utils");
+const user_1 = require("../../douyin/info/user"); // Correct path
+/**
+ * 註冊列表命令
+ * @param program Commander 實例
+ */
+function registerListCommand(program) {
+    program
+        .command('list')
+        .description('獲取指定抖音使用者發布的影片列表')
+        .argument('<user_profile_url>', '使用者的個人頁面連結 (僅支援單個)')
+        .option('-c, --cookie <path>', '指定包含有效 Cookie 的檔案路徑')
+        .option('--user-data-dir <path>', '指定 Puppeteer 使用者資料目錄 (主要用於 Cookie 相關操作)')
+        .option('-f, --file <path>', '將結果輸出為 JSON 檔案的路徑')
+        .option('-n, --count <number>', '指定獲取影片的數量 (預設獲取全部)', '0') // Default to '0' for all
+        .action(async (userProfileUrl, options) => {
+        // --- 輸入驗證 ---
+        // Commander's .argument('<arg>') handles the presence of the argument.
+        // We need to ensure only one URL is conceptually passed, although commander collects extras in program.args
+        // A simple check on the input argument itself is sufficient here as we define only one.
+        // If multiple URLs were intended, we'd use '<urls...>' and check options.args length.
+        const outputFile = options.file;
+        const cookiePath = options.cookie;
+        const userDataDir = options.userDataDir; // Keep for consistency, might be used by cookie logic
+        const count = parseInt(options.count, 10);
+        if (isNaN(count) || count < 0) {
+            console.error('錯誤：--count 參數必須是一個非負整數。');
+            process.exitCode = 1;
+            return;
+        }
+        // --- 輸出控制 ---
+        const isSilent = !outputFile; // Determine if silent mode is needed
+        // Silent logic for logger is now handled in logger constructor
+        try {
+            // 1. 檢查 Cookie, pass silent flag
+            const cookie = await (0, utils_1.checkAndGetCookie)(cookiePath, isSilent); // Pass isSilent // userDataDir might be implicitly used here if cookiePath is null
+            if (!cookie) {
+                // Error message is handled inside checkAndGetCookie (if not silent)
+                // or just exits silently if silent. We still need to set exit code.
+                process.exitCode = 1; // Ensure exit code is set even if silent
+                return;
+            }
+            // 2. 獲取用戶影片列表
+            // Pass an empty options object to fetchUserVideos to avoid triggering onProgress
+            const userVideos = await (0, user_1.fetchUserVideos)(userProfileUrl, cookie, count, {});
+            // 3. 輸出結果
+            if (outputFile) {
+                // 輸出到檔案
+                try {
+                    const outputDir = path_1.default.dirname(outputFile);
+                    await fs_extra_1.default.ensureDir(outputDir);
+                    await fs_extra_1.default.writeJson(outputFile, userVideos, { spaces: 2 });
+                    // No console output on success
+                }
+                catch (error) {
+                    console.error(`錯誤：無法寫入 JSON 檔案 ${outputFile}:`, error);
+                    process.exitCode = 1;
+                }
+            }
+            else {
+                // 輸出到控制台
+                process.stdout.write(JSON.stringify(userVideos, null, 2) + '\n');
+            }
+        }
+        catch (error) {
+            // Handle errors from checkAndGetCookie or fetchUserVideos
+            console.error('獲取用戶影片列表過程中發生錯誤:', error);
+            process.exitCode = 1;
+        }
+        // Console restore logic moved to bin/dydl.ts
+    });
+}
+//# sourceMappingURL=list.js.map

package/dist/src/cli/commands/list.js.map

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

package/dist/src/cli/commands/login.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 登入命令
+ * 提供 'dydl login' 命令的實現
+ */
+import { Command } from 'commander';
+/**
+ * 註冊登入命令
+ * @param program Commander 實例
+ */
+export declare function registerLoginCommand(program: Command): void;

package/dist/src/cli/commands/login.js

@@ -0,0 +1,158 @@
+"use strict";
+/**
+ * 登入命令
+ * 提供 'dydl login' 命令的實現
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerLoginCommand = registerLoginCommand;
+// 使用 dynamic import 代替直接導入 ESM 模塊
+// import ora from 'ora';
+// import chalk from 'chalk';
+const auth_1 = require("../../douyin/auth"); // Corrected path, import LoginOptions
+const auth_2 = require("../../douyin/auth"); // Corrected path (getDefaultCookiePath is in auth)
+const logger_1 = require("../../utils/logger"); // Updated path to shared utils logger
+const browser_1 = require("../../utils/browser"); // Updated path to shared utils
+const fs = __importStar(require("fs")); // 引入 fs 模組用於讀取檔案
+/**
+ * 註冊登入命令
+ * @param program Commander 實例
+ */
+function registerLoginCommand(program) {
+    program
+        .command('login')
+        .description('登入抖音並儲存 Cookie')
+        .argument('[cookie-path]', '儲存 cookie 的檔案路徑', (0, auth_2.getDefaultCookiePath)())
+        .option('-l, --load-cookie <cookie>', '載入初始 Cookie (可以是字串或檔案路徑)')
+        .action(async (cookiePath, options) => {
+        logger_1.cliLogger.debug(`登入命令執行，Cookie 儲存路徑: ${cookiePath}`);
+        logger_1.cliLogger.debug(`CLI 選項: ${JSON.stringify(options)}`);
+        // 動態導入 ESM 模塊 (移到最前面)
+        const [{ default: ora }, { default: chalk }] = await Promise.all([
+            Promise.resolve().then(() => __importStar(require('ora'))),
+            Promise.resolve().then(() => __importStar(require('chalk')))
+        ]);
+        let initialCookieString = undefined;
+        // --- 處理 --load-cookie 選項 ---
+        if (options.loadCookie) {
+            const loadCookieValue = options.loadCookie;
+            try {
+                // 嘗試判斷是否為檔案路徑
+                if (fs.existsSync(loadCookieValue) && fs.statSync(loadCookieValue).isFile()) {
+                    logger_1.cliLogger.info(`偵測到 --load-cookie 為檔案路徑，正在讀取: ${loadCookieValue}`);
+                    initialCookieString = fs.readFileSync(loadCookieValue, 'utf-8').trim();
+                    if (initialCookieString) { // 檢查是否已定義
+                        logger_1.cliLogger.debug(`從檔案讀取的 Cookie: ${initialCookieString.substring(0, 50)}...`); // 只記錄部分 Cookie
+                    }
+                }
+                else {
+                    logger_1.cliLogger.info(`將 --load-cookie 視為 Cookie 字串`);
+                    initialCookieString = loadCookieValue.trim();
+                }
+            }
+            catch (err) {
+                const readErr = err instanceof Error ? err : new Error(String(err));
+                logger_1.cliLogger.error(`處理 --load-cookie (${loadCookieValue}) 時發生錯誤: ${readErr.message}`);
+                // 在這裡使用 chalk 前確保它已被載入
+                console.error(chalk.red(`錯誤：無法讀取或處理 --load-cookie 指定的值: ${loadCookieValue}`));
+                process.exit(1);
+            }
+        }
+        // --- 結束處理 --load-cookie 選項 ---
+        // --- 自動載入 cookiePath (如果存在且未通過 --load-cookie 指定) ---
+        if (initialCookieString === undefined) {
+            try {
+                if (fs.existsSync(cookiePath) && fs.statSync(cookiePath).isFile()) {
+                    logger_1.cliLogger.info(`未指定 --load-cookie，但找到現有 Cookie 檔案，正在載入: ${cookiePath}`);
+                    initialCookieString = fs.readFileSync(cookiePath, 'utf-8').trim();
+                    if (initialCookieString) {
+                        logger_1.cliLogger.debug(`從檔案 ${cookiePath} 讀取的 Cookie: ${initialCookieString.substring(0, 50)}...`);
+                    }
+                    else {
+                        logger_1.cliLogger.warn(`現有 Cookie 檔案 ${cookiePath} 為空`);
+                    }
+                }
+            }
+            catch (err) {
+                const readErr = err instanceof Error ? err : new Error(String(err));
+                logger_1.cliLogger.warn(`嘗試自動載入現有 Cookie 檔案 ${cookiePath} 時發生錯誤: ${readErr.message}`);
+                // 不終止程序，允許繼續無初始 Cookie 的登入
+            }
+        }
+        // --- 結束自動載入 cookiePath ---
+        const spinner = ora('準備登入抖音...').start();
+        try {
+            spinner.info(`即將開啟瀏覽器，請在瀏覽器中完成登入`);
+            spinner.text = '等待登入中，請在瀏覽器中完成登入...';
+            spinner.start();
+            // 準備登入選項
+            const loginOpts = {
+                initialCookie: initialCookieString,
+                // 可以根據需要從 CLI 選項傳遞其他參數，例如 headless
+                // headless: options.headless // 假設有 --headless 選項
+            };
+            // 執行登入，傳遞儲存路徑和選項
+            const cookie = await (0, auth_1.login)(cookiePath, loginOpts);
+            // login 函數現在可能返回 string 或 LoginResult，但在此 CLI 情境下，autoCleanup 預設為 true，應只返回 string
+            if (typeof cookie === 'string' && cookie) {
+                spinner.succeed(`登入成功！Cookie 已儲存至 ${cookiePath}`);
+                console.log(chalk.green('✔') + ' 現在可以使用其他命令下載影片');
+            }
+            else {
+                spinner.fail('登入失敗，未能獲取有效的 Cookie');
+            }
+        }
+        catch (error) {
+            spinner.fail('登入過程中發生錯誤');
+            const err = error instanceof Error ? error : new Error(String(error));
+            logger_1.cliLogger.error('登入命令執行失敗:', err);
+            // 在這裡使用 chalk 前確保它已被載入
+            console.error(chalk.red(err.message));
+            process.exitCode = 1;
+        }
+        finally {
+            // 確保在登入完成後清理瀏覽器資源，讓程序可以正常退出
+            try {
+                await (0, browser_1.cleanupBrowser)();
+                logger_1.cliLogger.debug('已清理瀏覽器資源');
+            }
+            catch (cleanupError) {
+                const err = cleanupError instanceof Error ? cleanupError : new Error(String(cleanupError));
+                logger_1.cliLogger.error('清理瀏覽器資源失敗:', err);
+            }
+        }
+    });
+}
+//# sourceMappingURL=login.js.map