diff --git a/docs/index.html b/docs/index.html
index ac2900a..c24785d 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -1624,5 +1624,92 @@
       }).catch(function() { /* 静默失败，保留硬编码链接作为兜底 */ });
     })();
   </script>
+
+  <!-- ══════════════ Floating Promo Capsule ══════════════ -->
+  <style>
+    .promo-capsule{position:fixed;bottom:140px;right:24px;z-index:80;font-family:inherit;opacity:0;transform:translateY(20px);transition:opacity .5s,transform .5s;pointer-events:none}
+    .promo-capsule.promo-visible{opacity:1;transform:translateY(0);pointer-events:auto}
+    .promo-capsule.promo-dismissed{display:none}
+    .promo-fab{display:flex;flex-direction:column;align-items:center;gap:6px;cursor:pointer;transition:transform .3s;position:relative;border:none;padding:0;background:none}
+    .promo-fab:hover{transform:scale(1.08)}
+    .promo-fab-icon{width:48px;height:48px;border-radius:14px;background:linear-gradient(135deg,#f97316,#ef4444);box-shadow:0 4px 16px rgba(239,68,68,.3);display:flex;align-items:center;justify-content:center;position:relative}
+    .promo-fab-icon::after{content:'';position:absolute;inset:-3px;border-radius:17px;border:2px solid rgba(239,68,68,.2);animation:promoPulse 2.5s ease-in-out infinite}
+    @keyframes promoPulse{0%,100%{opacity:1;transform:scale(1)}50%{opacity:0;transform:scale(1.1)}}
+    .promo-fab-icon img{width:28px;height:28px;border-radius:6px;filter:brightness(0) invert(1)}
+    .promo-fab-ad{position:absolute;top:-6px;right:-6px;padding:1px 5px;border-radius:4px;font-size:9px;font-weight:700;color:#fff;background:rgba(0,0,0,.45);backdrop-filter:blur(4px);line-height:1.3;letter-spacing:.5px}
+    .promo-fab-text{font-size:11px;font-weight:600;color:var(--accent,#6366f1);background:var(--bg-card,rgba(255,255,255,.85));backdrop-filter:blur(8px);padding:3px 10px;border-radius:8px;border:1px solid var(--border,rgba(0,0,0,.06));box-shadow:0 2px 8px rgba(0,0,0,.06);white-space:nowrap;overflow:hidden;min-width:20px;max-width:120px}
+    html.dark .promo-fab-text{background:rgba(18,18,26,.8);color:#818cf8}
+    .promo-fab-text .typewriter{display:inline;border-right:2px solid var(--accent,#6366f1);animation:blink .7s step-end infinite}
+    @keyframes blink{50%{border-color:transparent}}
+    .promo-card{position:absolute;bottom:64px;right:0;width:280px;background:var(--bg-card,rgba(255,255,255,.8));backdrop-filter:blur(16px);-webkit-backdrop-filter:blur(16px);border:1px solid var(--border,rgba(0,0,0,.08));border-radius:16px;box-shadow:0 12px 40px rgba(0,0,0,.12);padding:20px;opacity:0;transform:translateY(8px) scale(.95);transition:opacity .25s,transform .25s;pointer-events:none;visibility:hidden}
+    html.dark .promo-card{background:rgba(18,18,26,.85);box-shadow:0 12px 40px rgba(0,0,0,.4)}
+    .promo-capsule.promo-expanded .promo-card{opacity:1;transform:translateY(0) scale(1);pointer-events:auto;visibility:visible}
+    .promo-card-close{position:absolute;top:8px;right:10px;background:none;border:none;color:var(--text-t,#9ca3af);font-size:18px;cursor:pointer;padding:2px 6px;border-radius:6px;line-height:1;transition:color .2s,background .2s}
+    .promo-card-close:hover{color:var(--text,#111);background:var(--accent-5,rgba(99,102,241,.05))}
+    .promo-card-icon{width:40px;height:40px;border-radius:10px;margin-bottom:12px;border:1px solid var(--border)}
+    .promo-card-title{font-size:15px;font-weight:700;color:var(--text,#111);margin-bottom:6px;line-height:1.3}
+    .promo-card-desc{font-size:13px;color:var(--text-s,#6b7280);line-height:1.5;margin-bottom:14px}
+    .promo-card-btn{display:inline-flex;align-items:center;gap:6px;padding:8px 18px;border-radius:10px;font-size:13px;font-weight:600;color:#fff;background:linear-gradient(135deg,#6366f1,#a855f7);text-decoration:none;transition:transform .2s,box-shadow .2s;border:none;cursor:pointer}
+    .promo-card-btn:hover{transform:translateY(-1px);box-shadow:0 4px 16px rgba(99,102,241,.35)}
+    .promo-card-tag{display:inline-block;padding:2px 8px;border-radius:4px;font-size:11px;font-weight:600;color:var(--accent,#6366f1);background:var(--accent-5,rgba(99,102,241,.05));margin-bottom:10px}
+    @media(max-width:768px){.promo-capsule{bottom:120px;right:16px}.promo-card{width:260px;right:-8px}.promo-fab-icon{width:42px;height:42px;border-radius:12px}.promo-fab-icon img{width:24px;height:24px}.promo-fab-text{font-size:10px;padding:2px 8px}}
+    @media(max-width:480px){.promo-capsule{bottom:100px;right:12px}}
+  </style>
+
+  <div class="promo-capsule" id="promoCapsule">
+    <div class="promo-card">
+      <button class="promo-card-close" id="promoClose" aria-label="关闭">×</button>
+      <img class="promo-card-icon" src="./apple-touch-icon.png" alt="OpenClaw 教程">
+      <div class="promo-card-tag">推荐课程 <span style="font-weight:400;opacity:.5;font-size:10px">· 广告</span></div>
+      <div class="promo-card-title">OpenClaw 教程<br>0 基础入门到精通</div>
+      <div class="promo-card-desc">系统学习 AI Agent 搭建，从安装到实战部署。含全网独家创业教程，视频+图文全覆盖。</div>
+      <a class="promo-card-btn" href="https://plus.wx.hapymcn.com/app/index.php?i=4532&c=entry&do=search&clear=1&m=fy_lessonv2&keyword=openclaw" target="_blank" rel="noopener">
+        <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polygon points="5 3 19 12 5 21 5 3"/></svg>
+        立即学习
+      </a>
+    </div>
+    <button class="promo-fab" id="promoFab" aria-label="OpenClaw 教程">
+      <span class="promo-fab-icon"><img src="./apple-touch-icon.png" alt=""></span>
+      <span class="promo-fab-text"><span class="typewriter" id="promoTypewriter"></span></span>
+    </button>
+  </div>
+
+  <script>
+    (function(){
+      if(sessionStorage.getItem('promo-dismissed'))return;
+      var capsule=document.getElementById('promoCapsule');
+      var fab=document.getElementById('promoFab');
+      var closeBtn=document.getElementById('promoClose');
+      // 延迟 3 秒显示，不打扰首屏体验
+      setTimeout(function(){capsule.classList.add('promo-visible')},1000);
+      fab.addEventListener('click',function(){capsule.classList.toggle('promo-expanded')});
+      // Typewriter effect — cycling phrases
+      var phrases=['OpenClaw 教程','0基础入门','AI Agent 实战','全网独家创业课','视频+图文'];
+      var tw=document.getElementById('promoTypewriter');
+      var pi=0,ci=0,deleting=false,speed=120;
+      function typeStep(){
+        var phrase=phrases[pi];
+        if(!deleting){
+          tw.textContent=phrase.substring(0,ci+1);
+          ci++;
+          if(ci>=phrase.length){deleting=true;setTimeout(typeStep,1800);return;}
+        }else{
+          tw.textContent=phrase.substring(0,ci);
+          ci--;
+          if(ci<0){ci=0;deleting=false;pi=(pi+1)%phrases.length;setTimeout(typeStep,400);return;}
+        }
+        setTimeout(typeStep,deleting?60:speed);
+      }
+      typeStep();
+      closeBtn.addEventListener('click',function(e){
+        e.stopPropagation();
+        capsule.classList.remove('promo-expanded');
+      });
+      // 点击外部关闭展开态
+      document.addEventListener('click',function(e){
+        if(!capsule.contains(e.target)){capsule.classList.remove('promo-expanded')}
+      });
+    })();
+  </script>
 </body>
 </html>