0.x: 베타와 화면해설작가 파일럿1.0.0: 코드 서명과 실제 파일럿 정확도 기준을 통과한 공개판- 패치: 호환되는 버그 수정
- 마이너: 호환되는 기능 추가
- 메이저: 프로젝트 스키마 또는 사용 흐름의 비호환 변경
다음은 공개판과 검증 완료로 안내하는 릴리스의 기본 절차입니다. 제한된 파일럿 베타는 아래 예외 원칙에 따라 사람 검증 일부를 배포 뒤에 진행할 수 있습니다.
main에서 작업 트리가 깨끗한지 확인합니다.- 수정 내용을 작고 설명 가능한 커밋으로 정리하고
npm ci후npm run verify를 실행합니다. - 한컴오피스 2022에서 테스트 HWPX가 복구 경고 없이 열리는지 확인합니다.
npm run dist:win으로 NSIS 설치본을 생성합니다.- 깨끗한 Windows 10/11 PC에서 설치, 실행, 제거, 한글 경로를 확인합니다.
내 PC에서 분석 + 화자 분리(실험)은 공식 4화자 샘플과 실제 한국어 다화자 영상에서 별도로 확인합니다. CHANGELOG.md와package.json버전을 갱신하고, 해당 태그 이름으로docs/release-notes-vX.Y.Z.md를 작성합니다. GitHub 릴리스 본문에는 이 파일이 자동으로 첨부됩니다.- 검증된 커밋을
main에 직접 푸시합니다. git tag vX.Y.Z를 만들고 원격 저장소에 푸시합니다.- GitHub Actions가 설치본, 블록맵,
latest.yml, SHA-256을 Releases에 게시했는지 확인한 뒤 베타 참여자에게 전달합니다.
소유자가 제한된 참여자를 위한 파일럿 베타 배포를 명시적으로 승인하면, 아래 사람 검증 항목을 아직 수행 중인 상태에서도 0.x 시험판을 배포할 수 있습니다. 이 승인은 파일럿을 시작할 권한일 뿐, 실제 작가 사용성·정확도·납품 적합성·공개판 기준 통과를 뜻하지 않습니다.
- 릴리스 노트와 다운로드 안내에
파일럿 베타임과 아직 완료하지 않은 사람 검증을 적습니다. - 자동 테스트·합성 자료·개발자 점검과 실제 작가 파일럿 결과를 구분합니다.
- 태그 전
npm ci,npm run verify, 설치본 생성은 생략하지 않습니다. 한컴오피스 실문서·실제 작가 등 뒤에 진행할 사람 검증은 릴리스 노트에 구체적으로 적습니다. 게시 후에는 GitHub Actions 성공, 설치본·블록맵·latest.yml·SHA-256, 실제 서명 상태를 다시 확인합니다. - 기존 베타 설치본에서 새 버전을 찾고 내려받는지 확인하되, 자동 업데이트 확인만으로 설치·데이터 보존 검증을 대신하지 않습니다.
- 아래 파일럿 통과 기준을 모두 충족하기 전에는
1.0.0, 공개판, 검증 완료 또는 납품 적합으로 표현하지 않습니다.
원격 저장소는 https://github.com/buildergarlic/ginuni.git으로 고정합니다. 관리자와 AI 에이전트의 일반 수정은 로컬 검증 후 main에 직접 푸시합니다. PR은 외부 기여자와 사람이 맥락을 공유하고 토론할 필요가 있을 때만 사용합니다. 자동 생성 코드와 자동 스크린샷을 AI가 다시 승인하는 절차는 필수 검증으로 취급하지 않습니다.
설치형 앱은 시작 5초 후 공개 GitHub Releases를 확인합니다. 새 버전은 백그라운드에서 내려받고, 검수 중 수정 내용을 저장한 뒤 사용자가 재시작하여 업데이트를 눌렀을 때 NSIS로 교체합니다. 개발 모드에서는 업데이트 서버를 호출하지 않습니다.
- GitHub Sponsors 주소,
.github/FUNDING.yml, 앱의 후원 CTA가 모두buildergarlic계정을 가리키는지 확인합니다. - GiNuNi 자체 소스 코드의 라이선스는 소유자가 채택한 AGPL-3.0-only입니다. 루트
LICENSE·NOTICE,package.json·package-lock.json의 라이선스 표시를 일치시킵니다. - 패키징 후
release/win-unpacked/resources/licenses에 루트LICENSE·NOTICE·THIRD_PARTY_NOTICES.md와resources/licenses의 제3자 고지·전문이 모두 포함됐는지 확인합니다. 루트 파일은build.extraResources에서 직접 복사하므로 별도 사본을 수동 관리하지 않습니다. - FFmpeg·FFprobe의 실제
-version·-L출력과 포함 라이브러리를 확인하고, 배포 바이너리에 대응하는 소스·빌드 자료의 제공 경로를 릴리스 다운로드 옆에 명시합니다. 라이선스 전문이나 프로젝트 홈페이지 링크만으로 대응 소스 제공 확인을 대신하지 않습니다. 자세한 범위는 제3자 구성 요소 고지를 따릅니다. - 저장소 공개 전 API 키, 개인 영상 경로, 사용자 프로젝트, 민감한 HWPX 내용이 Git 이력에 없는지 검사합니다.
- 인증서가 없는 베타 설치본은 무서명 배포임과 Windows 경고 가능성을 릴리스 노트에 명확히 기록합니다.
1.0.0공개판 전에는 신뢰할 수 있는 코드 서명을 적용합니다.
인증서 발급 전 베타 설치본은 무서명으로 배포하므로 Windows SmartScreen에 알 수 없는 게시자 경고가 나타날 수 있습니다. 사용자는 반드시 공식 buildergarlic/ginuni Releases와 SHA-256을 확인해야 합니다. 자체 서명 인증서는 일반 사용자 PC에서 신뢰되지 않으므로 사용하지 않습니다.
릴리스 워크플로는 WIN_CSC_LINK와 WIN_CSC_KEY_PASSWORD가 모두 없으면 설치 프로그램과 앱 실행 파일이 실제 NotSigned인지 검사하고 베타판을 게시합니다. 두 비밀값이 모두 있으면 서명된 결과만 허용하고 Authenticode 상태가 Valid가 아니면 배포를 중단합니다. 하나만 등록된 잘못된 상태도 즉시 실패합니다.
- 신원 확인을 거치는 공개 신뢰 코드 서명 인증서 또는 CI에서 사용할 수 있는 코드 서명 서비스를 마련합니다.
.pfx/.p12파일로 제공되는 인증서는 암호로 보호하고 Git 저장소와 공유 폴더에 넣지 않습니다.- 인증서의 게시자 이름, 유효기간, 코드 서명 용도를 확인합니다.
Microsoft Store의 MSIX 배포는 Microsoft가 서명하며, GitHub Releases에서 EXE를 직접 배포할 때는 별도의 Authenticode 서명이 필요합니다. Microsoft Artifact Signing이나 하드웨어·클라우드 키 방식 인증서를 선택하면 현재 PFX 방식 대신 해당 서비스용 GitHub Actions 연동을 별도로 구성해야 합니다.
PowerShell에서 실제 인증서 경로를 사용해 다음 명령을 실행합니다. Base64 문자열과 암호는 화면이나 로그에 출력하지 않습니다.
$certificatePath = 'C:\안전한 위치\buildergarlic-code-signing.pfx'
[Convert]::ToBase64String([IO.File]::ReadAllBytes($certificatePath)) | gh secret set WIN_CSC_LINK --repo buildergarlic/ginuni
gh secret set WIN_CSC_KEY_PASSWORD --repo buildergarlic/ginuni두 번째 명령이 기다리면 인증서 암호를 입력하고 Enter를 누릅니다. 등록 여부는 값이 아니라 이름만 확인합니다.
gh secret list --repo buildergarlic/ginuni인증서가 생긴 뒤 서명 배포에 사용할 선택 비밀값은 WIN_CSC_LINK, WIN_CSC_KEY_PASSWORD입니다. 두 값을 함께 등록하면 릴리스 워크플로가 설치 프로그램과 패키징된 앱의 Authenticode 상태가 Valid인지 검사합니다. 인증서가 없는 현재 베타 배포에는 등록하지 않습니다.
서명에는 SHA-256과 타임스탬프를 사용해야 인증서가 만료된 뒤에도 서명 시점의 유효성을 검증할 수 있습니다. 실제 인증서 등록 후 테스트 태그로 릴리스하고, 내려받은 설치본의 속성 → 디지털 서명과 다음 명령 결과를 확인합니다.
Get-AuthenticodeSignature '.\ScreenDescriptionScriptMaker-X.Y.Z-Setup.exe' | Format-List Status,StatusMessage,SignerCertificate,TimeStamperCertificate- 허가된 10분, 30분, 2시간 한국어 영상으로 테스트
- 명료한 음성에서 대사 경계 95%가 수동 정답 ±1초 이내
- 다화자, 동시 발화, 음악, 1초/2초 무음 사례 검수
- 모든 자동 오류를 앱에서 수정 가능
- HWPX가 한컴오피스 2022에서 복구 경고 없이 열림
- Windows 10/11에서 별도 FFmpeg·Python 설치 없이 동작
- Windows x64에서 별도 Python·API·인터넷 없이 로컬 화자 분리 실행
v0.6.0-beta.1 파일럿 시작 승인 시점에는 위 기준 외에도 실제 화면해설작가 5–8명의 첫 사용·오류 복구·납품 동선, 실제 OpenAI 계정 연결, 한컴오피스 긴 문서 페이지 나눔·서식 검증이 남아 있습니다. 이 결과는 파일럿 후 별도로 기록하며 사후에 통과한 것으로 소급 표현하지 않습니다.
package-lock.json을 항상 커밋합니다.- Dependabot의 정기 버전 PR은 사용하지 않습니다. GitHub 보안 경고와
npm audit결과를 확인한 뒤 필요한 업데이트를 로컬에서 적용하고 전체 검증 후main에 직접 푸시합니다. - Electron 보안 업데이트는 우선 처리합니다.
- FFmpeg·yt-dlp 변경 시 로컬 파일과 유튜브 링크를 모두 다시 검증합니다.
- sherpa-onnx·Pyannote·3D-Speaker 변경 시 고정 크기·SHA-256, 제3자 고지, 공식 4화자 샘플 검출을 다시 검증합니다.