- ▶ 라이브 버튼 → 카드 안에서 상시 WebRTC 스트리밍(k2-app.html의 검증된 연결
로직 이식: STUN 필수·오퍼 null-candidate/1.5초 중 빠른 쪽 퀴크 포함)
- 라이브 중엔 20초 스냅샷 그랩(WebRTC 풀협상)을 건너뛴다 — 비디오가 이미
실시간이고 짧은 연결이 간섭하므로. 상태 조회(Moonraker)는 계속, 상태줄에
"● 실시간" 표시
- 장비 탭을 벗어나면 stopEquipTimers가 라이브 연결을 닫는다(안 보는 동안
자원 안 쓰기), ICE failed면 자동 종료 후 안내문
Co-Authored-By: Claude Code <noreply@anthropic.com>
저장 개편(리뷰 #4 근본치료):
- PUT /api/workshop/project/:id — 서버가 디스크의 현재 문서에 해당 프로젝트만
upsert. 대시보드 저장과 채팅 도구 저장이 겹쳐도 서로 다른 프로젝트 편집이
통째로 사라지지 않음. DELETE /api/workshop/project/:id,
PUT /api/workshop/active(포인터 단독) 신설. 옛 전체문서 PUT은 스테일 탭
호환으로 유지
- 클라이언트: dirtyProjects 추적 → saveProject는 바뀐 프로젝트만 순차 PUT,
활성 포인터는 putActive() 즉시 저장, 프로젝트 삭제는 DELETE 직접 호출,
beforeunload flush도 프로젝트 단위 keepalive PUT으로 전환
- upsertProject/removeProject를 순수함수로 추출, 단위테스트 4건
LOW 2건:
- loadFiles에 요청 일련번호 — 빠른 프로젝트 전환 시 옛 응답이 나중에 도착해
이전 프로젝트 파일을 새 판에 그리는 레이스 제거
- 슬라이서 인계 ?load=를 JSON 배열 인코딩으로 전환(파일명에 쉼표 있으면
옛 쉼표 join이 깨지던 문제). 슬라이서 쪽은 JSON 우선, 옛 형식 폴백 유지
Co-Authored-By: Claude Code <noreply@anthropic.com>
- 새 프로젝트 생성 직전 syncLocalToProject — debounce 미완료 편집 유실 방지
- softRefreshWorkshop: 활성 프로젝트가 서버쪽에서 바뀐 경우에만 clearStlSelection/
refreshChatForProject/loadFiles — 채팅에서 전환 시 옛 STL이 슬라이서로 오전송되던 문제
- beforeunload/pagehide에서 debounce 저장 flush(keepalive fetch) — 600ms 안에 탭 닫으면
마지막 편집이 사라지던 문제
- XSS: escJs에 "·<·> 이스케이프 추가(속성 경계 탈출 차단), chatGreeting 프로젝트명/
모델변경 실패 메시지 escHtml, 부품 참고링크 safeUrl로 javascript:/data: 스킴 차단
Co-Authored-By: Claude Code <noreply@anthropic.com>
- workshop-app: 메모 탭과 동일 구조의 "개요" 탭(textarea) 추가 — project.description
직접 편집, 채팅 set_description으로 쓴 내용은 응답 후 softRefresh로 갱신
- readme.md 자동생성(syncProjectReadmes) 철회 — 파일탭이 산만해져서 사용자 지정으로
탭 방식으로 전환, 생성된 개요 폴더들도 삭제. description/set_description은 유지
- server.ts IMAGE_TYPES: 텍스트 계열(.md/.txt/.csv 등) charset=utf-8 명시 — charset
없이 text/plain으로 뱉으면 브라우저가 latin1로 해석해 한글이 전부 깨짐(실측)
Co-Authored-By: Claude Code <noreply@anthropic.com>
기존엔 앱 전체 공용 세션(ws_main/랜덤 id) 하나를 써서 프로젝트를 바꿔도
옛 프로젝트의 대화가 그대로 남았다. sessionId를 'ws_'+projectId로 결정적
파생하도록 바꿔 프로젝트마다 독립된 대화를 갖고, 새로고침/재접속에도 같은
프로젝트의 대화를 이어받는다. ws_ 접두어는 유지(tool-scope 도구 개방 +
메인 사이드바 제외 근거). 프로젝트 전환/생성/삭제 시 채팅창을 해당
세션 기록으로 리셋(refreshChatForProject), 연속 전환 레이스는 시퀀스
가드로 처리. 앱세션 저장소(app-sessions.json) 의존 제거.
Co-Authored-By: Claude Code <noreply@anthropic.com>
- switchProject/createProject/deleteProject에서 stlSelection 초기화 누락 →
프로젝트 전환 후 슬라이서 전송 시 옛 프로젝트 relPath가 현재 프로젝트
경로로 재해석되어 같은 이름의 다른 파일이 슬라이싱될 수 있던 버그
- renderParts에서 status/qty/unitPrice 이스케이프 누락(채팅 도구가 임의
문자열 쓰면 HTML 주입 경로) → escAttr 적용
- 프로젝트 생성/삭제 시 파일 탭이 열려있으면 loadFiles 미호출로 옛
프로젝트 파일 목록 남던 버그 → switchProject와 동일 갱신 추가
- callChat 내 SSE 파싱 변수 parts가 전역 부품 배열 parts를 섀도잉 →
sseParts로 개명
Co-Authored-By: Claude Code <noreply@anthropic.com>
renderMd: 코드펜스 Placeholder 추출→연속 목록 ul 그룹화→단락 분할→블록태그 p
래핑 제외→Placeholder 복원 순으로 재작성. softRefreshWorkshop 추가(저장 대기
플러시 후 변경시에만 재렌더, expandedParts/notes 보존). escJs 추가해 삭제/토글
onclick 인젝션 방지. 테마 토글 아이콘(🌙/☀️) 동기화.
Co-Authored-By: Claude Code <noreply@anthropic.com>
하나의 요청("scad를 STL로 만들어줘")을 실제로 안정적으로 처리하기까지
여러 겹의 문제가 있었음 — 전부 실측(ws_ 세션 실제 호출)으로 확인하고 고침.
1. 진짜 원인: build-tools.ts에 stl_cad의 완전히 별개인 낡은 하드코딩
스키마 사본이 있어서, stl-cad.ts의 jsonSchema를 아무리 고쳐도 모델에게
전달 안 되고 있었음(registry.ts 등록과 별개로 이 파일도 갱신해야 함).
2. 액션 enum(stl_cad의 action="compile") 선택 자체가 경량모델에 어려운
것으로 3연속 실측 확인 — 전용 단일목적 도구 scad_to_stl 신설(scad_path/
output_path/part만 받음, 선택지 없앰). tool-scope.ts에 게이트 추가.
3. python_eval의 subprocess 차단 메시지에 대안 도구 힌트 추가 — 처음엔
워드바운더리(\b) 정규식이 pattern.source 문자열 자체와 안 맞는 버그로
한 번도 안 붙었던 것도 같이 고침.
4. hasStlCadKeyword가 짧은 재시도("다시 시도해봐")에서 원래 요청이 2턴
윈도우 밖으로 밀려나며 도구가 사라지는 문제 — 직전 어시스턴트 답변도
같이 보게 함(lastAssistantMsg를 tool-scope.ts까지 스레딩).
5. AUTO-RECOVER가 scad_to_stl의 정상 결과("200.0×110.0×277.5 mm", 방금
만든 파일 실측치)를 "검증 안 된 스펙 주장"으로 오판해 웹서치를 강제
재프롬프트하던 것 — retry-decisions.ts의 GROUNDING_TOOL_PATTERN에 추가.
이 패턴이 "검색결과 읽는 법" 안내 트리거와 공유돼있어서, CAD 결과에
그 안내가 붙어 모델이 엉뚱하게 답하는 부작용도 같이 분리해서 막음.
6. 워크숍 세션 컨텍스트(handle-chat.ts workshopProjectCtx) 확장: 활성
프로젝트 안 scad 파일이 하나뿐이면 되묻지 않고 자동 사용, STL
저장경로는 원본 scad 옆 print/ 서브폴더로 유도(CAD/print=인쇄용,
CAD/reference=참고용 관례 유지).
7. workshop-app.html: 채팅으로 새 파일이 생겨도 파일탭이 이미 열려있으면
자동 새로고침 안 되던 것 수정.
Co-Authored-By: Claude Code <noreply@anthropic.com>
DELETE /api/chat/sessions/:id가 세션 파일만 unlink하고 session.ts의
in-memory Map은 그대로 둬서, 같은 세션ID를 계속 재사용하는 앱(투자자·의사·
날씨·회계사·변호사·마음·작업실·탐정, 총 8개)에서 삭제 후 같은 세션에 새
메시지를 보내면 다음 saveSession() 때 메모리에 남아있던 옛 대화가 파일로
그대로 부활했음.
파일 삭제 후 clearHistory()(메모리+파일 둘 다 제대로 비우는 기존 함수)도
호출하도록 수정. 실제로 메시지→삭제→같은 세션 새 메시지 시나리오로 재현
검증(부활 안 됨 확인).
워크숍 앱 채팅 헤더 CSS도 방어적으로 수정 — 삭제 버튼에 flex-shrink:0이
없어서 좁은 폭에서 라벨/모델pill에 밀려 안 보일 수 있던 것 고침.
Co-Authored-By: Claude Code <noreply@anthropic.com>
- slicer-view.js: ?load=<경로1,경로2,...> URL 파라미터 지원 추가 —
cad-editor-view.js의 ?path= 패턴과 동일한 취지로, 페이지 진입 시
지정한 워크스페이스 STL들을 /api/cad/file로 받아 자동으로
슬라이서 판에 배치한다
- workshop-app.html: 파일 탭 STL 카드에 다중선택 체크박스 추가 +
"선택 STL 슬라이서로" 툴바 버튼 — 체크한 부품 STL들을 K2 슬라이서
팝업(slicer-app.html)에 한 번에 올려 같은 판에서 배치/슬라이싱
기존 slicer-app.html/PrusaSlicer 파이프라인은 그대로 재사용, 새 백엔드
라우트 없이 routes-cad.ts의 /api/cad/file만 재사용.
Co-Authored-By: Claude Code <noreply@anthropic.com>
- routes-workshop.ts: 파일 목록/업로드/폴더생성/삭제 API 추가
(case-storage.ts 재사용, appType='workshop', caseId=projectId)
- workshop-app.html: 파일 탭 추가 — 드래그앤드롭 업로드, 폴더 그룹핑,
사진 썸네일, STL 클릭 시 Three.js CAD 편집기 팝업으로 연동
- cad-editor-view.js: ?path= 쿼리로 특정 STL 자동 로드 지원
- server.ts: registerWorkshopRoutes에 isPathInsideDir 전달
- stl-cad-core.ts: 평면뷰 렌더 카메라가 원점이 아닌 바운딩박스
중심을 look-at하도록 수정 — 원점에서 떨어진 모델 위쪽 잘림 해결
Co-Authored-By: Claude Code <noreply@anthropic.com>
메인 채팅의 전체 설정 모달을 그대로 들여오는 대신, 같은 백엔드
엔드포인트(/api/settings/model, /api/settings/provider, /api/models/test)만
재사용해 채팅 헤더에 작은 pill+드롭다운을 추가. 클릭하면 ollama provider가
보유한 로컬+클라우드 모델 태그 목록을 보여주고 선택 시 전역 models.primary를
바꾼다. curl로 GET/POST 전 구간 실측 확인(목록 12개 모델 조회, 전환→원복).
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
로봇 프로젝트 하나만 다루던 대시보드/도구를 로봇 외 다른 메이커 프로젝트
(3D프린팅, 밀링 등)도 같은 틀로 관리할 수 있게 재설계. 사용자가 이름을
"작업실"로 정함.
- workshop-storage.ts(구 robot-storage.ts): 단일 문서 대신
{projects:[], activeProjectId} 구조. 기존 실사용 중이던
robot-project.json이 있으면 빈 시드로 덮어쓰지 않고 그 실제 데이터를
그대로 첫 프로젝트("로봇 프로젝트")로 마이그레이션
- routes-workshop.ts(구 routes-robot.ts): GET/PUT /api/workshop/data
- workshop-project.ts(구 robot-project.ts) 채팅도구: project_name 파라미터
추가(생략시 활성 프로젝트 대상), list_projects/create_project/
set_active_project 액션 신설
- workshop-app.html(구 robot-app.html): 헤더에 프로젝트 선택 드롭다운 +
새 프로젝트/삭제 버튼 추가. 장비(K2/밀링) 탭은 프로젝트와 무관하게
전역 유지
- 세션 접두사 rb_→ws_(tool-scope.ts의 isWorkshopAppSession), 도구명
robot_project→workshop_project
- 마이그레이션+새 프로젝트 생성/전환/삭제+채팅 연동까지 브라우저로 실제
확인함
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
kimandClaude Code