site_name: DeepSeek Harness · 从插件源码到自己的 Agent
site_url: https://deepseek.baoer.me/
site_description: 固定官方 main 与 rc.2 源码的中文设计解析、插件组合、SDK 实战和独立审查课程。
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: teal
    accent: cyan
    toggle:
      icon: material/weather-night
      name: 切换深色
  - scheme: slate
    primary: teal
    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
  - 动手构建笔记 Agent:
      - 18 · 能力 seam 与两个业务工具: 18-own-plugin.md
      - 19 · 六个 checkpoint 组成自己的 Agent: 19-own-agent.md
      - 20 · SDK、Python 与真实运行时测试: 20-sdk-labs.md
      - 24 · 排错与进一步练习: 24-troubleshooting-and-tests.md
  - 设计与核心源码:
      - 02 · 插件树的设计思想: 02-design.md
      - 03 · Cordis 服务与可卸载效果: 03-cordis.md
      - 04 · CLI、profile、bundle 与 preset: 04-boot-and-presets.md
      - 05 · Session 与历史事实: 05-session.md
      - 06 · Projection 与 Prompt: 06-projection-and-prompt.md
      - 07 · AgentLoop 全路径: 07-agent-loop.md
      - 08 · 工具执行全管道: 08-tools.md
      - 09 · LLM、重试与上下文: 09-llm-and-context.md
      - 14 · TypeScript 与 Python SDK: 14-sdk.md
      - 16 · 存储、索引与迁移: 16-storage-and-migrations.md
  - 扩展成自己的产品:
      - 10 · Shell、PTY、SSH、LSP 与沙箱: 10-execution-and-sandbox.md
      - 11 · PTC、Code Mode 与 workflow: 11-ptc-and-workflows.md
      - 12 · MCP、Mods 与外部能力: 12-mcp-and-bridges.md
      - 13 · 多 Agent、Job、Goal 与 Schedule: 13-agents-and-goals.md
      - 15 · Web、Desktop、ACP 与 API: 15-ui-and-api.md
      - 17 · 人工决策与自动化: 17-human-and-automation.md
      - 21 · 与 Pi 的设计比较: 21-compare-pi.md
  - 源码、版本与审核:
      - 23 · 全仓源码地图与研究覆盖: 23-source-map.md
      - 26 · rc.2、alpha 与 Python 差异: 26-version-delta.md
      - 25 · 独立审查与交付验收: 25-review.md
      - 22 · 网站与课程维护: 22-deployment.md
      - 作者初审: appendix/astra/dsh-initial-review.md
      - 独立质量初审: appendix/astra/quality-initial.md
  - 完整单文件课程: complete-course.md
  - 实验完整源码: appendix/examples.md
  - 历史研究索引:
      - A · 核心: appendix/research-a.md
      - B · 集成: appendix/research-b.md
      - C · SDK: appendix/research-c.md
  - 历史审查原报告:
      - A · 初审: appendix/reviews/reviewer-a-initial.md
      - A · 复验: appendix/reviews/reviewer-a-final.md
      - A · 整合初审: appendix/reviews/reviewer-a-integration-initial.md
      - A · 整合复验: appendix/reviews/reviewer-a-integration-final.md
      - A · 实战初审: appendix/reviews/reviewer-a-labs-initial.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

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