diff --git a/README.md b/README.md
index 9b8f540..f2228ef 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,7 @@
-<p align="center">
+<div align="center">
   <img src="assets/logo_icon.svg" width="128" alt="Coding With Beat"/>
-</p>
-
-# Coding With Beat
+  <h1>Coding With Beat</h1>
+</div>
 
 ![Python](https://img.shields.io/badge/Python-3.10+-3776AB?style=flat-square&logo=python&logoColor=white)
 ![Platform](https://img.shields.io/badge/platform-macOS-000000?style=flat-square&logo=apple&logoColor=white)
diff --git a/docs/assets/logo_icon.svg b/docs/assets/logo_icon.svg
new file mode 100644
index 0000000..ee4876d
--- /dev/null
+++ b/docs/assets/logo_icon.svg
@@ -0,0 +1,100 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" width="128" height="128" shape-rendering="crispEdges">
+  <!-- Transparent background — no fill rect -->
+
+  <!-- ═══════════════════════════════════════════ -->
+  <!-- HEADPHONE BAND                             -->
+  <!-- ═══════════════════════════════════════════ -->
+  <!-- Top span -->
+  <rect x="40" y="8"  width="48" height="8"  fill="#2d4a6e"/>
+  <!-- Left descent -->
+  <rect x="28" y="12" width="12" height="10" fill="#2d4a6e"/>
+  <!-- Right descent -->
+  <rect x="88" y="12" width="12" height="10" fill="#2d4a6e"/>
+
+  <!-- ═══════════════════════════════════════════ -->
+  <!-- LEFT HEADPHONE CUP                        -->
+  <!-- ═══════════════════════════════════════════ -->
+  <rect x="12" y="18" width="24" height="44" fill="#ff8c00"/>  <!-- outer shell -->
+  <rect x="16" y="22" width="16" height="36" fill="#c45000"/>  <!-- ear pad -->
+  <rect x="21" y="34" width="6"  height="6"  fill="#ff8c00"/>  <!-- speaker dot -->
+  <rect x="21" y="42" width="6"  height="2"  fill="#ffa833"/>  <!-- mesh line -->
+  <rect x="21" y="46" width="6"  height="2"  fill="#ffa833"/>  <!-- mesh line -->
+
+  <!-- ═══════════════════════════════════════════ -->
+  <!-- RIGHT HEADPHONE CUP                       -->
+  <!-- ═══════════════════════════════════════════ -->
+  <rect x="92" y="18" width="24" height="44" fill="#ff8c00"/>  <!-- outer shell -->
+  <rect x="96" y="22" width="16" height="36" fill="#c45000"/>  <!-- ear pad -->
+  <rect x="101" y="34" width="6" height="6"  fill="#ff8c00"/>  <!-- speaker dot -->
+  <rect x="101" y="42" width="6" height="2"  fill="#ffa833"/>  <!-- mesh line -->
+  <rect x="101" y="46" width="6" height="2"  fill="#ffa833"/>  <!-- mesh line -->
+
+  <!-- ═══════════════════════════════════════════ -->
+  <!-- HEAD                                       -->
+  <!-- ═══════════════════════════════════════════ -->
+  <rect x="32" y="20" width="64" height="48" fill="#ffd6a5"/>
+  <!-- Ear nubs -->
+  <rect x="24" y="30" width="8"  height="16" fill="#ffc890"/>
+  <rect x="96" y="30" width="8"  height="16" fill="#ffc890"/>
+  <!-- Forehead shadow -->
+  <rect x="32" y="20" width="64" height="6"  fill="#ffcf99"/>
+
+  <!-- Eyes  (•  •) -->
+  <rect x="44" y="34" width="10" height="10" fill="#1a1a2e"/>
+  <rect x="74" y="34" width="10" height="10" fill="#1a1a2e"/>
+  <!-- Shine -->
+  <rect x="46" y="35" width="4"  height="4"  fill="#ffffffbb"/>
+  <rect x="76" y="35" width="4"  height="4"  fill="#ffffffbb"/>
+
+  <!-- Cheeks (blush) -->
+  <rect x="36" y="46" width="8"  height="4"  fill="#ffb3a0" opacity="0.6"/>
+  <rect x="84" y="46" width="8"  height="4"  fill="#ffb3a0" opacity="0.6"/>
+
+  <!-- Mouth — the  _  in (•_•) -->
+  <rect x="50" y="58" width="28" height="4"  fill="#1a1a2e"/>
+
+  <!-- ═══════════════════════════════════════════ -->
+  <!-- BODY — orange hoodie                       -->
+  <!-- ═══════════════════════════════════════════ -->
+  <rect x="24" y="68" width="80" height="36" fill="#ff8c00"/>
+  <!-- Collar / hood opening -->
+  <rect x="52" y="68" width="24" height="10" fill="#ffd6a5"/>
+  <!-- Hoodie top band shadow -->
+  <rect x="24" y="68" width="80" height="6"  fill="#e07800"/>
+  <!-- Center zip line -->
+  <rect x="63" y="78" width="2"  height="26" fill="#c45000"/>
+  <!-- Pocket -->
+  <rect x="50" y="86" width="28" height="14" fill="#c45000"/>
+  <rect x="63" y="86" width="2"  height="14" fill="#a03a00"/>
+
+  <!-- ═══════════════════════════════════════════ -->
+  <!-- ARMS                                       -->
+  <!-- ═══════════════════════════════════════════ -->
+  <rect x="6"  y="68" width="18" height="32" fill="#ff8c00"/>
+  <rect x="104" y="68" width="18" height="32" fill="#ff8c00"/>
+  <!-- Hands -->
+  <rect x="2"  y="96" width="24" height="8"  fill="#ffd6a5"/>
+  <rect x="102" y="96" width="24" height="8" fill="#ffd6a5"/>
+
+  <!-- ═══════════════════════════════════════════ -->
+  <!-- LEGS                                       -->
+  <!-- ═══════════════════════════════════════════ -->
+  <rect x="32" y="104" width="24" height="16" fill="#1a3050"/>
+  <rect x="72" y="104" width="24" height="16" fill="#1a3050"/>
+  <!-- Jeans highlight -->
+  <rect x="36" y="104" width="6"  height="16" fill="#243d65"/>
+  <rect x="76" y="104" width="6"  height="16" fill="#243d65"/>
+
+  <!-- Shoes -->
+  <rect x="28" y="118" width="32" height="8"  fill="#1a1a2e"/>
+  <rect x="68" y="118" width="32" height="8"  fill="#1a1a2e"/>
+  <!-- Sole accent -->
+  <rect x="28" y="123" width="32" height="3"  fill="#2d3a4a"/>
+  <rect x="68" y="123" width="32" height="3"  fill="#2d3a4a"/>
+
+  <!-- ═══════════════════════════════════════════ -->
+  <!-- FLOATING MUSIC NOTE                        -->
+  <!-- ═══════════════════════════════════════════ -->
+  <text x="100" y="22" font-size="14" fill="#ffd700" opacity="0.85" font-family="serif">&#9834;</text>
+  <text x="8"   y="20" font-size="10" fill="#9bbc0f" opacity="0.6"  font-family="serif">&#9835;</text>
+</svg>
diff --git a/docs/index.html b/docs/index.html
index 24bb73e..915672a 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -4,7 +4,7 @@
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>Coding With Beat</title>
-  <link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'><rect width='32' height='32' rx='5' fill='%230d0d10'/><text x='16' y='24' font-size='20' text-anchor='middle' fill='%239bbc0f'>♪</text></svg>">
+  <link rel="icon" href="assets/logo_icon.svg" type="image/svg+xml">
   <meta name="description" content="A pixel-art DJ companion for Claude Code. Music while you vibe-code.">
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;700&display=swap" rel="stylesheet">
@@ -82,6 +82,8 @@
       font-size: 12px;
       font-weight: 700;
       letter-spacing: .12em;
+      display: flex;
+      align-items: center;
     }
 
     .nav-logo span { color: var(--amber); }
@@ -641,7 +643,7 @@
 
 <!-- NAV -->
 <nav>
-  <div class="nav-logo">♪ <span>coding</span>-with-beat</div>
+  <div class="nav-logo"><img src="assets/logo_icon.svg" alt="" style="width:22px;height:22px;vertical-align:middle;margin-right:6px;image-rendering:pixelated"><span>coding</span>-with-beat</div>
   <div class="nav-right">
     <a class="gh-link" href="https://github.com/jaychempan/coding-with-beat" target="_blank" rel="noopener">GitHub ↗</a>
     <div class="lang-toggle">
diff --git a/skills/cwb/SKILL.md b/skills/cwb/SKILL.md
index 34ad4d3..1973cf9 100644
--- a/skills/cwb/SKILL.md
+++ b/skills/cwb/SKILL.md
@@ -74,6 +74,19 @@ Do NOT generate keywords. For any request that isn't a specific song/artist/comm
 
 Display results grouped by angle with emoji labels (returned by the tool), number globally across groups (1, 2, 3…), end with: 喜欢哪首？说编号我来播。 Do NOT auto-play.
 
+## Library-only search
+
+When the user explicitly restricts the search to their local library — trigger phrases include:
+- 中文: "从资料库找"、"资料库里有没有"、"我已经有这首"、"本地库里"
+- English: "in my library", "library only", "do I have", "from my library"
+
+**Do this:**
+1. Call `search(query)` as normal.
+2. From the results, **only show entries where `source == "library"`**.
+3. If none are found, tell the user: "资料库里没找到，要不要搜一下线上？" — do NOT auto-expand to catalog.
+
+Do NOT call `list_library` for this — `search()` is more targeted. `list_library` is only useful when the user wants to **browse all** tracks without a specific query.
+
 ## play_number — number parsing
 
 Always parse the user's number expression before calling `play_number(N)`: