原型 · 预览版:收录官方注册中心里的全部服务器,每 30 分钟同步一次。使用 Google 登录即可撰写评价。原型 · 每 30 分钟更新
PopNx MCP为使用 AI 的人准备的 MCP 服务器 · 用大白话讲清楚

Long Run Hybrid Coach

作者:atomchung版本 1.4.10i★ 6i在云端运行官方网站 ↗
注册名称io.github.atomchung/long-run-hybrid-coach

安装方法

What it does

Adaptive running and strength coaching for the long run.

  • Connects 在云端运行
  • Account or key Sign in to the service when you connect (OAuth)
  • Category 其他

为什么排在这里

列表按使用分(满分 100)排序,由以下部分组成

热度10/80GitHub 星标或每周下载量:较大的计 60,较小的计 20
新鲜度12/1230 天内有发布或代码更新得满分
仍在响应8/8上次检查时云端端点有响应
使用分30/100

质量: 基础检查通过 5/5 项(仅展示,不用于排序) · 上升势头: 暂无数据 (只用于“上升中”标签)

安装

选择你使用的 AI 应用,然后复制设置。

用一句话让 AI 帮你安装

请帮我安装 Long Run Hybrid Coach。按照 https://mcp.popnx.com/i/atomchung-long-run-hybrid-coach.md 操作,先把命令给我看,等我同意后再运行。

粘贴到能在你电脑上工作的 AI(如 Claude Code、Cursor)。它会读取我们的步骤,先给你看命令,等你同意。无需密钥,无需注册。 · 查看 AI 会读取的全文

通过 5/5 项检查 · 你的提问会经过开发者的服务器(mcp.paceandstaystrong.com) · ✓ 命令已检查 2026年11月13日

第一步:你用哪个 AI?

选择你用的应用,步骤会显示在下方。

可连接 Claude · 约 2 分钟

不需要密钥,不用安装程序 · 在 claude.ai 或桌面应用设置一次,即可在聊天中使用 · 免费账户可添加 1 个 · Team/Enterprise 方案由所有者(Owner)添加

  1. 打开 Claude 的 Connectors 页面

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. 点击“Add” → “Custom” → “Web”,填写这 2 项

    把这里的内容复制到 Claude 中同名的输入框,然后点击 Continue

    Name · 名称Long Run Hybrid Coach
    Remote MCP server URL · 地址https://mcp.paceandstaystrong.com/mcp

    在 Claude 检测到的登录设置页点击 Continue · Authentication 按作者说明选择(Sign in now、Sign in when needed 或 No sign in),然后点击 Add

  3. 在聊天中开启

    +ConnectorsLong Run Hybrid Coach

  4. 试一试

    用 Long Run Hybrid Coach 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Claude 说正在使用 Long Run Hybrid Coach,或回答中出现 Long Run Hybrid Coach 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同

能否连接 ChatGPT 取决于方案

完整 MCP:网页版 ChatGPT Business、Enterprise 或 Edu · Pro:以读取/获取权限连接,修改数据的工具可能用不了 · Plus:官方文档尚未确认,如果在插件页看到添加自定义 MCP 的选项可以试试 · 仅限网页

  1. 在网页版 ChatGPT 打开添加 MCP 的页面

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. 填写名称和地址

    输入名称,在 Connection 下粘贴地址,勾选风险提示,然后点击 Create as a plugin

    Name · 名称Long Run Hybrid Coach
    Connection · 地址https://mcp.paceandstaystrong.com/mcp
  3. 在聊天中选择 Long Run Hybrid Coach

    开启新聊天,输入前先从插件列表中选择 Long Run Hybrid Coach

  4. 试一试

    用 Long Run Hybrid Coach 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 ChatGPT 说正在使用 Long Run Hybrid Coach,或回答中出现 Long Run Hybrid Coach 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 OpenAI 帮助页面核实 · 你的界面可能因版本略有不同

可连接 Claude Code · 约 2 分钟

不需要密钥,不用安装程序

  1. 打开终端

    Mac:按 Command+空格,输入 Terminal · Windows:打开 PowerShell

  2. 粘贴这条命令并按 Enter

    claude mcp add --transport http --scope user long-run-hybrid-coach https://mcp.paceandstaystrong.com/mcp
  3. 在 Claude Code 中输入 /mcp

    应能看到 Long Run Hybrid Coach 在列表中并显示已连接

  4. 试一试

    用 Long Run Hybrid Coach 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Claude Code 说正在使用 Long Run Hybrid Coach,或回答中出现 Long Run Hybrid Coach 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同

可连接 Cursor · 约 2 分钟

不需要密钥,不用安装程序

  1. 点击这个按钮打开 Cursor

    在 Cursor 中打开

    Cursor 会请你确认安装,点击 Install

  2. 在 Cursor 中以 Agent 模式打开 AI 聊天

  3. 试一试

    用 Long Run Hybrid Coach 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Cursor 说正在使用 Long Run Hybrid Coach,或回答中出现 Long Run Hybrid Coach 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 Cursor 帮助页面核实 · 你的界面可能因版本略有不同

可连接 VS Code · 约 2 分钟

不需要密钥,不用安装程序

  1. 点击这个按钮打开 VS Code

    在 VS Code 中打开

    VS Code 会请你确认安装,点击 Install

  2. 在 VS Code 中以 Agent 模式打开 AI 聊天

  3. 试一试

    用 Long Run Hybrid Coach 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 VS Code 说正在使用 Long Run Hybrid Coach,或回答中出现 Long Run Hybrid Coach 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 VS Code 帮助页面核实 · 你的界面可能因版本略有不同

其他支持 MCP 的应用(如 Windsurf、Zed、Gemini CLI)添加方式各不相同,请在应用列表中查看

查看所有支持 MCP 的应用 →

通过网页连接的应用使用的地址

地址https://mcp.paceandstaystrong.com/mcp

JSON 设置在下方“开发者专用”中

卡住了?问问正在用 Long Run Hybrid Coach 的人💬 讨论 →
开发者专用:终端命令和 JSON 设置

通过网页连接

Claude Code

claude mcp add --transport http --scope user long-run-hybrid-coach https://mcp.paceandstaystrong.com/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "long-run-hybrid-coach": {
      "url": "https://mcp.paceandstaystrong.com/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "long-run-hybrid-coach": {
      "type": "http",
      "url": "https://mcp.paceandstaystrong.com/mcp"
    }
  }
}

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。

一览

每周下载量i
不在 npm/PyPI 上
连接方式
在云端运行
传输方式
streamable-http
最新版本i
1.4.10
分类i
其他
发布到注册中心i
2026年9月14日
代码最后更新i
2026年11月13日
最近检查
2026年11月18日
作者
atomchung
注册状态
活跃

哪些应用可以使用它

依据这个服务器的连接方式和各应用自己的文档,检查于 2026年11月10日。

通过互联网连接,适用于

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

全部应用及其优缺点 →

它能做什么

服务器要求先登录,才会列出它的工具。

基础检查i

我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月19日

  • ✓ 通过

    作者与仓库一致

    注册名称已通过 GitHub 账户 atomchung 验证,该账户拥有此仓库

  • ✓ 通过

    仍在维护

    代码最后更新于6天前

  • ✓ 通过

    有许可证

    使用 MIT

  • ✓ 通过

    端点有响应

    在 262 毫秒内响应(HTTP 401)

  • ✓ 通过

    使用 OAuth 登录

    声明支持 OAuth 登录,你的 AI 应用可以带你去登录

  • … 尚未检查

    工具描述中没有隐藏指令

    尚未检查;我们会在检查端点时读取工具列表

云端地址最近 4 次检查中有 4 次响应 · 最近一次 262 ms · 检查于 2026年11月18日

我们检查什么 → · JSON

作者:申请重新检查或报告信息错误
给作者:在 README 中加徽章

如果你是作者,可把这段代码贴到 README。徽章会链接回本页。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/atomchung-long-run-hybrid-coach.svg)](https://mcp.popnx.com/en/servers/atomchung-long-run-hybrid-coach)

讨论

提问、分享技巧或报告无法使用。按“有帮助”数量排序。

还没有帖子,欢迎第一个提问或分享。

此处内容由用户撰写,不代表 PopNx 团队。

登录后发帖

用户评价

还没有评价

登录后写评价

与“其他”中的其他服务器比较i

  • 星标数多于此分类中其他 20693 个服务器的 95%
  • 发布到注册中心的时间比此分类中其他 20693 个服务器的 39% 更新
  • 基础检查结果等于或优于此分类中其他 20693 个服务器的 99%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。

常见问题

Long Run Hybrid Coach 安全吗?

它在 5 项适用的基础检查中通过了 5 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。

它需要哪些密钥或代码?

注册中心没有列出必需的密钥,不过有些服务器会在首次使用时要求你登录。

它在我的电脑上运行还是在云端?

它在作者的云端运行。通过互联网连接,无需安装,但你发送的内容会经过作者的服务器。

它还在维护吗?

GitHub 仓库最后更新于6天前,最新版本(1.4.10)于2个月前进入注册中心。

哪些应用可以使用它?

支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,因此也能用于接受远程 MCP 的应用,例如网页版 ChatGPT(Business 及以上为完整 MCP;Pro 为只读)。

有什么可以替代它?

同一分类中有:World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

功能相近的其他选择

同一分类、其他作者、命令已通过检查。官方的排在前面,再按星标排序。

如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

作者:koala73广泛使用★ 9.1万3天前更新

在云端运行✓ 服务方 · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

作者:openstatusHQ广泛使用★ 92742个月前更新

在云端运行✓ 服务方 · openstatus.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

作者:Klavis-AI正在增长★ 582514个月前更新

在云端运行仓库已归档✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

作者:jitsucom广泛使用★ 51364个月前更新

在云端运行✓ 服务方 · jitsu.com
与相似项目对比
本项
Long Run Hybrid Coach
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
运行位置在云端运行,无需安装在云端运行,无需安装在云端运行,无需安装在云端运行,无需安装在云端运行,无需安装在云端运行,无需安装
需要密钥否否否否否否
可在 Claude 中按 + 添加否否否否否否
基础检查5/54/44/44/41/44/4
许可证MITAGPL-3.0AGPL-3.0MITApache-2.0MIT
价格登记中未列出费用登记中未列出费用登记中未列出费用登记中未列出费用登记中未列出费用登记中未列出费用

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

Long Run Hybrid Coach

繁體中文 · English · 简体中文

官網 paceandstaystrong.com | 遇到問題看支援頁

把一個網址貼進 Claude 或 ChatGPT,你就有一個讀得到你真實訓練的教練。

它讀你 Intervals.icu 帳號裡的活動與恢復數據,維持同一份 28 天的跑步+重訓方向與本週課表,拿計畫去對你實際做了什麼,並在你同意之後,把每一堂課排進你的日曆。免費使用,沒有付費方案。

Garmin 不是使用前提。 Garmin 只是目前第一條做過實機驗證的下游裝置路徑;Apple Watch、COROS、Polar、Suunto、Wahoo、其他 app/手錶,甚至沒有手錶,都可以用同一個教練。差別在於有多少可信的訓練紀錄能進到教練手上,以及 Intervals 後面那段裝置同步是否已經被驗證過。

一般使用者直接用託管版: https://mcp.paceandstaystrong.com/mcp。你需要一個 Intervals.icu 帳號,但不需要自己向 Intervals 申請 OAuth App,也不需要自己維運伺服器。


連接:兩步

官網把同一條流程拆成四個點擊步驟走一次:開始使用。

你需要什麼
  1. 一個 Intervals.icu 帳號。 免費,用 Google 登入大約 30 秒就能開好。
  2. Claude 或 ChatGPT。
  • Claude(claude.ai/Claude Desktop):免費方案就可以,免費帳號限一個自訂連接器。這條路徑已經做過完整實機驗證——production OAuth、教練對話、以及把課表送進 Intervals。
  • ChatGPT:目前需要 Business、Enterprise 或 Edu 的網頁版 workspace,在 Apps/developer mode 建立 custom app。個人方案的 custom MCP 只有 read/fetch,跑不完本產品「寫計畫+交付課表」的流程。ChatGPT 外掛程式目錄上另有這個教練的 Plugin 版。最新限制以 OpenAI 官方說明 為準。
  • 其他 MCP client:OpenClaw 與自架 client 見下面一節。
  1. 選配:已經會把活動同步進 Intervals.icu 的手錶或訓練 app。沒有手錶也可以用——教練會把拿不到的欄位當成「不知道」,不會當成 0。
第一步:把網址貼進你的 AI

在 AI 的連接器設定裡新增一個 remote MCP server,網址是:

https://mcp.paceandstaystrong.com/mcp
  • claude.ai/Claude Desktop:Settings → Connectors → Add custom connector → 貼上網址。
  • ChatGPT:Apps/developer mode → 建立 custom app → 指到同一個網址。

沒有別的欄位要填,也沒有金鑰要貼。

第二步:授權 Intervals.icu

瀏覽器會開 Intervals.icu 的同意頁。登入你自己的 Intervals.icu 帳號,四個權限都勾起來:

權限教練拿它做什麼
ACTIVITY:READ讀你已完成的訓練。
WELLNESS:READ讀 Intervals 手上的恢復數據。
CALENDAR:WRITE讀寫訓練日曆,讓你確認過的課表能送進去,並讀回來核對。
SETTINGS:WRITE讀你的門檻配速。它唯一會寫進去的,是你還沒有的門檻配速,發生在你已經確認過的課表交付當下;已經設好的絕不覆寫。

Intervals 也有只讀的設定權限;這裡要寫入,是因為上面那個補值動作真的會寫。它之所以需要,是因為 Intervals 這邊沒有門檻配速時,它照樣收下有配速的課表,但往手錶送的時候會把配速目標拿掉——你會收到距離正確、卻沒有任何目標的一堂課。少勾任何一個權限,需要它的功能就會壞掉,而且不容易看出原因;重新連線補上即可。

不要把 Intervals 密碼、API key 或 token 貼進對話。

在 ChatGPT 安裝 Plugin 版

ChatGPT 的外掛程式目錄上有這個教練的 Plugin 版,不用貼網址。先準備好一個 Intervals.icu 帳號,而且手錶的訓練紀錄已經同步進去。

  1. 開啟 Long Run Hybrid Coach 的安裝頁,按「安裝外掛程式」。還沒登入 ChatGPT 的話,會先請你登入。
  2. 連接時登入你自己的 Intervals.icu 帳號並同意。Plugin 版只要三項權限:ACTIVITY:READ、CALENDAR:WRITE、SETTINGS:WRITE。
  3. 在 ChatGPT 的對話裡問它,例如「讀我最近的訓練,告訴我這週該怎麼練。」

Plugin 版從 Intervals.icu 只讀你完成的訓練(活動、配速、運動心率、訓練負荷),不讀那裡的恢復數據。它的計畫和完整版(上面的個人 MCP 連線,https://mcp.paceandstaystrong.com/mcp)各自獨立,不互通。

Intervals 帳號是新的或空的?

教練讀的是 Intervals.icu 裡已經有的東西。帳號是新的話,有兩條路把歷史補進去:

  • 接上你原本就在用的裝置或 app。 在 Intervals.icu 自己的 Settings 裡連 Garmin 或你的手錶/訓練 app,過去的活動會自動補上。資料到了之後,再請教練重新讀一次。
  • 把匯出檔直接交給教練。 在對話裡給它 CSV、Apple Health 匯出檔或 .fit 檔,請它匯入。同檔與同一場活動會自動去重,判斷不了才回頭問你。(檔案是給教練的,不會進 Intervals.icu。)

裝置量不到的東西也可以直接在對話裡講:重訓的實際組數重量次數、本週能練的時間與器材、體重體脂、沒帶錶的那一場、「最近很累」「睡不好」,以及你從手錶上實際看到的睡眠、HRV、靜止心率、readiness 數字。教練不會把一句「我很累」偷偷翻成一個假的 readiness 分數。


連上之後會發生什麼

直接問正常的教練問題

不用先填問卷:

讀我最近的訓練,告訴我這週該怎麼練。

或:

我想提升 VO2max,又不想掉力量,幫我排第一個 28 天方向。

教練會先讀已經有的資料,再只問真正會改變決策的缺口——例如本週可練日、器材,或裝置不可能知道的重訓基準。

第一次會先看 28 天預覽,你同意才寫進去
  • 本週:精確、可執行、可以直接送進日曆的課。
  • 後三週:大方向,不假裝現在就知道所有細節。

之後每一次改動也是同一條體驗:改動前後對照 → 你同意一次 → 才寫入。

要送進日曆時,再確認一次

交付是另一個獨立確認:課表預覽 → 你同意一次 → 寫進 Intervals.icu → 讀回來核對。

預覽會先說明這次要寫進哪一個 Intervals.icu 帳號——先講 Intervals 上的 email,再講顯示名稱,所以同時有正式帳號和測試帳號的人,在寫進去之前就看得出來是哪一個。email 放前面,是因為自己的兩個帳號常常取同一個顯示名稱。兩者都是當下向 Intervals 讀的,只用在這一次回答,不會被存下來。

本產品能證明的最遠一步是 Intervals.icu 收下了。Intervals 成功不等於課表已經在 Garmin、Apple Watch 或其他手錶上——Intervals 後面那段同步是外部路徑,要各自驗證。


Intervals.icu 在這個產品裡做什麼?

Intervals.icu 是目前的中轉站:它幫教練接住不同裝置/app 的活動與恢復數據,也承接教練確認後的日曆課表。它不是計畫本身的存放處。

手錶 / 訓練 app

│ ▼ Intervals.icu ───── 已完成活動 + 恢復數據 ─────► 教練 ▲ │ │ │ └────────── 你確認過的日曆課表 ◄───────────┘ │ ▼ Garmin / Apple Watch / 其他下游同步

責任分工:

  • Intervals.icu:整合外部訓練資料,並持有日曆。
  • Long Run Hybrid Coach:持有唯一的當前計畫、決策歷史、你自己回報的紀錄、每一次確認的綁定,以及整條教練流程。
  • 你的手錶/app:可以把活動帶進 Intervals,也可能接收 Intervals 往下送的課表;但最後一哩是否成功,要獨立驗證。

只有帳號本身是必要條件。Intervals 裡已經有活動與恢復數據的話,教練自動拿得到的資料會比較完整;沒有的欄位保持「不知道」,不會被當成 0,也不會因為少一個選配數值就把一般教練對話擋掉。


託管版 vs 自架

實際會感覺到的差別只有一個:託管版你在手機上就能直接用;自架只有在跑伺服器的那台電腦上能用。下面每一行都是這個差別的成本。

託管版(推薦)自架
手機上能用嗎能——連一個有手機 App 的 client 就好不能,除非你自己把伺服器對外開放並處理 TLS
網址https://mcp.paceandstaystrong.com/mcp你自己的伺服器,例如 http://127.0.0.1:8422/mcp
維運不用自己管自己啟動、更新、備份與維運
Intervals OAuth App不需要需要自己的 OAuth application 憑證
計畫存哪託管端、以每位使用者為範圍你自己的伺服器 state root
適合誰一般使用者、多個 client 共用同一份計畫開發者、需要完全自管環境/資料的人

託管版會自己處理 dynamic client registration、PKCE、token 與使用者對應;一般使用者不需要任何 id、API key、client secret 或環境變數。

其他 MCP client
  • OpenClaw:用 openclaw mcp add 指到同一個網址,加上 --auth oauth。一個 instance 若不只一個人用,要把 OAuth identity 設成 per-requester,否則所有人會連到同一個 Intervals 帳號。設定見 entrypoints/openclaw/。
  • 其他:把同一個網址設成 remote Streamable HTTP MCP server。跑在你自己機器上的 client(OAuth callback 落在 loopback)可以直接連;跑在雲端主機、用自己網域接 callback 的 client 也能自行註冊連上,只是在進到 Intervals 授權之前,會先看到本產品自己的一頁確認畫面,上面寫明授權會被送到哪一個 origin,按下 Continue 才會繼續。該 origin 若已被維運者驗證並加進清單,就直接跳過這一頁。細節見 entrypoints/mcp/README.md。

逐入口「已完整實機驗證」或「已封裝、等待真實連線驗證」的狀態,以 entrypoints/ 為準。

自架怎麼跑?

Repo 使用 Python 3.11,只有一個釘死版本的依賴:官方 MCP Python SDK(requirements.txt 寫版本,requirements.lock 連同它解析出的每個套件一起釘死 sha256),它負責 /mcp 的協定與傳輸層。教練判斷、驗證、store、交付與身分都仍然只用標準函式庫。

  1. Clone repo,然後 python3 -m pip install --require-hashes -r requirements.lock。
  2. 向 Intervals.icu 申請建立 OAuth application。 Intervals 目前的公開流程不是在 Settings 自助新增:依官方說明提供 app name、description、website、logo、privacy policy、redirect URI 與你的 Intervals ID;app 建立後才會出現在 Settings,從 Manage App 取得 client_id / secret。流程見 Intervals.icu OAuth support。
  3. 在 Intervals app 裡註冊 callback: /oauth/callback。本機 client 可以走 loopback;remote client 需要可達的 HTTPS 或安全通道。
  4. 設定必要環境變數:
export GARMIN_COACH_LOOP_GATEWAY_STATE_ROOT="$HOME/.local/share/long-run-hybrid-coach-gateway"

export GARMIN_COACH_LOOP_TOKEN_HMAC_KEY="$(openssl rand -base64 32)" export GARMIN_COACH_LOOP_INTERVALS_CLIENT_ID="..." export GARMIN_COACH_LOOP_INTERVALS_CLIENT_SECRET="..."

  1. 啟動:
python3 -m garmin_coach_loop.cli serve-gateway --host 127.0.0.1 --port 8422
  1. 本機 MCP client 指到 http://127.0.0.1:8422/mcp。

要正式提供給 remote client 的話,不要把 loopback 範例當 production runbook。Persistent volume、TLS、信任的 client origin、single replica、release identity 與部署驗證見 docs/deploy-gateway.md。

一個人只該有一份當前計畫

本機設定 GARMIN_COACH_LOOP_GATEWAY_URL 指向託管版時,本機寫入預設會被擋;只有明確加 --offline 才代表「我刻意在做另一份本機計畫」。已經有本機資料的人可以搬到託管版,流程見 docs/ops/migrate-local-store-to-hosted.md。


現在可以做什麼?

  • 維護一份 28 天方向:本週精確的課 + 後三週大方向。
  • 讀 Intervals 的活動、恢復數據與日曆,把可信的「排了什麼 vs 實際做了什麼」自動對回當前計畫。
  • 在同一份週計畫裡同時處理跑步與重訓。
  • 記錄你自己回報的東西:個人資料、可練時間、長期目標、訓練習慣、實際重訓、體重體脂、裝置沒錄到的活動,以及主觀狀態。
  • 每次對話可以帶入當下的恢復數字。託管版不會、也不需要去讀你電腦上的健康資料庫。
  • 匯入歷史資料:支援格式的 CSV、Apple Health XML,以及 FIT 檔。同檔與同一場活動會自動去重,判斷不了才問你。
  • 課表可以帶一段教練備註一起進 Intervals,而不是偷偷長出第二套課表寫法。
  • 每週複盤「實際練了什麼、有沒有進步的證據、下一步是什麼」,而不是把「課表做完」直接當成體能提升。
  • 計畫變更先看對照,同意後才套用。
  • 日曆交付先看預覽,同意後才寫入;支援安全重試、取代與撤回本產品自己送出去的課表。
  • 在對話裡直接匯出本產品持有的資料。刪除整個帳號改為寫信申請,教練會直接給你說明要寄什麼的頁面。
重要邊界
  • 開始一次教練對話會做自動對帳,可能寫入新的計畫版本。只想看目前存了什麼、完全不動到資料的話,用唯讀的那條路徑(getCoachState)。
  • 你自己回報的活動是佐證資料,不會被偷偷升格成裝置確認的完成紀錄。
  • 恢復數字只接受真的觀察值;模型不可以從文字自己猜一個數字出來。
  • 本產品不做醫療診斷。
  • 交付的證據只到 Intervals 讀回來核對,不會聲稱已經到手錶。

資料、匯出與刪除

託管端保存維持同一份計畫所必要的東西:計畫的版本鏈、決策與回執、你自己回報的紀錄、身分對應,以及還沒收斂的交付紀錄。

匯出時刻意不包含三樣東西:授權憑證的 fingerprint(單向的指紋,只拿來做內部記帳)、供應商的原始 payload 與 GPS 軌跡(原始活動檔應該跟供應商拿),以及內部的 owner id(本產品自己的儲存位置編號)。

刪除也有三個明確邊界,這三件不在本產品能刪的範圍:

  • 已經寫進 Intervals.icu 日曆的課表;
  • 你在 Intervals.icu Settings 給出的授權;
  • 不含計畫、健康或身分內容的最小化平台營運紀錄。

匯出在對話裡自己做。刪除整個帳號是寫信申請,流程在支援頁:要的是你的 Intervals.icu athlete id,以及一張 Intervals.icu Settings 頁的截圖;不會跟你要密碼、API key 或 token。在對話裡要求刪除全部資料,教練只會給你這一頁——在你寄信之前,沒有提交,也沒有刪除任何東西。

1.4.5 之前刪除是兩次 tool call 加一次確認。有些 AI 用戶端會在自己的核准層擋掉那次確認,服務端完全收不到訊息,使用者手上只剩一份預覽、資料沒被刪掉。改成一條一定走得完的路,取代兩條中間可能斷掉的路。

完整生命週期見 docs/account-lifecycle.md,公開隱私政策在 paceandstaystrong.com/zh/privacy.html(英文版為準)。


目前限制

  • 教練不直接登入 Apple Health、Garmin Connect 或其他裝置帳號;主要的自動資料路徑目前仍是 Intervals.icu。
  • 託管版會按日期保存你提供的睡眠分數、睡眠時長、昨夜 HRV 與靜息心率,直到你刪除帳號資料。教練每次讀取最近 28 天,這不是保存期限;其他傳入的恢復數字只供當次判斷。要拿掉某一天的恢復紀錄,說那天的紀錄不算即可,但那一天是整筆拿掉,不能只留其中一個數字,詳見 資料說明。
  • 本產品不觀察 Intervals 之後的每一段裝置同步,因此不會把「Intervals 收下了」說成「已經在手錶上」。
  • 自架是給開發者/自管的人;一般使用者應優先用託管版。
  • 裝置相容性是逐條路徑的證據,不會因為 Garmin 已驗證就推論其他裝置一定相同。
  • 這是一個人的專案,不是公司。不保證服務不中斷,也可能改變。

遇到問題

  • [支援頁](https://paceandstaystrong.com/zh/support.html):匯出、刪除、更正、撤銷授權。匯出與更正你在對話裡自己做;刪除整個帳號是這一頁說明的寫信申請。上面也有直接寄給開發者的信箱。
  • [Issue tracker](https://github.com/atomchung/long-run-hybrid-coach/issues):bug 與功能建議。它是公開且永久的,不要貼健康/訓練/計畫內容、Intervals 的 athlete id、token 或任何憑證。要指認自己的帳號,用你資料匯出檔裡那個不可還原的參照碼就夠了。
  • 認為是資安或隱私漏洞的話,不要公開描述,直接寄信。

技術文件

目前 release 對外有 24 個 MCP tool、2 個 prompt、34 個 CLI 指令、4 份 JSON Schema contract、12 張 identity 表。這些數量由測試從真實程式碼推導,避免這份文件自己走鐘。

Long Run Hybrid Coach 是獨立專案,與 Garmin、Intervals.icu、Apple 或其他裝置/平台供應商沒有隸屬、背書或贊助關係。程式碼以 MIT License 釋出。