요약
M11.3 (Detection Cache + 부수 patch 4건) 의 첫 PyPI publish. v0.2.0 이후 누적 변경 = M11.1 (PR #17, Gemini Batch API + /analyzing dashboard) + M11.2 (PR #19, Batch Spritesheet Modality chat_spritesheet) + M11.3 (PR #20, Detection Cache + patch A/B/C/D-2). 회귀 1252 → 1559 passed + 1 skipped + 57 deselected (+307 신규 테스트, 0 회귀, M11 v0.2.0 baseline 기준).
참고: v0.2.1 은 PyPI 영구 결번. tag 는 push 됐으나 pyproject 미bump → 같은 wheel 빌드 → skip-existing: true silent skip. 자세히 milestones/HISTORY.md "Trusted Publishing 패턴".
M11.3 핵심 — Detection Cache (옵션 B+C)
M11.2 가 도입한 detect_sheet 시트당 3중 호출 (chat_image classify / chat_spritesheet classify / BatchPoller persist) 을 2-층 캐시로 1회 호출로 압축.
- 옵션 B —
sprite_meta.animations_jsonDB cross-sweep cache. 시트가 한번 detect 되면 다음 sweep 부터store.get_sprite_meta()hit 시 detect 우회 - 옵션 C —
BatchManager._detection_cacheLRU 메모리 sweep cache (max 1024) classify_image_assets(cache, save_sprite_meta)인자 추가 + 시트 hit 시 sprite_meta 자동 enrich+save- LIVE 검증: m113_verify (13자산) 24회→14회 (37% 감소), m113_complex (6자산) 16회→8회 (50% 감소)
부수 patch 4건 (동시 fix)
- Patch A —
/settingsUI modalityOrder + chainAdd 에chat_spritesheet추가, ko/en msgid "Spritesheet chain"/"스프라이트시트 체인" - Patch B —
core/analyzer/payload_parser.py_coerce_to_dicthelper, list/None 비-dict 입력 graceful unwrap - Patch C —
core/llm/backends/gemini.pybatch_embed가{"contents":[...]}단일 dict 로 SDK 호환 (실 API 200 OK 검증) - Patch D-2 —
core/sheet/detect.pyFrameSpec.w/h 가stride_x/y(slot 크기) 사용, grid_detect alpha-tight bound 한계 회피
회귀 및 의존성
- +30 신규 테스트 (1528 → 1559 passed + 1 skipped + 57 deselected, 0 회귀)
- 신규 의존성 0, 마이그 0, MCP 도구 20 그대로
알려진 한계 (M11.4 candidate)
- D-1: grid_detect alpha-only edge → color-cycling effect 시트 (
elemental_cyan같은 alpha-uniform) 검출 실패 - LLM #3: Gemma 분류 정확도 (inventory item 류가 character 로 분류, palette hex whitelist 위반)
설치
```powershell
pipx install assetcache-mcp
```
또는
```powershell
uv tool install assetcache-mcp
```
자세한 설치/사용 안내는 v0.1.0 release notes 참조.
Trusted Publishing 결과
- workflow run: 26225087198 (~30초)
- PyPI: https://pypi.org/project/assetcache-mcp/0.2.2/
관련 PR
- PR #20 — M11.3 Detection Cache + 부수 patch 4건
- PR #19 — M11.2 Batch Spritesheet Modality (v0.2.0 이후 누적)
- PR #17 — M11.1 Gemini Batch API + /analyzing dashboard (v0.2.0 이후 누적)
🤖 Generated with Claude Code