생기부 ChatGPT 연결 프로그램

기존 생기부 HTML을 유지하면서 본인의 ChatGPT 계정으로 AI 작성 보조를 사용하는 선택형 프로그램입니다. 연결 프로그램 자체는 무료이며, AI는 본인 ChatGPT 요금제의 사용 권한·한도·크레딧 설정을 따릅니다.

처음 시작

  1. ZIP을 완전히 압축 해제합니다. 기존 생기부 HTML은 원래 위치에 그대로 둡니다.
  2. Windows는 start-windows.cmd, Mac은 start-mac.command를 실행합니다. Mac에서 실행 확인이 나타나면 신뢰하는 파일인지 확인한 뒤 Finder의 ‘열기’를 사용하세요.
  3. 처음에는 공식 nodejs.org에서 실행에 필요한 Node.js를 내려받고 SHA-256을 검증합니다. 관리자 권한과 Codex 설치는 필요 없습니다. 학교 PC의 실행 정책으로 막히면 전산 담당자에게 문의하세요.
  4. 연결 화면의 Continue with ChatGPT를 누릅니다. OpenAI 공식 화면에서 로그인하고 이 앱의 ChatGPT 사용 권한을 확인합니다.
  5. 가상 문장으로 테스트로 실제 생성 성공을 확인합니다.
  6. 생기부 도우미 v1.22 이상 HTML에서 AI 작성 보조 → ChatGPT 계정을 선택합니다. 양쪽 화면의 확인 번호가 일치하면 연결 프로그램에서 이 HTML 연결 허용을 한 번 누릅니다.

기존 기록과 백업

연결 프로그램은 학생 DB·백업을 읽거나 이전하지 않습니다. 기존 HTML의 브라우저 저장소를 그대로 사용합니다. 브라우저나 PC를 바꾸려면 기존 HTML에서 JSON 백업을 내보내 새 환경에 복원해야 합니다. ChatGPT 인증 정보와 연결 코드는 학생 백업에 포함되지 않습니다.

매번 사용할 때

연결 프로그램 실행 창을 열어 둔 상태에서 기존 HTML을 사용하세요. 허용 후 같은 브라우저에서 HTML을 다시 열면 자동 연결됩니다. 허용은 30일간 유지되며 만료·계정 변경 시 다시 확인이 필요합니다. ChatGPT 로그인이 유효하면 다시 로그인할 필요는 없습니다. 브라우저의 로컬 네트워크 접근 권한 요청에는 허용이 필요합니다.

무엇이 전송되나요?

AI 버튼으로 요청한 메모·본문 또는 확인 후 첨부한 PDF가 로컬 연결 프로그램을 거쳐 OpenAI로 전송됩니다. 텍스트는 기존 이름 가림 처리를 거치지만 모든 개인정보 제거를 보장하지 않습니다. 결과는 교사가 검토한 뒤 직접 반영합니다. 자동 파일 접근·셸 실행·학생 명렬/전체 백업 업로드 기능은 없습니다.

연결 해제·오류

HTML의 ‘자동 연결 해제’는 해당 브라우저의 재연결 권한을 삭제합니다. 연결 프로그램에서 모든 자동 연결 허용을 해제할 수도 있습니다. 계정 로그아웃은 연결 프로그램에서 실행합니다. 필요하면 ChatGPT 설정 → 사용량에서 앱 권한을 해제하세요. 사용 한도 오류 때 다른 계정이나 유료 API로 자동 전환하지 않습니다.

‘로컬 연결 실패’: 프로그램이 실행 중인지, 로컬 네트워크 권한이 허용됐는지 확인하세요. ‘로그인 필요’: 연결 프로그램에서 다시 로그인하세요. ‘모델 없음’: 모델 목록을 갱신하고 선택하세요. ‘이미 실행 중’: 기존 실행 창을 사용하거나 종료 후 다시 시작하세요.

로그인 성공과 AI 생성 성공은 별도로 표시됩니다. 한도 도달·계정 자격·앱 권한·모델 미지원·일시 장애를 구분하고 오류 코드·HTTP 상태·요청 ID를 안내합니다. 서버가 제공하지 않은 한도 초기화 시각은 추측하지 않습니다. 진단에는 입력 본문이나 인증 토큰을 넣지 않습니다.

기술·보관 정보

127.0.0.1:47832에서만 동작합니다. Windows 인증 파일은 사용자 LocalAppData/SaenggibuConnector, Mac은 사용자 Library/Application Support/SaenggibuConnector에 보관합니다. 파일은 전용 접근 권한으로 보호하며 로그·HTML·백업에 OAuth 토큰을 기록하지 않습니다. 별도의 로컬 재연결 권한은 이 HTML의 브라우저 저장소에만 저장되고 학생 백업에서는 제외됩니다. 공용 PC에서는 사용 후 자동 연결 해제와 계정 로그아웃을 실행하세요. 이 폴더를 공유하거나 클라우드 동기화하지 마세요.

소스 전체는 이 ZIP의 server.mjs, lib, public에 포함돼 있습니다. Node.js 22 이상이 이미 있다면 node server.mjs로 실행할 수 있습니다. 연결 프로그램 소스는 MIT 라이선스이며 생기부 HTML의 자료·라이브러리 라이선스는 각각 기존 조건을 따릅니다.

공식 근거: Sign in with ChatGPT. ChatGPT 연결은 선택 기능이며 기존 Gemini와 오프라인 작성 기능은 유지됩니다.