前言¶
DeepSeek Harness（DSH）把能力拆成可安裝的插件；日常開發裏左側欄往往是入口。若你按 Jack Daniels 的 VDOT 安排訓練，配速和等效成績通常要查表或另開工具，和 Harness 界面是分開的。dsh-running 由社區維護者 Okinging 發佈，屬於客戶端類插件：在 Web GUI 左側欄增加「跑步」頁，用一場比賽成績反算跑力值，並給出 E/M/T/I/R 五區訓練配速與等效成績，計算全部在瀏覽器內完成。
這是什麼¶
一句話：dsh-running 在 DSH 左側欄註冊「跑步」入口，中央區域展示跑力（VDOT）與五區配速頁面；一期只做「跑力」這一項功能。
- 倉庫：Okinging/dsh-running
- 社區目錄頁：skillhub.cn/plugins/Okinging/dsh-running（獨立索引站點，與 DeepSeek / 幻方無官方從屬關係）
- 實現方式：純前端，不註冊 Host 資源；成績與最近一次輸入保存在本機
localStorage（鍵名dsh.running.v1）
核心功能¶
跑力（VDOT）反算¶
在頁面中選擇比賽距離、輸入完賽時間（例如 20:00 或 1:31:31），結果即時更新。算法按 Daniels & Gilbert（Oxygen Power, 1979，不調參）在瀏覽器中計算，不是從印刷表抄錄整表數據。
反算涉及的關係（資料原文口徑）：
VO2(v) = -4.60 + 0.182258·v + 0.000104·v²（v：米/分鐘）%VO2max(t) = 0.8 + 0.1894393·e^(−0.012778·t) + 0.2989558·e^(−0.1932605·t)（t：分鐘）VDOT = VO2(v) / %VO2max(t)
E/M/T/I/R 五區配速¶
頁面在跑力基礎上給出五區訓練配速與等效成績。五區按 %VO2max 劃分：E 59–74、M 75–84、T 83–88、I 95–100、R 105–110。
與 DSH 的集成方式¶
插件通過 cordis.patch.yml 與客戶端 bundle 注入側邊欄與佈局相關模塊（見倉庫 package.json 的 dsh.client 字段）。左側欄會出現跑步小人圖標，點開即進入「跑步」頁面。
安裝與啓用¶
需要 DSH 0.2.1-rc.2 或同一條版本線（^0.2.1-rc.2）。當前插件版本爲 1.0.0，許可證 MIT。
1. 把倉庫裝進 profile¶
推薦用 git 依賴並固定到 tag：
pnpm add "git+https://github.com/Okinging/dsh-running.git#v1.0.0"
也可以在 DSH 裏讓 Agent 通過插件管理器安裝同樣的 git spec。
包名沿用 @local/dsh-running（從 git 安裝時 pnpm 會按此包名寫入依賴）。
2. 加入 profile bundles¶
在 profile 的 package.json 裏把 @local/dsh-running 加進 dsh.profile.bundles，重啓 DSH。
3. 確認入口¶
重啓後左側欄應出現跑步小人圖標，點開即可使用。
可選：通過自定義插件市場安裝¶
DSH 目前沒有官方插件市場，但支持第三方索引源。本倉庫在 GitHub Pages 提供格式 1 索引：
- 在「插件」頁啓用實驗性的自定義插件市場（若尚未啓用）。
- 打開「插件 → 發現 → 添加索引源」，填入：
https://okinging.github.io/dsh-running/index.json
- 搜索「跑步」，安裝
1.0.0。索引條目固定到具體 commit，升級需索引更新後纔會變化。
典型用法¶
- 在左側欄圖標欄點擊「跑步」。
- 選擇比賽距離，輸入完賽成績；頁面會即時刷新 VDOT、五區配速與等效成績。
- 再次進入同一瀏覽器時，最近一次輸入會從
localStorage（dsh.running.v1）自動恢復。
適用場景與注意¶
適合誰：已在用 DSH Web GUI、並希望把 Daniels VDOT 與 E/M/T/I/R 配速查算放在 Harness 側邊欄裏的跑者或教練；不需要把成績同步到服務端時，本機存儲足夠。
環境與兼容：README 記載已在 DSH 0.2.1-rc.2（Windows，Web GUI）驗證。DSH 仍在 0.2.x 快速迭代，客戶端模塊 API 可能變動；不兼容時應在 GitHub Issues 附上 DSH 版本與報錯。
安全與權限：插件以當前 DSH 進程及 Web 前端權限運行；安裝前建議瀏覽倉庫源碼與 MIT 許可證。本插件不向外發送成績，但任何第三方插件都應按你的信任策略審查後再裝入 profile。
數據差異：頁面結果是公式實時計算；與印刷表逐格對拍屬於開發期校驗（倉庫 tools/vdot-check.mjs，不隨包加載），日常使用若與紙質表有微小差異，以你採用的訓練體系爲準。
結尾¶
dsh-running 把 VDOT 跑力與 E/M/T/I/R 配速收進 DSH 左側欄的一頁裏，純前端、無 Host 資源，適合在 Harness 裏順手查配速。安裝與 bundle 配置以 README 爲準；更多信息見 GitHub 倉庫 與 社區目錄頁。
