EchoPace 사용 설명서

데스크톱 앱 EchoPace(현재 버전 2.7.7)용입니다.

EchoPace는 일상적인 디자인과 데이터 작업을 한 창에 모읍니다: 경로 그리기, 워크플로 실행, 표 보기, DB 연결, HTTP, 로컬 AI 도우미, 폴더 안의 오디오 클립과 합성. 모듈 이름은 영어로 유지되며, UI 언어는 환경설정에서 바꿀 수 있습니다.

1. 실행 방법

Windows

1. EchoPace.exe를 더블클릭합니다. 설치·압축 해제가 필요 없습니다.
2. “Windows가 PC를 보호했습니다”가 뜨면 추가 정보 → 실행. 서명되지 않은 빌드에서 흔하며, 파일이 깨진 뜻은 아닙니다.
3. 검은 콘솔 창은 없습니다. 창을 닫으면 종료됩니다.

exe는 아무 폴더에나 둘 수 있습니다. 바로가기가 깨지지 않도록 위치를 고정하세요.

macOS

1. DMG를 열고 EchoPace를 Applications로 드래그합니다.
2. 첫 실행이 막히면: 시스템 설정 → 개인정보 보호 및 보안 → 그래도 열기(ad-hoc 서명, 공증 없음).
3. Launchpad 또는 응용 프로그램에서 엽니다. 일반 .app이라 검은 터미널은 나오지 않습니다.

2. 창 구성

창
├── 창 상단 막대    EchoPace 마크 · 모듈 탭(사이드바 숨김 시) · 보조 영역 토글 · 환경설정
├── 모듈 사이드바    왼쪽 약 200px 모듈 목록
├── 작업 영역
│   ├── 왼쪽 레일     현재 모듈 리소스(왼쪽 레일 탭)
│   ├── 주 영역       캔버스 / 표 / 그래프 / 채팅
│   └── 보조 영역     검사·내보내기·노드 속성 등(상단에서 숨김 가능)
└── 상태 표시줄      맨 아래: 라이선스 / 업데이트와 상태 문구

• 모듈 사이드바에서 모듈 이름을 눌러 전환합니다. 사이드바를 접으면 같은 항목이 창 상단의 모듈 탭에 나타납니다.
• 주/보조 영역마다 영역 상단·영역 탭·가운데·영역 하단이 있습니다.
• 상단 톱니는 환경설정입니다.
• 상태 표시줄 오른쪽 종/방패는 라이선스 · 개통됨 · 더 개통을 엽니다.

3. 처음 사용: 라이선스

라이선스가 없으면 GeoCanvas와 OtterDrive만 사용할 수 있습니다. 나머지 모듈은 사이드바에서 잠깁니다.

1. 상태 표시줄의 라이선스 입구를 엽니다.
2. 라이선스(또는 더 개통)에서 5일 체험/연장 신청을 누릅니다. 기기 MAC과 플랫폼을 보내고 App ID / App Secret을 받아 암호화 저장한 뒤 서버에 확인합니다. 같은 자격 증명은 생성 후 6개월 안 5일 연장을 횟수 제한 없이 자가 신청할 수 있습니다.
3. 관리자가 준 App ID / App Secret을 붙여 넣고 저장해도 됩니다.
4. 확인 성공 후 개통됨에 이 빌드의 모든 모듈이 나열됩니다. 잠금 해제는 클릭 가능, 미해제는 잠김.
5. App ID / App Secret은 디스크에 암호화되며 평문으로 저장되지 않습니다.

오프라인: 마지막 성공 확인을 재사용해 개통 모듈은 계속 쓸 수 있습니다. 약 2주간 온라인 확인이 없으면 시작 시 다시 안내합니다. 온라인 확인하거나 5일 체험/연장 신청을 다시 누르세요.

장기 라이선스, 또는 자가 창(생성 후 6개월)이 끝나면 같은 대화상자의 더 개통에서 support@mossboat.dev로 메일을 보내세요. 본문에 App ID를 꼭 넣으세요(페이지에서 복사 가능, 없으면 먼저 체험 신청). 지원팀은 서버에서 계정을 찾을 때 App ID가 필요합니다.

4. 환경설정

창 상단 톱니 → 환경설정.

저장으로 모듈 목록을 확정합니다. 언어는 일반 탭에서 바로 적용됩니다.

5. GeoCanvas — 경로 · SVG · 측정

벡터 그리기, 크기 측정, 비트맵 트레이스, 아이콘 내보내기.

왼쪽 레일

• 디자인: 도구, 아트보드, 페이지, 레이어.
• 측정: 크기·기하. 도형을 선택하면 가로·세로·면적 등.

주 영역 탭

• 보드: 캔버스 그리기. 왼쪽 레일 도구: 선택, 펜, 사각형, 타원, 다각형, 별, 정다각형, 화살표, 체크, 가위표, 번호, 텍스트.
• 경로: 노드 편집, 불린, 단순화 등.
• 미리보기: 선택 렌더. 내보내기… / SVG 내보내기에서 내보내기 배경: 투명/검정/흰색/사용자 색.

영역 상단 예: SVG 가져오기, 이미지 가져오기, 이미지 트레이스, 이미지 복사.

보조 영역

• 윤곽: 레이어 목록.
• 선택: 정렬, 분배, 회전 복사 등.
• 색: 선 / 채우기.

캔버스 습관

• 스크롤 확대, 드래그 이동. 미리보기에서 더블클릭으로 뷰 재설정.
• 눈금자에서 가이드를 끕니다. 눈금자로 되돌리면 삭제. 대화상자를 통과해 눈금자를 누르지 않습니다.
• 아트보드 배경: 영역 하단 배경.
• 디자인은 이 기기에 자동 저장(§12).

6. OtterDrive — 워크플로 · 트리거 · 모니터

노드 그래프로 명령을 짜고 수동·일정·파일 드롭으로 실행합니다.

왼쪽 레일

• 플레이북: 워크플로·프로젝트. Demo plant / Nightly ingest 또는 새로 만들기.
• 모니터: Workers와 Queue(대기 중인 파일 드롭).

주 영역

• 그래프: 노드 배치. 선택에서 연결. 가장자리 우클릭으로 삭제.
• 실행: 실행 기록.
• 모니터: 진행과 출력.

보조 영역

• 노드: 실행 명령.
• 트리거: cron(5필드) 및/또는 폴더 드롭. 일치 파일을 드롭하면 복사 후 대기열.
• 환경: 프로젝트/워크플로 $ENV.

한 번 실행으로 현재 그래프를 돌립니다. 다른 PC로 드롭하려면 Monitor → Workers에 이 PC를 등록하고 Hub URL을 맞추세요. 감시 폴더는 이식 가능한 경로를 쓰세요(Windows: %USERPROFILE%\Desktop\TAG, macOS/Linux: ~/Desktop/TAG).

7. SilkQuery — Excel · CSV · SQLite · JSON

표 파일을 데이터 소스로 보고, 필터하고, 질의를 만들고, 내보냅니다. 라이선스 개통 필요.

왼쪽 레일

소스: 파일·표·DB. **+**로 Excel / CSV / SQLite / JSON 추가.

주 영역

• 워크시트: 데이터 보기.
• 스키마: 필드 개요.
• 샘플: 샘플 미리보기.
• 빌더: 시각적 질의 작성.

보조 영역

• 스크립트: SQL / 레시피.
• 내보내기: 파일 쓰기.
• 기록: 내보내기 기록.

흐름 예: 파일 추가 → 워크시트 확인 → 빌더 또는 스크립트 → 내보내기.

8. RapidDock — 연결 · SQL

원격 DB에 연결해 워크시트에서 결과를 봅니다. 라이선스 개통 필요. 연결 대화상자에 나온 엔진(PostgreSQL, MySQL, SQLite, SQL Server 등).

왼쪽 레일

소스: 연결·표·DB. 새 연결에 호스트/DB/계정 입력 후 테스트, 표 탐색.

주 / 보조

SilkQuery와 비슷한 구성. 비밀번호는 로컬 연결 설정에 저장됩니다. 권한이 있는 DB만 쓰고 설정 파일을 함부로 공유하지 마세요.

9. MintCall — 요청 · 컬렉션

HTTP / WebSocket 클라이언트. 라이선스 개통 필요.

왼쪽 레일

컬렉션: 요청·폴더·프로젝트.

주 영역 탭

Headers, Body, Auth, Query, Listen, Encrypt. 메서드와 URL을 정한 뒤 전송.

보조 영역

응답 미리보기, 타임라인 등. 같은 프로젝트에서 WebSocket도 가능합니다.

관리자가 로컬 Playground를 주면 http://127.0.0.1:8765로 연습하세요.

10. MossNet — Ollama · 클라우드 모델

프로젝트 파일에 대해 채팅·편집·명령 실행. 라이선스 개통 필요. 로컬 모델은 Ollama 설치·실행이 필요합니다.

왼쪽 레일

• 채팅: 프로젝트·세션. 작업 디렉터리 지정.
• 파일: 파일 트리.

주 영역

• 작업 공간: 채팅. 모델 선택, 스트림, 취소.
• 도구: 호출 가능한 도구.

보조 영역

• 추적: 도구 호출.
• 문서: 설명 / 미리보기.
• 롤백: 체크포인트(git 아님).

스킬:

.moss/skills/<이름>/SKILL.md

.cursor/skills/*/SKILL.md도 인식합니다. list_skills / read_skill로도 읽을 수 있습니다.

민감 작업은 매번 묻기 또는 항상 허용. 작업 디렉터리 밖은 기본 제한됩니다.

11. AmberClip — 폴더 · 파형 · 클립 · 합성

폴더의 오디오 / 비디오 / 이미지를 캐러셀에서 고르고, 재생 범위를 표시한 뒤 순서대로 합성해 내보냅니다. 라이선스가 필요합니다. 비디오 포스터·파형·내보내기는 이 기기의 ffmpeg(앱과 같은 폴더 또는 PATH)가 필요합니다.

왼쪽 레일

• 소스: 폴더(끌어다 놓거나 찾아보기), 파일 트리(개수와 크기, 가리켜 삭제).
• 스냅샷: 클립(슬라이서의 단일 파일 재생 범위), 합성(합성기의 여러 파일 순서와 범위).

주 영역 탭

• 캐러셀: 카드 미리보기(오디오 / 비디오는 파형). 영역 하단에서 유형·정렬·필터. 영역 상단에서 전체 / 없음 / 반전.
• 슬라이서: 파형에서 인/아웃을 표시하면 스냅샷 클립 목록에 나타납니다.
• 합성기: 여러 파일의 재생 범위와 순서를 배열하면 합성 목록에 나타납니다.

보조 영역

• 스크립트: 현재 캐러셀에 맞는 파일을 다른 폴더로 옮깁니다.
• 내보내기: 선택한 합성에서 합친 WAV, 또는 각 구간을 내보냅니다. ffmpeg 필요.
• 기록: 내보내기 기록. 보조 영역 하단에서 기록을 지울 수 있습니다.

전형: 폴더 추가 → 캐러셀에서 고르기 → 슬라이서 및/또는 합성기 → 내보내기.

12. 데이터 위치

설치 폴더에는 쓰지 않습니다. 설정과 모듈 데이터:

앱만 복사해도 데이터는 따라가지 않습니다. 필요하면 데이터 폴더 전체를 복사하세요. App Secret·DB 비밀번호가 든 파일을 공개 장소에 올리지 마세요.

13. 업데이트

시작 시 백그라운드에서 업데이트를 확인합니다. 상태 표시줄에 힌트가 나오면 라이선스/업데이트 대화상자를 여세요. 이 설명서는 2.7.7에 맞습니다.

• Windows: 새 EchoPace.exe로 덮어쓰기.
• macOS: 새 DMG에서 Applications로 다시 드래그.

데이터 폴더는 유지됩니다.

14. FAQ

모듈이 두 개만 보여요?
라이선스가 없거나 해당 모듈이 포함되지 않았습니다. 상태 표시줄에서 라이선스를 열고 App ID / App Secret을 입력하세요. 개통됨의 잠긴 행은 미포함입니다.

라이선스가 만료됐나요?
먼저 5일 체험/연장 신청. 6개월 창이 끝나면 더 개통에서 support@mossboat.dev로 App ID를 넣어 메일하세요.

UI가 한국어가 아닌가요?
환경설정 → 일반 → 언어 → 한국어.

보조 영역을 숨긴 뒤 검사를 못 찾겠어요?
창 상단에서 보조 영역을 다시 켜세요.

GeoCanvas 내보내기에 배경이 붙나요?
미리보기 → 내보낼 때 투명/검정/흰색/사용자 지정.

MossNet에 모델이 없나요?
Ollama를 켜고 모델을 pull한 뒤(예: ollama pull …) MossNet에서 목록을 새로고침하세요.

AmberClip에 파형이 없거나 내보내기가 실패하나요?
ffmpeg를 설치하거나 ffmpeg / ffmpeg.exe를 앱과 같은 폴더에 두세요.

SmartScreen / “확인되지 않은 개발자”?
Windows: 추가 정보 → 실행. macOS: 개인정보 보호 및 보안 → 그래도 열기. 회사 정책이면 IT에 허용 목록 요청.

아트보드나 워크플로를 지웠어요?
모듈의 실행 취소, MossNet 체크포인트. 그래도 없으면 오래된 백업으로 데이터 폴더 전체를 함부로 덮어쓰지 마세요.