• [en] Tools to download novels (→ epub) and comics.
• [TW] 批量下載小說 (→ epub)、漫畫網站作品的工具。
• [CN] 批量下载小说 (→ epub)、漫画网站作品的网络爬虫。
• [ja] ウェブ小説 (→ epub)、ウェブ漫画作品を一括ダウンロードツール。

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

Welcome to join the translating project! 一緒に翻訳しましょう！

• 最愛作品清單功能。
• 一鍵搜尋各網站與下載作品。
• 可將簡體小說轉換為繁體小說。
• 自動下載小說封面以及章節中的插圖。
• 小說漫畫自動分部(part)。
• 盡量取得原有的圖片檔案中最高品質的，並自動檢核下載的圖片是否是否完整。若有破損將重新下載。
• 跨平臺支援：支援 Windows, Linux, Mac。
• 採用 CeJS 網路作品爬蟲程式庫來製作 crawler，可自行配置與設定。
• 對於漫畫，下載完畢後可以章節為單位自動產生壓縮檔，並自動刪除下載目錄原始圖檔/清除暫存檔。每次下載前將自動讀取壓縮檔資料，僅更新有問題的圖檔。（👉請注意：必須先安裝 7-Zip 18.01 以上的版本）

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

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

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

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

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

comic.cmn-Hant-TW/*.js, images → zip

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

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

comic.ja-JP/*.js, images → zip

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

若是想要使用系統安裝的方法，或者您的系統並未提供命令列介面，您可以 直接下載📦安裝包，並且安裝 7-Zip 18.01 以上的版本。惟 安裝包不含最新的功能，有些網站下載起來會出問題。安裝包現在落後最新測試版修正次數：。欲採用最新版本，或研究開發、想要使用命令列介面作批次處理，請採用下列步驟。

為了想趕快嘗鮮的您～

1. 先安裝 node.js 與 7-Zip 18.01 以上的版本。已經安裝過的可以跳過。Node.js 用以執行本工具。7-Zip 在更新本工具，或者打包漫畫章節，以及製作電子書時使用。

2. 下載並儲存本工具安裝檔 work_crawler.updater.js（按右鍵另存新檔）。本工具安裝檔 預設會將所有組件放在 work_crawler-master 目錄下。

3. 在命令列介面下以 Node.js 執行安裝檔 `work_crawler.updater.js`。（本安裝檔不能直接點擊兩下執行。點擊本行可獲得更詳細的說明。）

   1. 進入命令列介面下：

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

      

   2. 進到本工具安裝檔 work_crawler.updater.js 所在的目錄：

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

   3. 執行命令以下載最新版本組件（本安裝檔必須以 node 執行， 不能直接點擊兩下執行。）：

      node work_crawler.updater.js

   4. 執行完畢後，除了 work_crawler-master 這個目錄，還會出現一些附屬檔案。這些檔案是幫助更新用的，就算刪除也不會影響程式運行或更新。

4. 然後就能開始試用囉。若是您希望使用圖形使用者介面，請執行 work_crawler-master 目錄下面的 start_gui_electron.bat 或 start_gui_electron.sh。

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

   

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

   # sample commands to extract work_crawler + cejs
   curl -O https://raw.githubusercontent.com/kanasimi/work_crawler/master/work_crawler.updater.js
   # wget https://raw.githubusercontent.com/kanasimi/work_crawler/master/work_crawler.updater.js
   node work_crawler.updater.js

5. 若是您將 CeJS 放置在其他目錄底下，您可以從 _repository_path_list.txt 這個檔案來設定放置的路徑。

6. 您可設定 work_crawler.configuration.js 以指定 所有網站採用之預設主要下載目錄，所下載的作品檔案預設會放置到此主要目錄之工具檔名稱底下。簡便的方法是：

   1. 將 work_crawler.default_configuration.js 改名成 work_crawler.configuration.js。只要在 work_crawler.configuration.js 檔案裡面，已將所有選項設定好；那麼是否有 work_crawler.default_configuration.js 並不影響程式運作，請不用擔心。
   2. 直接用文字編輯器打開 work_crawler.configuration.js，找到 global.data_directory = ''; 這一段，把引號中改成您要的 所有網站採用之預設主要下載目錄；例如：

      global.data_directory = 'D:\\web_works\\';

      請記得在引號中，目錄分隔號必須輸入兩次！ 這不會影響到您之前曾手動改變過的標的目錄。

7. 每次要更新到最新版本時，只要進到工具安裝檔所在目錄，重新執行一次本工具安裝檔即可。

   node work_crawler.updater.js

   由於本工具會 cache 作品資訊，更新幅度較大的時候，新程式可能無法讀取這些舊格式的 cache，會產生錯誤；此時您需要刪除下載目錄中所有的 cache，重新下載作品。這些 cache 包括 search.json, servers.json 以及作品目錄下面，以作品名稱為名的 .json 檔案。

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

若是您在作研究開發時，希望使用圖形使用者介面，那麼您還需要安裝 Electron。若是您採用懶人安裝法，應該已經安裝過 Electron，可以直接採用圖形使用者介面。

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

   npm i -D electron@latest

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

   

   視窗型態介面支援不同語系：

   有許多可調整的下載選項：

   可選用暗色系主題：

   能一鍵搜尋各網站與下載作品： 搜尋名稱用於跨網站。僅能搜尋作品名稱，無法搜尋作品ID。假如您已知作品id，可以直接在最愛作品清單輸入id，用不著搜尋。

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

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 "斗罗大陆Ⅲ龙王传说" proxy=localhost:8080
   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 && node 630book "267" && echo "via id"
   cd novel.ja-JP       && node yomou "転生したらスライムだった件"

   

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

3. 本工具會循序下載每個章節，對於漫畫基本上每個章節的圖片會並行下載。不可並行下載同一個網站的同一個作品，否則會出現衝突。若是想要並行下載不同網站或是不同的作品，那麼您就需要再開一個命令列介面來執行工具檔。

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

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

  

• 預設每個章節一個壓縮檔。

  

• 若設定不壓縮章節圖片，則每個章節一個目錄。

  

  

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

  

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

  

  

• 若是您採用📦安裝包，請利用系統正規的移除方法或移除介面。否則要移除本工具，只需先備份好之前下載過的漫畫，之後將解壓縮後工具檔所在的目錄整個刪除即可。
• 作品下載的標的目錄（存放圖片檔與紀錄檔的目錄）需另外手動刪除。

• 對於本工具已經包含的下載模式，熟練後一般約需2至4小時新增或更新下載工具，以達初步可用狀態。
• 小說作品採用單線程下載，以避免對網站造成過度的負荷。漫畫作品則以章節為單位多線程下載，每個章節的圖片下載完畢之後，再接著下一個章節。
• 若可能，您應該檢核並參與維護您需要的軟體。現在您可以參與本工具開發了！本工具歡迎熱心友人參與開發，以改進這個工具。

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

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

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

Contact us at GitHub.