diff --git a/web/html/api-doc-drawer.html b/web/html/api-doc-drawer.html
index 0dbb319..c85a51a 100644
--- a/web/html/api-doc-drawer.html
+++ b/web/html/api-doc-drawer.html
@@ -1,5 +1,5 @@
 <div class="drawer-backdrop hidden" id="apiDocDrawer">
-  <aside class="drawer" role="dialog" aria-modal="true" aria-labelledby="apiDocTitle">
+  <aside class="drawer api-drawer" role="dialog" aria-modal="true" aria-labelledby="apiDocTitle">
     <div class="drawer-head">
       <h3 id="apiDocTitle">API.md</h3>
       <button type="button" class="secondary" id="closeApiDoc">关闭</button>
diff --git a/web/js/docs.js b/web/js/docs.js
index c30741b..f8e08e6 100644
--- a/web/js/docs.js
+++ b/web/js/docs.js
@@ -103,10 +103,11 @@ export async function loadApiDoc() {
       if (!id) {
         return;
       }
-      dom.apiDocContent.querySelector(`#${CSS.escape(id)}`)?.scrollIntoView({
-        behavior: "smooth",
-        block: "start",
-      });
+      const target = dom.apiDocContent.querySelector(`#${CSS.escape(id)}`);
+      if (target) {
+        const offset = target.getBoundingClientRect().top - dom.apiDocContent.getBoundingClientRect().top;
+        dom.apiDocContent.scrollBy({ top: offset, behavior: "smooth" });
+      }
     });
   });
 
diff --git a/web/styles.css b/web/styles.css
index e9748c7..95cabb5 100644
--- a/web/styles.css
+++ b/web/styles.css
@@ -968,6 +968,10 @@ button.danger:hover { background: var(--danger-hover); }
   grid-template-columns: 220px minmax(0, 1fr);
 }
 
+.api-drawer {
+  width: min(1100px, 96vw);
+}
+
 .equipment-drawer {
   width: min(1120px, 96vw);
 }