# 项目中的笔记与共享笔记

把笔记关联到项目，把笔记保存在项目的 notes 文件夹中，并通过协作服务器与他人一起写一篇笔记。

笔记是一项实验功能，在你开启之前一直关闭。参见[开启笔记](/docs/notes/#turn-on-notes)。

笔记可以通过两种方式与项目归在一起。个人笔记存放在笔记中，你可以把它关联到某个项目，只有你自己能看到它。项目笔记是项目 `notes` 文件夹中的一个文件，所以它会随项目一起移动，与项目共享的每个人也都拥有它。

## 把笔记关联到项目

笔记中某篇笔记的页眉会显示它所处的位置：一个代表**笔记主页**的房子图标，然后是它的项目，再是它的标题。

![Long-context LLMs: thesis hub 的页眉显示它所处的位置，从房子图标到 LLaMA 项目再到它的标题，侧边栏把它列在该项目之下。](https://cdn.oleafly.com/images/screenshots/desktop/docs/notes-workspace-dark-window-v2.png#view=0,0,1060,930)

1. 在笔记中打开这篇笔记。
2. 在页眉中选择项目名称。没有项目的笔记在那里显示**选择项目**。
3. 从列表中选取一个项目。**无项目**会移除关联。

笔记的**更多**菜单中的**关联到项目**效果相同，在笔记侧边栏中右键单击笔记得到的菜单也一样。要把笔记关联到一个尚不存在的项目，请选择笔记页眉中的**新建项目**。你创建的项目会关联到这篇笔记。

已关联的笔记仍然是个人笔记。它留在笔记中，与你共享该项目的人不会得到它。这个关联只保存在这台电脑上。

笔记一旦被关联：

- 笔记中的引用可以来自该项目的参考文献。
- 笔记中的助手可以读取该项目的文件，项目中的助手会得到这篇笔记的标题和一段简短的摘要。详情参见[结合 AI 使用笔记](/docs/notes/ai/)。

## 项目中的笔记面板

打开一个项目后，选择项目侧栏中的**笔记**，或从命令面板运行**打开此项目的笔记**。这个面板有两个列表：

- **项目笔记**是项目 `notes` 文件夹中的文件。拥有该项目的每个人都有它们。
- **我的笔记**是关联到这个项目的你的个人笔记。它们留在笔记中。

![在 LLaMA 项目中，笔记面板的项目笔记列表为空，我的笔记下有四篇个人笔记，它们只在这台电脑上关联到该项目。](https://cdn.oleafly.com/images/screenshots/desktop/docs/notes-project-panel-dark-window-v2.png#view=0,0,700,580)

当两个列表合起来有超过八篇笔记时，它们上方会出现一个搜索框。

### 项目中的个人笔记

选择**我的笔记**旁边的**新建个人笔记**（**+**），或运行**为此项目新建个人笔记**，即可新建一篇关联到该项目的个人笔记。它会在你的文件旁边的一个标签页中打开。标签页上写着**个人笔记**和**只有你能看到**，如果你已经共享了这篇笔记，则写着**从“笔记”共享**。**在笔记中打开**会在笔记中打开同一篇笔记。

**我的笔记**下的每一行都显示你上次编辑这篇笔记的时间。它的菜单中有**移入项目**、**在笔记中打开**、**重命名**、**取消与此项目的关联**和**移入回收站**。你取消关联一篇笔记之后，消息中会提供**撤销**。

## 项目笔记

项目笔记是项目中位于 `notes/<Title>.md` 的 Markdown 文件。它的 front matter 里写着 `kind: note`，正是这一行让 Oleafly 把它作为笔记打开。`notes` 中没有这一行的 Markdown 文件不会列在**项目笔记**下，并且像其他任何 Markdown 文件一样打开。

### 创建项目笔记

1. 选择项目侧栏中的**笔记**。
2. 选择**项目笔记**旁边的**新建项目笔记**（**+**）。Oleafly 会创建 `notes/Untitled.md` 并打开它。
3. 在列表中出现的字段里输入标题并按 Enter。Oleafly 会把文件重命名为 `notes/<Title>.md`。

如果你没有输入标题就离开了这个字段，笔记会保持 Untitled。命令面板中的**新建项目笔记**同样会新建一篇 Untitled 笔记。请在笔记顶部输入它的标题。

文件名跟随标题：

- 某些系统不允许出现在文件名中的字符，例如 `/`、`\`、`:`、`*`、`?`、`"`、`<`、`>` 和 `|`，会变成空格。
- 名称最长 80 个字符。
- Windows 为自己保留的名称，例如 `CON` 或 `AUX`，会加上“note”，如 `notes/CON note.md`。
- 当名称已被占用时，Oleafly 会加上一个数字，如 `notes/Methods-2.md`。

### 打开和编辑

选择**项目笔记**下的一篇笔记，或在文件树中打开 `notes` 文件夹里它的文件。它会在一个标有**项目笔记**和**与此项目的文件保存在一起**的标签页中打开。

- **以 Markdown 编辑**会显示文件的源码。横幅“你正在以 Markdown 编辑这篇笔记。”里有**以笔记编辑**，可以切换回来。右键单击标签页也有同样的切换。
- **复制到我的笔记**会用它生成一篇关联到该项目的个人笔记，并带上它用到的图片和文件。这个副本是一篇独立的笔记。

这个列表跟随磁盘上的文件夹，所以当另一个程序添加、更改或删除笔记文件时，**项目笔记**会随之更新。它最多读取文件夹中的 200 个 Markdown 文件，并说明还有多少个没有列出。

笔记关闭时，这些文件仍留在项目中，并作为普通的 Markdown 打开。

### 重命名

选择该行菜单中的**重命名**，或更改笔记顶部的标题。Oleafly 会更新 front matter 中的标题，并把文件重命名为与之匹配，所以把 Draft 重命名为 Results 会让 `notes/Draft.md` 变成 `notes/Results.md`。当另一个文件已经有这个名称时，新名称会加上一个数字。

Oleafly 会先保存你打开的笔记。如果其中某一篇无法保存，就不会重命名任何内容，你会看到“部分笔记有未保存的更改，因此没有重命名这篇笔记。请先保存，然后重试。”

### 删除

笔记行菜单中的最后一项会移除这篇笔记。这一项叫什么，以及它做什么，取决于项目存放在哪里：

- 在项目库中的项目里，**删除**会移除文件。你无法撤销这一操作。
- 在[就地打开的文件夹](/docs/library/#folders-opened-in-place)中，macOS 和 Linux 上的**移到废纸篓**，或 Windows 上的**移入回收站**，会把文件移到那里，你可以恢复它。

### 把个人笔记移入项目

1. 在项目中打开这篇个人笔记，然后选择**移入项目**。它也在**我的笔记**下该笔记的行菜单中，以及标签页的右键菜单中。
2. 对话框会警告说，项目中的每个人都将能够查看和编辑这篇笔记。选择**移入项目**。

Oleafly 会把笔记写入 `notes/<Title>.md`，把笔记用到的图片和文件复制到 `notes/assets`，并打开它。你的个人副本会进入**设置 → 数据存储**中的[回收站](/docs/settings/storage/#recycle-bin)。如果 `notes/assets` 中已有另一个同名的文件，副本会加上一个数字，笔记的链接会指向它。

## 共享项目中的项目笔记

当你[共享项目](/docs/collaboration/sharing/)时，它的 `notes` 文件夹会像其他任何文件夹一样随之共享，而你的个人笔记仍然留在你这里。笔记开启时，**共享**对话框会这样说明：“项目笔记会与此项目中的所有人共享，个人笔记仍然只有你能看到。”当文件夹里没有笔记时，它会说：“个人笔记仍然只有你能看到。只有项目笔记文件夹中的笔记会被共享。”

在共享项目中：

- **笔记**面板会说：“项目笔记会与此项目中的所有人共享，你的个人笔记仍然只有你能看到。”
- 项目笔记的标签页上写着**此项目中的所有人都能查看和编辑**。
- 你们在输入时一起写项目笔记，笔记中会显示每个人的光标和名字。
- 只有所有者和编辑者可以更改项目笔记。其他人都可以阅读它，笔记会说：“你可以阅读这篇笔记，但不能编辑。”

## 与他人一起写一篇笔记

你可以通过协作服务器单独共享一篇个人笔记，而不需要项目。你需要在这个服务器上有账号。[开始使用](/docs/collaboration/get-started/)介绍了如何添加服务器并登录。

### 共享笔记

1. 在笔记中打开这篇笔记，选择它页眉中的**共享**。**共享**也在笔记侧边栏中该笔记的菜单里。
2. 在**人员**标签页中，选择**服务器**。
3. 查看摘要。它显示这篇笔记的**文件**和**大小**，并指出哪个服务器可以读取它们。
4. 选择**共享**。

笔记中的图片和其他文件会随它一起共享。Oleafly 设置和 Git 历史不会共享。同一个标签页随后会显示**有权访问的人员**。像处理项目一样添加人员并选择他们的角色。参见[添加人员](/docs/collaboration/sharing/#add-people)。已共享的笔记在侧边栏和笔记主页中带有**已共享**标记。

与共享项目中的项目笔记一样，只有所有者和编辑者可以在这篇笔记中书写。审阅者、评论者和查看者可以阅读它，助手也无法替他们更改它。

要结束共享，所有者在同一个标签页中选择**停止共享**，其他人则选择**退出项目**。所有者停止共享后，每个人都会保留自己的笔记副本，但它不再同步。你退出时，你的副本会留在这台电脑上，并且停止同步。参见[停止共享](/docs/collaboration/sharing/#stop-sharing)和[退出项目](/docs/collaboration/sharing/#leave-a-project)。

### 协作者需要什么

- 在同一个服务器上有账号，并已在 Oleafly 中登录。
- 已开启笔记。

这篇笔记会像共享项目一样，出现在他们项目库的**与你共享的项目**下。**打开**会下载它并在笔记中打开。[打开与你共享的项目](/docs/collaboration/get-started/#open-a-project-shared-with-you)介绍了这个列表和链接。

### 一起编辑

当其他人和你一起在这篇笔记里时：

- 他们的头像在笔记的页眉中。把指针悬停在头像上，可以看到这个人的名字、他的角色以及他正在做什么，例如**编辑**加上笔记的标题。选择头像会滚动到这个人所在的块。
- 每个人的光标会以他的颜色和名字显示。左侧页边的一条彩色竖条标出有人所在的块。把指针悬停在它上面可以看到是谁。
- 头像旁边，同步状态会说明你的更改是否已传到每个人那里，例如**已是最新**或**正在同步**。[同步状态](/docs/collaboration/working-together/#the-sync-status)列出了每一种状态。

同一时间只有一篇共享笔记处于实时状态。如果你在第一篇仍显示在屏幕上时移到另一篇共享笔记，第二篇会提示“另一篇笔记正在实时编辑”。选择**在这里实时编辑**，把实时编辑移到它上面。

### 更改没有发出时

如果 Oleafly 无法发送你最近的更改，笔记上方会出现提示说明这一点：

- “你对这篇笔记的最近更改没有发送，因为你现在只能查看它。”
- “Oleafly 无法发送你对这篇笔记的最近更改，这些更改已被丢弃。”

选择 **×** 可关闭这条提示。

### 没有网络连接时

如果连接断开，请继续写。笔记会保存在你的电脑上，Oleafly 会自动重新连接并发送你的更改。更改在等待期间，同步状态会显示**离线。等待同步的更改：** 和一个数字。[离线与重新连接](/docs/collaboration/offline/)解释了重新连接和合并是如何工作的。

## 发布只读副本

同一个对话框的**发布**标签页会把笔记的只读副本放在一个公开链接上。任何拿到链接的人无需登录就能阅读它。你不必先把这篇笔记共享给任何人。

1. 在笔记中打开这篇笔记，选择**共享**，然后选择**发布**。
2. 选择**服务器**。
3. 选择**发布**。标签页会显示**公开链接**，并带有**复制链接**和**打开**。

这个页面包含图片、统计图、图表、公式、Typst 和分子。HTML、React、CSV、序列和笔记本块不会包含在内。

这个页面不会跟随笔记变化。你更改笔记之后，标签页会提示“自上次发布以来，你更改了这篇笔记。再次发布即可更新页面。”选择**再次发布**即可更新它。**取消发布**会立刻停用这个链接，不过保存了这个页面副本的人仍会保留它。每个服务器卡片上**设置 → 协作**中的**已发布的笔记**会列出你在那里发布的内容。

一些限制：

- 只有笔记的所有者才能发布它。
- 服务器的管理员必须在管理控制台的设置中开启**允许笔记公开链接**。它默认关闭。
- 管理员可以撤下已发布的页面。在他们恢复它之前，读者无法打开它，你也无法再次发布它。你仍然可以取消发布。
