QuarkPanTool：把夸克雲端硬碟的轉存、分享、下載收進命令列

用 AI 摘要這篇文章：

ChatGPT Claude Perplexity Google Grok

用過夸克雲端硬碟（官方名稱夸克網盤）的人都碰過同一種牆：同樣一顆檔案，從網頁版下載有大小限制，裝了官方用戶端就通了；同樣一個帳號，免費會員與付費會員拿到的速度不同。這道牆很少畫在功能本身，多數畫在「你用什麼身分敲它的介面」。開源工具 QuarkPanTool 值得認識的地方，就在於它把這件事講得很白：它的核心絕招，是在伺服器拒絕時把自己偽裝成官方桌面版再敲一次門。這一招在 2025 年為它贏得大量下載，到了 2026 年則變成一場還在進行的拉鋸。

先說定位。這是一支主檔 899 行的 Python 命令列工具，出自 GitHub 帳號 ihmily（作者署名 Hmily），2024 年 3 月開張，用 Apache-2.0 授權，到 2026 年 9 月累積約一千四百顆星、一百六十多次 fork。它做三件事：把別人分享的檔案批次轉存進自己的雲端硬碟、把自己雲端硬碟裡的資料夾批次產生分享連結、把已經在自己帳號裡的檔案批次下載到本機。三件事共用一個文字選單，跑起來像上個時代的 DOS 小程式，沒有視窗介面。

Pin

Pin

六個選項，對應一條資源整理線

執行 python quark.py 之後，畫面上是六個編號選項，按下去分別是轉存、批次分享、切換保存目錄、建立資料夾、下載、重新登入。單看清單像功能表，實際對照原始碼與官方釋出包裡的使用說明，它其實把「資源整理」的整條動線都排進去了。

轉存是入口。把分享連結一行一條寫進 url.txt，選單就會逐條讀取、列出檔案與資料夾數量、送出轉存任務並輪詢結果，全部完成後回報儲存在哪個資料夾。分享連結帶密碼的場合，在網址後面補上 pwd 參數即可，工具會自己帶入。它也會在送出任務後檢查容量，空間不夠時停下來提醒你注意已經成功的數量，避免重複轉存把配額吃光。

分享是出口。選擇批次產生分享連結時，可以指定效期（一天、七天、三十天或永久）、是否加密、要不要自動產生隨機密碼，以及遍歷深度：只分享根目錄、把一級資料夾逐一分享，或下探到二級資料夾。結果寫進 share 資料夾裡的 share_url.txt，每行一條完整連結；失敗的項目另有紀錄檔，下輪可以針對失敗清單重試。有個細節官方說明寫得明白：批次分享只對資料夾生效，散裝檔案會被略過。想分享單一檔案，得自己包一層資料夾。

下載這格的規則最容易被誤解。它不能直接抓別人的分享連結，原始碼裡有明確檢查：檔案必須已經在你自己的雲端硬碟裡。實際流程是先轉存、再從自己的帳號對那個檔案建立分享連結、把連結貼回工具，它才會逐檔抓下來，存進 downloads 資料夾並保留原本的資料夾層級。換句話說，下載功能是替「自己的檔案搬回本機」設計的，與俗稱的離線下載器不同路。

翻開 quark.py 還會看到一個說明文件沒提的細節：轉存任務的輪詢之間固定插入零點五到一秒的隨機延遲，批次分享的每個資料夾之間則間隔零點五到兩秒。這些數字不寫在任何文件裡，但意圖很清楚：讓批次操作的節奏接近真人手動操作，降低一口氣幾百個請求觸發平台風控的機率。

登入交給真的瀏覽器，Cookie 留在自己機器上

這類工具最老派的門檻是抓 Cookie：登入網頁版、打開開發者工具、複製一長串字串貼進設定檔，過期再重來一遍。QuarkPanTool 用 Playwright 把這一步整個包掉。第一次執行時它會開一個真的 Firefox 視窗，讓你手動登入夸克帳號，登入完成回到終端機按 Enter，瀏覽器自動關閉，登入狀態存進 config 資料夾裡的 cookies.txt，之後執行不必再登入。Linux 環境沒有這套互動，官方建議自行從網頁取得 Cookie 填入同一個檔案；要換帳號，選單上的重新登入會清掉舊狀態。

信任邊界也值得攤開看。我把它全案的對外連線掃過一遍：寫死在原始碼裡的介面端點只指向 drive-pc.quark.cn、drive.quark.cn、pan.quark.cn 三個夸克自家網域，沒有任何第三方統計、更新檢查或遙測端點，檔案本體的下載位址也由官方介面回傳，依賴清單裡也只有 HTTP 請求庫、表格與進度條這類純工具庫。帳號 Cookie 只存在你自己的磁碟上，不經過任何中間伺服器。這個乾淨程度在同類閉源工具裡很難驗證，在這裡是可以自己翻原始碼確認的事實。

兩個但書。cookies.txt 等同帳號鑰匙，誰拿到這個檔案誰就能操作你的雲端硬碟，共用電腦上要特別小心；原始碼讀回這個檔案時用的是 Python 的 eval 函數，檔案內容若被其他程式竄改，理論上會以你的身分執行任意程式碼，這在單人使用的電腦上風險很低，但知道這條界線比不知道好。另外，官方釋出的 Windows 執行檔是打包好的二進位，解壓後近五百個檔案、三百多 MB，你要嘛選擇相信作者的打包，要嘛用公開的原始碼自己裝 Python 環境跑，兩種信任程度不同。這和微信影片下載工具那種要植入根憑證的作法相比溫和許多：這支工具不裝憑證、不開代理，只是拿你登入後的 Cookie 直接呼叫官方介面。

下載限速這件事：一行 User-Agent 的貓鼠遊戲

README 對下載功能的描述很吸睛，作者宣稱已經繞過網頁版的檔案大小下載限制、不需要 VIP。翻到原始碼的下載函式，實作比傳聞樸素得多：工具先用一般瀏覽器的身分請求下載網址，伺服器若回傳代表資格不符的錯誤碼，就換上夸克官方桌面版的身分字串（帶 quark-cloud-drive 版號與 Electron 版號的 User-Agent）再試一次，第二回成功就把檔案串流下來。整段邏輯就是一個重試迴圈加一行身分替換，靠的是同一套介面對官方用戶端的查驗較寬鬆這個現實。

這一招有明確的時間軸。2025 年 7 月 5 日的版本加入繞過檔案大小限制的功能，同年 12 月 18 日的最後一版修正了小於 100MB 檔案被限速的問題，作者在問題回報區親自回覆說明這次更新。然而進入 2026 年，問題回報區的風向變了：一月有人問這工具是不是已經被平台處理掉，因為下載時又被要求改用用戶端；有會員帳號的使用者表示付了錢照樣慢；到 2026 年 8 月中，仍有人回報下載速度被壓在每秒 100KB 上下、找不出原因。社群裡流傳的可行解法，是回到前面說的正規流程：先轉存到自己帳號、用自己產生的分享連結下載，成功率高一些，但速度依然時好時壞。

所以免費繞過下載限制這樁賣點要拆開讀。轉存與分享走的是正規介面，不與平台的查驗機制對抗；下載繞限則是對這套機制的逆向利用，平台每收緊一次，工具就得再改一次，而它的原始碼已經九個月沒有動靜。把繞限當成這工具的註冊理由，2026 年的今天很可能會失望；把它當成偶爾奏效的加分項，把轉存與批次分享當主菜，期待會準確得多。

工具繞不掉的，是夸克自己畫的規則

有些限制跟工具無關，跟帳號有關。有使用者貼出的錯誤訊息顯示，轉存的檔案數量超過帳號等級的上限，這是夸克對免費與付費帳號畫的線，等幾個小時配額重置後才恢復，開會員才能拉高；雲端硬碟容量不足時，工具也只能如實回報並停下。這兩道牆存在於帳號層，任何用戶端都繞不動。

另一些是工具自己的邊角。有使用者回報超過三層的深層資料夾內容下載不到；也有最精簡格式的分享連結解析失敗的案例；還有人以為它能上傳檔案，實際上選單裡根本沒有這個功能。這些是開源小工具常見的未修邊角，加上問題回報區目前有三十餘個待處理項目、過半連一則回應都沒有，作者本人從 2025 年 7 月之後就未再回覆，遇到時要有自己找答案的心理準備。

免費開源和付費閉源，站在同一條線的兩端

夸克批次管理這個需求已經長出一條光譜。一端是NeoPan 這類閉源付費工具：圖形介面，把轉存、清理、批次分享、追更、AI 產素材一路自動化，每個月收月費，功能最全但程式不公開、資料流向只能聽站方說法。另一端就是 QuarkPanTool：功能少、長得醜、全靠命令列，但每一行對外行為都攤在原始碼裡，授權允許你自由使用與修改，不收一毛錢。兩者的取捨本質是「你要便利還是要可稽核」，沒有誰取代誰。

光譜中間還有其他位置。想把夸克當成眾多雲端硬碟之一掛載進自己的檔案總管，可以看自架私有雲 Foxel；想用一個介面聚合管理多家網路硬碟，AList 是這條路的老牌選擇。QuarkPanTool 補的是「批次操作」這一格：不掛載、不聚合，就是快速把幾百個分享連結轉進帳號、再把幾百個資料夾分享出去。

維護狀態也要放進天平。這個倉庫的主要分支凍結在 2025 年 12 月 18 日，之後沒有任何提交；同一時間作者的精力顯然在別處，他的直播錄製專案 DouyinLiveRecorder 有一萬顆星以上，另一個 StreamCap 也有四千多顆、2026 年 9 月初仍有更新。對使用者來說這不全是壞消息：轉存與分享靠的是單純的介面呼叫，不太需要追著平台改；真正會過期的是下載繞限那一段，而那正是最不該依賴的部分。

誰該把它放進工具箱，誰該直接繞開

它適合的人相當具體：已經有夸克帳號、手上有大量分享連結要整理進自己雲端硬碟的人；要把自己資料夾批次分享出去的資源整理者；以及在意資料流向、只願用能自行稽核的工具的人。安裝也分兩種：Windows 使用者直接從 GitHub 的 Releases 頁下載打包好的執行檔壓縮包，解壓就能跑；macOS 與 Linux 使用者走原始碼路線，裝 Python 3.11、裝依賴、再用 Playwright 裝一份 Firefox。釋出包的累積下載量到 2026 年 9 月約兩萬六千次，最新版本身就有超過一萬次，在同類工具裡算得上主流選擇。

不適合的名單同樣清楚。想要穩定滿速下載大檔的人，前面限速的實況已經說明一切；需要圖形介面與一條龍自動化的人，付費的 NeoPan 陣營比較對味；還沒有夸克帳號的人也先別急，這工具的一切都建立在既有帳號上，帳號取得與地區規則要先自己確認。另外兩件小事：選單與訊息是簡體中文環境長出來的，讀繁體的你看得懂但未必順眼；官方免責聲明寫明僅供學習研究用途，批次轉存與分享的內容合規性，責任在使用者自己身上，版權物轉手分享在任何司法管轄區都是紅線，工具的中立性不會替你擋這一條。

授權與專案狀態

QuarkPanTool 以 Apache-2.0 授權開源，原始碼在 GitHub（ihmily/QuarkPanTool），主程式 quark.py 有 899 行，連同登入模組與工具函式約一千一百行，可以逐行核對。專案建立於 2024 年 3 月，共六個版本，最新版 v0.0.6 於 2025 年 12 月 18 日釋出，主要分支自該日起凍結，問題回報區有三十餘個待處理項目。作者同時維護多個活躍的開源專案，信譽可以查證。Windows 執行檔從官方 Releases 頁取得，其他平台自行架設環境。這類繞限類工具的行為會隨平台政策漂移，動手前以官方倉庫的最新狀態為準。