site_name: Pi 1.0 · 从源码到自己的 Agent
site_url: https://pi.baoer.me/
site_description: 基于 Pi 1.0 官方源码的中文设计解析、源码精读与 Agent 实战课程。
docs_dir: docs
site_dir: site
exclude_docs: |
  assets/complete-course.md
hooks:
  - scripts/mkdocs_hooks.py
theme:
  name: material
  language: zh
  font: false
  palette:
    - scheme: default
      primary: indigo
      accent: cyan
      toggle:
        icon: material/weather-night
        name: 切换深色
    - scheme: slate
      primary: indigo
      accent: cyan
      toggle:
        icon: material/weather-sunny
        name: 切换浅色
  features:
    - navigation.sections
    - navigation.top
    - navigation.footer
    - content.code.copy
    - search.suggest
    - search.highlight
plugins:
  - search:
      lang: [en]
      pipeline: []
      separator: '[\s\u200b\u3000\-、。，．？！；]+|(?=[\u4e00-\u9fff])|(?<=[\u4e00-\u9fff])'
markdown_extensions:
  - admonition
  - attr_list
  - tables
  - toc:
      permalink: true
  - pymdownx.details
  - pymdownx.highlight:
      anchor_linenums: true
  - pymdownx.inlinehilite
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: pi-diagram
          format: !!python/name:pymdownx.superfences.fence_code_format
extra_css: [assets/course-v3.css]
extra_javascript: [assets/mermaid.min.js, assets/diagrams-v5.js]
nav:
  - 开始学习: index.md
  - 01 · 版本与学习路线: 01-version-roadmap.md
  - 03 · 安装与日常工作: 03-usage.md
  - 动手构建研究 Agent:
      - 13 · Core 循环与证据验收: labs/13-core.md
      - 14 · SDK 与磁盘恢复: labs/14-sdk.md
      - 12 · 配置、技能与包: labs/12-customize.md
      - 15 · 产品化与评测: labs/15-production.md
      - 16 · 故障排查与练习: 16-troubleshooting.md
  - 理解设计与源码:
      - 02 · 设计思想与架构: 02-design.md
      - 04 · 模型与消息协议: 04-models-messages.md
      - 05 · Agent 与主循环: source/05-agent-loop.md
      - 06 · SDK 与 AgentSession: source/06-session.md
      - 07 · 会话树与上下文: source/07-context.md
      - 08 · 工具与扩展: source/08-tools-extensions.md
      - 09 · MCP 与 Code Mode: source/09-mcp-codemode.md
      - 10 · TUI、RPC 与服务化: source/10-interfaces.md
      - 11 · Durable 与 Chord: source/11-durable.md
  - 源码、版本与审核:
      - 17 · 源码地图与研究边界: 17-source-map.md
      - 20 · 1.0.1 版本差异与复审: 20-review-and-version-delta.md
      - 18 · 审核与验收记录: 18-validation.md
      - 19 · 网站维护: 19-deployment.md
      - 作者初审: appendix/astra/pi-initial-review.md
      - 独立质量初审: appendix/astra/quality-initial.md
  - 完整单文件课程: complete-course.md
  - 实验完整源码: appendix/examples.md
  - 历史 1.0.0 审查原报告:
      - A · 初审: appendix/reviews/reviewer-a-initial.md
      - A · 复验: appendix/reviews/reviewer-a-final.md
      - B · 初审: appendix/reviews/reviewer-b-initial.md
      - B · 复验: appendix/reviews/reviewer-b-final.md
      - C · 初审: appendix/reviews/reviewer-c-initial.md
      - C · 复验: appendix/reviews/reviewer-c-final.md
      - D · 最终交付: appendix/reviews/reviewer-d-final.md
      - 旧版版本差异: appendix/astra/pi-previous-review-and-delta.md

  - 本轮独立复审:
      - 教学质量终审: appendix/astra/quality-final.md
      - 交叉终审: appendix/astra/cross-dsh-final.md
      - 源码图示初审: appendix/astra/source-review-initial.md
      - 源码图示复验: appendix/astra/source-review-final.md