ShotPulled
首页

帮助

连接、决策方式和账户帮助

各项功能的分步说明:使用指南

ShotPulled 的运作方式

流程
记录、品鉴、只改一处
每次萃取就是粉量、出液量和时间。说说味道如何,引擎就会把最可能的原因排序,告诉你它有多大把握,并指出下一次萃取只改一处。
建议背后的规则
为什么只改一处
同时改研磨度和出液量,下一次萃取就什么也说明不了:如果变好了,你不知道是哪项改动起的作用;如果没变好,你不知道该撤回哪一项。每次萃取只改一个变量,这就是全部方法。
“未核实”是什么意思
引擎不会用一个无法信任的研磨刻度来调校。登记磨豆机时,或者转动刻度环之后,告诉它刻度环设在哪里,并标记为实测。在此之前,解读会一直被挡住。
数字从哪里来
目录收录了 66 款磨豆机、126 款咖啡机和 17 款秤,每一条都对照过厂商自己的说明书。厂商从未公布的数值就留空,不做猜测。预填的内容你都可以修改,改过的会标为你自己的。
冷冻会暂停计时
每一个新鲜度判断都取决于豆龄。冷冻的天数不计入豆龄,所以第 6 天冷冻的豆子,解冻时仍是第 6 天。

免费吗?

是的。在 ShotPulled 成长期间,所有内容(手机 App、网页版和 AI 助手连接)都免费。如果将来收费,也只针对新功能,绝不针对你已经在用的。没有信息流,没有连续打卡,也没有广告。

唯一要花钱的是你自己用的 AI 助手。ChatGPT 需要可以安装插件的套餐;Claude 不需要。

连接 AI 助手

ShotPulled 通过一个端点使用 Model Context Protocol,下面的每个客户端都连接同一个端点,使用与网页版和 App 相同的账户。

  • 服务器 URL: https://mcp.shotpulled.com/mcp
  • 登录: 通过 Clerk 的 OAuth 2.1,从服务器自动发现。客户端 ID 和 客户端密钥 框都请留空。

ChatGPT

免费的 ChatGPT 账户加上免费的 ShotPulled 账户就能用。

OpenAI 已不再公布按套餐划分的规则:能否安装插件,取决于你的套餐、工作区、角色和所在地区;其中任何一项不满足时,连接 按钮就会显示为灰色。如果你看到的是灰色,原因就在这里,我们这边无法改变。(ChatGPT 在 2026 年 7 月把应用目录并入了 插件目录,所以你会看到这个名称。)

  1. 打开 ChatGPT 插件目录中的 ShotPulled,然后点击 连接。
  2. 用你的 ShotPulled 账户登录,也就是网页版使用的同一个邮箱。
  3. 在任何对话中输入 @ShotPulled 来调用它。
  4. 如果 ChatGPT 在写入前显示授权卡片,请允许。如果你拒绝,对话看起来像是成功了,但其实什么都没写入。它是否会询问取决于你的应用权限设置;新账户使用默认设置时不会询问。
截图待补 ShotPulled 在 ChatGPT 插件目录中的页面,带“连接”按钮。

先这样说 @ShotPulled 记录粉量 18g,出液 36g,30 秒,味道发酸。

Claude 网页版和桌面版

所有 Claude 套餐都能用,包括免费版,不过免费账户同一时间只能有一个自定义连接器。

ShotPulled 还没有进入 Claude 的连接器目录,所以要作为自定义连接器添加。填五个字段,之后一切用法都一样。

  1. 在 Claude 中打开 设置 → 连接器。
  2. 点击 添加,然后点击 添加自定义连接器。它是那个菜单里的一项,不是页面上的按钮。
  3. 名称: ShotPulled
  4. 远程 MCP 服务器 URL: https://mcp.shotpulled.com/mcp
  5. 客户端 ID 和客户端密钥留空。点击 添加,然后点击 连接 并登录。
截图待补 Claude 的“添加自定义连接器”对话框,已填好名称和远程 MCP 服务器 URL。

先这样说 我刚开了一包 Kenya Nyeri AA,12 号烘焙的。帮我登记一下,再告诉我什么时候可以喝。

iPhone 和 Android 上的 Claude

无需安装,但不能在手机上添加。

Anthropic 自己的说明(2026 年 9 月 4 日核实):你在网页版或桌面版添加的连接器,“会在你下次在 iOS 或 Android 版 Claude 上登录账户时可用”,而在手机上安装连接器仍处于测试阶段,网页版和桌面版才是主要途径。所以请先在电脑上填好上面的五个字段,然后在手机上登录,它就在那里了。

先这样说 我下一次萃取该改什么?

Claude Code 和其他 MCP 客户端

任何支持 streamable HTTP 的客户端。无需粘贴密钥。

登录方式会从服务器自动发现(/.well-known/oauth-protected-resource),所以支持 OAuth 的客户端会打开浏览器并自行完成。在 Claude Code 中只需一条命令:

claude mcp add --transport http shotpulled https://mcp.shotpulled.com/mcp

在其他任何地方,提供上面的 URL 和传输方式 streamable-http 即可。

先这样说 列出我这周的每一次萃取,看看是不是越来越好。

“它登录了,但看不到我的任何数据”

几乎总是因为有两个账户。助手用一个邮箱帮你登录,而网页版把你的萃取存在另一个账户下,通常是因为一个通过 Google 登录、另一个用密码登录,或者其中一个是几个月前在手机上创建的。写信之前,请先核对两边的邮箱:网页版的“设置”里会显示,问助手“我登录的是哪个账户?”也能看到另一边的。无论哪种情况,数据都不会丢;如果你一直在用的恰好是错的那个,发邮件说明一下就能解决。

它如何做决定

建议不是由语言模型写出来的。它来自一个有版本、确定性的知识库:同一包豆子、同一套器具上的同一次萃取,今天、下个月、在别人的账户上,得到的回答都一样。助手负责说话(读回你的历史、问你尝到了什么、组织回复的措辞),但不负责做决定,也无法说服引擎改变决定。

每条建议都会写明它用了哪条规则,而且你可以读到那条规则。有三个工具专门为此而设:get_rule 按编号返回规则原文,get_kb_version 告诉你是哪个版本的知识库给出的回答,kb_changelog 告诉你各版本之间改了什么。问你的助手“那是哪条规则,它怎么说?”,它就会去取。无法核查的回答只是意见;这个回答有出处。

这些防护规则在服务器上强制执行,而不是写在提示词里的建议,所以换什么说法都绕不过去。有两条值得记住名字。G1,状态核实关卡:如果引擎只知道你的磨豆机刻度是凭记忆或假定的,它就完全拒绝调校,直到你测量刻度环并告诉它。从未知起点给出的自信数字,正是会浪费一整包豆子的那种失败。G3/G4,不编造微米数:磨盘几何参数只在内部使用,绝不输出绝对的微米数,因为诚实的单位是你自己刻度环上的格数,其他都只是伪装成测量值的数字。此外,G2 会阻止中间没有萃取的“更细↔更粗”来回反复,这是“一次只改一处”由机器强制执行的那一半。

常见问题

它支持我的磨豆机和咖啡机吗?

目录收录了 66 款磨豆机、126 款咖啡机 和 17 款秤,每一条都对照过厂商自己的说明书;目录里没有的,大约一分钟就能手动登记。手动登记的磨豆机同样完整:告诉它刻度方案和哪边更细,格数换算就交给它。目录里的每台磨豆机和咖啡机都有一个页面,列出厂商说明书中关于清洁和保养的内容。

哪些秤可以通过蓝牙连接?

Bookoo, Decent, DiFluid, Felicita, Timemore和 Varia。这些是手机 App 真正解码过的协议,比单纯带蓝牙模块的秤要少。世界上任何一个秤都能用另一种方式:手动输入数字。ShotPulled 的所有功能都不需要连接秤。

为什么每次萃取只改一处?

因为同时改两处什么也说明不了:如果下一次更好,你不知道是哪一处起的作用;如果更差,你不知道该撤回哪一处。这就是全部方法,上面的建议背后的规则里有解释。

我需要手机 App 吗?

不需要。网页版和 AI 助手各自都是完整的:登记器具、记录萃取、品鉴、锁定配方、查看历史。App 额外提供的是蓝牙秤、没有信号时也能用,以及在咖啡机旁随手可用。

有 Android App 吗?

有,在 Google Play 免费下载,Android 8.0 或更高版本。与 iPhone App、网页版和各个助手使用同一个账户,所以你已经记录的内容都在。

清洁磨豆机后,我锁定的配方会怎样?

它们原样保留,也不会再“装作”准确。只有拆下磨盘的清洁才有影响。反冲洗也同样记录,但什么都不会改变。不过,手摇磨豆机真正的零点是磨盘相碰的位置,而重新组装决定了印着的刻度环相对于这个零点在哪里,所以上周记录的数字今天可能对应不同的间距。

记录这次清洁后,在它之前锁定的每个配方都会把刻度显示为未知,而不是一个碰巧错误的数字。不会重写任何内容:你锁定的仍然是你锁定的,每次显示时都会根据之后的清洁重新推算读数。之后测量一次刻度环,它们就全部恢复。

只要有一次清洁跳过了这个测量,之后每次清洁的链条都会断开:结果是未知,而不是近似。这是刻意的。“没人看过”和“测量过,没有移动”得出的数字完全相同,可信度却完全相反,所以绝不允许两者看起来一样。

可以从 Beanconqueror 导入吗?

还不行,目前也没有任何形式的导入。如果你要迁移过来,最快也最实在的做法是登记你正在喝的豆子,然后从现在开始记录。引擎需要你的器具上有几次萃取才能给出判断,而在不同研磨刻度下的旧记录帮不上这个忙。

这是“AI”吗?

对话是。建议不是。建议来自 它如何做决定 中描述的规则手册,助手只是使用它的界面,而不是建议的来源。

怎样删除我的账户?

在网页版或手机 App 的“设置”中点 删除账户。可以自助完成,会清除账户的所有内容,无法撤销。导出数据等其他事项见下方的你的数据和你的账户。

ShotPulled 由一个人运营,所以支持渠道是一个邮箱,而不是客服系统。这也意味着你是在写信给写代码的那个人。请写明你试了什么、发生了什么,回复就会是真正的答复,而不是一个工单号。

  • 邮箱: support [at] shotpulled [dot] com
  • 通常回复时间: 两个工作日内。涉及账户登录或数据丢失的问题优先回复。
  • 语言: 英语或罗马尼亚语。

需要写些什么

说明你当时在哪个平台上的报告,修复得最快。尽量写上:

  • 平台:AI 助手(Claude、ChatGPT)、手机 App 还是网页版,以及“设置”中显示的 App 版本。
  • 你请求了什么,以及得到的结果。完整屏幕的截图比裁剪过的好。
  • 时间:大概的时间,以及你的时区。服务器日志使用 UTC 时间戳,这样才能找到对应记录。
  • 账户邮箱:如果问题涉及你自己的数据,请写上你登录用的邮箱。

请不要发送密码或认证令牌。这里永远不会有人向你索要。登录完全由 Clerk 处理,没有任何密码会到达我们的服务器。

你的数据和你的账户

  • 删除你的账户可以自助完成:在网页版或手机 App 的“设置”中点 删除账户。这会清除账户的所有内容,无法撤销。
  • 导出你的数据,以及依据 GDPR 提出的访问、更正或限制处理请求,都会在 30 天内人工处理。请用你账户绑定的邮箱发信到 privacy [at] shotpulled [dot] com。
  • 存储了什么、存在哪里、保存多久,详见隐私政策。

报告安全问题

发邮件到 support [at] shotpulled [dot] com,主题中写上“security”,当天就会被阅读。在公开你发现的问题之前,请给我们合理的修复时间。涉及跨账户数据访问的报告是最高优先级。

你在写信给谁

  • 运营者: Bacosca Iulian PFA,在罗马尼亚(欧盟)注册的个体经营者
  • 注册地址: Str. Ion Câmpineanu nr. 24, Sector 1, București, Romania
  • 商业登记号: F40/4818/2022 · CUI: 46937352

服务条款说明了这项服务承诺什么、不承诺什么。