開放原始碼

開放原始碼

EPUB Tools 是 MIT 授權的開源專案，原始碼託管於 GitHub。歡迎檢視、使用、修改與散佈。

授權方式

本專案採用 MIT License。你可以自由使用、修改與散佈本軟體，惟需保留原始授權聲明。完整授權條款請見專案中的 LICENSE 檔案。

版本差異

瀏覽器版（Cloudflare Pages）

所有處理在瀏覽器記憶體中完成，無需後端伺服器。使用 JavaScript 搭配 fflate 函式庫處理 ZIP 結構。部署於 Cloudflare Pages 邊緣網路。

Python 版

提供命令列介面與本機 HTTP 伺服器兩種模式。採用交易式檔案替換機制——處理過程中先寫入暫存檔，確認成功後再以原子操作取代原始檔案，最大限度降低資料損壞風險。適合批次處理與自動化整合。

安全模型

瀏覽器版：檔案透過 File API 讀入記憶體，所有操作在瀏覽器沙箱中執行，原始檔案不會被修改。重新封裝後的 EPUB 以 Blob 形式提供下載。Python 版：使用 tempfile 進行交易式寫入，成功後再以 os.replace 取代原始檔案，處理過程中發生錯誤不會影響原始檔案完整性。

貢獻指南

歡迎提交 Pull Request。為確保品質，貢獻時請遵守以下原則：

• 新增功能時應一併提供對應的合成測試檔案（synthetic fixture）
• 確保通過既有測試
• 瀏覽器版請注意瀏覽器相容性
• Python 版請遵循 PEP 8 風格