renamed watch

새 파일을 위한 폴더를 모니터링하고 자동으로 처리하십시오. 상태 확인, 재시도 처리 및 정상 종료가 포함된 프로덕션 준비입니다.

설치 없이 즉시 사용해 보십시오:

$ npx @renamed-to/cli watch ~/Downloads --output-dir ~/Organized

renamed watch <directory> [options]

watch 명령은 디렉터리에 새 파일이 있는지 모니터링하는 장기 실행 프로세스로 실행됩니다. 파일이 나타나면 대기열에 추가되고 AI 이름 변경으로 처리된 다음 선택적으로 정리된 출력 폴더로 이동됩니다.

동시 작업자, 지수 재시도 백오프 및 Unix 소켓 상태 모니터링을 갖춘 프로덕션 환경을 위해 설계되었습니다.

예제

Downloads를 감시하고 ~/Organized로 정리:

$ renamed watch ~/Downloads --output-dir ~/Organized --apply

4개의 동시 작업자로 PDF만 감시:

$ renamed watch ~/Documents -p "*.pdf" --concurrency 4

JSON 로그가 있는 프로덕션 모드:

$ renamed watch /data/incoming --apply --log-format json

옵션

-o, --output-dir <path>

처리된 파일을 여기로 이동합니다. AI가 하위 폴더로 정리합니다.

-p, --patterns <globs>

패턴과 일치하는 파일만 감시합니다 (예: "*.pdf *.jpg *.png"). 기본값: *.pdf *.jpg *.png

-f, --failed-dir <path>

처리에 실패한 파일을 제자리에 두는 대신 여기로 이동합니다.

-n, --dry-run

미리보기 모드입니다. 파일을 처리하지 않고 어떤 일이 발생할지 확인합니다.

--concurrency <n>

병렬 작업자 (1-10). 기본값: 2.

-c, --config <path>

YAML 구성 파일의 경로입니다.

--log-format <type>

출력 형식: text, json. 로그 집계에는 json을 사용하십시오.

프로덕션 기능

Concurrent workers — 여러 파일을 병렬로 처리합니다. 하드웨어에 따라 1-10에서 구성할 수 있습니다.

Retry with backoff — 실패한 파일은 지수 지연(5s → 10s → 20s)으로 자동 재시도됩니다.

Graceful shutdown — SIGTERM/SIGINT가 대기열을 비웁니다. 파일이 반쯤 처리된 상태로 남지 않습니다.

Health monitoring — 모니터링 도구와 통합을 위한 Unix 소켓 엔드포인트입니다.

상태 확인

상태 엔드포인트를 쿼리하십시오:

$ curl --unix-socket /tmp/renamed.sock http://localhost/health

{
 "status": "healthy",
 "uptime": 847293,
 "queue": {"pending": 3, "processing": 2}
}

구성 파일

복잡한 설정의 경우 YAML 구성을 사용하십시오:

~/.config/renamed/config.yaml

watch:
 patterns: ["*.pdf", "*.jpg", "*.png"]

rateLimit:
 concurrency: 4
 retryAttempts: 3

health:
 enabled: true
 socketPath: /tmp/renamed.sock

참고

service — systemd 서비스로 실행 rename — 일회성 일괄 이름 변경