開始新專案

在工作區 Dock 中按一下 新增專案。選擇你想怎麼開始：整理一項研究、帶入現有的工作，或從準備好的版面開始。

新增專案對話框，有研究專案、匯入專案和使用範本。 開啟完整螢幕截圖

起點	適合的情況	接下來會發生什麼
研究專案	你想要一份稿件，並附有存放來源、分析和審閱筆記的空間	選擇語言和研究起始範本，然後檢視建議的檔案
匯入專案	你已經有壓縮檔、草稿或儲存庫	選擇匯入來源並建立本機專案
使用範本	你知道自己需要的文件版面	瀏覽並預覽範本，或用 AI 生成一個

研究專案

這個方式會在你的稿件周圍建立一個運作中的研究資料夾。它提供一些地方，讓你存放和論文相關的證據與審閱工作。

專案名稱

輸入一個描述性的名稱。預覽會隨著你輸入而更新，讓你在建立任何東西之前，就能看到建議的標題和檔案。

文件引擎

選擇 LaTeX、Typst 或 Markdown。這決定了主要的原始檔和編輯器工具。如果你是用新的格式開始，請閱讀 選擇文件引擎。

研究起始範本

選擇符合你工作的起始範本。論文 的起始結構是一篇研究論文，包括摘要，以及緒論、方法、結果、討論和結論的章節。繼續之前，請檢視起始範本的說明和檔案預覽。

第一個研究任務

閱讀顯示在起始範本下方的任務。對於論文，它會勾勒出研究問題和論文大綱。這個任務是你工作的起點；建立專案並不會替你產生研究發現。

專案預覽

選取預覽樹中的檔案，檢視它們的內容。論文會包含稿件，以及分析、圖片、研究筆記、來源和審閱筆記的資料夾。主文件 標籤會指出用來編譯論文的檔案。

研究專案設定畫面，顯示 LaTeX 論文起始範本和它將建立的檔案。 開啟完整螢幕截圖

建立並開啟專案

預覽看起來沒問題時，請選擇 建立並開啟專案。你的新專案會在寫作工作區中開啟。請從 研究工作區指南 開始，連接來源並整理任務。

取消

關閉對話框或選擇 取消，即可離開而不建立專案。

匯入專案

如果要繼續你已經有的工作，請選擇這個方式。對話框提供專案 ZIP、Word 文件、Markdown 文件、HTML 頁面、Typst 文件、arXiv 論文或 GitHub 儲存庫。Oleafly 會用選取的輸入建立本機專案。

已有多個原始檔和圖片的現有專案，請使用 ZIP。Word、Markdown、HTML 和 Typst 的匯入會把文件轉換成另一種格式，所以請在繼續之前檢查轉換後的稿件並編譯它。要以原生的 Markdown 寫作，請建立 Markdown 專案，並把你的原始碼和資源帶進去。

依各種格式的匯入步驟操作 →

使用範本

開啟範本庫，搜尋或篩選你需要的文件類型，並檢視預覽。範本可以為論文、學位論文、報告、履歷、信件、海報、簡報或單一圖片提供版面，格式可以是 LaTeX、Typst 或 Markdown。當你已經有原始碼要貼上時，空白的起點很有用。

第二步會要你輸入專案名稱並選擇封面顏色。如果你沒有選顏色，Oleafly 會從調色盤中隨機選一個，這樣新專案在書架上更容易分辨。

有些範本在第一次使用時會下載套件包或字型。如果你打算離線工作，請在連線時先準備好這些下載。

瀏覽、預覽並從範本建立 →

用 AI 生成範本

當你想描述自己的起始版面時，請在範本庫中選擇 生成範本。把文件類型、必要的章節、頁面大小和格式偏好告訴助理。預覽結果、加以調整，並儲存範本供之後重複使用。

生成並重複使用 AI 範本 →

第一次 Git 提交

Oleafly 建立或匯入的專案，會從一次包含其檔案的 Git 提交開始，名為 Create project。這樣原始檔控制從你的第一次編輯起就能顯示真正的差異，研究任務 也有可供比較的版本。這次提交絕不會執行 Git hook 和提交簽署，所以全域的 Git 設定不會阻擋或中斷專案的建立。在那之後，Oleafly 只會在你要求時才提交。

在下列情況下，Oleafly 仍會建立儲存庫，但略過這次提交：

• 專案檔案的總大小超過 100 MB，這樣匯入的資料集就不會自行被複製進 Git 歷史記錄；
• 專案包含通常存放密碼或金鑰的檔案，例如 .env、*.pem、SSH 私密金鑰或 credentials.json。機密一旦提交，即使你刪除該檔案，仍會留在歷史記錄中。

.env.example 這類範本、以 .pub 結尾的公開金鑰，以及 Keynote 的 .key 簡報檔，都不算機密。略過提交時，原因會寫入應用程式記錄，你可以在 Git 與原始檔控制 中自己進行第一次提交。

沒有安裝 Git、專案已經有儲存庫，或在 設定 → 整合 → GitHub 中關閉了 為每個專案初始化 Git 時，不會建立儲存庫。