把枯燥的现实训练，变成一场可以升级记录的异世界冒险

一个对话驱动的 AI 健身教练框架：训练记录、RPG 属性成长、剧情推进三者联动。你的每一次训练都会转化为角色成长和故事推进——不只是数据，还是冒险。

真实训练 → 经验值 & 属性成长 → 剧情推进 → 下一次训练的动力

• 🎯 对话式训练：和 AI 聊天就能记录训练、获取建议、推进剧情
• 📊 自动加点：完成训练自动获得 EXP，升级后属性点自动分配（力量/耐力/体质/敏捷/智力）
• 📝 智能记录：自动追踪重量、次数、RPE、体感反馈，AI 会参考历史数据给建议
• 🎭 剧情模式：可选的故事系统，把每次训练映射成你设定的世界里的冒险
• 🌍 自由世界观：完全可定制。剑与魔法、武侠、乙游只是例子，也可以直接描述任何世界；未设定时可用预置的剑与魔法世界
• 🔄 恢复感知：智能判断中断后的恢复强度，不硬来
• 🤖 越用越懂你：AI 会记住你的偏好、弱项和进步节奏

已经有能读写文件的 AI Agent（Cursor、Claude Code、Codex 等）时，把安装和第一次训练交给它。想自己克隆，用路径 2。

把下面这段话发给你的 Agent：

请帮我安装 https://github.com/k1ein-chen/fitness-coach-rpg ，按仓库 README 初始化档案。世界观可以自由定制（比如异世界、武侠、乙游，或者我自己描述的任何世界），请先问我想要什么世界观，然后引导我开始第一次训练。

English:

Please install https://github.com/k1ein-chen/fitness-coach-rpg and initialize my profile following the repo README. The worldview is fully customizable (for example isekai, wuxia, otome, or any world I describe). Ask which worldview I want first, then guide me through my first workout.

Agent 会克隆仓库、按本 README 初始化档案，先问你想要什么世界观，再引导第一次训练。

git clone https://github.com/k1ein-chen/fitness-coach-rpg.git
cd fitness-coach-rpg

方式一：脚本初始化（推荐）

python scripts/init_profile.py --name 你的名字 --theme 武侠

--theme 是自由文本。「武侠」只是例子，可以换成你自己描述的任何世界。

方式二：手动复制

cp -r assets/starter-profile user-data
# 然后编辑 user-data/PROFILE.md 填入你的信息

💡 脚本只用 Python 标准库，无需安装依赖。没有 Python？直接复制模板也能用。

在支持读写本地文件的 AI 里打开项目，对 AI 说：

• "开始训练" — 直接开练
• "初始化档案" — 完整设定流程
• "帮我做个计划" — 制定训练计划

AI 会自动读取你的档案和历史记录，给出个性化建议。

每次训练后，系统会自动：

1. 记录训练数据（动作、重量、次数、RPE）
2. 计算并发放经验值
3. 检查是否升级，自动分配属性点
4. 更新训练统计和个人最佳记录

开启后，你的训练会映射为故事情节：

世界观可以完全按你的描述定制。下表只是几种常见风格的等级称号示例，不是可选清单。预置世界在 worlds/default/（剑与魔法）；也可以用 assets/starter-profile/story/WORLD.md 从空白模板写自己的世界。

不想要剧情？选择「经典模式」，纯教练功能。

预设的凯圣王×谭指导适合力量增长。其他目标可以选择：

初始化时告诉 AI："我想跟周六野练"或"力量日跟凯圣王，有氧跟帕梅拉"——混搭也可以。

详见 教练风格指南。

fitness-coach-rpg/
├── SKILL.md                    # AI 行为说明书（核心）
├── assets/starter-profile/     # 空白存档模板
├── worlds/default/             # 预置世界设定（剑与魔法）
├── references/                 # 训练方法论、RPG 规则、叙事模板
├── scripts/                    # 辅助脚本（初始化、更新状态等）
├── templates/                  # 训练日志模板
└── examples/                   # 示例存档（用了一个月后的样子）

初始化后会生成 user-data/ 目录，存放你的个人档案和训练记录。

这不是需要安装的 app 或插件——它是一套本地文件 + AI 行为规则。

需要的环境：

• 可读写本地文件的 AI 环境
• 可持续访问同一工作区的多个 Markdown/JSON 文件
• 最好支持时间获取和长期上下文

推荐平台：

• Cursor（原生支持）
• 其他支持文件读写的 AI IDE/Agent

没有 Python 也能用：

AI 可以直接手写 JSON 记录，脚本只是让更新更可靠。

• 完整示例存档 — 用了一个月后的样子
• 训练方法论 — 凯圣王×谭指导的力量训练体系
• RPG 规则详解 — 等级、属性、经验值计算
• 叙事引擎 — 训练如何映射为剧情
• 更新日志 — 版本变化

• 小红书：@龙酱
• GitHub：k1ein-chen/fitness-coach-rpg

如果这个项目对你有帮助，请给个 Star ⭐ 支持一下！

这是对作者最大的鼓励，也能让更多人发现这个项目。

MIT License

Fitness Coach RPG is a conversation-driven AI fitness coach framework that links workout logging, RPG stat progression, and optional story mode.

Features:

• Chat-based workout tracking (weight, reps, RPE, notes)
• Auto stat allocation: training → EXP → level up → attribute growth
• Optional story mode: map real workouts to fantasy adventures
• Fully customizable worldview. Sword & Sorcery and Wuxia are examples; describe any world you want. A preset Sword & Sorcery world is included if you do not want to start from scratch.
• Recovery-aware planning with smart intensity adjustment
• Local Markdown/JSON storage — your data stays yours

Quick Start:

1. Hand it to an agent (recommended) if you already use Cursor, Claude Code, Codex, or another file-aware agent. Paste:

Please install https://github.com/k1ein-chen/fitness-coach-rpg and initialize my profile following the repo README. The worldview is fully customizable (for example isekai, wuxia, otome, or any world I describe). Ask which worldview I want first, then guide me through my first workout.

2. Clone manually:

git clone https://github.com/k1ein-chen/fitness-coach-rpg.git
cd fitness-coach-rpg
python scripts/init_profile.py --name YourName --theme "Sword & Sorcery"

--theme is free text. "Sword & Sorcery" is only an example.

Then open the project in a file-aware AI environment and say "Start training" or "Initialize profile".

See RELEASE-v0.1.md for more details in English.