이 레포, 나한테 필요한가?
사람 검수 전
- 무엇인가
- 스마트밴드에 탑재된 가속도 센서로 배드민턴 스윙 동작을 분석하는 오픈소스 프로젝트예요.
- 마치 손목에 찬 시계가 '지금 네가 포핸드 오버헤드 스윙을 했구나'라고 알려주는 것처럼, 기계학습 모델이 동작의 방향과 형태를 분류해줍니다.
- 샤오미 밴드 9 Pro 같은 제한된 웨어러블 기기에서도 가볍게 동작하도록 설계되었어요.
[README-001 · README-002]- 할 수 있는 일
- 배드민턴 스윙 분류 앱 [README-001 · README-003]
- 진입 조건
- 고급자용 · JavaScript [분석]
- 먼저 확인
- 현재 샤오미 Vela 전용이므로 다른 웨어러블 기기로 포팅 시 상당한 추가 작업이 필요합니다. [README-004 · README-002]
이걸로 실제로 할 수 있는 일
기능명보다 사용자가 완성할 수 있는 작업과 결과를 우선해 정리했습니다.
배드민턴 스윙 분류 앱
샤오미 스마트 밴드에서 실시간으로 포핸드/백핸드, 오버헤드/언더핸드 스윙을 구분해주는 웨어러블 앱
데이터 수집 도구
라벨이 붙은 가속도계 데이터를 연속 기록하여 모델 학습용 데이터셋을 만드는 컬렉터 앱
ML 파이프라인
Node.js 스크립트로 데이터 복구, 특징 추출, 모델 학습, 검증, 온디바이스 패킹까지 자동화하는 재현 가능한 파이프라인
기능보다 중요한 건
내 상황과의 적합성.
공식 기능과 시작 조건을 바탕으로 한 AI 판단입니다. 도입 전 원문과 실제 환경에서 다시 확인하세요.
- 샤오미 스마트 밴드에서 배드민턴 스윙 피드백 앱을 만들고 싶은 경우
- 웨어러블 기기에서 동작 분류 ML 모델을 직접 학습하고 배포해보고 싶은 경우
- 오픈소스로 재현 가능한 운동 분석 파이프라인을 구축하려는 연구자나 개발자
- 다른 브랜드의 웨어러블 기기(애플워치, 갤럭시워치)에서 바로 사용해야 하는 경우
- 왼손잡이 사용자를 포함한 양손 동작 분석이 필요한 경우
- 라켓 속도나 칼로리 같은 정량적 운동 지표가 필요한 경우
기술과 도입 조건
자동 감지된 기술 스택, 문서 상태와 유지보수 메모를 한곳에 모았습니다.
JavaScript · Vela JS Quick App · Node.js · aiot-toolkit · @aiot-toolkit/jsc
README에 설치, 빌드, 실행 방법이 상세히 설명되어 있습니다. 코드 예제나 데모는 포함되어 있지 않습니다.
최근 7일 이내 push 기록이 있습니다. 유지보수 품질과 응답 속도는 별도 확인이 필요합니다.
코드 위험 신호를 확인하고 있습니다.
저장소를 실행하지 않고 공개 텍스트 파일과 설치 경로를 읽고 있습니다.
저장소 전체 정적 검사
커밋을 고정하고 저장소의 소스 파일 전체를 파일 단위로 확인합니다. 설치·빌드·실행은 하지 않습니다.
가장 짧은 시작 경로
- 01설치
저장소 루트 잠금 파일 기준으로 pnpm을 사용합니다. 설치 전에 공식 문서의 사전 요구사항과 설치 명령을 직접 확인하세요. 자동 분석은 이 단계를 확정하지 못했습니다.
- 02실행
pnpm run build:all로 앱과 컬렉터를 빌드한 후, aiot release --enable-jsc로 기기에 배포합니다.
GitExplain 자동 분석은 설치 명령을 직접 실행해 검증한 결과가 아닙니다.
아래 내용을 Codex 같은 코딩 에이전트에 붙여 넣으면 공식 문서를 다시 확인한 뒤 내 환경에 맞는 설치를 안내합니다.
너는 내 로컬 개발 환경에서 오픈소스 저장소를 안전하게 설명하고 설치하는 시니어 엔지니어야.
저장소: https://github.com/yixuan-wu39/bandminton
GitExplain 요약: 스마트밴드에 탑재된 가속도 센서로 배드민턴 스윙 동작을 분석하는 오픈소스 프로젝트예요. 마치 손목에 찬 시계가 '지금 네가 포핸드 오버헤드 스윙을 했구나'라고 알려주는 것처럼, 기계학습 모델이 동작의 방향과 형태를 분류해줍니다. 샤오미 밴드 9 Pro 같은 제한된 웨어러블 기기에서도 가볍게 동작하도록 설계되었어요.
주요 언어: JavaScript
난이도 메모: 고급자용
해야 할 일:
1. 먼저 저장소의 최신 README, 설치 문서, manifest를 읽고 현재 기본 브랜치 기준으로 설명해줘.
2. 이 저장소가 무엇이고 내가 무엇을 만들 수 있는지 비개발자도 이해할 수 있게 짧게 설명해줘.
3. 내 운영체제와 기존 개발 환경을 먼저 질문한 다음, 가장 안전한 설치 방법을 단계별로 제시해줘.
4. 명령을 실행하기 전 각 명령이 바꾸는 것과 예상 결과를 알려줘. 파괴적인 명령은 자동 실행하지 마.
5. 필요한 API 키나 비밀 값은 채팅이나 코드에 직접 적게 하지 말고 환경 변수와 .env 예시로 안내해줘.
6. 설치 후 최소 예제를 실행해 성공 여부를 확인하고, 실패하면 오류 원인과 되돌리는 방법을 알려줘.
7. GitExplain 요약과 공식 문서가 다르면 공식 문서를 우선하고 차이를 명시해줘.
GitExplain이 정리한 시작 메모:
1. 설치: 저장소 루트 잠금 파일 기준으로 pnpm을 사용합니다. 설치 전에 공식 문서의 사전 요구사항과 설치 명령을 직접 확인하세요. 자동 분석은 이 단계를 확정하지 못했습니다.
2. 실행: pnpm run build:all로 앱과 컬렉터를 빌드한 후, aiot release --enable-jsc로 기기에 배포합니다.도입 전에 놓치기 쉬운 점
현재 샤오미 Vela 전용이므로 다른 웨어러블 기기로 포팅 시 상당한 추가 작업이 필요합니다.
[HIGH · README-004 · README-002]왼손잡이 사용자나 양손 동작 분석은 현재 지원되지 않습니다.
[MEDIUM · README-004 · README-002]근거 원장
이 표는 원문이 어떤 분석 항목에 연결됐는지를 보여주며, 사실 정확도를 보증하는 점수는 아닙니다.
이 해설로 저장소를 이해하셨나요?
입력 내용 없이 선택 결과만 기록합니다.