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

服務條款說明了這項服務承諾什麼、不承諾什麼。