CeJS 線上小說漫畫下載工具 online novels / comics downloader

• [en] Download novels → epub and comics with GUI and command-line interface.
• [TW] 批量下載小說 → epub、漫畫網站的工具。視窗+命令行介面。
• [CN] 批量下载小说 → epub、漫画网站的网络爬虫。图形+命令行界面。
• [ja] ウェブ小説 → epub、ウェブ漫画作品を一括ダウンロードツール。グラフィカル+コマンドラインインターフェース。

TOC 快速瀏覽

• Installation 安裝
  • Lazy installation 懶人安裝法
• Execution 執行

Features 特點

• 可自動下載小說封面以及章節中的插圖。
• 自動檢核下載的圖片是否是否完整。若有破損將重新下載。
• 採用 CeJS 線上作品爬蟲程式庫來製作 crawler，可自行配置與設定。
• 對於漫畫，下載完畢後可以章節為單位自動產生壓縮檔，並自動刪除下載目錄原始圖檔/清除暫存檔。每次下載前將自動讀取壓縮檔資料，僅更新有問題的圖檔。（請注意：必須先安裝 7-Zip 18.01 以上的版本）

Supported sites 已完成之網站工具

• For novels, please install 7-Zip command-line version first. 請注意：必須先安裝 7-Zip 18.01 以上的版本，這樣才能製作 .epub 小說電子書、壓縮漫畫章節。
• 各線上作品網站往往不時改版（更改結構），同時造成本工具無法正常作動；因此若有無法正常運作的情況請見諒，這通常得要更改原始碼方能回復正常。

已撰寫完的各大小說漫畫網站工具包括：

Japanese web fictions / Japanese light novels ライトノベル 日本輕小說 日本のオンライン小説

novel.ja-JP/*.js, web pages → epub

Chinese web fictions / novels **内地小说 **のオンライン小説

novel.cmn-Hans-CN/*.js, web pages → epub

• 中國大陸之小說文字常常會被審查而消失、變造。例如黑名單關鍵字轉為拉丁字母或是打星號，以及數字 0 改成 o、9 改成 q 等等。有時需要多下載幾個網站的文件再做比較。

Chinese webcomics **内地漫画 **のウェブコミック

comic.cmn-Hans-CN/*.js, images → zip

• 本工具無法下載需VIP付費、已屏蔽或刪除的內容。

English webcomics 英語網路漫畫 英語のウェブコミック

comic.en-US/*.js, images → zip

Installation 安裝

若是想要使用圖形介面，您可以 直接下載安裝包，惟 安裝包並非最新的版本，有些網站下載起來會出問題。若是欲採用最新的版本，或者用作研究開發、想要使用命令行介面作批次處理，請採用下列步驟。

Lazy installation 懶人安裝法

為了想趕快嘗鮮的您～

1. 先安裝 Node.js 與 7-Zip 18.01 以上的版本。（已經安裝過的可以跳過）

2. 下載本工具壓縮檔並解壓縮，應能得到 work_crawler-master 目錄；這將是本工具將安裝的標的目錄，若有需要亦可將之改名。

3. 下載 CeJS 安裝檔 _CeL.updater.node.js。（點擊本行可獲得更詳細的說明）

   下載 CeJS 安裝檔 _CeL.updater.node.js，將此檔儲存到前面所提到的，本工具將安裝的標的目錄 work_crawler-master 下。

   

4. 下載 CeJS 程式庫：在命令行介面下執行 _CeL.updater.node.js。

   1. 進入命令行介面下：

      • Windows 10 下，請按下⊞ Windows鍵 + X → 選擇 命令提示字元。（如下圖的示範）
      • Windows 7 下打開命令行介面，請從 開始 → 所有程式 → 附屬應用程式 → 選擇 命令提示字元

      

   2. 進到本工具安裝的目錄：

      • 若是您視窗的 背景為藍色，表示您使用的可能是 PowerShell，您應該使用這種形式的指令來切換目錄：cd "本工具安裝的目錄"。
      • 若是您視窗的 背景為黑色，表示您使用的可能是 命令行介面，您應該使用這種形式的指令來切換目錄：cd/d "本工具安裝的目錄"（cd/d 表示「同時變更工作磁碟機及其工作目錄」的意思）。

      下圖中示範了用命令行介面切換到 I:\work_crawler-master 的情況：

      

   3. 執行命令以下載 CeJS 程式庫：

      node _CeL.updater.node.js

      

5. 然後就能開始試用囉。

   下載 CeJS 程式庫後本工具安裝的目錄看起來的樣子：

   

   以下是在linux下直接操作上述作業時的指令，Windows用戶可以跳過，直接開始試用。

   # sample commands to extract work_crawler + cejs
   mkdir work_crawler
   cd work_crawler
   wget --output-document=work_crawler.zip https://github.com/kanasimi/work_crawler/archive/master.zip
   unzip work_crawler.zip
   cd work_crawler-master
   wget --output-document=_CeL.updater.node.js https://raw.githubusercontent.com/kanasimi/CeJS/master/_for%20include/_CeL.updater.node.js
   node _CeL.updater.node.js

6. 若是您將 CeJS 放置在其他目錄底下，您可以從 _CeL.path.txt 這個檔案來設定放置的路徑。
7. 您可設定 work_crawler_loder.configuration.js 以指定下載的檔案要放置的標的目錄。 (see work_crawler_loder.js)
8. 每次要更新到最新 CeJS 程式庫時，只要重新執行一次 CeJS 安裝檔即可。

   node _CeL.updater.node.js

   通常您還需要 重新下載本工具壓縮檔並解壓縮。由於本工具會 cache 作品資訊，更新幅度較大的時候您可能需要刪除作品目錄的 cache，重新下載作品。

Setup GUI 設定視窗型態介面

若是您在作研究開發時，希望使用圖形使用者介面，那麼您還需要安裝 Electron。

1. 請在命令行介面下，進到本工具安裝的目錄，執行命令以安裝 Electron 程式庫：

   npm i -D electron@latest

2. 在本工具安裝的目錄下，執行 start_gui_electron.sh 或 start_gui_electron.bat。

   

Normal installation 一般正常安裝方法

1. Please see Node.js usage section at CeJS for detail.
2. Setup _CeL.path.txt if necessary.
3. Setup work_crawler_loder.configuration.js (see work_crawler_loder.js). 最後設定好設定檔 work_crawler_loder.configuration.js。例如指定 global.data_directory。

Execution 執行

所有操作都必須進到工具檔所在的目錄，在命令行介面下執行。

1. 確認要下載的網站名與作品名。之後在命令行介面下，執行：（請在作品的名稱外面加上引號）

   node 工具檔名.js "作品名" [option=true] [option=value]
   node 工具檔名.js "l=作品列表檔案名" [option=true] [option=value]

   e.g.,

   cd comic.cmn-Hans-CN && node qq.js "狐妖小红娘" skip_error=true
   cd novel.cmn-Hans-CN && node qidian free && echo 下载 起点中文网限免作品
   cd novel.cmn-Hans-CN && node 23us "斗罗大陆Ⅲ龙王传说"
   cd comic.cmn-Hans-CN && node 2manhua "大主宰" recheck=true
   cd comic.cmn-Hans-CN && node ikanman "l=ikanman.txt" recheck=true
   cd novel.cmn-Hans-CN && echo "via id" && node 630book "267"
   cd novel.ja-JP       && node yomou "転生したらスライムだった件"

   

2. 下載的檔案將放在設定檔 work_crawler_loder.configuration.js 的 global.data_directory 所設定的目錄下。若採懶人安裝法，則預設放在解壓縮後工具檔所在的目錄下。

3. 若是下載出錯，重新執行即可接續下載。

Workflow 工作流程

• 本工具將把所指定的漫畫下載至特定目錄中（預設為工具檔名，如 manhuatai），每套漫畫一個目錄。

  

  

  

• 接續下載時，將從上次的進度（最後下載的章節）接著下載。

  

• 若是下載小說，最後將包裝成可匯入 calibre 的 epub。

  

  

Uninstallation 移除

• 若是您採用安裝包，請利用系統的移除介面。否族要移除本工具，只需將解壓縮後工具檔所在的目錄整個刪除即可。
• 作品下載的標的目錄（存放圖片檔與紀錄檔的目錄）需另外手動刪除。

FAQ 常見問題集

Notes 附注

• 目前本工具不支援自動更新。
• 對於本工具已經包含的下載模式，熟練後一般約需2至4小時新增或更新下載工具，以達初步可用狀態。
• 小說作品採用單線程下載，以避免對網站造成過度的負荷。漫畫作品則以章節為單位多線程下載，每個章節的圖片下載完畢之後，再接著下一個章節。
• 歡迎熱心友人參與開發，以改進這個工具。

Purpose 公開目的

• 示範如何使用 CeJS 之 線上作品爬蟲程式庫 (module) 批量下載各線上小說漫畫網站。
• 展示程式撰寫當時，各線上小說漫畫網站之網站資料結構。
• 提供離線瀏覽小說漫畫功能，以利個人化閱覽方式。增進閱覽體驗、掌控閱覽環境。
• 增加對閱讀權的掌控能力，預防暫時無法連接網頁，或者數十年後找不到記憶中閱覽過的作品。

非常歡迎提供使用意見與改善建議。

Announce 聲明

• 本工具僅供同好學習和研究，嚴禁傳播或用於任何商業、非法用途！請小心利用本工具。所下載或備分之內容版權屬原作者所有，請勿公開散布傳播。利用本工具可能引起的任何糾紛或損失損害，本人恕不負責。