插件开发指南

这篇指南只做一件事:让你的第一个 Tavo 插件跑起来。

我们会制作一个「自定义帮答」插件。你只需要填写想引导的内容,AI 就会生成自定义回复并填入聊天输入框。

你可以选择:

如果你正在使用 Codex、Claude Code、Trae、DeepSeek Harness(DSH)或 WorkBuddy,优先选择 AI Agent


使用 AI Agent 开发

开始前,请准备:

  • 一台电脑
  • 一个已经安装并可以正常使用的 AI Agent,例如 Codex、Claude Code、Trae、DeepSeek Harness(DSH)或 WorkBuddy
  • 一台安装了 Tavo 的手机
  • 让手机和电脑连接到同一个局域网,例如同一个 Wi-Fi

1. 开启 Tavo MCP 服务器

  1. 在任意聊天页打开 更多 → 设置 → MCP 服务器
  2. 访问范围 设为 局域网
  3. 开启 MCP 服务器
  4. 滚动到页面底部,点击 复制完整连接配置
  5. 连接和开发期间,让 Tavo 保持前台运行并保持屏幕常亮。
Tavo MCP 服务器页面和复制完整连接配置入口

需要了解网络和连接问题时,查看 MCP 服务器文档

2. 把连接配置发给 Agent

回到 Agent 对话,发送下面的话。删除占位行,再把你在 Tavo 中复制的完整连接配置粘贴进去:

请连接下面的 Tavo MCP 服务器,并先读取当前版本的插件开发文档。
<删除这一行,然后粘贴你在 Tavo 中复制的完整连接配置>
连接成功并读完文档后,只回复“已准备好”。

你复制到的完整配置格式类似下面这样(示例已脱敏,不要直接使用):

Tavo MCP Server: 1.2.8
Preferred access: direct HTTP JSON-RPC
Server URL: http://192.168.x.x:0000/mcp
Authorization: Bearer XXXXX

不要把真实的 Server URL 和 Bearer token 发布到公开聊天、截图、文档或 issue。它们只应发送给你正在使用的 Agent。

如果 Agent 请求连接权限,按它的提示确认。看到“连接成功”后再继续。

3. 告诉 Agent 你想做什么

发送这个需求:

做一个 Tavo 插件,在聊天输入框的 + 菜单中添加“自定义帮答”。点击后弹窗询问用户想引导的内容;确认后,结合当前聊天上下文生成回复草稿,填入输入框但不要自动发送。

完成后,通过已连接的 Tavo MCP 服务器安装并启用插件。

4. 测试插件

Agent 完成安装后,回到 Tavo 聊天页:

  1. 打开输入框旁的 + 菜单

    点击 Tavo 中文聊天输入框的加号后,菜单中显示自定义帮答
  2. 点击 自定义帮答

  3. 填写想引导的内容并确认。

  4. 确认生成的回复草稿出现在输入框里。

看到草稿后,你的第一个插件就成功了。


使用对话式 AI 辅助开发

ChatGPT、Claude 等对话式 AI 不能直接连接 Tavo 或安装文件,但同样可以帮你生成插件。

1. 复制最新的插件开发文档

打开 插件开发文档,点击页面右上角的 复制本页

把复制的内容发送给 AI,并补充:

请阅读这份 Tavo 插件开发文档。

接下来请严格按照文档帮我制作一个简单插件,不要使用文档中没有的 API。

请始终从文档页面复制。文档会持续更新,这样 AI 获得的才是最新规则。

2. 发送插件需求

继续发送:

做一个 Tavo 插件,在聊天输入框的 + 菜单中添加“自定义帮答”。点击后弹窗询问用户想引导的内容;确认后,结合当前聊天上下文生成回复草稿,填入输入框但不要自动发送。

3. 获取并导入 .zip

让 AI 生成安装包:

请生成一个可以直接安装到 Tavo 的 .zip 文件给我。

下载文件后,在 Tavo 中:

  1. 打开 更多 → 插件
  2. 点击右上角的 安装
  3. 选择 从文件导入插件,找到刚下载的 .zip。
  4. 确认安装并启用,然后回到聊天页测试 自定义帮答
在 Tavo 中选择从文件导入插件

只安装由你信任的 AI 或开发者生成的 .zip 文件。


分享到 Tavo 插件中心

插件可以正常使用后,你也可以把它分享给其他用户:

  • 直接打开 Tavo 插件中心
  • 或在 Tavo 进入 更多 → 插件,点击插件中心横幅,再点击页面右上角的创作者入口。

准备好 .zip、插件名称、简短介绍,以及需要展示的图标或截图,就可以按照页面提示上传。

第一个插件不需要复杂,也不需要一次做到完美。先让它成功运行,再做下一个想法。

目录