> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archetype.ing/llms.txt
> Use this file to discover all available pages before exploring further.

# 笔记

> 你自己的笔记：阅读和撰写笔记的页面、每日笔记和快速笔记，以及智能体的工具。

笔记是你自己的笔记所在的地方。它随 Archetype 一起提供，默认开启。这是你唯一的笔记：应用的搜索和 `@` 提及都通过它读取笔记。通用设置见[插件](https://docs.archetype.ing/zh/extend/plugins.md)。

## 在侧边栏中

**笔记**打开你的笔记。笔记之间用 `[[wikilinks]]` 互相链接，笔记中可以画 Mermaid 图。

* **今天**打开你当天的笔记（`Daily/YYYY-MM-DD`），第一次打开时根据你的模板创建。模板是你选定的一篇笔记，否则使用 `Templates/Daily`；其中的 `{{date}}` 会替换为当天日期。
* **快速笔记**，位于页面顶部：输入一行，按 Enter。按照**快速笔记保存到**的设置，它会带上时间写到今日笔记的 `## Quick notes` 下，或追加到**收件箱**笔记的末尾。菜单栏面板中、以及在应用中任何地方按 ⌘⇧N，都有同样的输入行。
* 把图片粘贴或拖放到笔记中，就会和笔记保存在一起：PNG、JPEG、GIF、WebP 或 AVIF，最大 5 MB。

## 智能体能做什么

| 工具 | 作用 |
| - | - |
| `search_notes` | 按文字查找笔记，或列出最近更改的笔记。笔记的名称、别名或 `[[wikilink]]` 优先匹配。只读。 |
| `read_note` | 读取一篇笔记，或按标题读取其中一节。`today` 读取今日笔记。只读。 |
| `write_note` | 写一篇新笔记，或替换一篇笔记的全部文字。front matter 保持不变。 |
| `append_note` | 添加一条快速笔记，和页面上的输入行一样。 |

读取无需询问。写入遵循你的[批准模式](https://docs.archetype.ing/zh/use/approvals.md)。用 `archetype mcp serve --own` 连接的外部智能体，在向今日笔记添加一行之前，会在**通知**中询问你。

## 保存在 Git 中

笔记默认保存在这台电脑上。要把它们保存在 Git 仓库中，获得历史记录并在你的其他电脑上使用，请在“管理 → 连接 → 工作来源”中连接仓库。之后笔记会通过 ssh 用 `git` 同步，使用你自己的密钥。因此，笔记在其他插件所用的沙盒之外运行；“管理 → 插件”中该插件的页面会说明这一点。

## 离开公司

front matter 中写有 `company: <address>` 的笔记会被标记为属于那个公司。离开公司时，Archetype 可以删除这些笔记，但只在你选择这样做时才会删除。

## 关闭

在“管理 → 插件”中关闭，或在 `~/.config/archetype/config.json` 中设置 `"plugins": { "notes": false }`。这会隐藏笔记及其工具，但不会动笔记本身。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.