Keep avatar asset URLs aligned with image bytes

Character and intro avatar files contained JPEG data while being served through .png paths. The assets now use .jpg filenames, data/component references point at those URLs, and the repository verifier checks public image signatures against their extensions so static MIME assumptions stay honest.

Constraint: Keep existing image bytes and avoid introducing image-processing dependencies.

Rejected: Re-encode all avatars as PNG | unnecessary binary churn and no current image tooling dependency.

Confidence: high

Scope-risk: narrow

Directive: When adding public image assets, ensure file signatures match their URL extensions before committing.

Tested: python3 scripts/check_repository.py; npm run verify; npm audit --omit=dev; git diff --check

Author: worldwonderer

components/chat/screens/IntroView.jsx

@@ -64,7 +64,7 @@ export default function IntroView() {
         <div className="w-full max-w-sm flex flex-col items-center gap-6 animate-in fade-in slide-in-from-bottom-4 duration-500">
           <div className="flex flex-col items-center gap-3">
             <div className="relative">
-              <ImageShim src="/avatar-girl.png" alt="游戏角色" width={90} height={90} className="rounded-2xl object-cover shadow-xl ring-4 ring-white" />
+              <ImageShim src="/avatar-girl-intro.jpg" alt="游戏角色" width={90} height={90} className="rounded-2xl object-cover shadow-xl ring-4 ring-white" />
               <span className="absolute -top-2 -right-2 text-white text-[16px] font-bold rounded-full px-1.5 py-0.5">❤️</span>
             </div>
 

data/girls.json

@@ -2,7 +2,7 @@
   "lin": {
     "id": "lin",
     "name": "林晓柔",
-    "avatar": "/lin.png",
+    "avatar": "/lin.jpg",
     "tags": [
       "段位：🌟🌟",
       "白银捞女",
@@ -14,7 +14,7 @@
   "tan": {
     "id": "tan",
     "name": "谭佳欣",
-    "avatar": "/tan.png",
+    "avatar": "/tan.jpg",
     "tags": [
       "段位：🌟🌟🌟🌟🌟",
       "钻石海王",
@@ -26,7 +26,7 @@
   "su": {
     "id": "su",
     "name": "苏佳怡",
-    "avatar": "/su.png",
+    "avatar": "/su.jpg",
     "tags": [
       "段位：🌟🌟🌟🌟",
       "病娇白切黑",
@@ -38,7 +38,7 @@
   "shen": {
     "id": "shen",
     "name": "沈书仪",
-    "avatar": "/shen.png",
+    "avatar": "/shen.jpg",
     "tags": [
       "段位：🌟🌟🌟🌟🌟",
       "高阶海后",
@@ -50,7 +50,7 @@
   "chen": {
     "id": "chen",
     "name": "陈盈盈",
-    "avatar": "/chen.png",
+    "avatar": "/chen.jpg",
     "tags": [
       "段位：🌟",
       "恋爱脑青梅",

data/summary.json

@@ -6,11 +6,11 @@
   "asset_paths": [
     "/avatar-boy.jpg",
     "/avatar-girl.jpg",
-    "/avatar-girl.png",
-    "/chen.png",
-    "/lin.png",
-    "/shen.png",
-    "/su.png",
-    "/tan.png"
+    "/avatar-girl-intro.jpg",
+    "/chen.jpg",
+    "/lin.jpg",
+    "/shen.jpg",
+    "/su.jpg",
+    "/tan.jpg"
   ]
 }

public/avatar-girl.png public/avatar-girl-intro.jpgpublic/avatar-girl.png renamed to public/avatar-girl-intro.jpg

@@ -40,6 +40,7 @@
     ROOT / 'data' / 'girls.json',
     ROOT / 'data' / 'chapters.json',
     ROOT / 'data' / 'scenes.json',
+    ROOT / 'data' / 'summary.json',
     ROOT / 'data' / 'tactics.json',
     ROOT / 'scripts' / 'verify_visual_baseline.py',
     ROOT / 'scripts' / 'verify_ai_integration.mjs',
@@ -54,6 +55,7 @@
 girls = json.loads((ROOT / 'data' / 'girls.json').read_text())
 chapters = json.loads((ROOT / 'data' / 'chapters.json').read_text())
 scenes = json.loads((ROOT / 'data' / 'scenes.json').read_text())
+summary = json.loads((ROOT / 'data' / 'summary.json').read_text())
 tactics = json.loads((ROOT / 'data' / 'tactics.json').read_text())
 
 env_example = (ROOT / '.env.example').read_text()
@@ -164,13 +166,43 @@
     raise SystemExit('chapters.json must be a non-empty object')
 if not isinstance(scenes, list) or not scenes:
     raise SystemExit('scenes.json must be a non-empty array')
+if not isinstance(summary, dict):
+    raise SystemExit('summary.json must be an object')
 if not isinstance(tactics, list) or not tactics:
     raise SystemExit('tactics.json must be a non-empty array')
 
 scene_ids = {scene['id'] for scene in scenes}
 missing_public_assets: list[str] = []
 missing_scene_links: list[str] = []
 implicit_silent_choices: list[str] = []
+bad_public_image_types: list[str] = []
+
+
+def public_image_type(path: Path) -> str:
+    header = path.read_bytes()[:12]
+    if header.startswith(b'\x89PNG\r\n\x1a\n'):
+        return 'png'
+    if header.startswith(b'\xff\xd8\xff'):
+        return 'jpg'
+    if header.startswith(b'\x00\x00\x01\x00'):
+        return 'ico'
+    return 'unknown'
+
+
+for public_path in PUBLIC_ROOT.iterdir():
+    if not public_path.is_file():
+        continue
+    suffix = public_path.suffix.lower()
+    if suffix not in {'.png', '.jpg', '.jpeg', '.ico'}:
+        continue
+    detected_type = public_image_type(public_path)
+    expected_type = 'jpg' if suffix in {'.jpg', '.jpeg'} else suffix.lstrip('.')
+    if detected_type != expected_type:
+        bad_public_image_types.append(f'{public_path.relative_to(ROOT)} is {detected_type}, expected {expected_type}')
+
+for asset_path in summary.get('asset_paths', []):
+    if isinstance(asset_path, str) and asset_path.startswith('/') and not (PUBLIC_ROOT / asset_path.lstrip('/')).exists():
+        missing_public_assets.append(asset_path)
 
 for girl_id, girl in girls.items():
     avatar = girl.get('avatar', '')
@@ -206,6 +238,9 @@
 if missing_public_assets:
     raise SystemExit('Missing public assets: ' + ', '.join(sorted(set(missing_public_assets))))
 
+if bad_public_image_types:
+    raise SystemExit('Public image extensions must match file signatures: ' + '; '.join(bad_public_image_types))
+
 if missing_scene_links:
     preview = ', '.join(missing_scene_links[:10])
     raise SystemExit(f'Broken scene links detected ({len(missing_scene_links)}): {preview}')