- 새 프로젝트 생성 직전 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>
모델이 액션 이름을 그대로 파라미터 이름으로 씀(set_description=텍스트) → description
undefined → 기본 '' 로 개요가 조용히 지워짐(테스트 프로젝트 실측, ws_proj_h70rk5i5).
- 별칭 수용: description ?? set_description ?? overview
- 어떤 파라미터도 안 오면 ''로 덮지 말고 에러로 끝냄(덮어쓰기 방지)
- 스키마 설명에서 "(set_description 필수)"가 파라미터 이름처럼 읽히는 문제 정정 —
"(set_description 액션에서 필수 — 파라미터 이름은 description이다)"
- 지워진 테스트 프로젝트 개요는 세션 이력에서 복구해 백필
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>
- workshop/<프로젝트id>/개요/readme.md — 대시보드 데이터(개요/예산/부품/작업/메모)에서
자동 생성, saveWorkshop과 대시보드 data GET에서 내용 변화 때만 동기화(기존 프로젝트 백필 포함)
- WorkshopProject.description 신설 + workshop_project set_description 액션 — 채팅 모델이
서술형 개요를 쓰면 readme 맨 위 개요 섹션으로 들어감
- formatProject/budgetSummary/fmtWon을 storage로 이동(도구 get과 readme가 같은 문서 소스)
- 파일탭에는 개요 폴더 그룹으로 자동 표시(walkCaseFiles)
Co-Authored-By: Claude Code <noreply@anthropic.com>
SO-101 워크숍 실측: 모델이 전부 한 번에 받으려다 전체가 타임아웃으로 물러나고,
GitHub 미러 구조(stls/STL/SO101/... 식)를 그대로 따와 폴더가 산만해짐.
- 순차 다운로드(파일당 requests.get timeout=15 + try/except 1회 재시도)
- 도구 timeout 60 권장, 남으면 다음 턴에서 이어받기
- 워크숍은 workshop/<프로젝트id>/stl/ 아래 평평하게, 서브폴더는 부품군 하나까지만
Co-Authored-By: Claude Code <noreply@anthropic.com>
SO-101 워크숍 채팅(ws_proj_1osbd78g)에서 폴더 생성이 차단돼 STL 다운로드 작업이 죽고,
모델이 차단을 '권한 문제'로 오독해 파일 수령을 포기하는 실측 사례 수정.
- BLOCKED에서 makedirs/mkdir 분리 — remove/rename/rmtree 등 파괴 연산은 계속 차단
- python_eval 설명에 다운로드 가이드 인접 삽입: GitHub API로 경로 먼저 확인,
받은 개수 실측 보고, 기대보다 적으면 실패로 보고
Co-Authored-By: Claude Code <noreply@anthropic.com>
- model_search: 3사이트 통합 검색(Thingiverse는 토큰 필요, Printables/MakerWorld는 익명 검색 실측 확인)
- model_download: 슬라이싱 가능한 STL/3MF 중 최대 파일 1개 워크스페이스 저장(Printables getDownloadLink 익명 동작, Thingiverse /v2/files download, MakerWorld는 Bambu 토큰 필요)
- print3d_model에 stl_path 추가 — model_download로 받아둔 파일 바로 슬라이싱
- 토큰은 vault secret(print3d.*_token/cookie), Thingiverse App Token 등록 완료
- 게이트: ws_ 세션 항상 + 메인 채팅은 3D 키워드
Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-23 실측: ws_proj 세션에서 "608ZZ 베어링 1개만 있으면 되나?"에 모델이
①도구 호출 없이 "조회하겠습니다"만 말고 턴 종료(BOM이 프롬프트에 없어 도구를
써야 하는데 안 씀) → 사용자 "??" ②다음 턴엔 도구 0건으로 "확인해 보니 608ZZ가
등록 안 됐다"고 지어냄 — 실제 BOM엔 608ZZ ×4(J2/J3 감속기 출력축 지지용)가
등록돼 있어 정반대의 사실이었다.
workshopProjectCtx에 부품 목록(이름·수량·단가·상태·메모)을 턴마다 새로 읽어
주입한다. 목록이 프롬프트에 있으면 부품 질문에 도구 왕복 없이 정확히 답한다.
Co-Authored-By: Claude Code <noreply@anthropic.com>
- server.ts의 separateThinkingFromContent를 chat/thinking-separation.ts로 추출 (단위 테스트 가능하게)
- stripEnglishScratchPrefix 신설: 영어 런 40자+ + 문장부호 뒤 무공백 한글 봉합점(seam)을
구조로 탐지 — 키워드가 아니라 구조라 한글 조각이 섞인 영어 계획 단락도 처리
- 스크래치 증거 게이트(메타 라벨 또는 한글 없는 40자+ 단락 2개)로 오탐 방지,
정상 혼합문("Open-Meteo 모델은")은 보존
- think 태그 내용을 버리지 않고 thinking으로 보존하던 손실 수정
- 실측 표본 2건(09-22 추석 날씨 세션)을 단위 테스트로 고정, 6/6 통과
Co-Authored-By: Claude Code <noreply@anthropic.com>
모델이 'robot_arm_2min.mp4'처럼 접두어 없이 호출해 워크스페이스 루트에
쓰여 파일 탭에 안 보이는 사고 반복(2026-09-22 실측). 설명에
'workshop/<프로젝트id>/...' 접두어 필수 규칙 추가.
Co-Authored-By: Claude Code <noreply@anthropic.com>
모델이 scad 소스에 '$t = 0;'을 직접 쓰면 --animate 엔진의 $t 구동을
덮어써 프레임이 전부 동일 이미지(정지 화면)가 되는 실측 사고 방지.
렌더 전 최상위 $t 할당 줄을 걷어낸 사본으로 렌더하고 결과 안내에 표시.
도구 설명에도 모델용 경고 추가.
Co-Authored-By: Claude Code <noreply@anthropic.com>
OpenSCAD 2021.01 CLI에서 -D '$t=x' 오버라이드가 최상위 변수 할당에
반영되지 않아 프레임 48장이 전부 동일 이미지가 되는 문제 수정.
- 프레임 렌더를 프레임별 -D 루프 → --animate N 단일 프로세스로 전환
(엔진이 $t를 직접 구동, frame00000.png~ 5자리 0-인덱스로 export)
- 프루브도 -D '$t=0.5' 단일 포즈 → --animate 4 포즈 STL bbox 합집합으로
카메라 자동 프레이밍(관절이 벌어지는 전 범위 커버)
- 렌더 타임아웃을 프레임 수 기준으로 재조정(60s + 프레임당 20s, 상한 900s)
Co-Authored-By: Claude Code <noreply@anthropic.com>
--autocenter --viewall이 오프스크린 CLI 렌더에서 모델을 프레임에
신뢰성 있게 못 담는다(실측: 구석에 작게 나오거나 아예 밖으로 나가
"노란 빈 화면" MP4가 됨). renderStlPng와 동일 방식으로, 대표 프레임
($t=0.5)을 STL로 컴파일해 실측 바운딩박스 중심+최대길이×3 거리의
명시적 김발 카메라를 계산해서 프레임마다 넘긴다. 사용자가 camera를
주면 그대로 쓰고, 프루브 컴파일 실패 시에만 옛 autocenter 폴백.
배경색도 기본 Cornfield(노란색 — "빈 화면"으로 오독됨) 대신
Tomorrow로 통일.
Co-Authored-By: Claude Code <noreply@anthropic.com>
워크숍 채팅에서 "애니메이션으로 굴려보자" 요청이 python_eval subprocess
차단(scad_to_stl 설명의 "직접 실행하지 말 것" 안내)에 걸려 Pillow 투영
폴백으로 떨어지는 게 실측됨. OpenSCAD CLI는 runOpenscad으로 실제로 잘
돌아가므로, 프레임 렌더+합성 전용 단일목적 도구를 추가.
- 프레임은 /tmp 임시디렉터리에서 렌더해 워크스페이스엔 mp4 하나만 남김
(PNG 수십 장이 파일탭에 쏟아지는 사고 방지)
- $t는 frames 기준 균등 간격(0~1-1/N)으로 -D 전달, defines 오버라이드
scad_to_stl과 동일 패턴. camera는 김발 7값 CSV 검증 후 --camera 통과,
생략 시 --autocenter --viewall
- ffmpeg libx264/yuv420p(+faststart) — 브라우저 <video> 호환
- stl_cad 3종과 동일하게 ws_ 세션 전용 게이트(tool-scope), 스키마 사본은
build-tools에도 추가(둘 다 갱신 원칙). 숫자 그라운딩 게이트 면제 대상에
scad_animate 추가(프레임 수/fps 등 방금 만든 파일 실측값이라 AUTO-RECOVER
오탐 방지 — stl_cad/scad_to_stl과 동일 취지)
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>
사용자 요청 "작업실 전용으로 하자" — 지금까지 이 셋은 키워드 게이트
(hasStlCadKeyword)라 메인 채팅이든 다른 앱이든 메시지에 "stl"/"cad" 등만
있으면 어디서든 호출 가능했음. isWorkshopAppSession(ws_ 세션) 게이트로
교체 — 이제 워크숍 세션에서만 뜨고, 메인 채팅에선 같은 키워드를 써도 안 뜸.
k2-app.html의 "🔧 STL 확인" 웹 UI 패널은 routes-cad.ts 직접 호출이라 이
게이트와 무관, 영향 없음.
더는 안 쓰는 hasStlCadKeyword/stlCadPattern 정리. lastAssistantMsg 필드는
남겨둠(다른 재시도-유지 게이트가 필요해지면 재사용 가능, 비용 없음).
실측: 메인채팅 세션은 "scad를 stl로" 요청해도 세 도구 다 false, 워크숍
세션은 키워드 없는 "안녕"에도 세 도구 다 true 확인.
Co-Authored-By: Claude Code <noreply@anthropic.com>
write_scad — .scad 신규작성/수정 전용 도구(사용자 요청: "그래도 툴 하나
만들어주자"). python_eval의 open(path,'w') 우회는 os.makedirs가 막혀있어
폴더 없으면 실패하는 등 신뢰도가 낮았음. 저장 직후 실제 OpenSCAD 컴파일까지
해서 문법오류/빈 형상을 그 자리에서 알려주고 모델이 고쳐서 재시도하게 함.
registry.ts+build-tools.ts(실제 스키마) 둘 다 등록, tool-scope.ts 게이트 추가.
직접 테스트(정상/문법오류)+실채팅 테스트 통과.
PART 값 오타 흡수 — stl_cad의 compile 액션과 scad_to_stl 둘 다: scad 파일에
없는 PART 문자열을 넘기면 OpenSCAD가 에러 없이 조용히 빈 STL을 만드는 함정이
있었음(실측: 워크숍 채팅이 "tilt_arm"을 "Tilt Arm"/"tiltarm"/"tilt-arm"으로
반복해서 틀려 빈 STL만 생성). scad 소스에서 PART 분기 문자열을 미리 뽑아
대소문자/공백/하이픈 차이를 정규화해서 매칭하고, 그래도 안 맞으면 openscad를
돌리지도 않고 사용 가능한 PART 값 목록을 바로 에러로 돌려줌.
전체조립 vs 부품 저장위치 분리 — handle-chat.ts의 workshopProjectCtx 힌트:
part 지정해서 부품 하나만 만들 때는 CAD/print/에, part 없이 전체조립본
(시각화용, 인쇄 대상 아님) 만들 때는 CAD/ 바로 밑에 저장하도록 구분.
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>
기존엔 info/render/add_hole만 있어서 기존 STL만 다뤘고, .scad 소스를 STL로
직접 컴파일하는 기능이 없었음 — 워크숍 채팅이 ".scad를 STL로 만들어달라"는
요청에 "제가 직접 하는 기능은 없다"고 정확히 답했던 이유.
compile 액션 추가: scad_path(.scad 소스) + part(선택, PART 변수 있는 scad용
-D 'PART="..."' 전달) + output_path로 openscad CLI 호출, 바이너리 STL 생성.
기존 runOpenscad() 헬퍼 재사용.
DIY 스캐너 프로젝트(scanner-diy-rig.scad)에도 PART 분기 추가하고 이 기능으로
프린트 부품 4종(base_plate/turntable/post/tilt_arm) 실제 생성 — 전부 230mm
베드 이내 확인.
Co-Authored-By: Claude Code <noreply@anthropic.com>
이전 커밋(8866266)의 시스템 프롬프트 지시만으로는 절반만 먹혔음 — 경량모델이
"다른 프로젝트는 후보로 내놓지 말 것" 지시를 받고도 참고용으로 계속 언급함
(실측 확인). 로컬모델은 멀리 있는 프롬프트 지시보다 데이터 바로 옆 신호를
더 잘 따르는 기존 패턴(groundingResultReadingRule)과 동일한 원리로 코드
백스톱을 추가.
- getWorkshopCrossProjectWarning(): ws_ 세션에서 도구 인자/결과/데이터에
활성 프로젝트가 아닌 workshop/<id>/ 경로가 섞여 있으면 경고를 결과 텍스트
맨 앞에 직접 붙임(완전 차단은 아님 — 사용자가 명시적으로 다른 프로젝트나
전체 워크스페이스를 요청하면 정상 동작)
- list 도구만이 아니라 python_eval(os.listdir 등, default 분기 공유)과
shell 양쪽에 적용 — list만 막았더니 모델이 python_eval로 똑같이 다른
프로젝트를 들여다보는 것을 확인해서 범위를 넓힘
3가지 시나리오로 실측 검증: 다른 프로젝트 명시 요청(정상 응답) / 전체
워크스페이스 명시 요청(정상 응답) / 모호한 질문(현재 프로젝트만 응답,
원래 버그 시나리오 해결).
Co-Authored-By: Claude Code <noreply@anthropic.com>
ws_ 세션(작업실 앱 전용 채팅)이 "지금 어떤 프로젝트를 보고 있는지" 정보를
시스템 프롬프트에 전혀 못 받고 있었음 — tool-scope.ts의 isWorkshopAppSession은
"작업실 세션이다"만 판별하지 활성 프로젝트 ID는 안 넘김.
그 결과 모델이 STL/scad 파일을 찾을 때 워크스페이스 전체를 뒤져서 다른
프로젝트 파일까지 후보로 내놓는 혼동이 있었음(예: proj_scan_dental_diy
채팅에서 STL 요청했는데 proj_scan_dental 쪽 scad까지 같이 나열).
workshop.json의 activeProjectId를 읽어 "지금 프로젝트는 이거고 파일은
workshop/<id>/ 아래만 볼 것"을 callerContext에 주입하도록 수정.
실제 ws_ 세션으로 테스트해 크로스 프로젝트 혼동 없어진 것 확인.
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>
APP_SESSION_PREFIXES 목록에 ws_(workshop-app.html)와 dr_(doctor-app.html)가
빠져 있어서 두 앱의 전용 채팅 세션이 메인 채팅 세션 목록에 그대로 섞여
보이고 있었음. 실제 8개 앱 HTML의 세션 프리픽스와 대조해서 누락분 추가.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
한 번 검색해서 끝내지 말고(문구 바꿔 재검색), 스니펫이 부실하면 web_fetch로
실제 페이지를 읽으라는 일반 규칙(searchPersistenceRule)을 system-prompt에
추가. 기존 fileSearchRule은 겹치는 부분 덜어내고 파일검색 고유 내용(저장소
이름, 다운로드 버튼 차단은 정상)만 남김.
실측: K2 배기 덕트 STL 검색 재현 시 이번엔 검색 1회로 Printables/MakerWorld
실제 모델 3종+링크를 찾아 답변(이전엔 1회 검색 후 포기). 일반 쿼리("오늘
환율")는 과다검색 없이 기존과 동일하게 2회로 정상 답변 — 회귀 없음 확인.
Co-Authored-By: Claude Sonnet 5 <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>
작업실 채팅(gemma4)이 K2 배기 덕트 STL을 검색 1회만 하고 포기하는 걸
로그로 확인(SEARCH-ABANDONMENT 가드가 재시도시켜도 결론은 동일). STL/3MF
등 다운로드형 파일을 찾는 요청에서는 검색어 2-3종 + 알려진 저장소
(Printables/Thingiverse/MakerWorld/Creality Cloud) 명시 검색을 시도하고,
직접 파일 링크를 못 찾아도 모델 페이지 URL을 주는 걸 성공으로 취급하도록
system-prompt에 메시지 게이트 규칙 추가.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
3MF를 미리보기 없이 원본 그대로 보내는 대신, PrusaSlicer --export-stl로
서버에서 STL로 변환한 뒤 기존 STL 파이프라인(미리보기+다중배치편집)에
그대로 태우도록 개선. 사용자 쪽에서도 '그냥 STL로 변환하면 안 되나' 제안.
- routes-k2.ts: POST /api/k2/convert-3mf-to-stl 신규(임시파일→변환→응답,
cleanupTemp로 정리)
- slicer-view.js: 파일선택 시 .3mf면 변환API 먼저 태운 뒤 기존
loadModel()/addInstance()로 합류 — STL과 완전히 동일하게 취급됨.
이전 커밋의 '미리보기 없는 패스스루'(pending3mf 상태/분기) 전부 제거.
print3d_model 채팅도구의 .3mf 다운로드 확장자 인식은 유지(변경 없음).
E2E 검증: 변환 API 단독 호출로 3MF→STL 정상 확인(삼각형 수 일치).
Co-Authored-By: Claude Code <noreply@anthropic.com>
- 파일 입력 multiple: 여러 STL을 한 번에 불러와 각각 별도 모델(색으로 구분)로 등록,
인스턴스 1개씩 배치. 모델/인스턴스 구조 분리(userData.modelIdx)로 서로 다른 기하 공존.
- ↕뒤집기 버튼: X축 180° 회전 후 reLiftInstance로 바닥이 베드에 붙도록 position.y 보정.
bake 시 mesh.matrix(전체 회전·배율·liftY 포함)를 정점에 적용 → 뒤집기 상태까지 보존.
- 전체삭제 버튼 추가. 복제는 회전·뒤집기·배율 전부 복사.
- 기존 좌표계 규약(three Z = BED - bedY) 유지, 다중 모델에서도 인스턴스·툴패스 정렬 유지.
Co-Authored-By: Claude Code <noreply@anthropic.com>
단일 stlMesh 대신 인스턴스 모델 도입 — baseGeo 공유 위에 다중 THREE.Mesh를
position/rotation/scale로 배치. 뷰에서 클릭 선택·드래그 이동, 사이드 패널에서
숫자 입력(X/Y/회전/배율) + 복제/↺90/↻90/중앙/자동배치/삭제 버튼.
슬라이스 시 모든 인스턴스를 단일 바이너리 STL로 구워(bake) 전송 — 각 정점을
베드 좌표(bedX=threeX, bedY=BED-threeZ, 높이=threeY)로 변환. 서버 /api/k2/slice
에 arrange=0 추가 → PrusaSlicer --dont-arrange 로 원본 XY 보존(기존 --duplicate
대체, --merge 세그폴트 회피).
실측 검증: 큐브 STL 0..20 을 arrange=0 슬라이스 → 베드 0..20 유지(재중앙화 ❌).
2-큐브 합본 STL → 두 클러스터가 각각 지정 베드 좌표에 배치됨 확인.
Co-Authored-By: Claude Code <noreply@anthropic.com>
PrusaSlicer가 모델을 베드 중심(130,130)에 두고 gcode 좌표를 베드 좌표계
(0~260) 그대로 내보내는데, 렌더링에서 거기에 +BED/2(+130)를 또 더해서 모델이
(260,260) 모서리 쪽으로 밀려 보였음("중심에서 벗어나 있네").
수정: gcode X → three X 오프셋 없이 그대로, gcode Z(높이) → three Y,
gcode Y → three Z = BED - gcodeY. Z를 뒤집는 건 STL 미리보기(rotateX -90)가
STL +Y를 three -Z로 보내는 것과 정렬하기 위함. 실측: 모델 three X/Z 둘 다
130.00 중심, 0~260 베드 안. STL 미리보기와 동일 위치로 겹침.
Co-Authored-By: Claude Code <noreply@anthropic.com>
단순 6파라미터 모달을 PrusaSlicer --load <ini> 기반 풀 에디터로 교체.
베이스 ini(K2_BASE_INI, 약 60키 큐레이션)를 TS 문자열로 임베드하고
buildProfileIni가 오버라이드 머지 + canonical start_gcode(13줄 K2 프라이밍
시퀀스, placeholder 온도 치환)를 강제 주입 — k2_config.ini 원본의 3줄
start_gcode를 그대로 쓰면 프라이밍이 날아가 출력이 망가지는 회귀 회피.
웹 UI: 9개 섹션(기본/소재·온도/서포트/브림/속도/팬/표면/리트랙션/고급)
약 40파라미터 편집 + 프로파일 저장/불러오기/삭제. 속도·소재 프리셋 연동.
라우트: /api/k2/profile/base·/profiles CRUD + /api/k2/slice?profile= 변경.
print3d_model 채팅도구는 기존 buildBaseArgs 경로 유지(동작 변경 회피).
Co-Authored-By: Claude Code <noreply@anthropic.com>
채팅으로 좌표를 말로 불러주는 게 너무 번거롭다는 피드백으로, stl_cad
채팅도구와 같은 기능을 드롭다운+버튼 UI로도 쓸 수 있게 함.
- stl-cad-core.ts: stl-cad.ts에서 OpenSCAD 실행/STL 파싱/렌더링 로직을
추출한 공용 모듈 + 워크스페이스 내 STL 파일 재귀 검색(findStlFiles)
추가. stl-cad.ts(채팅도구)와 routes-cad.ts가 공유
- routes-cad.ts: GET /api/cad/list(STL 목록), /api/cad/info(치수),
/api/cad/render(PNG 스트리밍), POST /api/cad/add-hole
- k2-app.html: "🔧 STL 확인" 모달 — 파일 드롭다운 선택 → 7방향 뷰 버튼 →
실시간 렌더 미리보기+치수, 접이식 "구멍 뚫기" 폼(x/y/z/지름/길이/축).
브라우저로 실제 렌더링/각도전환 확인함
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
"작업실"의 다음 단계로 남겨뒀던 CAD 연동을 시작. FreeCAD 대신 OpenSCAD를
백엔드로 씀 — 텍스트 스크립트 기반 CSG라 AI가 파라메트릭 스크립트를 짜서
바로 실행하는 이 워크플로에 훨씬 적합함(GUI/Python API가 무거운 FreeCAD
대비). 오늘 ESP32 카메라 하우징 렌즈 소켓 위치를 실제로 이 방식(OpenSCAD
--camera 렌더 + 메시 좌표 분석)으로 조사해본 뒤 정식 도구로 정리했다.
- info: 바운딩박스/치수/삼각형수 조회(바이너리 STL 직접 파싱, 의존성 없음)
- render: iso/top/front 등 각도로 PNG 렌더링, 모델이 직접 보게 함
(buildImageMarkdown 재사용). QT_QPA_PLATFORM=offscreen으로 헤드리스
렌더 확인(xvfb 불필요)
- add_hole: 지정 좌표에 원통 구멍을 뚫어 새 STL로 저장(difference()).
테스트 큐브로는 정상 작동 확인했으나, 오늘 다룬 ESP32 STL 자체가
CGAL이 못 받아들이는 미세 메시 결함이 있어(admesh로도 복구 안 됨)
그 파일에서는 실패 — 원인이 도구가 아니라 소스 STL 품질 문제임을
확인함
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>
부품 카드에 추가한 참고링크(구매처/대체품/업그레이드/레포 등, 076a53b)를
이제 채팅으로도 붙이고 뗄 수 있다 — "이거 어디서 팔아?" 하고 물어서
web_search로 찾은 뒤 이 액션으로 바로 그 부품에 링크를 붙이는 흐름을
위한 것. delete_link는 라벨 일부일치로 찾는다(다른 액션들과 동일 패턴).
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
각 부품 카드에 라벨+URL 쌍을 여러 개 붙일 수 있는 "정보" 섹션 추가 —
파는 곳, 대체품, 업그레이드 옵션, 관련 GitHub 레포 등 무엇이든 자유롭게
기록. URL을 입력하면 옆에 ↗ 열기 버튼이 자동으로 뜬다(타이핑 중 포커스가
끊기지 않게 그 버튼만 DOM에서 직접 갱신, 전체 리렌더 안 함).
- robot-storage.ts: RobotPart에 links: RobotPartLink[] 필드 추가(기존
저장된 데이터는 링크 없이 시작, 별도 마이그레이션 불필요)
- robot-project.ts: add_part 기본값에 links:[] 추가, get 응답에 부품별
링크 목록도 같이 표시
- robot-app.html: 카드 펼침 영역에 라벨/URL 입력 행 + 추가/삭제 버튼
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
kimandClaude Code