Files
edf/.agents/references/known-issues.md

49 lines
3.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Known Issues — 과거 실패 기록
> 이 파일은 에이전트가 같은 실수를 반복하지 않도록 실패를 기록합니다.
> 세션 종료 시 자동으로 새 이슈를 추가합니다.
---
### 2026-03-11 pykrx — get_market_ticker_list 항상 0 반환
- **증상**: `stock.get_market_ticker_list(date, market="KOSPI")`가 모든 날짜에 0 반환
- **원인**: pykrx 1.2.4 버전에서 ticker_list API가 정상 동작하지 않음 (2026년 환경)
- **해결**: DART `corp_codes`로 종목 목록 확보 + per-ticker `get_market_ohlcv`는 정상 동작
- **주의**: `get_market_ticker_list` 의존하지 말 것. DART corp_codes를 종목 마스터로 사용
### 2026-03-11 pykrx — get_market_cap 단일일자 조회 시 시총=0
- **증상**: `stock.get_market_cap(date, date, ticker)` 호출 시 시가총액이 0 반환
- **원인**: 단일일자 조회 문법 이슈 (pykrx 내부 처리 문제)
- **해결**: `stock.get_market_cap_by_date(start, end, ticker)`로 15일 범위 조회 후 마지막 값 사용
- **주의**: 단일일자 `get_market_cap` 사용 금지. 반드시 date range + `_by_date` 변형 사용
### 2026-03-11 DART — corp_codes 순서에 소형/비활성 종목 우선
- **증상**: DART `corp_codes` 순서대로 수집 시 처음 10~20개가 전부 에러 (비활성/상폐 종목)
- **원인**: corp_codes 정렬이 코드 순이라 소형/비활성사가 앞에 위치
- **해결**: KRX에서 주가 확인된 종목(volatility 테이블)만 DART 수집 대상으로 필터링
- **주의**: DART 수집 시 반드시 KRX 활성 필터 적용. `finstate(stock_code, year)` 형태로 직접 조회 가능
### 2026-03-11 PowerShell — 인라인 Python f-string 이스케이핑 불가
- **증상**: `python -c "...f'{var}'..."` 형태 인라인 코드가 PowerShell에서 파싱 오류
- **원인**: PowerShell의 `'`, `"`, `{}` 이스케이핑이 Python f-string과 충돌
- **해결**: 항상 별도 `.py` 파일로 작성하여 실행
- **주의**: PowerShell에서 복잡한 Python 코드를 `-c` 옵션으로 실행하지 말 것
### 2026-03-12 pykrx — get_market_cap 전 함수군 완전 불가
- **증상**: `get_market_cap`, `get_market_cap_by_date`, `get_market_cap_by_ticker` 모두 0 반환 또는 columns 오류
- **원인**: pykrx 1.2.4에서 시가총액/상장주식수 관련 API 전면 고장
- **해결**: DART `total_equity`(자본총계)를 E(자기자본)로 대체 사용
- **주의**: 시가총액 필요 시 유료 DB(FnGuide 등) 또는 DART 발행주식수 × 종가로 별도 산출 필요
### 2026-03-12 Merton — SPAC/스팩 종목 DD 비정상 (50~124)
- **증상**: DD가 50~124로 비정상적으로 높아 AAA 등급 오염
- **원인**: SPAC은 자산=현금, 부채=극소 → Merton 모형에서 부도확률이 0에 수렴
- **해결**: 종목명에 "스팩", "SPAC", "N호" 패턴 포함 시 제외 (62개)
- **주의**: 리츠(26개)도 동일 문제. 비정상 종목 필터 항상 적용
### 2026-03-12 Shadow Rating — EDF 등급역전 (composite score 기반)
- **증상**: AA-의 EDF가 A+보다 높은 역전 현상
- **원인**: composite score에서 DD 외 재무비율(레버리지/ROA)이 등급을 왜곡
- **해결**: DD 가중치를 50% → 70%로 상향, isotonic 단조보정 적용
- **주의**: composite score 산출 시 DD 가중치를 70% 미만으로 낮추면 역전 재발