# 新建项目

选择研究工作区、导入现有稿件，或从模板开始。

点击程序坞中的 **新建项目**。选择你想怎样开始：组织一项研究、带入已有的工作，或者从现成的版式开始。

![新建项目对话框，包含研究项目、导入项目和使用模板。](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 钩子和提交签名，所以全局的 Git 设置不会阻止或打断项目的创建。此后，Oleafly 只在你要求时才提交。

在以下情况下，Oleafly 仍会创建仓库，但会跳过这次提交：

- 项目文件加起来超过 100 MB，这样导入的数据集就不会被单独复制进 Git 历史记录；
- 项目包含通常保存密码或密钥的文件，例如 `.env`、`*.pem`、SSH 私钥或 `credentials.json`。密钥一旦提交，即使之后删除了文件，也会留在历史记录里。

`.env.example` 之类的模板、以 `.pub` 结尾的公钥，以及 Keynote 的 `.key` 演示文稿，都不算作密钥。跳过提交时，原因会写入应用日志，你可以从 [Git 与源代码管理](/docs/git-history/)自己进行第一次提交。

如果没有安装 Git、项目已经有仓库，或者 **设置 → 集成 → GitHub** 中的 **为每个项目初始化 Git** 已关闭，就不会创建仓库。