ai-agent-book 精选快照（<2MB 代码与文档，来自 github.com/bojieli/ai-agent-book）

book-zhtw/preamble.tex

@@ -0,0 +1,179 @@
+% ===== ElegantBook customizations for 《深入理解 AI Agent》 =====
+% Accent color comes from ElegantBook's cyan theme: \structurecolor = RGB(31,186,190)
+
+% ── Unicode glyph fallback (Times/Courier lack these) ─────────────
+\usepackage{newunicodechar}
+\IfFontExistsTF{Arial Unicode MS}{\newfontfamily\fallbackfont{Arial Unicode MS}}{\IfFontExistsTF{Noto Sans CJK SC}{\newfontfamily\fallbackfont{Noto Sans CJK SC}}{\newfontfamily\fallbackfont{DejaVu Sans}}}
+\IfFontExistsTF{Heiti SC}{\newunicodechar{★}{{\fontspec{Heiti SC}★}}}{\IfFontExistsTF{Noto Sans CJK SC}{\newunicodechar{★}{{\fontspec{Noto Sans CJK SC}★}}}{\newunicodechar{★}{{\fontspec{DejaVu Sans}★}}}}
+\newunicodechar{✓}{{\fallbackfont ✓}}
+\newunicodechar{✗}{{\fallbackfont ✗}}
+\newunicodechar{₀}{{\fallbackfont ₀}}
+\newunicodechar{₁}{{\fallbackfont ₁}}
+\newunicodechar{₂}{{\fallbackfont ₂}}
+\newunicodechar{₃}{{\fallbackfont ₃}}
+\newunicodechar{₄}{{\fallbackfont ₄}}
+\newunicodechar{₅}{{\fallbackfont ₅}}
+\newunicodechar{₆}{{\fallbackfont ₆}}
+\newunicodechar{₇}{{\fallbackfont ₇}}
+\newunicodechar{₈}{{\fallbackfont ₈}}
+\newunicodechar{₉}{{\fallbackfont ₉}}
+\newunicodechar{ⓐ}{{\fallbackfont ⓐ}}
+\newunicodechar{ⓑ}{{\fallbackfont ⓑ}}
+\newunicodechar{ⓒ}{{\fallbackfont ⓒ}}
+\newunicodechar{ⓓ}{{\fallbackfont ⓓ}}
+\newunicodechar{ⓔ}{{\fallbackfont ⓔ}}
+% Math / symbols absent from the Latin text font
+\newunicodechar{≈}{{\fallbackfont ≈}}
+\newunicodechar{♠}{{\fallbackfont ♠}}
+\newunicodechar{♣}{{\fallbackfont ♣}}
+\newunicodechar{♥}{{\fallbackfont ♥}}
+\newunicodechar{♦}{{\fallbackfont ♦}}
+% Greek letters used inline in body text (Latin Modern lacks them here)
+\newunicodechar{α}{{\fallbackfont α}}
+\newunicodechar{β}{{\fallbackfont β}}
+\newunicodechar{γ}{{\fallbackfont γ}}
+\newunicodechar{δ}{{\fallbackfont δ}}
+\newunicodechar{ε}{{\fallbackfont ε}}
+\newunicodechar{η}{{\fallbackfont η}}
+\newunicodechar{θ}{{\fallbackfont θ}}
+\newunicodechar{λ}{{\fallbackfont λ}}
+\newunicodechar{μ}{{\fallbackfont μ}}
+\newunicodechar{π}{{\fallbackfont π}}
+\newunicodechar{ρ}{{\fallbackfont ρ}}
+\newunicodechar{σ}{{\fallbackfont σ}}
+\newunicodechar{τ}{{\fallbackfont τ}}
+\newunicodechar{φ}{{\fallbackfont φ}}
+\newunicodechar{ω}{{\fallbackfont ω}}
+
+% ── Code/monospace font (covers box-drawing glyphs used in code) ──
+\setmonofont[Scale=0.86]{Menlo}
+
+% ── tcolorbox (ElegantBook already loads it; just add libraries) ──
+\tcbuselibrary{skins,breakable}
+
+% ── TikZ (for the full-bleed image cover in cover.tex) ───────────
+\usepackage{tikz}
+\usetikzlibrary{fadings}
+% Vertical fade: invisible at the top, solid at the bottom — lets the cover
+% art melt smoothly into the navy title band.
+\tikzfading[name=titlefade, top color=transparent!100, bottom color=transparent!0]
+
+% Theme accent color: override ElegantBook's bright cyan with a deep navy
+% (classic, authoritative technical-book tone). Drives headings, rules, links,
+% code chrome and the cover. Tweak this one line to restyle the whole book.
+\definecolor{structurecolor}{RGB}{30,58,107}
+
+% Accent shade for code/figure chrome (follows the theme color above)
+\colorlet{accent}{structurecolor}
+
+% Internal cross-reference links (圖N-M / 第N章) — clickable + subtle teal,
+% independent of the document class's global linkcolor. Used by crossref.lua.
+\newcommand{\crossreflink}[2]{\hyperref[#1]{\textcolor{structurecolor}{#2}}}
+\colorlet{accentbg}{structurecolor!6}
+\colorlet{accentrule}{structurecolor!35}
+
+% ── Wrap long lines in code blocks ───────────────────────────────
+% pandoc emits fancyvrb's Verbatim (via `Highlighting` for ```lang blocks
+% and plain `verbatim` for un-tagged blocks); neither wraps by default, so
+% long lines overflow the page. fvextra adds breaklines; re-define both
+% environments to wrap, breaking mid-token when a chunk has no spaces (URLs,
+% long identifiers, CJK comments). A teal ↳ marks each continued line.
+\usepackage{fvextra}
+\fvset{breaklines=true,breakanywhere=true,%
+  breaksymbolleft={\footnotesize\textcolor{accentrule}{$\hookrightarrow$}\,}}
+\DefineVerbatimEnvironment{Highlighting}{Verbatim}{commandchars=\\\{\},breaklines,breakanywhere}
+
+% ── Code blocks: subtle O'Reilly-style framed box ────────────────
+% One shared box style for ALL code blocks so highlighted (```lang → Shaded)
+% and plain (``` → verbatim) blocks look identical. The plain verbatim nests
+% a fvextra Verbatim inside the box; \VerbatimEnvironment makes it end at
+% \end{verbatim} (the outer env name) rather than \end{Verbatim}.
+\newtcolorbox{codebox}{%
+  breakable, enhanced,
+  colback=black!3, colframe=accentrule,
+  boxrule=0.5pt, leftrule=2.5pt,
+  left=0.7em, right=0.6em, top=0.4em, bottom=0.4em,
+  arc=0.6mm,
+  before skip=0.7em, after skip=0.7em
+}
+\renewenvironment{Shaded}{\begin{codebox}}{\end{codebox}}
+\renewenvironment{verbatim}%
+  {\VerbatimEnvironment\begin{codebox}\begin{Verbatim}}%
+  {\end{Verbatim}\end{codebox}}
+
+% ── Experiment & question callouts (used by experiment_box.lua) ───
+\newtcolorbox{experimentbox}{
+  breakable, enhanced,
+  colback=accentbg, colframe=accent,
+  boxrule=0.6pt, left=0.8em, right=0.8em, top=0.6em, bottom=0.6em,
+  arc=1mm, before skip=0.9em, after skip=0.9em
+}
+
+\newtcolorbox{questionbox}{
+  breakable, enhanced,
+  colback=accentbg, colframe=accent,
+  boxrule=0.8pt, left=0.9em, right=0.9em, top=0.9em, bottom=0.7em,
+  arc=1.2mm, before skip=0.9em, after skip=0.9em,
+  title={\sffamily\bfseries 深度思考},
+  fonttitle=\normalsize\color{white},
+  coltitle=white,
+  attach boxed title to top left={xshift=1em, yshift=-\tcboxedtitleheight/2},
+  boxed title style={colback=accent, colframe=accent, arc=0.8mm, outer arc=0.8mm}
+}
+
+% ── Figures: force [H] so they can sit inside callout/quote boxes ─
+\usepackage{float}
+\let\origfigure\figure
+\let\origendfigure\endfigure
+\renewenvironment{figure}[1][htbp]{\origfigure[H]}{\origendfigure}
+\setkeys{Gin}{width=\linewidth,height=0.38\textheight,keepaspectratio}
+
+% ── Figure captions: manual numbering in text, so suppress label ──
+\usepackage{caption}
+% Captions apply \sffamily, which switches Chinese to a CJK sans (Heiti SC).
+% The earlier fix used Scale=MatchLowercase, which scales CJK down to the Latin
+% x-height — wrong for Chinese, whose glyphs should sit at the nominal point
+% size (as they do in the body, which is why the body looks fine and only
+% captions were off). Render Heiti SC at nominal size (no MatchLowercase) with a
+% faux bold, so 中文 matches the Latin in captions. Injected into captions only;
+% headings and body are untouched.
+\IfFontExistsTF{Heiti SC}{\setCJKfamilyfont{capcjksf}[AutoFakeBold=2.5]{Heiti SC}}{\IfFontExistsTF{Noto Sans CJK SC}{\setCJKfamilyfont{capcjksf}[AutoFakeBold=2.5]{Noto Sans CJK SC}}{\setCJKfamilyfont{capcjksf}[AutoFakeBold=2.5]{DejaVu Sans}}}
+\DeclareCaptionFont{cjkmatch}{\CJKfamily{capcjksf}}
+\captionsetup{font={normalsize,sf,bf,cjkmatch}, labelformat=empty, skip=4pt, justification=centering}
+
+% ── Blockquotes: teal left bar (experiments render as quotes) ────
+\renewenvironment{quote}{%
+  \begin{tcolorbox}[
+    blanker, breakable,
+    borderline west={2.5pt}{0pt}{accent},
+    colback=accent!4,
+    left=1em, right=0.6em, top=0.5em, bottom=0.5em,
+    before skip=0.6em, after skip=0.6em
+  ]%
+}{%
+  \end{tcolorbox}%
+}
+
+% ── Inline code: keep it tight ───────────────────────────────────
+\setlength{\parindent}{2em}
+
+% 正文中文字体：本地 macOS 用 Songti TC / Heiti TC；CI（无 Apple 字体）用 Noto Sans CJK TC。
+% fontset=none 由 build_pdf.sh 传入，避免 ctex 自动选择已被移除的 ST 系列旧字体。
+\IfFontExistsTF{Songti TC}{%
+  \setCJKmainfont[AutoFakeBold=2.5]{Songti TC}%
+  \setCJKsansfont[AutoFakeBold=2.5]{Heiti TC}%
+  \setCJKmonofont[AutoFakeBold=2.5]{Songti TC}%
+}{%
+  \setCJKmainfont[AutoFakeBold=2.5]{Noto Sans CJK TC}%
+  \setCJKsansfont[AutoFakeBold=2.5]{Noto Sans CJK TC}%
+  \setCJKmonofont[AutoFakeBold=2.5]{Noto Sans CJK TC}%
+}
+
+% ElegantBook empties the `plain` page style used on chapter-opening pages.
+% Keep those pages numbered, matching the centered footer on regular pages.
+\fancypagestyle{plain}{%
+  \fancyhf{}%
+  \fancyfoot[C]{\color{structurecolor}\small\thepage}%
+  \renewcommand{\headrulewidth}{0pt}%
+  \renewcommand{\footrulewidth}{0pt}%
+}