@charset "UTF-8";
/* ==========================================================================
   docs.css — 帮助文档页专属样式
   只被 product/docs.html 引用（加载于 style.css 之后），全部类名 `docs-` 前缀。
   设计契约与 features.css / home.css 一致：直角（radius 0）、2px 实线边框、
   平面色块、硬偏移投影、零模糊滤镜、零图片、零 CDN。变量只取自 style.css :root。
   ========================================================================== */

/* --------------------------------------------------------------------------
   1. 骨架：单列正文，最大 860px 居中
   -------------------------------------------------------------------------- */
.docs-layout {
  max-width: 860px;
  margin: 0 auto;
  padding: clamp(40px, 6vw, 72px) 0 clamp(64px, 8vw, 104px);
}

/* 标题区 */
.docs-head {
  margin-bottom: clamp(26px, 3.6vw, 38px);
}

.docs-head h1 {
  font-size: clamp(26px, 4vw, 38px);
  line-height: 1.16;
  letter-spacing: -.035em;
}

.docs-lede {
  margin-top: 14px;
  max-width: 62ch;
  color: var(--ink-soft);
  font-size: 15.5px;
  line-height: 1.75;
}

/* --------------------------------------------------------------------------
   2. 目录：像素面板 + 跳转列表（不是文档副本，只做定位）
   -------------------------------------------------------------------------- */
.docs-toc {
  position: relative;
  margin: 0 0 clamp(34px, 5vw, 52px);
  padding: 20px 22px;
  border: 2px solid var(--line-strong);
  border-left-color: var(--green);
  border-radius: 0;
  background: var(--surface-solid);
  box-shadow: 4px 4px 0 rgba(0, 0, 0, .45);
}

.docs-toc-heading {
  display: inline-block;
  margin-bottom: 14px;
  color: var(--muted);
  font-family: 'DM Mono', ui-monospace, SFMono-Regular, Consolas, monospace;
  font-size: 10.5px;
  font-weight: 500;
  line-height: 1;
  letter-spacing: .18em;
  text-transform: uppercase;
}

.docs-toc-list {
  display: grid;
  gap: 2px;
  counter-reset: docs-toc;
}

.docs-toc-list > li {
  counter-increment: docs-toc;
}

.docs-toc-list a {
  display: flex;
  gap: 10px;
  align-items: baseline;
  padding: 7px 8px;
  border-radius: 0;
  color: var(--ink-soft);
  font-size: 14px;
  line-height: 1.5;
  transition: color var(--anim-fast) var(--ease-out),
              background var(--anim-fast) var(--ease-out),
              border-color var(--anim-fast) var(--ease-out);
  border-left: 2px solid transparent;
}

.docs-toc-list a::before {
  flex: 0 0 auto;
  content: counter(docs-toc, decimal-leading-zero);
  color: var(--subtle);
  font-family: 'DM Mono', ui-monospace, SFMono-Regular, Consolas, monospace;
  font-size: 10.5px;
  letter-spacing: .08em;
}

.docs-toc-list a:hover,
.docs-toc-list a:focus-visible {
  border-left-color: var(--green);
  background: var(--surface-hover);
  color: var(--ink);
}

.docs-toc-list a:hover::before,
.docs-toc-list a:focus-visible::before {
  color: var(--green);
}

/* 二级目录：不重新计数，用短横线做从属标记 */
.docs-toc-sub {
  display: grid;
  gap: 0;
  margin: 2px 0 4px;
  padding-left: 16px;
  border-left: 2px solid var(--line);
}

.docs-toc-sub a {
  padding: 5px 8px;
  font-size: 13px;
  color: var(--muted);
}

.docs-toc-sub a::before {
  content: '·';
  color: var(--line-strong);
  font-size: 12px;
}

/* --------------------------------------------------------------------------
   3. 章节与标题：锚点必须让开 sticky 顶栏
   顶栏占位 66px（--header-h 64px + 底边 2px），沿用 style.css 的 74px 约定
   再加一点余量，保证跳到锚点时标题不压在顶栏下面。
   -------------------------------------------------------------------------- */
.docs-section {
  padding-top: 2px;
}

.docs-section + .docs-section {
  margin-top: clamp(34px, 4.4vw, 52px);
  padding-top: clamp(24px, 3vw, 34px);
  border-top: 2px solid var(--line);
}

.docs-section,
.docs-sub,
.docs-section h2,
.docs-section h3,
.docs-section h4 {
  scroll-margin-top: 84px;
}

.docs-section h2 {
  margin-bottom: 18px;
  font-size: clamp(20px, 2.6vw, 26px);
  line-height: 1.25;
}

.docs-section h3 {
  margin-bottom: 14px;
  font-size: clamp(17px, 2.1vw, 20px);
  line-height: 1.3;
}

.docs-section h4 {
  margin-bottom: 12px;
  font-size: 16px;
  line-height: 1.35;
}

/* 方式 A / 方式 B 之间：左侧 2px 竖线做层级提示，不缩进正文变窄 */
.docs-sub + .docs-sub {
  margin-top: clamp(28px, 3.6vw, 40px);
  padding-top: clamp(22px, 2.8vw, 30px);
  border-top: 2px dashed var(--line);
}

/* Commit 子块：再降一级，靠左边框而不是字号 */
.docs-sub .docs-sub {
  margin-top: 22px;
  padding-left: 16px;
  border-left: 2px solid var(--line);
}

/* --------------------------------------------------------------------------
   4. 正文
   -------------------------------------------------------------------------- */
.docs-section p {
  margin: 0 0 14px;
  color: var(--ink-soft);
  font-size: 15px;
  line-height: 1.8;
}

.docs-section p:last-child {
  margin-bottom: 0;
}

.docs-section strong {
  color: var(--ink);
  font-weight: 600;
}

.docs-section code {
  padding: 1px 5px;
  border: 1px solid var(--line);
  border-radius: 0;
  background: var(--surface-soft);
  color: var(--ink);
  font-family: 'DM Mono', ui-monospace, SFMono-Regular, Consolas, monospace;
  font-size: 12.8px;
  line-height: 1.6;
  word-break: break-word;
}

/* 小标签行（**操作顺序：** 这类）保留段落节奏但与下文贴紧 */
.docs-label {
  margin: 20px 0 10px;
  color: var(--ink) !important;
  font-size: 14px !important;
}

/* --------------------------------------------------------------------------
   5. 列表：ol 用计数器画编号方块，ul 用实心方块项目符
   style.css 已统一 `ul, ol { list-style: none }`，标记全部自己画。
   -------------------------------------------------------------------------- */
.docs-steps {
  counter-reset: docs-step;
  display: grid;
  gap: 12px;
  margin: 0 0 16px;
}

.docs-steps > li {
  counter-increment: docs-step;
  position: relative;
  padding-left: 34px;
  color: var(--ink-soft);
  font-size: 15px;
  line-height: 1.8;
}

.docs-steps > li::before {
  content: counter(docs-step);
  position: absolute;
  left: 0;
  top: 2px;
  display: block;
  width: 22px;
  padding: 2px 0;
  border: 2px solid var(--line-strong);
  border-radius: 0;
  background: var(--surface-soft);
  color: var(--muted);
  font-family: 'DM Mono', ui-monospace, SFMono-Regular, Consolas, monospace;
  font-size: 10.5px;
  line-height: 1.35;
  text-align: center;
}

.docs-list,
.docs-sublist {
  display: grid;
  gap: 9px;
  margin: 0 0 16px;
}

.docs-list > li,
.docs-sublist > li {
  position: relative;
  padding-left: 20px;
  color: var(--ink-soft);
  font-size: 15px;
  line-height: 1.8;
}

.docs-list > li::before,
.docs-sublist > li::before {
  content: '';
  position: absolute;
  left: 2px;
  top: 11px;
  width: 6px;
  height: 6px;
  border-radius: 0;
  background: var(--line-strong);
}

.docs-list > li:hover::before {
  background: var(--green);
}

/* 嵌在 ol 里的子列表：与上一条文字同列，不再额外缩进一级 */
.docs-steps .docs-sublist {
  margin: 8px 0 4px;
  padding-left: 2px;
  gap: 6px;
}

.docs-steps .docs-sublist > li {
  font-size: 14.5px;
}

.docs-steps .docs-sublist > li::before {
  top: 10px;
  width: 5px;
  height: 5px;
}

/* --------------------------------------------------------------------------
   6. 代码块
   -------------------------------------------------------------------------- */
.docs-section .code-body {
  margin: 0 0 16px;
  padding: 16px 18px;
  overflow-x: auto;
  border: 2px solid var(--line-strong);
  border-radius: 0;
  background: var(--surface-solid);
  box-shadow: 4px 4px 0 rgba(0, 0, 0, .45);
  color: var(--ink-soft);
  font-family: 'DM Mono', ui-monospace, SFMono-Regular, Consolas, monospace;
  font-size: 12.4px;
  line-height: 1.85;
  tab-size: 2;
}

.docs-section .code-body code {
  display: block;
  padding: 0;
  border: 0;
  border-radius: 0;
  background: none;
  color: inherit;
  font: inherit;
  white-space: pre;
  word-break: normal;
}

/* --------------------------------------------------------------------------
   7. 提示块：左侧绿边 + 淡绿底（危险/必须强调的那几句）
   -------------------------------------------------------------------------- */
.docs-callout {
  margin: 0 0 18px;
  padding: 14px 16px;
  border: 2px solid var(--line-strong);
  border-left: 4px solid var(--green);
  border-radius: 0;
  background: var(--green-soft);
}

.docs-callout p {
  margin: 0;
  color: var(--ink);
  font-size: 14.5px;
  line-height: 1.75;
}

.docs-callout strong {
  color: var(--green);
}

.docs-callout code {
  background: var(--surface-solid);
  border-color: var(--line-strong);
}

/* --------------------------------------------------------------------------
   8. 表格：真表 + DM Mono 表头 + 斑马行
   -------------------------------------------------------------------------- */
.docs-table {
  width: 100%;
  margin: 0 0 18px;
  border: 2px solid var(--line-strong);
  border-collapse: collapse;
  border-radius: 0;
  background: var(--surface-solid);
  font-size: 14px;
  line-height: 1.7;
}

.docs-table thead th {
  padding: 10px 14px;
  border-bottom: 2px solid var(--line-strong);
  background: var(--surface-soft);
  color: var(--muted);
  font-family: 'DM Mono', ui-monospace, SFMono-Regular, Consolas, monospace;
  font-size: 10.5px;
  font-weight: 500;
  line-height: 1.5;
  letter-spacing: .16em;
  text-align: left;
  text-transform: uppercase;
}

.docs-table tbody td {
  padding: 10px 14px;
  border-top: 1px solid var(--line);
  color: var(--ink-soft);
  vertical-align: top;
}

.docs-table tbody tr:first-child td {
  border-top: 0;
}

/* 斑马行用 --surface-soft：暗底上比奇偶纯色更可控，不会压低正文对比度 */
.docs-table tbody tr:nth-child(even) td {
  background: var(--surface-soft);
}

.docs-table tbody tr:hover td {
  background: var(--surface-hover);
  color: var(--ink);
}

.docs-table td code {
  font-size: 12.4px;
}

/* 第二列（要求 / 原因）收窄一档，第三列给「处理」留出宽度 */
.docs-table th:nth-child(2),
.docs-table td:nth-child(2) {
  min-width: 22%;
}

/* --------------------------------------------------------------------------
   9. 界面路径：等宽小胶囊，读作「点这里」
   -------------------------------------------------------------------------- */
.docs-path {
  display: inline-block;
  padding: 1px 6px;
  border: 1px solid var(--line-strong);
  border-radius: 0;
  background: var(--surface-soft);
  color: var(--blue);
  font-family: 'DM Mono', ui-monospace, SFMono-Regular, Consolas, monospace;
  font-size: 12.2px;
  line-height: 1.6;
  white-space: normal;
}

/* --------------------------------------------------------------------------
   10. 响应式：900px 以下收成单列，目录退回普通列表
   -------------------------------------------------------------------------- */
@media (max-width: 900px) {
  .docs-layout {
    max-width: none;
    padding-top: clamp(28px, 5vw, 44px);
  }

  .docs-toc {
    padding: 16px 16px;
    box-shadow: none;
  }

  /* 目录不再用编号/方块的仪表盘感，退成一条条可点的纯文本行 */
  .docs-toc-list {
    gap: 0;
  }

  .docs-toc-list a {
    padding: 8px 4px;
    border-left: 0;
    border-bottom: 1px solid var(--line);
  }

  .docs-toc-sub {
    padding-left: 10px;
    border-left: 0;
  }

  .docs-toc-sub a {
    border-bottom: 0;
    padding: 4px 4px 4px 12px;
  }

  .docs-toc-list a::before,
  .docs-toc-sub a::before {
    display: none;
  }

  .docs-table {
    font-size: 13.5px;
  }

  .docs-table thead th,
  .docs-table tbody td {
    padding: 9px 10px;
  }

  .docs-section .code-body {
    padding: 13px 12px;
    font-size: 11.8px;
    box-shadow: none;
  }
}

@media (max-width: 560px) {
  .docs-table {
    display: block;
    overflow-x: auto;
    white-space: nowrap;
  }

  .docs-table thead th {
    letter-spacing: .1em;
  }
}

/* --------------------------------------------------------------------------
   11. 降低动态效果：过渡全部关掉，状态落到终态
   -------------------------------------------------------------------------- */
@media (prefers-reduced-motion: reduce) {
  .docs-toc-list a,
  .docs-list > li::before,
  .docs-table tbody tr:hover td {
    transition: none !important;
  }
}

/* --------------------------------------------------------------------------
   12. 打印：去掉目录与投影，保留 2px 边框让结构仍可读
   -------------------------------------------------------------------------- */
@media print {
  .docs-toc {
    display: none !important;
  }

  .docs-layout {
    max-width: none;
    padding: 0;
  }

  .docs-section h2,
  .docs-section h3,
  .docs-section h4 {
    scroll-margin-top: 0;
  }

  .docs-toc,
  .docs-section .code-body {
    box-shadow: none !important;
  }

  .docs-section p,
  .docs-steps > li,
  .docs-list > li,
  .docs-sublist > li,
  .docs-table tbody td,
  .docs-table tbody tr:nth-child(even) td,
  .docs-table tbody tr:hover td,
  .docs-callout,
  .docs-callout p,
  .docs-table,
  .docs-table thead th,
  .docs-path,
  .docs-section code {
    background: transparent !important;
    color: #111 !important;
    transition: none !important;
  }

  .docs-table,
  .docs-table thead th,
  .docs-table tbody td,
  .docs-callout,
  .docs-section .code-body,
  .docs-path,
  .docs-section code,
  .docs-steps > li::before {
    border-color: #333 !important;
  }

  .docs-callout {
    border-left-color: #333 !important;
  }

  .docs-section + .docs-section {
    border-top-color: #333 !important;
  }
}