---
title: "深度链接 · Finch Agent"
description: "用 finch:// 链接直达对话、会话和空间"
source: https://finchwork.app/zh/docs/deeplinks
---

# Finch 的 deeplink 怎么用

Finch 支持一种特殊的链接格式——`finch://` 开头。点击这种链接，会直接跳到 Finch 里对应的位置或动作（比如打开一段新对话、跳转到某个历史会话），不用你手动去找。

跟普通网址不一样：`finch://` 链接点开会直接呼出 Finch 客户端并执行动作，而不是被浏览器打开。

## 常见的几种 deeplink

| 想做的事 | 链接格式 | 举例 |
| --- | --- | --- |
| 打开一段新对话 | `finch://new` | [打开新对话](finch://new) |
| 新对话，并且提前把一句话填进输入框 | `finch://chat?message=你想说的话` | [帮我总结一下今天的待办](finch://chat?message=%E5%B8%AE%E6%88%91%E6%80%BB%E7%BB%93%E4%B8%80%E4%B8%8B%E4%BB%8A%E5%A4%A9%E7%9A%84%E5%BE%85%E5%8A%9E) |
| 打开某个历史会话 | `finch://open?id=会话ID` | 从会话右键菜单「复制链接」获取 |
| 跳转到某个空间 | `finch://open?target=space&id=空间ID` | 从空间列表获取对应链接 |
| 打开工具箱（小工具列表） | `finch://toys` 或 `finch://toys/minitools` | [打开工具箱](finch://toys) |
| 打开工具箱的技能页 | `finch://toys/skills` | [打开技能页](finch://toys/skills) |
| 跳到某个具体小工具的详情页 | `finch://toys?id=工具ID` 或 `finch://toys/minitools?id=工具ID` | 已安装的直接打开；未安装的会打开它在社区里的介绍页 |
| 打开设置里的模型页，预填「添加自定义模型」表单 | `finch://models/add?provider=供应商名&baseUrl=接口地址&apiKey=密钥` | 常见于第三方服务引导你配置接入模型，打开后表单已填好，确认即可保存 |

其中最常用的是 `finch://chat?message=...`——它相当于一个"一键提问"按钮：别人（或者你自己）点一下，就能直接把一句预设好的话发给 Finch，不用自己再打字。

## 怎么用

### 1\. 直接点击

如果你在 Finch 对话里、或者一份文档里看到蓝色的 `finch://` 链接，直接点就行，Finch 会自动跳到对应的地方。

### 2\. 自己写一个

只要按上面的格式写成 Markdown 链接，就能做出一个可点击的 deeplink：

```markdown
[帮我看看今天的日程](finch://chat?message=帮我看看今天的日程)
```

想让 Finch 一打开就问某个问题、执行某个操作，都可以用这种方式提前"埋好"一个链接——比如做操作手册、快捷入口、常用问题合集的时候特别好用。

### 3\. 从会话菜单复制链接

想分享或收藏某一段具体的对话，在侧边栏找到这个会话，右键（或点更多菜单）选择「复制链接」，就能拿到一个 `finch://open?id=...` 的链接，发给别人或者存起来，打开后会直接跳回这段对话。

### 4\. 帮别人配置自定义模型

如果你运营一个第三方 AI 服务，想让用户一键把模型接入 Finch，可以在文档或邮件里放一个 `finch://models/add` 链接，把供应商名称、接口地址（`baseUrl`）和 API Key 预填好：

```markdown
[一键接入某某模型](finch://models/add?provider=某某服务&baseUrl=https://api.example.com/v1&apiKey=sk-xxxx)
```

用户点击后 Finch 会直接打开设置里的模型页，表单已经填好，确认一下就能保存。三个参数都可选，也可以只填部分（比如只填 `provider` 和 `baseUrl`，让用户自己粘 Key）。注意：

-   `baseUrl` 必须是 `http://` 或 `https://` 开头的合法网址，否则不会预填。
-   链接里的参数值建议做 URL 编码（空格变 `%20`、`&` 变 `%26`），避免被截断。
-   API Key 只会被填进表单、**不会自动保存**，最终保存还是要用户自己点确认。

## 一些可以直接试试的例子

-   [打开新对话](finch://new)
-   [帮我整理一下今天要做的事](finch://chat?message=%E5%B8%AE%E6%88%91%E6%95%B4%E7%90%86%E4%B8%80%E4%B8%8B%E4%BB%8A%E5%A4%A9%E8%A6%81%E5%81%9A%E7%9A%84%E4%BA%8B)
-   [给我讲个笑话](finch://chat?message=%E7%BB%99%E6%88%91%E8%AE%B2%E4%B8%AA%E7%AC%91%E8%AF%9D)
-   [帮我设计一套专属的主题配色](finch://chat?message=%E5%B8%AE%E6%88%91%E8%AE%BE%E8%AE%A1%E4%B8%80%E5%A5%97%E4%B8%93%E5%B1%9E%E7%9A%84%E4%B8%BB%E9%A2%98%E9%85%8D%E8%89%B2)

## 小贴士

-   如果你要填的那句话里有空格，写成链接时把空格换成 `%20`，中文字符不用额外处理，直接写就行。
-   deeplink 只在 Finch 客户端里生效，发到别的地方（比如微信、浏览器）点开可能没反应，需要电脑上装了 Finch 才能正常跳转。
-   工具箱链接里的「工具ID」就是这个小工具在社区里的 id（也是安装后的扩展 id），在工具详情页或社区列表对应条目里能看到；写教程、发分享贴的时候用它跳转到某个具体工具特别方便。
-   出于安全考虑，deeplink 只负责跳转到工具详情页，不会自动帮你安装——安装还是需要你自己在详情页手动点一下「安装」按钮确认。
-   技能页（`finch://toys/skills`）目前不支持 `id`，只能跳到列表，不能直达某个具体技能的详情。