/* ============================================================
   哨卡 · 公开接入文档版式 (docs.css)
   复用 site.css 的视觉令牌，只补文档专属版式：左目录 + 右正文 +
   代码块 + 参数表 + callout。公开页，可放心给访客看。
   ============================================================ */

.doc-wrap{background:var(--paper)}
.doc{max-width:1220px;margin:0 auto;padding:0 28px;display:grid;grid-template-columns:250px 1fr;gap:52px;align-items:start}

/* ---- 左侧目录 ---- */
.doc-toc{position:sticky;top:92px;padding:36px 0 60px;max-height:calc(100vh - 92px);overflow:auto}
.doc-toc .toc-t{font-size:11.5px;letter-spacing:1.4px;text-transform:uppercase;color:var(--faint);font-weight:700;margin-bottom:14px}
.doc-toc nav{display:flex;flex-direction:column;gap:1px}
.doc-toc .grp{font-size:11px;letter-spacing:1px;color:var(--faint);font-weight:700;margin:16px 0 6px;padding-left:12px}
.doc-toc a{font-size:13.5px;color:var(--ink-2);padding:6px 12px;border-left:2px solid transparent;border-radius:0 8px 8px 0;line-height:1.45;transition:.14s}
.doc-toc a:hover{color:var(--ink);background:var(--surface-2)}
.doc-toc a.active{color:var(--accent-ink);border-left-color:var(--accent);background:var(--accent-soft);font-weight:650}

/* ---- 右侧正文 ---- */
.doc-main{min-width:0;padding:36px 0 96px}
.doc-h1{font-family:var(--serif);font-size:38px;font-weight:700;letter-spacing:-.6px;line-height:1.16;margin:6px 0 12px}
.doc-lead{font-size:16.5px;line-height:1.8;color:var(--ink-2);max-width:72ch}

.dsec{scroll-margin-top:96px;padding-top:40px;margin-top:40px;border-top:1px solid var(--line)}
.dsec:first-of-type{border-top:0;padding-top:6px;margin-top:10px}
.dsec > h2{font-family:var(--serif);font-size:25px;font-weight:700;letter-spacing:-.3px;line-height:1.28;margin:0 0 8px;display:flex;align-items:center;gap:11px;flex-wrap:wrap}
.dsec > h2 .num{font-size:13px;font-family:var(--mono);color:var(--accent);background:var(--accent-soft);
  border:1px solid color-mix(in srgb,var(--accent) 18%,transparent);border-radius:7px;padding:2px 8px;font-weight:600}
.dsec h3{font-size:17px;font-weight:700;margin:28px 0 8px}
.doc-p{font-size:15px;line-height:1.82;color:var(--ink-2);max-width:76ch;margin:10px 0}
.doc-p b,.doc-li b{color:var(--ink);font-weight:650}
.doc-ul{list-style:none;margin:12px 0;display:flex;flex-direction:column;gap:9px}
.doc-li{position:relative;padding-left:22px;font-size:15px;line-height:1.75;color:var(--ink-2)}
.doc-li::before{content:"";position:absolute;left:4px;top:11px;width:5px;height:5px;border-radius:50%;background:var(--accent)}

/* ---- 行内代码 ---- */
code,.k,.f{font-family:var(--mono);font-size:.86em;background:var(--surface-3);color:var(--ink);padding:2px 6px;border-radius:6px;border:1px solid var(--line);word-break:break-word}

/* ---- 徽章 ---- */
.pill{display:inline-flex;align-items:center;gap:5px;font-family:var(--mono);font-size:11.5px;font-weight:700;
  letter-spacing:.3px;padding:3px 9px;border-radius:7px;vertical-align:middle;white-space:nowrap}
.pill.get{color:var(--accent-ink);background:var(--accent-soft);border:1px solid color-mix(in srgb,var(--accent) 22%,transparent)}
.pill.req{color:var(--bad);background:var(--bad-soft);border:1px solid color-mix(in srgb,var(--bad) 30%,transparent)}
.pill.opt{color:var(--faint);background:var(--surface-3);border:1px solid var(--line)}
.ep{display:flex;align-items:center;gap:10px;flex-wrap:wrap;margin:16px 0 6px;padding:13px 16px;
  background:var(--surface);border:1px solid var(--line);border-radius:var(--r)}
.ep .path{font-family:var(--mono);font-size:13.5px;font-weight:600;color:var(--ink);word-break:break-all}
.ep .btn{margin-left:auto}

/* ---- 参数表 ---- */
.tw{overflow-x:auto;margin:16px 0;border:1px solid var(--line);border-radius:var(--r);background:var(--surface)}
.doc-table{width:100%;border-collapse:collapse;font-size:13.8px;min-width:520px}
.doc-table th{text-align:left;font-weight:650;color:var(--ink);background:var(--surface-2);padding:11px 15px;border-bottom:1px solid var(--line);white-space:nowrap}
.doc-table td{padding:11px 15px;border-bottom:1px solid var(--line);color:var(--ink-2);vertical-align:top;line-height:1.68}
.doc-table tr:last-child td{border-bottom:0}
.doc-table td:first-child{width:24%;min-width:130px}
.doc-table .f{font-family:var(--mono);font-size:12.6px;color:var(--ink);white-space:nowrap}

/* ---- 代码块 ---- */
.code{margin:16px 0;border:1px solid var(--line);border-radius:var(--r-lg);overflow:hidden;background:var(--surface)}
.code .ch{display:flex;align-items:center;gap:12px;padding:10px 14px;background:var(--surface-2);border-bottom:1px solid var(--line)}
.code .ch b{font-size:12.5px;font-weight:650;color:var(--ink-2);letter-spacing:.2px}
.code .ch .cp{margin-left:auto}
.code pre{margin:0;padding:18px 20px;overflow-x:auto;background:var(--ink);color:#e9ecff;
  font-family:var(--mono);font-size:12.8px;line-height:1.78;white-space:pre}
html[data-theme="dark"] .code pre{background:#0a0c16;color:#dfe3fb}
.code pre code{background:none;border:0;padding:0;color:inherit;font-size:inherit}

/* ---- callout ---- */
.note{display:flex;gap:12px;margin:18px 0;padding:15px 18px;border-radius:var(--r);font-size:14px;line-height:1.72;
  background:var(--accent-soft);color:var(--accent-ink);border:1px solid color-mix(in srgb,var(--accent) 16%,transparent)}
.note svg{flex-shrink:0;margin-top:3px}
.note b{font-weight:700}
.note.warn{background:var(--warn-soft);color:var(--warn);border-color:color-mix(in srgb,var(--warn) 24%,transparent)}
.note.plain{background:var(--surface-2);color:var(--ink-2);border-color:var(--line)}

/* ---- 小节卡片（快速上手三步） ---- */
.doc-cards{display:grid;grid-template-columns:repeat(3,1fr);gap:14px;margin:18px 0}
.doc-card{padding:18px 18px;border:1px solid var(--line);border-radius:var(--r);background:var(--surface)}
.doc-card .t{font-size:12px;color:var(--faint);font-weight:650;letter-spacing:.3px}
.doc-card .v{font-family:var(--mono);font-size:13px;margin-top:8px;word-break:break-all;color:var(--ink)}

/* ---- 响应式 ---- */
@media(max-width:1000px){
  .doc{grid-template-columns:1fr;gap:0}
  .doc-toc{position:static;max-height:none;padding:26px 0 0}
  .doc-toc nav{flex-direction:row;flex-wrap:wrap;gap:6px}
  .doc-toc .grp{display:none}
  .doc-toc a{border:1px solid var(--line);border-left:1px solid var(--line);border-radius:20px;padding:6px 13px;font-size:12.8px}
  .doc-toc a.active{border-color:var(--accent)}
  .doc-main{padding-top:24px}
  .doc-cards{grid-template-columns:1fr}
}
@media(max-width:600px){
  .doc{padding:0 18px}
  .doc-h1{font-size:29px}
  .dsec > h2{font-size:21px}
  .doc-table td:first-child{width:auto;min-width:104px}
}