> ## 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.

# 从 Quip 导入

> 无需导出文件，直接把 Quip 的文档、电子表格和文件夹导入 Craft。

## 如何开始导入

在浏览器中打开 [docs.craft.do/import/quip](https://docs.craft.do/import/quip)，如果尚未登录，请登录你的 Craft 账户。

## 获取你的 Quip 访问令牌

Craft 通过你自行生成的个人访问令牌连接 Quip。

<Steps>
  <Step title="打开 Quip 的令牌页面">
    在登录你要导入内容的那个 Quip 账户后，访问 [quip.com/dev/token](https://quip.com/dev/token)。
  </Step>

  <Step title="生成并复制令牌">
    点击 **Get Personal Access Token**，然后复制显示出来的令牌。

    <Warning title="请像对待密码一样对待令牌">
      访问令牌拥有你 Quip 账户中所有内容的完整权限。请勿分享，也不要发布到任何公开场合。
    </Warning>
  </Step>
</Steps>

<Info title="哪些文档会被导入">
  该令牌让 Craft 能够访问你的 Quip 账户可见的全部内容——你的私人文档，以及你参与的共享文件夹和群组文件夹。你无需逐个文档授权。
</Info>

## 导入你的文档

<Steps>
  <Step title="粘贴访问令牌">
    把令牌粘贴到导入页面的输入框中。
  </Step>

  <Step title="选择目标位置">
    选择你希望 Quip 文档出现在其中的 **Craft Space**。你也可以选择一个**目标文件夹**，把导入的内容集中放在一起。
  </Step>

  <Step title="配置选项">
    如有需要，可打开**包含评论**，把 Quip 的评论与文档一起导入。
  </Step>

  <Step title="开始导入">
    点击 **Import**。导入过程中会显示进度条。你可以随时关闭页面——导入会在后台继续。
  </Step>
</Steps>

<Tip title="账户较大时需要一些时间">
  Quip 会限制读取数据的速度。如果你的账户较大，导入会自动暂停并继续，直到全部内容传输完毕——几百个文档可能需要十五分钟甚至更久。你不需要一直开着页面。
</Tip>

## 导入完成后

完成后你会看到一条确认信息，其中的按钮可以带你进入 Craft，在那里找到导入的文档。

## Craft 未能带过来的内容

Quip 中有些内容在 Craft 里没有对应形式，偶尔也会有文件下载不成功。为了不让你自己去发现这些情况，Craft 会在导入结束后列出所有未能完整带过来的内容，并附上受影响的文档，方便你逐一查看。

你可能会看到以下几类：

* **未能导入的文档**——聊天和幻灯片，或 Quip 未返回的文档。
* **未能下载的图片或附件**——文档已导入，但不包含这些内容。
* **以表格形式导入的 Live App**——内容仍在，但不再可交互。
* **未能导入的评论**——文档导入时不包含评论。
* **评论中的附件**——评论正文已带过来，附加的文件没有。
* **丢失了位置的评论**——它们关联到整个文档，而不是原本所指的那段文字。

<Check title="这并不表示导入失败">
  出现这样的汇总是正常的，账户较大时尤其如此，而且你的文档已经在 Craft 中了。它的作用是告诉你需要查看哪些内容，而不是提示出了问题。
</Check>

<Info title="列出的内容并非都能打开">
  未被导入的聊天或幻灯片在 Craft 中没有对应文档可打开，因此只会显示名称。其余条目都会直接链接到导入后的文档。
</Info>

## 会被带过来的内容

<AccordionGroup>
  <Accordion title="文档与格式">
    标题、加粗、斜体、删除线、行内代码、链接、高亮、项目符号与编号列表、待办清单、表格、代码块、分隔线和引用。

    Quip 有下划线而 Craft 没有，因此带下划线的文字会以浅灰色高亮的形式导入——强调效果得以保留，尽管样式并不完全相同。
  </Accordion>

  <Accordion title="文件夹与加星标的文档">
    你的文件夹结构会在 Craft 中重建，你在 Quip 中加过星标的文档导入后同样带有星标。

    在 Quip 中，一个文档可以同时位于多个文件夹。Craft 会把每个文档放进其中一个，因此导入的文档会落在最先找到它的那个文件夹里。空文件夹不会被重建。
  </Accordion>

  <Accordion title="图片与附件">
    图片和附件会被下载并重新上传到 Craft，因此导入后仍可正常使用——它们不是指回 Quip 的链接。
  </Accordion>

  <Accordion title="电子表格">
    Quip 电子表格会转换为 Craft 表格，可以直接查看和编辑。原始的 `.xlsx` 文件也会作为附件附在文档上，因此原件的内容不会有任何损失。
  </Accordion>

  <Accordion title="看板与 Project Tracker">
    它们会转换为 Craft 集合，你的列会成为状态属性，每张卡片保留各自的状态。列的颜色也会一并保留。
  </Accordion>

  <Accordion title="文档之间的链接">
    指向其他 Quip 文档和文件夹的链接与提及，会被改写为指向导入后的 Craft 版本，因此内部链接仍然有效。指向未包含在本次导入中的文档的链接，仍会指向 Quip。
  </Accordion>

  <Accordion title="日期">
    Quip 中的日期提及会转换为真正的 Craft 日期，而不是纯文本。
  </Accordion>

  <Accordion title="评论">
    如果启用**包含评论**，评论及其回复会连同原始作者名称和时间一起导入，并锚定在其所针对的文字上。
  </Accordion>
</AccordionGroup>

## 限制

以下大多数情况会在导入后的汇总中列出，让你知道哪些文档受到影响。下方标注的两项不会提示，因为对 Craft 来说并没有缺失任何内容。

* **聊天和幻灯片不会被导入。** Craft 对这两者都没有对应形式，因此 Quip 的对话和演示文稿会被跳过。文档和电子表格会被导入。
* **除看板和 Project Tracker 之外的 Live App**（例如日历）会以展示其内容的普通表格形式导入。信息仍在，但不再可交互。
* **评论中的附件不会被导入。** 评论正文仍会带过来，附加的文件不会。
* **部分评论可能丢失位置。** 如果某条评论所针对的文字在 Quip 的导出内容中已不存在，该评论会锚定到整个文档，而不是那段文字。内容不会丢失，但可能不在你预期的位置。
* **模板会作为普通文档导入**（*不会提示*）。Quip 模板会成为普通的 Craft 文档，而不是 Craft 模板。全部内容都在，只是没有被设置为模板。
* **Quip 回收站中的文档不会被导入**（*不会提示*）。Craft 只能看到你的 Quip 账户中位于回收站之外的文档。

<Info title="你的 Quip 账户不会被改动">
  导入只会从 Quip 读取数据。你 Quip 账户中的任何内容都不会被移动、编辑或删除，因此你可以照常使用，并在需要时重新导入。
</Info>

## 疑难解答

<AccordionGroup>
  <Accordion title="Quip 访问令牌无效">
    请确认你从 [quip.com/dev/token](https://quip.com/dev/token) 完整复制了整个令牌。如果你不确定粘贴的令牌是否是当前的令牌，请重新打开该页面并复制上面显示的令牌。
  </Accordion>

  <Accordion title="未找到任何文档">
    这表示令牌本身有效，但 Craft 通过它没有看到任何文档。请确认你是在登录正确的 Quip 账户时生成令牌的——如果你有多个账户，很容易为错误的账户创建令牌。
  </Accordion>

  <Accordion title="导入耗时很长">
    这通常是 Quip 的速率限制所致，而不是出了问题。导入会自动暂停并继续，关闭页面后也会继续运行。账户较大时可能需要一段时间。
  </Accordion>

  <Accordion title="某个文档缺失或位于错误的文件夹">
    位于多个 Quip 文件夹中的文档会被放入最先找到的那个文件夹，因此可能不在你预期的位置。如果某个文档完全找不到，请确认它是否是不会被导入的聊天或幻灯片，以及它是否在 Quip 的回收站中。
  </Accordion>

  <Accordion title="导入失败">
    请尝试重新开始导入。已经导入的文档不会重复。如果问题仍然存在，请联系支持团队。
  </Accordion>
</AccordionGroup>