/* WhispBuild 用户文档站样式
 *
 * 版面要做到一件事：让「三层写作」肉眼可分辨（方案 §1.2）。
 *   主线   = 正常正文，初学者只读这一层必须能走完全程
 *   旁注   = .dev-note，给会写代码但不碰硬件的人的类比锚点，跳过不影响结果
 *   事实块 = .facts，给资深工程师查证用，位置固定在页首「一览」与页尾「参考」
 *
 * 另外两个不能混的东西：
 *   .warn  普通提醒（会浪费时间）
 *   .danger 不可逆的物理动作（会烧掉东西 / 收不回来）
 * base44 把两者都用同一个 <Warning>，结果是读者学会了略过。我们分开。
 */

:root {
  --bg: #ffffff;
  --bg-soft: #f7f7f9;
  --bg-code: #f3f3f6;
  --fg: #1c1c22;
  --fg-mute: #5d5d68;
  --line: #e4e4ea;
  --accent: #5b3df5;
  --accent-soft: #efeaff;
  --warn-bg: #fff8e6;
  --warn-line: #e8b53a;
  --danger-bg: #fdeceb;
  --danger-line: #d9433c;
  --ok: #1f8a4c;
  --radius: 10px;
  --mono: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace;
  --sans: -apple-system, BlinkMacSystemFont, "Segoe UI", "Noto Sans SC",
          "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", sans-serif;
}

@media (prefers-color-scheme: dark) {
  :root {
    --bg: #16161a;
    --bg-soft: #1e1e24;
    --bg-code: #232329;
    --fg: #e9e9ee;
    --fg-mute: #a0a0ad;
    --line: #2e2e37;
    --accent: #9d86ff;
    --accent-soft: #262040;
    --warn-bg: #2e2716;
    --warn-line: #9a7a25;
    --danger-bg: #33191a;
    --danger-line: #b8433c;
    --ok: #4cc47f;
  }
}

* { box-sizing: border-box; }

body {
  margin: 0;
  font-family: var(--sans);
  font-size: 16px;
  line-height: 1.75;
  color: var(--fg);
  background: var(--bg);
  -webkit-font-smoothing: antialiased;
}

/* ---------- 布局 ---------- */

.wrap { display: flex; align-items: flex-start; max-width: 1240px; margin: 0 auto; }

.sidebar {
  position: sticky; top: 0; flex: 0 0 244px; height: 100vh; overflow-y: auto;
  padding: 28px 20px 48px; border-right: 1px solid var(--line);
}
.sidebar__brand {
  display: block; font-weight: 700; font-size: 17px; color: var(--fg);
  text-decoration: none; margin-bottom: 4px;
}
.sidebar__tag { font-size: 13px; color: var(--fg-mute); margin-bottom: 12px; }
.sidebar__lang { margin-bottom: 20px; }
.sidebar__lang a {
  display: inline-block; padding: 3px 11px; border: 1px solid var(--line);
  border-radius: 999px; font-size: 12.5px; color: var(--fg-mute); text-decoration: none;
}
.sidebar__lang a:hover { border-color: var(--accent); color: var(--accent); }
.sidebar__group { font-size: 12px; letter-spacing: .06em; text-transform: uppercase;
  color: var(--fg-mute); margin: 22px 0 8px; }
.sidebar a.nav {
  display: block; padding: 6px 10px; margin: 0 -10px; border-radius: 7px;
  color: var(--fg); text-decoration: none; font-size: 14.5px; line-height: 1.5;
}
.sidebar a.nav:hover { background: var(--bg-soft); }
.sidebar a.nav.is-active { background: var(--accent-soft); color: var(--accent); font-weight: 600; }

main { flex: 1 1 auto; min-width: 0; padding: 40px 44px 120px; max-width: 860px; }

/* ---------- 文字 ---------- */

h1 { font-size: 33px; line-height: 1.3; margin: 0 0 10px; letter-spacing: -.01em; }
h2 { font-size: 23px; line-height: 1.4; margin: 46px 0 14px; padding-top: 14px;
     border-top: 1px solid var(--line); letter-spacing: -.005em; }
h3 { font-size: 18px; margin: 30px 0 10px; }
h2:first-of-type { border-top: 0; padding-top: 0; }

.lede { font-size: 18px; color: var(--fg-mute); margin: 0 0 28px; line-height: 1.65; }

p, li { overflow-wrap: break-word; }
a { color: var(--accent); }

code {
  font-family: var(--mono); font-size: .89em; background: var(--bg-code);
  padding: .12em .38em; border-radius: 4px;
}
pre {
  background: var(--bg-code); border: 1px solid var(--line); border-radius: var(--radius);
  padding: 14px 16px; overflow-x: auto; font-size: 14px; line-height: 1.6;
}
pre code { background: none; padding: 0; font-size: inherit; }

/* 可整段复制的例句 —— 提示词库用 */
.prompt {
  background: var(--bg-code); border: 1px solid var(--line); border-left: 3px solid var(--accent);
  border-radius: var(--radius); padding: 13px 16px; margin: 12px 0;
  font-family: var(--mono); font-size: 14px; line-height: 1.65; white-space: pre-wrap;
}
.why { font-size: 14.5px; color: var(--fg-mute); margin: -4px 0 18px; padding-left: 3px; }
.why b { color: var(--fg); font-weight: 600; }

/* ---------- 步骤 ---------- */

.step-h {
  font-size: 21px; margin: 42px 0 12px; padding-top: 16px;
  border-top: 1px solid var(--line);
}
.step-h .n { color: var(--accent); font-variant-numeric: tabular-nums; }

ol.steps { padding-left: 0; list-style: none; counter-reset: s; margin: 16px 0; }
ol.steps > li {
  counter-increment: s; position: relative; padding-left: 38px; margin-bottom: 12px;
}
ol.steps > li::before {
  content: counter(s); position: absolute; left: 0; top: 2px;
  width: 24px; height: 24px; border-radius: 50%;
  background: var(--accent); color: #fff; font-size: 13px; font-weight: 700;
  display: flex; align-items: center; justify-content: center;
}

/* 看到什么算成功 */
.check {
  border-left: 3px solid var(--ok); background: var(--bg-soft);
  padding: 12px 16px; border-radius: 0 var(--radius) var(--radius) 0; margin: 16px 0;
}
.check b { color: var(--ok); }

/* ---------- 提醒的两个等级 ---------- */

.warn, .danger {
  border-radius: var(--radius); padding: 13px 16px; margin: 18px 0; font-size: 15.5px;
}
.warn { background: var(--warn-bg); border-left: 3px solid var(--warn-line); }
.danger { background: var(--danger-bg); border-left: 3px solid var(--danger-line); }
.warn p:last-child, .danger p:last-child { margin-bottom: 0; }
.warn p:first-child, .danger p:first-child { margin-top: 0; }

/* ---------- 旁注：给会写代码但不碰硬件的人 ---------- */

details.dev-note {
  border: 1px dashed var(--line); border-radius: var(--radius);
  background: var(--bg-soft); margin: 20px 0; font-size: 15.5px;
}
details.dev-note > summary {
  cursor: pointer; padding: 11px 16px; font-weight: 600; color: var(--fg-mute);
  list-style: none; user-select: none;
}
details.dev-note > summary::before { content: "▸ "; }
details.dev-note[open] > summary::before { content: "▾ "; }
details.dev-note > div { padding: 0 16px 14px; }
details.dev-note p:last-child { margin-bottom: 0; }

/* ---------- 事实块：给资深工程师 ---------- */

table { border-collapse: collapse; width: 100%; margin: 18px 0; font-size: 15px; }
th, td { text-align: left; padding: 9px 12px; border-bottom: 1px solid var(--line); vertical-align: top; }
th { font-weight: 600; background: var(--bg-soft); }
table.facts { border: 1px solid var(--line); border-radius: var(--radius); overflow: hidden; }
table.facts th { width: 30%; white-space: nowrap; }
.facts-title {
  font-size: 12px; letter-spacing: .08em; text-transform: uppercase;
  color: var(--fg-mute); margin: 26px 0 -8px; font-weight: 700;
}

/* ---------- 图 ---------- */

figure { margin: 24px 0; }
figure img {
  display: block; max-width: 100%; height: auto;
  border: 1px solid var(--line); border-radius: var(--radius);
}
figcaption { font-size: 14px; color: var(--fg-mute); margin-top: 8px; line-height: 1.6; }


/* ---------- 分流卡片（首页用） ---------- */

.cards { display: grid; gap: 14px; grid-template-columns: repeat(auto-fit, minmax(232px, 1fr)); margin: 26px 0; }
.card {
  display: block; padding: 18px 18px 16px; border: 1px solid var(--line);
  border-radius: var(--radius); text-decoration: none; color: var(--fg); background: var(--bg);
}
.card:hover { border-color: var(--accent); background: var(--bg-soft); }
.card h3 { margin: 0 0 6px; font-size: 16.5px; }
.card p { margin: 0; font-size: 14.5px; color: var(--fg-mute); line-height: 1.6; }

/* ---------- 故障页：按症状 ---------- */

.symptom {
  border: 1px solid var(--line); border-radius: var(--radius);
  padding: 18px 20px; margin: 18px 0; background: var(--bg-soft);
}
.symptom h3 { margin-top: 0; font-size: 17.5px; }
.symptom .label {
  font-size: 12px; letter-spacing: .06em; text-transform: uppercase;
  color: var(--fg-mute); font-weight: 700; margin: 14px 0 2px;
}
.symptom p, .symptom ol, .symptom ul { margin-top: 4px; }
.probe { border-left: 3px solid var(--accent); padding-left: 13px; margin-top: 14px; }

/* ---------- 杂项 ---------- */

.pill {
  display: inline-block; font-size: 12.5px; padding: 1px 9px; border-radius: 20px;
  background: var(--bg-soft); border: 1px solid var(--line); color: var(--fg-mute);
}
.next {
  display: flex; gap: 12px; flex-wrap: wrap; margin-top: 48px;
  padding-top: 22px; border-top: 1px solid var(--line);
}
.next a {
  padding: 9px 15px; border: 1px solid var(--line); border-radius: 999px;
  text-decoration: none; font-size: 15px; color: var(--fg);
}
.next a:hover { border-color: var(--accent); color: var(--accent); }
.foot { margin-top: 56px; font-size: 14px; color: var(--fg-mute); }

@media (max-width: 900px) {
  .wrap { display: block; }
  .sidebar {
    position: static; height: auto; width: auto; flex: none;
    border-right: 0; border-bottom: 1px solid var(--line); padding: 18px 20px;
  }
  main { padding: 26px 20px 80px; max-width: none; }
  h1 { font-size: 27px; }
}