HBTI 代谢脾气测试

16 道题，用约 2 分钟看看你更像「自律永动机」「奶茶雷达」，还是「压力囤囤兽」。

立即在线体验 · 查看验证研究方案

_{16 种类型均有对应中文外号、低多边形角色和可导出的结果卡。}

HBTI（Health Biomarker Type Indicator）是一个面向体重管理场景的开源研究原型。它不按胖瘦或传统体型贴标签，而是通过自我报告题目观察进食、食欲、恢复、压力和日常活动倾向，并生成易记的类型外号与卡通结果卡。

项目定位：研究支持的产品原型，不是医学诊断工具，也尚未获得医学或心理测量学验证。

界面预览

为什么值得体验

• 中文逐题作答，16 道题约 2 分钟完成
• 4 个维度、16 种类型代码和贴近生活的中文外号
• 结果包含卡通形象、倾向解释和可导出的分享卡
• 无需登录，答案仅在当前浏览器中计算，不上传或保存
• 题目、评分逻辑、研究计划与验证缺口全部公开

当前版本

当前原型已经包含：

• 一次一题的浏览器问卷与进度反馈
• 默认中文、可即时切换 English 的完整双语界面
• 可选的代谢相关指标输入
• 透明的前端计分逻辑
• 减脂、增肌健身、生活方式三种目标模式
• 16 型专属综合评价与可复制 AI 咨询摘要
• 数值范围校验和高风险情况安全分流
• 类型外号、卡通形象和 SVG 分享卡
• 候选题项库、专家评审表、认知访谈提纲、预注册草稿和验证研究方案

项目边界

HBTI 目前只能用于产品探索、自我观察和研究设计演示。它不能用于疾病筛查、风险预测、治疗建议或替代医生判断。

当前仍缺少：

• 已完成的专家评审和认知访谈
• 真实受试者的预测试与正式样本
• 信度、结构效度、效标效度与重测信度证据
• 临床有效性和跨人群稳定性证据

因此，类型结果应被理解为“当前规则下的倾向描述”，而不是稳定人格或医学结论。

本地运行

本项目没有构建步骤或第三方依赖。克隆仓库后直接用浏览器打开 index.html 即可。

git clone https://github.com/WilliamClifton-dev/hbti-prototype.git
cd hbti-prototype
start index.html

运行零依赖逻辑测试：

node --test tests/hbti.test.js

HBTI Dimensions

1. F / S
   • F: Fuel Flexible
   • S: Sugar Sensitive
2. H / C
   • H: Hunger Stable
   • C: Craving Reactive
3. R / W
   • R: Recovery Efficient
   • W: Stress Wired
4. N / D
   • N: Naturally Active
   • D: Energy Defending

Research Status

HBTI is currently an exploratory instrument, not a validated scale.

What already exists in this repo:

• prototype assessment interface
• candidate scoring framework
• validation study plan
• pilot-study protocol
• item bank
• expert review form
• cognitive interview guide
• data dictionary
• preregistration draft

What does not exist yet:

• completed expert review
• completed cognitive interviews
• pilot dataset
• psychometric validation
• clinical validation

Important Limitations

• HBTI is not a diagnostic system
• current scoring is heuristic, not empirically calibrated
• type labels are useful for product expression, but continuous scores are likely more appropriate for research analysis
• optional objective indicators are shown separately and do not alter the questionnaire-derived type

Repository Structure

.
├─ index.html                 # Static prototype entry page
├─ styles.css                 # Shared UI styles
├─ assessment.css             # Landing and questionnaire flow styles
├─ guidance.css               # Goal, safety, and AI-handoff styles
├─ hbti-data.js               # Questions, type identities, and field configuration
├─ hbti-i18n.js               # English translations and bilingual interface text
├─ hbti-avatar.js             # Parametric low-poly SVG character generator
├─ app.js                     # Assessment logic and result rendering
├─ AGENTS.md                  # Project-level working rules
├─ docs/
│  ├─ project-summary.md      # Portfolio-style project overview
│  ├─ specs/                  # Product and feature specifications
│  ├─ decisions/              # Architecture / positioning decisions
│  └─ research/               # Validation and research planning materials
├─ tasks/                     # Plan and execution notes
└─ .codex/skills/             # Local agent-skills, including custom HBTI skill

How To Run

This project currently has no package manager or build step.

To run locally:

1. Open index.html in a browser.
2. Complete the questionnaire.
3. Review the generated type result and share card.

GitHub Pages

This repository is already deployable as a static site.

Live demo:

• https://williamclifton-dev.github.io/hbti-prototype/

Deployment notes:

• GitHub Pages Deployment Guide

GitHub About

Recommended repository description:

Exploratory metabolic-typing prototype for weight-management scenarios, combining questionnaire logic, biomarker-inspired inputs, and validation-oriented research documentation.

Recommended topics:

• digital-health
• health-informatics
• frontend
• research-prototype
• questionnaire-design
• weight-management

Public Positioning

This repository is best understood as:

• a digital health product prototype
• a health-informatics portfolio project
• a validation-ready research concept

It is not yet:

• a validated medical assessment
• a clinical decision tool
• a published scientific instrument

Validation Roadmap

Planned validation path:

1. Expand and refine the item pool
2. Run expert content-validity review
3. Run cognitive interviews with target users
4. Freeze a formal survey version
5. Collect a cross-sectional validation sample
6. Test structure, reliability, and construct validity
7. Recalibrate scoring if warranted

Documentation Map

Core docs:

• Release Notes v0.1.0
• Project Summary
• Release Preparation
• Project Bio Snippets
• HBTI Assessment Spec
• Validation Study Plan (Chinese)
• Pilot Study Protocol
• Item Bank (Chinese)
• Expert Review Form (Chinese)
• Cognitive Interview Guide (Chinese)
• Data Dictionary (Chinese)
• Preregistration Draft (Chinese)

Author Context

This project is being developed from the perspective of an undergraduate student in Information Management and Information Systems within a medical university context, with an interest in digital health, structured assessment design, and research-oriented product prototyping.

License

This project is released under the MIT License. See LICENSE.