, which is
# exactly what mermaid.js expects. Any other fenced language still
# uses the default highlighted
.
custom_fences:
- name: mermaid
class: mermaid
format: !!python/name:pymdownx.superfences.fence_div_format
- pymdownx.inlinehilite
- pymdownx.tabbed:
alternate_style: true
- pymdownx.details
extra_javascript:
# Generated into _web/ by scripts/site_i18n.py during each MkDocs build.
- extras/site-i18n.generated.js
- extras/lang-switcher.js
# Must load after lang-switcher.js: it appends to the menu the switcher
# builds, and relies on `window.langSwitcher` to map the current page to
# the English edition.
- extras/auto-translate.js
- extras/nav-collapse.js
- https://unpkg.com/mermaid@11/dist/mermaid.min.js
- extras/mermaid-init.js
# mathjax.js must load first: it sets the `window.MathJax` config that
# the MathJax bundle reads at startup (see the file header).
- extras/mathjax.js
- https://unpkg.com/mathjax@3/es5/tex-mml-chtml.js
extra_css:
- extras/lang-switcher.css
- extras/auto-translate.css
- extras/book-theme.css
# Language definitions for the switcher tab bar.
# Each entry maps its prefix + suffix rules to rewrite URLs across editions.
extra:
languages:
# `prefix` and `suffix` apply to chapter prose (book*/chapterN[.suffix]/).
# `readmeSuffix` is the URL slug used for the per-language experiment
# index page (chapterN/README./), which mkdocs renders
# from the source file README..md.
zh: { label: 中文, prefix: book/, default: true }
zhtw: { label: 繁體中文（台灣）, prefix: book-zhtw/, suffix: .zhtw, readmeSuffix: zh-TW }
en: { label: English, prefix: book-en/, readmeSuffix: en }
es: { label: Español, prefix: book-es/, suffix: .es, readmeSuffix: es }
id: { label: Bahasa Indonesia, prefix: book-id/, readmeSuffix: id }
ru: { label: Русский, prefix: book-ru/, readmeSuffix: ru }
ta: { label: தமிழ், prefix: book-ta/, suffix: .ta, readmeSuffix: ta }
vi: { label: Tiếng Việt, prefix: book-vi/, suffix: .vi, readmeSuffix: vi }
ja: { label: 日本語, prefix: book-ja/, suffix: .ja, readmeSuffix: ja }
ko: { label: 한국어, prefix: book-ko/, suffix: .ko, readmeSuffix: ko }
ar: { label: العربية, prefix: book-ar/, suffix: .ar, readmeSuffix: ar }
tr: { label: Türkçe, prefix: book-tr/, suffix: .tr, readmeSuffix: tr }
hu: { label: Magyar, prefix: book-hu/, readmeSuffix: hu }
he: { label: עברית, prefix: book-he/, suffix: .he }
# Tier 3 — languages the book has no edition for. Selecting one loads
# translate.js (MIT, https://github.com/xnx3/translate) on demand and
# machine-translates the English edition in the browser. See
# extras/auto-translate.js for why it is opt-in, lazy, and always labelled.
#
# This is explicitly a lesser tier than the 14 built editions: figures stay
# in English (they are ![]()
SVGs, unreachable from page scripts) and the
# text is unreviewed. Anything worth shipping properly should get a real
# edition instead.
auto_translate:
label: 机器翻译 / Machine translation
# The edition to translate *from*: MT out of English beats MT out of
# Chinese for most targets, and that edition is reviewed. `source` is the
# site language code; `sourceLanguage` is translate.js' name for it.
source: en
sourceLanguage: english
# Free, keyless channel. NOT `client.edge`: that channel authenticates
# against https://edge.microsoft.com/translate/auth, an undocumented Edge
# browser endpoint that now returns 404, so it fails for every visitor.
# `giteeAI` posts to giteeai.zvo.cn/translate.json (verified working,
# keyless) and fails over to two backup hosts on its own.
# Alternatives: `siliconflow`, or `translate.service` against a self-host.
service: giteeAI
# translate.js' MutationObserver (translate.listener.start) throws
# "Cannot read properties of null (reading 'nodeValue')" against Material's
# navigation.instant DOM swaps, and queues a redundant translation pass per
# mutation. We re-translate on Material's own `document$` instead, so it
# stays off unless you explicitly want it.
listener: false
# How long a translation pass may go without any sign of life before the
# notice tells the reader the service is not answering. It is a stall
# window, not a deadline: every batch that comes back restarts it, and a
# pass that lands after it expired still clears the warning. The states in
# between ("translating", "translated") come from translate.lifecycle.
failureTimeoutMs: 12000
# Pinned version + SRI hash: this is third-party code from a public CDN,
# so the exact bytes are fixed. Both must be updated together.
cdn: https://cdn.staticfile.net/translate.js/3.18.66/translate.js
integrity: sha384-J3fM1QvC/Px5E8QNZj9KjrYuADHneSN4vCpv//WZPKUVzJocwGpZO/byDiEjaPCL
# `name` is translate.js' v2 language name (note German is `deutsch`);
# `locale` becomes the attribute.
languages:
- { name: french, label: Français, locale: fr }
- { name: deutsch, label: Deutsch, locale: de }
- { name: portuguese, label: Português, locale: pt }
- { name: italian, label: Italiano, locale: it }
- { name: polish, label: Polski, locale: pl }
- { name: dutch, label: Nederlands, locale: nl }
- { name: ukrainian, label: Українська, locale: uk }
- { name: czech, label: Čeština, locale: cs }
- { name: romanian, label: Română, locale: ro }
- { name: greek, label: Ελληνικά, locale: el }
- { name: swedish, label: Svenska, locale: sv }
- { name: danish, label: Dansk, locale: da }
- { name: finnish, label: Suomi, locale: fi }
- { name: norwegian, label: Norsk, locale: "no" }
- { name: thai, label: ไทย, locale: th }
- { name: hindi, label: हिन्दी, locale: hi }
- { name: bengali, label: বাংলা, locale: bn }
- { name: malay, label: Bahasa Melayu, locale: ms }
- { name: filipino, label: Filipino, locale: fil }
- { name: swahili, label: Kiswahili, locale: sw }
- { name: urdu, label: اردو, locale: ur, dir: rtl }
- { name: persian, label: فارسی, locale: fa, dir: rtl }
nav:
# The left sidebar is a clean chapter tree. With navigation.indexes,
# each chapter's index page (book/chapterN/index.md, promoted from
# book/chapterN.md by scripts/build_site.sh) is attached to its section:
# clicking the chapter title opens the prose directly, and the chevron
# expands the subtree to reveal "配套实验" (the experiment index).
- 首页: index.md
- 引言: book/introduction.md
- 第1章 Agent基础知识:
- book/chapter1/index.md
- 配套实验: chapter1/README.md
- 第2章 上下文工程:
- book/chapter2/index.md
- 配套实验: chapter2/README.md
- 第3章 用户记忆和知识库:
- book/chapter3/index.md
- 配套实验: chapter3/README.md
- 第4章 工具:
- book/chapter4/index.md
- 配套实验: chapter4/README.md
- 第5章 CodingAgent与通用Agent:
- book/chapter5/index.md
- 配套实验: chapter5/README.md
- 第6章 交互：观察与动作空间的扩展:
- book/chapter6/index.md
- 配套实验: chapter6/README.md
- 第7章 Agent的评估:
- book/chapter7/index.md
- 配套实验: chapter7/README.md
- 第8章 模型后训练:
- book/chapter8/index.md
- 配套实验: chapter8/README.md
- 第9章 Agent的持续进化:
- book/chapter9/index.md
- 配套实验: chapter9/README.md
- 第10章 多Agent协作:
- book/chapter10/index.md
- 配套实验: chapter10/README.md
- 后记: book/afterword.md
- 思考题参考答案: book/reference-answers.md