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

# URL 方案

> 使用 Craft 的 URL 方案来自动化工作流程并与其他应用集成。

URL 方案允许用户和其他应用的开发者向 Craft 发送命令。本页说明其工作原理以及当前支持的功能。

<Info title="提示">
  我们计划在未来为现有功能添加更多能力。
</Info>

## 可用命令

以下是 Craft 支持的可用命令：

* 打开文档
* 创建文档
* 向现有文档追加内容
* 在空间中启动搜索
* 访问每日笔记

## 打开页面

**输入：**

* **blockId** – 你可以在文档中点击 Copy Deeplink 获取，链接包含 blockId 参数
* **spaceId** – 通常是你的用户 id (随机 guid)；如果是共享空间，需通过点击 Copy Deeplink 获取

**示例：**

```
craftdocs://open?spaceId=<spaceId>&blockId=<blockId>
```

<Warning title="警告">
  当你不是该空间成员时无法使用。
</Warning>

## 打开空间

**输入：**

* **spaceId** – 你可以通过点击 Copy Deeplink 从简单 deeplink 中获取
* **(optional) tab** – `calendar` **或** `search` **或** `documents`

**示例：**

```
craftdocs://openspace?spaceId=<spaceId>&tab=<tab>
```

<Warning title="警告">
  当你不是该空间成员时无法使用。
</Warning>

## 创建新空白文档

**输入：**

只需使用此 URL 即可在当前打开的空间中创建一个新的空白文档：

```
craftdocs://createnewdocument
```

## 创建文档

**输入：**

* **spaceId** – 你可以通过点击 Copy Deeplink 从简单 deeplink 获取
* **content** – 百分号编码的 Markdown (当前不支持图片)
* **title** – 百分号编码的纯文本标题
* **folderId** – 该参数必填，但可以为空

**示例：**

```
craftdocs://createdocument?spaceId=<spaceId>&title=<title>&content=<content>&folderId=<folderId>
```

## 追加到文档

**输入：**

* **spaceId** – 你可以通过点击 Copy Deeplink 从简单 deeplink 获取
* **index** – 新块的索引 (0 表示插入到最前；使用很大的数字表示追加，即比文档中现有块数量更大)
* **parentBlockId** – 文档的 blockId
* **content** – 百分号编码的字符串

**示例：**

```
craftdocs://createblock?parentBlockId=<parentBlockId>&spaceId=<spaceId>&content=<content>&index=<index>
```

## 在空间中搜索

在指定空间中启动搜索，并在搜索文本框中预填查询内容。

**输入：**

* **spaceId** – 你可以通过点击 Copy Deeplink 从简单 deeplink 获取
* **query** – 请确保已进行百分号编码

**示例：**

```
craftdocs://opensearch?spaceId=<spaceId>&query=<query>
```

## 访问每日笔记

* **昨天** – `craftdocs://openByQuery?query=yesterday&spaceId=<spaceId>`
* **今天** – `craftdocs://openByQuery?query=today&spaceId=<spaceId>`
* **明天** – `craftdocs://openByQuery?query=tomorrow&spaceId=<spaceId>`

## 相关文章

<CardGroup cols={2}>
  <Card title="Craft API" href="/zh-Hans/integrate/api">
    用于与 Craft 集成的完整 REST API 文档
  </Card>

  <Card title="iOS Shortcuts" href="/zh-Hans/integrate/apple-shortcuts">
    使用 Shortcuts 在 iOS 上自动化 Craft
  </Card>

  <Card title="Deeplinks (User Guide)" href="/zh-Hans/organize-and-find/linking/deeplinks">
    了解如何在工作流程中使用 deeplinks
  </Card>
</CardGroup>