Kdan Cloud 凱鈿

目標:做一個本機優先的個人雲端檔案庫，支援跨裝置同步、分享連結、版本保留與資料匯出。 技術棧建議:Python FastAPI + SQLite + 本機檔案系統，前端使用原生 HTML/CSS/JavaScript；同步客戶端可用 Python CLI，日後再包成桌面程式。 需求: - 建立檔案庫根目錄，支援資料夾建立、重新命名、移動、刪除與搜尋 - 上傳與下載檔案，顯示檔案大小、修改時間、MIME 類型與 SHA-256 雜湊 - 大檔案使用分段上傳，支援中斷後續傳與重複檔案去重 - 提供同步 CLI，依檔案雜湊比對本機與伺服器差異 - 同步時偵測雙方同時修改，產生衝突副本，不直接覆蓋原檔 - 每個檔案保留最近五個版本，可從管理頁檢視、下載或還原 - 產生可設定到期日的唯讀分享連結，可設定下載次數上限 - 支援圖片、PDF、純文字與常見 Office 檔案的瀏覽器預覽 - 管理頁顯示儲存空間用量、最近變更與目前同步狀態 - 支援單一管理密碼，密碼只放在環境變數，不寫入資料庫明文 - 可將檔案 metadata、資料夾結構與分享連結匯出為 JSON 與 CSV - 提供完整檔案打包匯出功能，保留原始資料夾結構與版本資料 明確不做(out of scope):多人即時協作、Office 線上編輯、行動 App、公開檔案搜尋、企業級 SSO、全球 CDN、自動跨區備援與商用等級 SLA。 README 要求:說明本機部署、環境變數、同步 CLI 用法、反向代理設定、備份與還原流程、衝突處理規則，以及如何完整匯出資料。