fix(tools): 애니 파이프라인 버그 4건 수정 — Unicode SyntaxError, 카타카나 변환, Nyaa 검색 전략 + Python 환경 설정

.agents/AGENT.md

@@ -49,6 +49,7 @@ description: 모든 작업에 자동 적용되는 에이전트 행동 규칙.
 
 ## PowerShell Notes
 
+- **Python**: `C:\ProgramData\miniforge3\envs\gravity_web\python.exe` 사용 (시스템 `python` 대신)
 - `curl` → PowerShell에서 `Invoke-WebRequest` 별칭. **반드시 `curl.exe`** 사용
 - `npm` → 실행 정책 문제 시 `cmd /c npm` 사용
 - JSON 처리 시 `.py` 스크립트 권장 (PowerShell 이스케이핑 이슈 방지)

.agents/references/known-issues.md

@@ -40,4 +40,20 @@
 
 > 아래에 프로젝트 특화 이슈를 추가하세요.
 
-(아직 기록된 프로젝트별 이슈가 없습니다)
+### [2026-03-08] nas_scanner docstring — Unicode escape SyntaxError
+- **증상**: `from tools.nas_scanner import NasScanner` 시 `SyntaxError: (unicode error) 'unicodeescape' codec can't decode \N`
+- **원인**: docstring 내 `\\NasData` 경로에서 `\N`이 Python Unicode named escape로 해석
+- **해결**: docstring을 `r"""..."""` (raw string)으로 변경
+- **주의**: Windows 경로(`\\`, `\N`, `\U` 등)가 포함된 docstring은 반드시 `r"""`로 작성
+
+### [2026-03-08] title_matcher _kata_to_hira — 장음기호 깨짐
+- **증상**: `フリーレン` → `ふり゜れん` (ー가 ゜로 변환)
+- **원인**: 카타카나 범위 `0x30A0~0x30FF`에 기호 문자(`ー` U+30FC) 포함
+- **해결**: 범위를 `0x30A1~0x30F6`으로 좁혀 실제 문자만 변환
+- **주의**: 유니코드 범위 지정 시 기호/구두점 문자 포함 여부 확인 필수
+
+### [2026-03-08] anime_pipeline — Nyaa 검색 0건 반환
+- **증상**: 한자 포함 원제의 로마자 변환 결과(`葬送nofuriren`) + suffix 고정으로 Nyaa 검색 실패
+- **원인**: 단일 검색 전략, suffix(ASW HEVC) 항상 부착
+- **해결**: 6단계 fallback 전략 (romaji±suffix → 원제±suffix → 한글±suffix)
+- **주의**: 외부 API 검색 시 반드시 다중 전략 + suffix 토글 구현

.agents/workflows/check-gitea.md

@@ -1,4 +1,4 @@
----
+---
 description: Gitea API로 저장소 커밋/이슈/PR 현황을 조회하는 워크플로우
 ---
 
@@ -26,15 +26,15 @@ $issues | ForEach-Object { Write-Host "#$($_.number) $($_.title)" }
 
 3. Wiki 페이지 목록:
 ```powershell
-python .agents\workflows\helpers\wiki_helper.py list
+C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\wiki_helper.py list
 ```
 
 4. Wiki 페이지 읽기:
 ```powershell
-python .agents\workflows\helpers\wiki_helper.py read "Architecture"
+C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\wiki_helper.py read "Architecture"
 ```
 
 5. Wiki 페이지 업데이트:
 ```powershell
-python .agents\workflows\helpers\wiki_helper.py update "페이지-제목" /tmp/wiki_content.md
+C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\wiki_helper.py update "페이지-제목" /tmp/wiki_content.md
 ```

.agents/workflows/check-vikunja.md

@@ -12,27 +12,27 @@ description: Vikunja API로 프로젝트 태스크 현황을 조회하는 워크
 
 1. 전체 목록:
 ```powershell
-python .agents\workflows\helpers\vikunja_helper.py list
+C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\vikunja_helper.py list
 ```
 
 2. TODO만:
 ```powershell
-python .agents\workflows\helpers\vikunja_helper.py list todo
+C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\vikunja_helper.py list todo
 ```
 
 3. DONE만:
 ```powershell
-python .agents\workflows\helpers\vikunja_helper.py list done
+C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\vikunja_helper.py list done
 ```
 
 4. 태스크 완료 처리 (**⚠️ 반드시 이 방법 사용 — 직접 API 호출 금지**):
 ```powershell
-python .agents\workflows\helpers\vikunja_helper.py done {TASK_ID}
+C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\vikunja_helper.py done {TASK_ID}
 ```
 
 5. 새 태스크 생성:
 ```powershell
-python .agents\workflows\helpers\vikunja_helper.py create "제목" "설명" --labels Backend,Priority:High
+C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\vikunja_helper.py create "제목" "설명" --labels Backend,Priority:High
 ```
 
 > [!CAUTION]

.agents/workflows/end.md

@@ -87,9 +87,9 @@ git log --oneline -20
 
 | 커밋 유형 | Vikunja 액션 |
 |-----------|-------------|
-| 기존 태스크 해당 작업 **완료** | `python .agents\workflows\helpers\vikunja_helper.py done {ID}` |
-| 신규 작업 완료 (기존 태스크 없음) | `python .agents\workflows\helpers\vikunja_helper.py create "제목" "설명" --done --labels Backend,Priority:High` |
-| 작업 중 발견된 **미완료 TODO** | `python .agents\workflows\helpers\vikunja_helper.py create "제목" "설명" --labels Backend,Priority:Mid` |
+| 기존 태스크 해당 작업 **완료** | `C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\vikunja_helper.py done {ID}` |
+| 신규 작업 완료 (기존 태스크 없음) | `C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\vikunja_helper.py create "제목" "설명" --done --labels Backend,Priority:High` |
+| 작업 중 발견된 **미완료 TODO** | `C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\vikunja_helper.py create "제목" "설명" --labels Backend,Priority:Mid` |
 
 > [!IMPORTANT]
 > 모든 커밋이 기존 또는 신규 태스크에 매핑되었는지 확인.
@@ -97,13 +97,13 @@ git log --oneline -20
 ### 2-2. 완료 처리
 
 ```powershell
-python .agents\workflows\helpers\vikunja_helper.py done {TASK_ID}
+C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\vikunja_helper.py done {TASK_ID}
 ```
 
 ### 2-3. 신규 태스크 생성
 
 ```powershell
-python .agents\workflows\helpers\vikunja_helper.py create "제목" "설명" --labels Backend,Priority:High
+C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\vikunja_helper.py create "제목" "설명" --labels Backend,Priority:High
 ```
 
 ### 라벨 규칙
@@ -123,7 +123,7 @@ python .agents\workflows\helpers\vikunja_helper.py create "제목" "설명" --la
 | 새 모듈/패키지 추가 | Architecture |
 
 ```powershell
-python .agents\workflows\helpers\wiki_helper.py update "Architecture" /tmp/wiki_content.md
+C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\wiki_helper.py update "Architecture" /tmp/wiki_content.md
 ```
 
 ---

.agents/workflows/start.md

@@ -48,7 +48,7 @@ git log --oneline -5
 ### 3. Vikunja TODO 태스크
 
 ```powershell
-python .agents\workflows\helpers\vikunja_helper.py list todo
+C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\vikunja_helper.py list todo
 ```
 
 ### 4. 종합 보고