개발 문제 해결 · 가이드 · 아이디어
개발 취재록
문제의 원인과 해결부터
개발에 도움이 되는 가이드와 아이디어까지.
실제 개발 과정에서 찾은 단서와 해결 과정, 가이드와 아이디어를 담습니다.
취재 기록
30편Windows 로컬 웹앱에서 WiFi QR 자동 입력값이 null로 나올 때 확인할 순서
완성 코드가 아니라 null의 원인을 가르는 진단 순서를 적은 글이다. 휴대폰으로 접속하는 뷰어·리더 페이지를 가진 로컬 웹앱(formation)의 서버 화면에서, Windows PC의 Node 서버가 현재 WiFi 이름과 비밀번호를 읽어 접속용 QR 입력칸을 채우게 하려 했다. 첫 검
파이썬 프로그램 하나만 띄웠는데 작업 관리자에 pythonw.exe가 두 개 보일 때 — Windows venv 런처 스텁 구분법
윈도우에서 늘 대기하다가 호출어를 들으면 말을 받아 적고, Claude Code CLI에게 답을 받아 음성으로 읽어주는 개인 음성 비서(voice-assistant)를 만들고 있었다. venv(가상환경)의 pythonw.exe로 창 없이 상주시키는데, 비서가 대답을 멈춰서 프로세스를 살
크롬은 되는데 웨일 브라우저에서만 스크립트가 안 돌 때 — Cannot destructure property of undefined
안드로이드 웨일에서만 영상 선택 뒤 버튼이 켜지지 않던 문제는 fingerprint.js를 mediacheck.js로 바꾸고 두 페이지의 참조를 수정한 뒤 해결됐다. 추적 방지가 파일명을 차단했다는 설명은 가설이며, 차단 규칙 자체를 확인한 기록은 없다.
웹소켓 방장이 나갔다 들어오면 권한이 사라진다 — localStorage 토큰과 서버 해시로 되찾기
무용 연습실에서 한 사람(리더)이 영상을 재생하면 나머지가 각자 폰으로 같은 지점의 영상과 대형을 따라 보는 웹앱(formation)을 Cloudflare Workers의 WebSocket 방 구조로 옮기고 있었다. 방 만들기·참여·동선 첨부까지 로컬에서 잘 돌았는데, 리더가 방을 한
시작 프로그램에 넣은 VBS 파이썬 스크립트가 가끔 에러 창을 띄우고, 부팅 때만 조용히 안 뜰 때
윈도우에서 늘 켜져 있다가 호출어를 들으면 대답하는 로컬 음성 비서(voice-assistant)를 만들고 있었다. 창 없이 뜨게 하려고 시작 프로그램 폴더에 숨김 VBS를 넣어 파이썬(pythonw)을 띄웠는데, 가끔 VBS 에러 창이 떴고, 어떤 날은 부팅 후 비서가 아예 뜨지 않았
AI 콘텐츠 파이프라인이 거의 같은 주제를 매번 다시 웹 검색할 때 (발행 글·같은 배치 중복 걸러내기)
주제를 뽑고 웹 조사·집필·모델 심사를 거쳐 통과한 글을 저장하는 자동 콘텐츠 생성 파이프라인(content-loop-mvp)을 손보던 중이었다 . 여기서 구현 보고가 “발행 글”이라고 부르는 것은 저장소의 비교 대상 글이며, 외부 블로그 자동 발행까지 확인한 것은 아니다 . 최근 실행
AI 글 생성 파이프라인 테스트는 통과했는데 실제 통과 글이 0개일 때, 어디부터 확인하나
이 글은 해결책이 아니라 진단 순서를 다룬다. 주제 선정 → 웹 조사 → 집필 → 심사를 거치는 IT 문제해결 글 자동 생성 프로그램(직접 만든 개인 프로젝트)에서 테스트 9개가 통과했는데, 실제 Claude CLI 실행은 후보 31개 중 통과 0개였다. 어느 단계에서 얼마나 떨어졌는지
Termux 깔았는데 다운로드 폴더가 안 보여요 — storage 권한부터 잡는 순서
무용 연습실에서 다 같이 영상에 맞춰 대형을 보는 웹앱(formation)을 노트북 없이 안드로이드 폰 한 대로 돌려보려고 Termux(안드로이드용 터미널 앱)를 설치했다. 그런데 프로젝트 폴더를 분명 폰 다운로드에 넣어 뒀는데, Termux에서 ls를 쳐도 아무것도 안 보이고 cd로
여러 폰에서 같은 영상 동시 재생, 영상 서버 없이 만들기 — WebSocket으로 재생 위치만 중계하고 파일은 부분 해시로 대조
영상은 각자 폰에 미리 저장하고, 서버는 WebSocket으로 리더의 재생·정지·재생 위치만 방 단위로 중계하면 된다. 여러 사람이 각자 폰으로 같은 안무 영상을 보며 대형·동선을 겹쳐 보는 연습용 웹앱(formation)을 이렇게 옮겼다. 서버는 Cloudflare Worker와 Du
캐릭터 쇼츠에 정보도 캐릭터 개성도 제대로 안 담길 때, 블로그 글로 옮길지 판단한 기준
쇼츠에서 정보와 캐릭터가 모두 약하다고 느꼈다면, 글 시제품으로 표현이 나아지는지 확인할 이유가 있다. 이 사례는 시제품 제안에서 끝났고 전환 효과는 아직 확인되지 않았다 .
오디오 싱크 자동 보정이 자꾸 틀린다면 — 장면 컷 검출이 못 보는 '정지 화면'
AI 캐릭터들이 그날의 이슈로 티격태격하는 쇼츠 영상을 대본부터 렌더링까지 자동으로 만드는 파이프라인(personaverse)을 만들고 있었다. 배경으로 쓰는 원본 클립의 소리를 녹화 결과물에 자동으로 싱크 맞춰 입히는 기능이 있는데, 작은 플레이어 영역에 캐릭터 혼자 거의 움직이지 않
AI 모델 성능을 비교했는데 한쪽이 자꾸 질 때 — 추론 강도 설정부터 확인하세요
AI 캐릭터들이 그날의 이슈로 티격태격하는 쇼츠 영상을 대본부터 렌더링까지 자동으로 만드는 파이프라인(personaverse)에서, 대사를 쓰는 작업자로 Claude Opus와 Codex를 번갈아 돌려 비교하고 있었다. "Codex가 문장은 더 잘 쓰는 것 같던데?"라는 인상을 확인해보
파이썬 스크립트 import가 표준 라이브러리 대신 내 파일을 읽는다면, 파일 이름이 inspect.py인지부터 보자
자동 콘텐츠 생성 파이프라인(content-loop-mvp)의 채점이 기준을 못 넘기던 때, 항목별 점수를 찍어 볼 진단 스크립트를 만들고 있었다. Windows 11에서 그 스크립트를 실행하려는데 실행이 되지 않았고, 원인으로 파일 이름 inspect.py가 지목됐다.
PowerShell Start-Process로 파이썬을 띄우면 unrecognized arguments, bat으로 돌리면 멀쩡할 때
윈도우에서 늘 대기하다가 호출어를 들으면 말을 받아 적고 답을 읽어 주는 로컬 음성 비서(voice-assistant)를 만들고 있었다. 부팅 뒤 비서가 안 떠 있어서 원인을 찾으려고 PowerShell로 pythonw를 직접 띄워 봤다. 그랬더니 error: unrecognized a
Playwright로 화면 녹화해서 영상을 만들었더니 소리가 하나도 없다
AI 캐릭터들이 쇼츠 영상을 만드는 프로젝트(personaverse)에서, 캐릭터 컷아웃을 배경 클립 위에 얹는 "버튜버" 포맷을 만들던 중이었다. HTML 화면을 헤드리스 브라우저에 띄우고 그걸 통째로 화면 녹화해서 영상을 뽑는 파이프라인인데, 완성본을 재생해보니 분명 소리가 있는 배
Playwright page.goto가 30초 만에 타임아웃난다면 — networkidle의 함정
AI 캐릭터들이 쇼츠 영상에서 티격태격하는 콘텐츠(personaverse)의 렌더링 파이프라인은 HTML 페이지를 헤드리스 크로미움으로 열어 Playwright로 화면을 녹화하는 방식이었다. 배경 클립을 1080x1620, 53초짜리 영상으로 바꿔 넣고 렌더를 돌리자, 109MB 클립에
0~1 정규화 좌표로 격자를 그리면 왜 정사각형이 직사각형으로 비뚤어질까
무용 연습실에서 여러 사람이 각자 폰으로 같은 안무 영상을 보며 대형(포메이션)과 동선을 맞춰 보는 웹 앱(formation)을 만들고 있었다. 영상 위에 격자를 띄워 무용수 위치를 찍는 기능이 있는데, 좌표를 격자에 맞춰 배치하려고 보니 배치가 격자와 맞지 않고 비뚤어 보인다는 지적이
모바일 브라우저(웨일)에서만 안 되는데 콘솔을 볼 수가 없을 때 — ?debug=1 화면 디버그 패널
무용 연습실에서 각자 준비한 영상을 리더의 조작에 맞춰 함께 보는 영상 동기화 웹앱을 만들고 있었다. 매번 노트북 서버를 켜는 번거로움을 줄이려고 클라우드로 옮겼는데, 안드로이드 웨일에서 영상을 골라도 방 만들기·참여 버튼이 켜지지 않았다.
선택한 로컬 영상을 다음 페이지에서 다시 골라야 한다면
여러 사람이 각자 준비한 안무 영상을 리더의 조작에 맞춰 재생하는 무용 연습용 웹앱(formation)을 만들고 있었다. 클라우드판을 로컬 개발 서버와 브라우저에서 구현·검증하던 중, 로비에서 영상을 고른 뒤 리더 페이지로 이동하려던 흐름에 제약이 드러났다. 이동한 페이지에서도 고른 영
아이폰 영상 동기화가 계속 점프하고 0.5초 늦을 때
무용 연습실에서 리더 노트북이 음악이 담긴 안무 영상을 틀면, 멤버들이 각자 폰으로 같은 지점의 영상과 대형(동선)을 맞춰 보는 웹앱(formation)을 만들고 있었다. 아이폰 12 Pro에서 영상이 리더와 맞았다가 끊기고 느려지기를 반복했다. seek(재생 위치로 순간 이동)이 끝날
여러 휴대폰을 노트북 서버에 붙일 때 핫스팟 접속 조건을 확인하는 법
무용 연습실에서 여러 사람이 각자 폰으로 같은 안무 영상을 맞춰 보는 웹앱(formation)을 만들고 있었다. 노트북이 서버를 맡고 폰들이 그 주소로 붙는 구조인데, 핫스팟을 열어 10명 정도를 연결해도 되는지가 질문이었다. 이 질문은 AI 코딩 도우미에게 던졌다. 버그가 아니라 설계
격자 크기가 기록 안 된 좌표 데이터에서 원래 스냅 간격을 찾아내는 법
무용 연습 영상 위에 격자를 띄우고 시점마다 무용수 위치를 찍어 대형(포메이션)·동선을 편집하는 웹 앱(formation)에서, 댄서 12명·83개 키프레임짜리 안무 데이터를 격자에 맞춰 정리하려 했다. 그런데 좌표 파일에는 애초에 어떤 격자 크기로 찍었는지 기록이 없었다 — 저장 형식
Durable Objects 방 목록·alarm 만료·WebSocket 퇴장 인원 카운트 오류 해결
방별 상태는 Room Durable Object(DO)에, 참가자가 고르는 활성 방 목록은 별도 Lobby DO에 뒀다. 만료는 alarm으로 예약하고, 퇴장 인원 오류는 닫히는 소켓을 집계에서 제외해 고쳤다. 안무 연습용 웹앱을 노트북 서버에서 Cloudflare Workers로 옮기
Claude Code를 안드로이드 태블릿에 붙이려는데, 음성비서 앱은 어디부터 만들까?
PC에서 쓰던 음성비서(호출어 hey_jarvis를 듣고, 문장을 claude -p로 넘겨 답을 받아 음성으로 읽어주는 Windows용 Python 프로그램)를 안드로이드 태블릿으로 옮기려는 설계 대화다. 이 글은 실제로 앱을 만들거나 태블릿에서 돌려 본 기록이 아니라, 무엇부터 만들지
안드로이드에서 동영상 업로드가 구글 포토로만 열릴 때 — accept는 필터가 아니라 선택기를 바꾼다
무용 연습실에서 각자 폰에 둔 안무 영상을 리더의 조작에 맞춰 함께 보는 웹앱(formation)을 만들고 있었다. 안드로이드 폰에서 영상 파일을 선택하면 파일명은 보이는데 방 만들기·참여 버튼이 켜지지 않았고, 선택 화면을 열면 구글 포토가 뜨거나 "클라우드 미디어에 액세스합니다"라는
안드로이드 앱에서 마이크를 계속 켜두려면? 부팅 자동 시작·SpeechRecognizer 오프라인까지 구현 전 체크리스트
PC에서 호출어를 듣고 답을 읽어주던 개인 음성비서(voice-assistant)를, 충전 거치해 둔 안드로이드 태블릿에서 항상 듣는 앱으로 옮기려 했다. 구현 전에 "상시 마이크에 필요한 것" 목록부터 받았다. 그런데 공식 문서와 맞춰 보니 부팅 자동 시작과 내장 음성 인식 = 로컬이
안드로이드 웨일에서 영상을 골라도 참여 버튼이 안 켜질 때
무용 연습실에서 여러 사람이 각자 폰으로 같은 안무 영상을 재생해 동작을 맞춰 보는 웹앱을 만들고 있었다. 리더가 방을 만들고, 뷰어들이 같은 영상을 고른 뒤 실시간 동기화로 따라 보는 구조였다 . 노트북 크롬과 아이폰에서는 되는데, 안드로이드의 네이버 웨일 브라우저에서는 영상 파일명이
AI한테 짧게 물었는데 엉뚱하게 설계 설명만 길게 돌아올 때
무용 연습실에서 리더 한 명이 영상을 재생하면 나머지는 각자 폰으로 접속해 같은 지점을 따라보는 동기화 웹앱(formation)을 만들고 있었다. 영상·음악 동기화 기능을 다 붙이고 "이제 네가 두 창으로 직접 테스트해봐"라는 말이 오간 바로 다음 턴에, "그거 어떻게 추가해?"라는 짧
AI가 쓴 대화가 어색한 이유 — 캐릭터가 자기 특징을 스스로 말할 때
세대와 가계도를 가진 AI 캐릭터들이 일상 소재로 티격태격하는 쇼츠 영상(personaverse)은 대본을 AI가 자동으로 쓴다. 대화 구조를 고쳐 "자연스럽다"는 평가까지 받았는데, 다음 소재에서는 캐릭터가 자기 개그 포인트를 스스로 설명해 버리는 새로운 종류의 어색함이 나왔다.
Claude Code로 띄운 백그라운드 프로세스가 몇 초 뒤 사라진다 — Windows에서 버그가 아니라 에이전트 셸의 프로세스 정리였다
Windows에서 AI 코딩 에이전트(Claude Code)에게 프로그램을 백그라운드로 띄워 보게 했더니, 띄운 프로세스가 20초쯤 지나면 계속 사라졌다. 프로그램이 떠서 바로 죽는 버그처럼 보였지만, 같은 프로그램을 에이전트 셸 밖에서 띄우자 30초 내내 살아 있었다. 프로그램은 "H