# 開始新專案

選擇研究工作區、匯入現有稿件，或從範本開始。

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

![新增專案對話框，有研究專案、匯入專案和使用範本。](https://cdn.oleafly.com/images/screenshots/desktop/docs/new-project-dark-window-v2.png)

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

## 研究專案

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

### 專案名稱

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

### 文件引擎

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

### 研究起始範本

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

### 第一個研究任務

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

### 專案預覽

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

![研究專案設定畫面，顯示 LaTeX 論文起始範本和它將建立的檔案。](https://cdn.oleafly.com/images/screenshots/desktop/docs/research-project-dark-window-v2.png)

### 建立並開啟專案

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

### 取消

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

## 匯入專案

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

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

[依各種格式的匯入步驟操作 →](/docs/import-project/)

## 使用範本

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

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

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

[瀏覽、預覽並從範本建立 →](/docs/templates/)

### 用 AI 生成範本

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

[生成並重複使用 AI 範本 →](/docs/templates/ai-templates/)

## 第一次 Git 提交

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

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

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

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

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