랄프 자율개발 보고

어떻게 사용하나요?

프로젝트 화면에서 새 프로젝트를 만들고, ‘할 일’에서 작업을 추가하세요. 대기·진행·확인 필요·완료 상태로 정리할 수 있습니다. 저장한 내용은 앱을 다시 열어도 남습니다.

Orkify를 준비해야 하나요?

필요 없습니다. 기존 로컬 저장 기능을 사용하므로 Orkify 구매·ZIP 설치·서버 연결 없이 사용할 수 있습니다. 작업 폴더를 정기적으로 백업하세요.

팀이 함께 쓰려면?

담당자·스프린트·실시간 공동 편집은 기본 기능에 포함되지 않습니다. 필요할 때 WeKan 또는 Vikunja 등을 별도 연결하는 방법은 전환 문서에 정리했습니다.

지금 무엇이 가능한가요?

내 PC 원고 제작은 지금처럼 사용할 수 있습니다. 웹 서비스의 기존 회원·팀 로그인과 Stripe 결제 경로도 유지합니다.

GNU Hub 결제는 바로 사용할 수 있나요?

아직 준비 중입니다. 무엇을 판매할지, 한 번 결제인지 정기 구독인지, 어떤 계정을 연결할지 먼저 정해야 합니다. 현재 Hub에서 한 번 결제하려면 계정 연결이 필요합니다. 회원 연결 없는 결제와 정기 구독은 별도 검토가 필요합니다.

새 결제나 계정 연결을 자동으로 시작하지 않습니다. 결제창에 성공이라고 표시된 것만으로 이용 권한을 지급하지 않습니다.

비밀 키는 채팅에 붙여 넣지 않습니다. 결제 연결에 필요한 설정은 서버의 안전한 설정 공간에서 관리합니다.

결제 연결 범위와 남은 준비 보기

무슨 뜻인가요?

CLI는 명령어로 실행하는 도구, Bridge는 우리 프로그램과 AI 도구의 연결 통로, 인증은 허용된 프로그램만 접근시키는 장치입니다. 로컬·루프백은 내 컴퓨터 안의 통신을 뜻합니다.

Diff는 수정 전후의 차이이고, 제안 ID는 수정 제안의 식별번호입니다. live-1은 프로젝트 식별자 중 하나입니다.

예를 들면 / 완료 조건

“날씨가 조습니다”를 AI가 “날씨가 좋습니다”로 고치자고 제안했다면, 실제 AI가 답했는지, 올바른 프로젝트에 들어왔는지, 수정 차이가 정확한지 확인합니다. 승인 전에 원문을 마음대로 덮어쓰면 안 됩니다. 실행 기록과 제안 번호도 맞아야 합니다.

이제 어떻게 사용하나요?

프로젝트 → Agent 실행을 열면 공식 CLI 구독 Bridge가 기본으로 선택되고, 이 PC 또는 연결된 Bridge PC의 설치·로그인 상태를 자동 확인합니다. 확인된 도구를 선택하고 수정 지시를 입력한 뒤 AI 변경 제안 실행을 누릅니다. 결과는 기존 버전·Diff 경로로 들어가며, 적용 여부는 프로젝트의 승인 규칙을 따릅니다.

구독 로그인 다시 확인은 원고를 전송하거나 AI 답변을 생성하지 않습니다. 다시 확인해도 입력한 지시와 직접 선택한 도구를 보존합니다. 실행 직전에도 로그인 상태를 확인하며, 다른 AI나 API 과금 방식으로 자동 전환하지 않습니다.

자동으로 확인되는 범위와 준비사항

공식 CLI가 제공하는 상태 명령을 사용합니다. Claude Code·Codex·Cursor Agent의 계정 로그인을 자동 확인합니다. Meta Muse는 공식 usage --json으로 모델 생성 없이 구독 할당량을 확인하며, 로그인 전에는 로그인 필요로 표시합니다. 데스크톱의 AI 엔진 관리에서 공식 로그인 열기로 연결한 다음 다시 확인하세요. Gemini·Antigravity·Grok는 현재 설치 버전에 비대화식 계정 상태 명령이 없어 미확인으로 유지합니다. 설치·모델 목록·과거 사용량을 구독 로그인 증거로 오인하지 않습니다. 계정 로그인 확인이 모든 모델의 권한·잔여 한도까지 보증하지는 않으며, 확인되지 않은 요금제·한도는 추측하지 않습니다.

공식 자료: Gemini 인증 · Antigravity 명령 · Grok 명령 · Muse 공식 변경 기록. Muse 1.4.13 이상은 모델 턴 없는 할당량 조회를 제공합니다. 이 PC의 Meta 계정은 현재 미로그인이므로 실제 구독 응답 성공은 아직 검증되지 않았습니다.

이미 로그인되어 있다면 API 키를 따로 입력할 필요가 없습니다. 미로그인 도구는 해당 공식 CLI에서 직접 로그인한 후 다시 확인하세요. 비밀번호·인증 토큰을 채팅으로 보내거나 복사해서 등록하지 않습니다. 실제 원고 전송은 기존의 허용 범위·승인 조건을 따르며, 자동 로그인 감지만으로 전체 AI·Diff 실검증이 완료된 것은 아닙니다.

무슨 뜻인가요?

3번이 내 컴퓨터 안의 연결이라면, 이 항목은 외부 서버까지의 연결입니다. WebSocket은 연결을 유지하며 데이터를 주고받는 방식, WSS는 이를 암호화한 방식, TLS는 통신을 보호하는 기술입니다.

무엇을 확인해야 끝나나요?

외부 주소에 실제 접속해 암호화·인증·AI 실행이 작동하고, 허용하지 않은 연결은 거절되는지 확인합니다. 내 PC 안에서만 성공한 결과로 외부 연결까지 성공했다고 판단하지 않습니다.

내가 준비할 것 / 비용

외부에서 접속 가능한 서버 주소와 인증·암호화 설정이 필요합니다. 구성에 따라 호스팅 비용이 발생할 수 있습니다. 개인 PC 전용 기능과 외부 접속 기능은 요구 범위를 구분합니다.

무슨 뜻인가요?

현재 전체 완료 판정의 네 도구는 Codex·Claude·Gemini·Cursor입니다. 설치, 올바른 명령어, 로그인, 실제 응답을 각각 확인합니다. Gemini 실행 경로는 프로젝트 규칙에 따라 설치된 Antigravity의 Gemini 모델을 우선하고, 없으면 기존 Gemini CLI를 사용합니다.

무엇을 확인해야 끝나나요?

프로그램 미설치, 로그인 안 됨, 결제·사용량 제한을 구분해야 합니다. 모든 오류를 “로그인 안 됨”으로 표시하면 안 됩니다. 공식 도움말과 실제 응답을 현재 코드 버전의 증거로 남깁니다.

이번 작업에서 Cursor CLI의 Grok 4.7 검토 응답을 받은 사실과, 네 도구의 모든 연결 경로가 통과한 것은 다른 판정입니다.

내가 준비할 것 / 비용

사용할 도구의 설치·로그인·이용 권한입니다. 하나의 서비스 구독이 모든 도구나 API 이용료를 포함한다고 가정하지 않고 계정별 조건을 확인합니다.

무슨 뜻인가요?

Bibliogon 프로그램을 실제 실행해 책 생성부터 결과 가져오기까지 확인합니다. FastAPI는 Python 서버 개발 도구이고, API는 프로그램끼리 요청과 결과를 주고받는 창구입니다.

여기서 “계약”은 법률 계약이 아니라 어떤 요청에 어떤 형식의 결과가 와야 하는지에 대한 연결 규칙입니다.

무엇을 확인해야 끝나나요?

책 생성 요청 → 책 식별번호 수신 → 전체 원고 조회 → 내보내기 결과 가져오기를 확인합니다. 제목이나 일부 문장만 받아온 것을 전체 원고 연결 완료로 처리하면 안 됩니다.

내가 준비할 것 / 비용

먼저 기존 설치본·서버 설정·접근 권한으로 실행할 수 있는지 확인합니다. 새로운 유료 상품 구매가 반드시 필요한 것은 아닙니다. 실제 생성에 사용하는 AI가 있다면 그 이용 조건은 별도로 확인합니다.

무슨 뜻인가요?

PostgreSQL은 데이터베이스 프로그램, pgvector는 문장 의미 등을 숫자 배열로 저장·비교하는 추가 기능, ABook은 연결 대상 프로그램입니다.

무엇을 확인해야 끝나나요?

• 검증용 관리자 등록과 로그인이 됩니다.
• 원고를 실제 DB에 저장하고 같은 내용으로 다시 읽습니다.
• 로그인하지 않은 요청은 거절됩니다.
• pgvector의 실제 비교 연산이 실행됩니다.

내가 준비할 것 / 비용

DB 실행 환경과 검증 권한입니다. 개발자가 별도의 검증용 DB와 계정을 만들 수 있으므로 중요한 운영 DB나 개인 계정을 반드시 사용할 필요는 없습니다. 로컬 DB로 검증할 수 있는 부분도 있습니다.

무슨 뜻인가요?

SaaS는 보통 인터넷에서 계정으로 이용하는 소프트웨어 서비스입니다. 여러 사람이 사용할 때 내 자료와 다른 사람의 자료가 섞이지 않는지 확인합니다. Next.js는 이 웹서비스를 만드는 데 쓰는 개발 도구입니다.

무엇을 확인해야 끝나나요?

A팀은 A팀 자료, B팀은 B팀 자료만 볼 수 있어야 합니다. A팀 사용자가 주소나 요청 값을 바꿔도 B팀의 원고를 볼 수 없어야 합니다. 실제 가입·로그인·회원/팀 API와 DB 구성을 시험합니다.

이는 개인정보·저작물 유출을 막는 검사입니다. 로그인 성공과 결제 성공, 팀 권한 보호는 각각 별개입니다.

내가 준비할 것 / 비용

검증용 환경과 권한입니다. 테스트용 팀·계정을 별도로 만들어 시험할 수 있으며, 실제 고객 자료를 사용할 필요는 없습니다.

무슨 뜻인가요?

STT는 음성을 글자로 바꾸는 기술이고, Whisper는 음성 인식 도구입니다. SRT·VTT는 자막과 표시 시간을 저장하는 파일, Transcript는 말한 내용을 풀어 쓴 대본입니다.

무엇을 확인해야 끝나나요?

공식 검사값으로 모델 파일을 확인하고, 한국어 음성을 실제 분석해 자막·시간·대본이 생성되는지 확인합니다. 미리 쓴 문장을 파일로 저장한 것만으로 음성 인식이 되었다고 할 수 없습니다. 합성 영상의 음성 인식 성공과 실제 OBS 녹화 성공도 별개입니다.

내가 준비할 것 / 비용

검증에 사용할 수 있는 음성 파일과 실행 환경입니다. 로컬 실행으로 구성할 수 있으므로 유료 음성 API가 반드시 필요한 것은 아닙니다. 컴퓨터 성능에 따라 처리 시간이 달라집니다.

무슨 뜻인가요?

OBS는 화면과 소리를 녹화하는 프로그램입니다. 실제 작업 화면 녹화 → 원본 MP4 저장 → 음성 인식 → 자막·대본 생성까지 확인합니다.

왜 9번과 별개인가요?

샘플 음성 인식은 성공해도 실제 녹화에서 마이크가 꺼져 있거나, 다른 창이 녹화되거나, 파일 저장이 실패할 수 있습니다. 프로그램이 자신이 시작하지 않은 다른 녹화를 함부로 중단하지 않는지도 확인해야 합니다.

내가 준비할 것 / 주의사항

녹화할 창·소리·저장 위치와 해당 내용의 사용 권한입니다. 화면에 개인정보가 들어갈 수 있으므로 대상 범위를 정해야 합니다. 안내 음성이 합성 음성이라면 실제 음성처럼 숨기지 않고 구분합니다.

무슨 뜻인가요?

Release는 사용자에게 전달할 배포본입니다. Manifest는 파일 이름·버전·검사값을 적은 목록, SHA256은 파일 변경 여부를 확인하는 지문입니다. 이 프로젝트의 Build 문법 검사와 Windows 설치 파일 패키징은 별도 과정입니다.

설치 파일은 이미 만들지 않았나요?

이전 데스크톱 마무리 작업에서는 Windows 설치 파일 생성·실제 GUI 검증·검사값 기록을 마쳤습니다. 하지만 기존 전체 완료 판정은 별도의 ZIP 배포본과 지정된 Manifest가 현재 코드 버전과 맞는지까지 검사합니다.

따라서 이 항목이 남았다고 설치 파일 자체가 없다는 뜻은 아닙니다. 이후 변경까지 과거 설치 파일에 포함되었다고 가정해서도 안 됩니다.

내가 준비할 것 / 비용

대부분 개발자가 수행하는 패키징·검사·기록 작업입니다. 이 검사 자체를 위해 외부 유료 서비스를 반드시 구매할 필요는 없습니다.

무슨 뜻인가요?

파일이 생성됐다는 것과 책을 펼쳤을 때 올바르게 보이는 것은 다릅니다. 렌더는 페이지를 실제 화면·이미지로 그리는 작업이고, DOCX는 Word 문서입니다.

무엇을 확인해야 끝나나요?

• 전체 페이지에서 글자가 깨지거나 잘리지 않는지 확인합니다.
• 그림·표가 겹치거나 의도하지 않은 빈 페이지가 생기지 않는지 확인합니다.
• 표제지·목차·제목 스타일·문서 내부 구조를 검사합니다.

통과하면 바로 판매할 수 있나요?

아닙니다. 기술적 파일 검사와 맞춤법·문장 교정, 내용의 사실 확인, 이미지·인용문의 저작권 확인, 최종 편집 품질 판단은 별도입니다. 필요한 경우 사람이 최종 검수·승인해야 합니다.

무슨 뜻인가요?

프로그램 중단이나 장시간 지연을 감지해 자동 경고 메일을 보내는 기능입니다. SMTP는 프로그램이 메일을 발송할 때 사용하는 통신 방식입니다.

무엇을 확인해야 끝나나요?

사람이 직접 메일 보내기, 프로그램이 발송 서버에 전달하기, 실제 받은편지함에 도착하기는 서로 다릅니다. 발송 서버가 받아도 스팸으로 분류되거나 수신이 거절될 수 있으므로 실제 도착을 확인해야 합니다.

내가 준비할 것 / 비용

발송 계정 또는 메일 발송 서비스 설정과 수신 확인 환경입니다. 서비스 이용 조건에 따라 비용이 달라집니다. 메일 비밀번호·앱 비밀번호는 채팅에 붙여 넣지 않고 안전한 설정 경로로 입력합니다.

무슨 뜻인가요?

Production은 실제 사용자에게 제공하는 운영 환경, Staging은 운영 전 시험 환경입니다. 도메인은 인터넷 주소, DNS는 주소를 서버에 연결하는 설정, HTTPS는 암호화된 웹 접속입니다.

현재 보고서 주소와 무엇이 다른가요?

http://127.0.0.1:4173/은 그 프로그램이 실행되는 컴퓨터 자신을 가리킵니다. 다른 사람이 자기 PC에서 같은 주소를 입력한다고 사용자님의 서버로 접속하는 것은 아닙니다.

내가 준비할 것 / 완료 조건

운영 방식에 맞는 서버·호스팅, 외부 접속 주소, 필요한 DNS·HTTPS·인증 설정이 필요합니다. 외부에서 접속하고 재시작·장애 대응·백업도 확인해야 합니다. Windows 앱을 개인 PC에서 쓰는 것과 인터넷 서비스를 운영하는 것은 다른 범위이며, 구성에 따라 운영비가 발생합니다.

무슨 뜻인가요?

설치 파일을 누가 만들었는지 확인할 수 있도록 전자 서명을 붙이는 작업입니다. 서명이 없다고 반드시 실행되지 않는 것은 아니지만 “알 수 없는 게시자” 또는 Windows 보호 경고가 표시될 수 있습니다.

서명하면 무엇이 좋아지나요?

배포자의 신원과 서명 후 파일 변경 여부를 확인하기 쉬워집니다. 다만 서명이 있다고 모든 경고가 사라지거나 프로그램의 안전성이 보증되는 것은 아닙니다.

내가 준비할 것 / 비용

일반 배포를 위해 본인·사업자 상황에 맞는 코드 서명 서비스 또는 인증서와 신원 확인 절차를 검토합니다. 비용이 발생할 수 있습니다. 서명용 개인키와 인증서 비밀번호는 채팅으로 보내지 않습니다.