Skip to main content

深度链接

用 finch:// 链接直达对话、会话和空间

Finch 的 deeplink 怎么用

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

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

常见的几种 deeplink

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

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

怎么用

1. 直接点击

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

2. 自己写一个

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

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

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

3. 从会话菜单复制链接

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

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

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

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

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

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

一些可以直接试试的例子

小贴士

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