From 08de63b448c16d247120209a1dd18c19fc79c52d Mon Sep 17 00:00:00 2001 From: Claude Owner Date: Tue, 26 May 2026 14:42:35 +0900 Subject: [PATCH] docs: refresh README for fixes landed in this branch MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Drop the 'known build defect' callout — tsconfig now compiles cleanly with rootDir + ignoreDeprecations applied. - Add SIGNATURE_HOST to the env var table. --- README.md | 14 +++----------- 1 file changed, 3 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 5c62c2b..66181f7 100644 --- a/README.md +++ b/README.md @@ -73,6 +73,7 @@ db/ | `DEV` | 선택 | `true`면 글로벌 대신 `GUILDID`에만 슬래시 등록 | | `DEBUG` | 선택 | `true`면 명령어 오류 스택 로깅 | | `REPLACETEXT` | 선택 | 치환 사전(JSON 배열). 기본 사전(`def_replaceObj`)과 병합 | +| `SIGNATURE_HOST` | 선택 | 시그니처 서버 `host:port`. 미설정 시 `192.168.10.5:2967` 기본값 | | `TTSPATH` | 선택 | `Config.ttsPath` getter만 정의돼 있고 현재 호출처 없음. 향후 사용 대비 환경변수만 받아둠 | ## 실행 @@ -86,22 +87,13 @@ npm run dev # 빌드 후 실행 (ts-cleaner가 dist/를 스캔하므로 먼저 만들어야 함) mkdir -p dist -npm run build # ⚠️ 현재 tsconfig 결함으로 실패 — 아래 "알려진 빌드 결함" 참고 +npm run build npm start # 전역 슬래시 명령어 등록 (배포 파이프라인) npm run prod ``` -> **알려진 빌드 결함 (TypeScript 6+ 환경)** -> -> 현재 `tsconfig.json` 상태에서 `tsc` 가 다음 두 에러로 실패한다: -> - `TS5101`: `baseUrl` 옵션이 사용중지(deprecated). `"ignoreDeprecations": "6.0"` 추가 필요 -> - `TS5011`: `outDir`만 지정돼 있고 `rootDir` 미지정. `"rootDir": "./src"` 추가 필요 -> -> Docker 빌드도 내부에서 `npm run build`를 실행하므로 같은 사유로 실패한다. -> 임시 우회로 `npm run dev`(ts-node)를 사용하거나, 위 두 옵션을 `tsconfig.json` `compilerOptions`에 추가하면 정상 빌드된다. - ### Docker ```bash @@ -109,7 +101,7 @@ docker build -t tts_bot . docker run --env-file .env -v $(pwd)/db:/app/db tts_bot ``` -Dockerfile은 `node:20-alpine` 기반이며 `ffmpeg`을 설치한다. 단 위 "알려진 빌드 결함"이 해결돼야 이미지 빌드가 통과한다. +Dockerfile은 `node:20-alpine` 기반이며 `ffmpeg`을 설치한다. ## 동작 흐름 요약