> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Readwise

> 将你在 Readwise 的阅读高亮自动同步到 Craft 的集合中。

Craft 让你可以轻松地将来自 Readwise 的阅读见解直接导入到工作区。只需简单设置，就能将书籍、文章和推文中的高亮内容有序保存并自动同步。

## 如何设置 Readwise 同步

<Steps>
  <Step>
    **打开 [Readwise 导入设置页面](https://docs.craft.do/readwise)**

    如果你还未登录 Craft，系统会提示你登录，登录后会返回到设置页面。
  </Step>

  <Step>
    **配置与你的 Craft 帐户的连接**

    按说明从 Readwise 获取你的 Access Token，然后选择希望高亮内容出现的空间。
  </Step>
</Steps>

现在，初次导入会在后台运行。根据你的 Readwise 库中高亮数量，可能需要几分钟时间。你可以放心关闭设置页面，稍后再回来查看 - 同步会在后台继续进行。

## 设置完成后会发生什么

Craft 会在所选的空间中创建一个名为 **"Readwise Highlights"** 的文档。在该文档中，你会看到名为 **"My Library"** 的集合，所有高亮内容都会存放在此集合中。

<img src="https://mintcdn.com/craft-support/4lRkwRvDwE7Wr43k/images/integrate/readwise/en/content/readwise-library-collection.png?fit=max&auto=format&n=4lRkwRvDwE7Wr43k&q=85&s=2e76596a174c6cac89c9d78d5c6c660e" alt="带有 My Library 集合的 Readwise Highlights 文档" width="2528" height="1568" data-path="images/integrate/readwise/en/content/readwise-library-collection.png" />

初次导入后，**新的高亮**会在一天内**自动更新**到 Craft。

每本书、文章或推文都会作为集合中的独立页面存储。这些页面将包含：

* 来自 Readwise 的标题和元数据
* 所有高亮和注释

<img src="https://mintcdn.com/craft-support/4lRkwRvDwE7Wr43k/images/integrate/readwise/en/content/readwise-page-example.png?fit=max&auto=format&n=4lRkwRvDwE7Wr43k&q=85&s=2c745d44bb00dd40256b61821c0c08e3" alt="展示高亮和元数据的 Readwise 页面示例" width="2528" height="1728" data-path="images/integrate/readwise/en/content/readwise-page-example.png" />

## 常见问题

### 当我做了新的高亮时会发生什么？

你导入到 Readwise 的任何新高亮都会自动导入到 Craft，无需你做额外操作。如果高亮来自一个新的文档，Craft 会在集合中插入一个新页面；如果高亮来自已有文档，则会追加到该页面的底部。

<Info title="同步时机">
  某些服务 (例如 Amazon Kindle、Instapaper 和 Pocket) 一天只与 Readwise 同步数次。因此，新高亮可能不会立即出现在 Readwise 或 Craft 中。如果你需要更快同步，可以在 Readwise 的 [Import Highlights 页面](https://readwise.io/welcome/sync) 和 Craft 的 [Readwise 导入设置页面](https://docs.craft.do/readwise) 强制手动重新同步。
</Info>

### 我可以筛选要导入的高亮吗？

可以！在首次配置集成时，或在之后的任何时候，你都可以使用 **"Select Items to be Exported"** 选项来筛选要导入的书籍、文章和推文。新添加的书籍会默认同步，除非你在[设置](https://docs.craft.do/readwise)中专门取消勾选。

### 我可以更改高亮的格式选项吗？

如果你不希望高亮使用 Craft 的默认格式，而想要更简洁的样式，请在[设置](https://docs.craft.do/readwise)中启用 **"Use Simple Formatting"** 开关。

使用 Craft 默认格式：

<img src="https://mintcdn.com/craft-support/4lRkwRvDwE7Wr43k/images/integrate/readwise/en/content/readwise-default-formatting.png?fit=max&auto=format&n=4lRkwRvDwE7Wr43k&q=85&s=ffb4d16913ba3b4b932a57ff443728cd" alt="使用 Craft 默认格式的高亮" width="2060" height="500" data-path="images/integrate/readwise/en/content/readwise-default-formatting.png" />

使用简洁格式：

<img src="https://mintcdn.com/craft-support/4lRkwRvDwE7Wr43k/images/integrate/readwise/en/content/readwise-simple-formatting.png?fit=max&auto=format&n=4lRkwRvDwE7Wr43k&q=85&s=7759fe6894352b026c6003b4992b5733" alt="使用简洁格式的高亮" width="2062" height="516" data-path="images/integrate/readwise/en/content/readwise-simple-formatting.png" />

### 我可以将 Readwise 文档移动到 Craft 的其他位置吗？

在你为集成设置的空间内，可以将 Readwise 文档自由移动到任意文件夹。

### 我可以在 Craft 中修改 Readwise 的集合吗？

可以！你可以随意修改集合视图或添加新的视图，也可以增加额外字段或编辑默认字段的名称。后续的同步不会覆盖你的这些更改。

<Warning title="重要">
  注意不要删除任何默认字段或更改字段类型。这会导致同步中断，你需要从头重新设置。
</Warning>

### 我可以编辑 Readwise 集合中的页面吗？

对于单独的书籍、文章和推文，你可以随意更改页面标题，系统不会覆盖这些更改。当然，你也可以任意编辑页面内容。集成会始终将新的高亮追加到页面底部，而不会覆盖现有内容。

### 如果我在 Readwise 中编辑或格式化已有高亮，或为已有高亮添加新的笔记或标签，这些更改会同步到 Craft 吗？

不会。来自 Readwise 的导入为仅追加模式。这意味着已存在于 Craft 中的 Readwise 文档内容不会被覆盖 – 以避免意外删除你在 Craft 中直接编辑或添加的内容。

### 如何删除我的 Readwise 文档并重新开始？

<Steps>
  <Step>
    在 Craft 中删除 Readwise 文档。
  </Step>

  <Step>
    转到 [Readwise 导入设置页面](https://docs.craft.do/readwise) 并关闭该集成。
  </Step>

  <Step>
    重新设置该集成。确保取消勾选 **"Use existing collection"** 选项。
  </Step>
</Steps>

### 如何更改要导入到的 Craft 空间？

<Steps>
  <Step>
    转到 [Readwise 导入设置页面](https://docs.craft.do/readwise) 并关闭该集成。
  </Step>

  <Step>
    重新设置该集成。确保取消勾选 **"Use existing collection"** 选项。
  </Step>

  <Step>
    选择你要导入到的另一个空间。
  </Step>
</Steps>

## 故障排除

当你在 [Readwise 导入设置页面](https://docs.craft.do/readwise) 看到类似 “Last import failed. Please try again” 的错误消息时，可能由以下几个原因导致：

* **你已重置 Readwise 的 Access Token**
  关闭同步并使用新的 token 重新设置。勾选 **"Use existing collection"** 以确保继续使用你现有的 Readwise 文档。

* **你删除了某个默认集合字段或更改了字段类型**
  不幸的是，这会导致同步中断且无法恢复。你需要从头重新设置。如果该选项可用，请确保取消勾选 **"Use existing collection"**，因为现有集合将无法继续用于同步。

如果仍无法解决，且你确定上述原因都不适用，请联系我们并告知你遇到的问题。

## 相关主题

<CardGroup cols={2}>
  <Card title="集合" href="/zh-Hans/organize-and-find/collections">
    了解如何在 Craft 中使用集合
  </Card>

  <Card title="集成概览" href="/zh-Hans/integrate">
    探索 Craft 中可用的其他集成
  </Card>
</CardGroup>