Finch 的 deeplink 怎么用
Finch 支持一种特殊的链接格式——finch:// 开头。点击这种链接,会直接跳到 Finch 里对应的位置或动作(比如打开一段新对话、跳转到某个历史会话),不用你手动去找。
跟普通网址不一样:finch:// 链接点开会直接呼出 Finch 客户端并执行动作,而不是被浏览器打开。
常见的几种 deeplink
| 想做的事 | 链接格式 | 举例 |
|---|---|---|
| 打开一段新对话 | finch://new | 打开新对话 |
| 新对话,并且提前把一句话填进输入框 | finch://chat?message=你想说的话 | 帮我总结一下今天的待办 |
| 打开某个历史会话 | finch://open?id=会话ID | 从会话右键菜单「复制链接」获取 |
| 跳转到某个空间 | finch://open?target=space&id=空间ID | 从空间列表获取对应链接 |
| 打开工具箱(小工具列表) | finch://toys 或 finch://toys/minitools | 打开工具箱 |
| 打开工具箱的技能页 | 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:
[帮我看看今天的日程](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 会直接打开设置里的模型页,表单已经填好,确认一下就能保存。三个参数都可选,也可以只填部分(比如只填 provider 和 baseUrl,让用户自己粘 Key)。注意:
baseUrl必须是http://或https://开头的合法网址,否则不会预填。- 链接里的参数值建议做 URL 编码(空格变
%20、&变%26),避免被截断。 - API Key 只会被填进表单、不会自动保存,最终保存还是要用户自己点确认。
一些可以直接试试的例子
小贴士
- 如果你要填的那句话里有空格,写成链接时把空格换成
%20,中文字符不用额外处理,直接写就行。 - deeplink 只在 Finch 客户端里生效,发到别的地方(比如微信、浏览器)点开可能没反应,需要电脑上装了 Finch 才能正常跳转。
- 工具箱链接里的「工具ID」就是这个小工具在社区里的 id(也是安装后的扩展 id),在工具详情页或社区列表对应条目里能看到;写教程、发分享贴的时候用它跳转到某个具体工具特别方便。
- 出于安全考虑,deeplink 只负责跳转到工具详情页,不会自动帮你安装——安装还是需要你自己在详情页手动点一下「安装」按钮确认。
- 技能页(
finch://toys/skills)目前不支持id,只能跳到列表,不能直达某个具体技能的详情。