文档

posture-patrol

试用

Track your posture throughout the workday with manual logging, smart break reminders, ergonomic scoring, posture streaks, and trend analysis. Calculates spinal load, suggests desk stretches, tracks slouch patterns, and generates weekly posture reports with actionable recommendations.

它能做什么

Track your posture throughout the workday with manual logging, smart break reminders, ergonomic scoring, posture streaks, and trend analysis. Calculates spinal load, suggests desk stretches, tracks slouch patterns, and generates weekly posture reports with actionable recommendations.

技能文档

Posture Patrol

A standalone command-line tool for tracking posture quality, scheduling movement breaks, calculating spinal load, and building better sitting habits. Pure Python (stdlib only) with a JSON file database.

Quick Start

# Set up your profile
python3 scripts/posture_patrol.py init

# Log a posture check
python3 scripts/posture_patrol.py check good "feet flat, back straight"
python3 scripts/posture_patrol.py check poor "slouching forward"

# Schedule break reminders
python3 scripts/posture_patrol.py breaks --interval 30

# See today's score
python3 scripts/posture_patrol.py score

# Weekly report
python3 scripts/posture_patrol.py report week

Commands

CommandDescription
initCreate your profile (height, desk type)
check [notes]Log a posture observation
score [today|week]Show your posture score
report [week|month]Detailed report with charts and recommendations
streakShow your good-posture streak
breaks [--interval N]Generate a break reminder schedule
stretchShow desk stretches for your problem areas
spinal-loadCalculate estimated spinal loading from posture data
ergonomicsShow ergonomic checklist and personalized recommendations
patternIdentify when you're most likely to slouch
goal [minutes]Set daily good-posture goal

How It Works

Posture Scoring

Each check is rated 1-3:

  • Good (3): Ears over shoulders, shoulders back, feet flat, lumbar supported
  • Fair (2): Slight forward lean, one foot up, shoulders rounded slightly
  • Poor (1): Slouched, hunched forward, head far forward, legs crossed

Daily score = average of all checks × 33.3 (scaled to 0-100).

Spinal Load Calculation

Poor posture increases the effective load on your cervical spine:

  • Neutral head (0°): ~10-12 lbs on neck
  • 15° forward: ~27 lbs
  • 30° forward: ~40 lbs
  • 45° forward: ~49 lbs
  • 60° forward: ~60 lbs

The tool estimates cumulative excess spinal load from your posture data.

Pattern Detection

Analyzes your check times to identify:

  • High-risk hours — when you're most likely to slouch
  • Post-lunch dip — posture degradation after eating
  • End-of-day fatigue — slouching increases with work hours
  • Meeting vs. solo work — if you log context

Desk Stretches

Recommends stretches based on your problem patterns:

  • Neck rolls for forward head posture
  • Shoulder blade squeezes for rounded shoulders
  • Hip flexor stretches for prolonged sitting
  • Chin tucks for text neck

Data Storage

Data is stored in ~/.posture_patrol.json. Delete to reset.

References

  • Spinal Biomechanics
  • Desk Ergonomics Guide

License

MIT © Denis Voronin

相关技能

Track sleep vs optimal, calculate accumulated sleep debt, and suggest evidence-based recovery schedules. Chronotype detection, quality-weighted sleep tracking, ASCII charts, and caffeine/alcohol impact monitoring.

1 次安装

Log and track daily calorie intake, macronutrients, body weight, and waist measurements locally in a SQLite database. Provides granular statistics, weekly averages, and future calorie budgets.

5 次安装

Track symptoms over time and generate doctor-ready timelines. Correlates symptoms with food, weather, medication, activity, sleep, and stress. Detects patterns, flare-ups, and produces concise clinical reports.

Help users do a gentle burnout risk check-in by reflecting on exhaustion, detachment, overload, and recovery. Use when the user says they feel drained, emoti...

14 次安装

Smart water intake tracking based on body weight, weather, and activity level. Calculates personalized hydration targets, adjusts for caffeine and alcohol consumption, tracks streaks with gamification, generates hourly drinking schedule, and provides hydration education with urine color chart reference.

以最后一次进食为起点记录间歇性与长时断食,估算当前阶段,并在 24 小时后给出电解质与复食建议。

47 次安装2 星标