DeerFlow
DeerFlow 入门：用一个小而可验收的任务开始
检查本地依赖，选择克制的执行权限，再用自有文档验证报告工作流，不必一开始就接入外部账号。
你将学会
- 从文档要求的环境开始，而不是猜命令
- 首个任务只使用有权处理的输入
- 观察过程，再独立评分产物
开始前需要
- 基础 Python、HTTP 和容器知识
- 拥有明确验收条件的自有任务
解释本章实现边界，并应用检查清单或隔离辅助函数练习。
先看结论
- 同时检查 Shell 和前后端运行环境。
- 先用自有小样例，再添加集成。
- 产物验收与服务健康检查分开。
从文档要求的环境开始，而不是猜命令
固定版本 README 使用 make check 检查 Node.js 22+、pnpm、uv 和 nginx，再用 make install 安装前后端依赖。make setup 启动交互向导，写入 config.yaml 并把凭据保存到 .env。这些命令会改变本地环境，安装过程还可能设置钩子，应先在可丢弃的检出目录审查。
Windows 有一个重要前提：该版本为基于 Bash 的服务脚本指定 Git Bash，不支持直接使用原生 PowerShell 或 cmd.exe，也不保证 WSL 兼容。Python 要求来自后端清单。PATH 中出现 Python，并不能证明前端、Shell 工具和所选沙箱都已准备好。
首个任务只使用有权处理的输入
准备两份有权处理的小文档，包含几个已知事实和一处刻意设置的矛盾。让智能体生成对照报告，引用对应输入，并把矛盾明确标为未解决。无需浏览器账号、公开发布、支付方式或生产仓库，就可以判断基础工作流是否有用。
在配置向导中主动选择沙箱模式和文件写入权限。处理不可信材料时保持宿主机 Shell 关闭，不要为了方便首次运行就挂载个人 CLI 凭据目录。生产配置把这类挂载拆成了需要主动启用的叠加文件，因为它们暴露的内容远超过单个任务的工作文件。
观察过程，再独立评分产物
make doctor 完成相关配置诊断后，文档中的本地启动入口是 make dev。观察调用了哪些工具、输出是否落在预期任务目录，以及最后记录了什么停止原因。健康检查成功只说明服务可用，不能证明读取、推理和文件生成都正确。
下面是编辑设计的验收样例，不是 DeerFlow 原生配置。合格报告应保留两个冲突年份及各自来源，而不是静默选择其中一个。本次没有运行这项端到端任务；实际执行的上游代码仅限源码分析章节介绍的标准库辅助函数。
实施步骤
- 1
在支持的 Shell 中审查固定检出并执行 make check。
- 2
安装依赖，运行 make setup，选择受限能力。
- 3
在隔离评估环境执行 make doctor，再运行 make dev。
- 4
按预期事实和矛盾检查交付文件。
可复制示例
{"fixture":{"documentA":{"releaseYear":2024},"documentB":{"releaseYear":2025}},"expected":"引用两份文档，并将年份标为未解决","externalWritesAllowed":false,"exerciseExecuted":false}常见问题
能把 make 命令直接粘贴进原生 PowerShell 吗？
固定版本 README 为 Windows 服务脚本指定 Git Bash，应遵循该环境要求。
首个任务一定要联网搜索吗？
不需要。有明确预期的自有文档更适合小规模、可复现的初次验证。
资料来源
- README.md来源核查 2026-09-08
- LICENSE来源核查 2026-09-08
- backend/README.md来源核查 2026-09-08
- backend/pyproject.toml来源核查 2026-09-08
- backend/docs/middleware-execution-flow.md来源核查 2026-09-08
- backend/packages/harness/deerflow/agents/lead_agent/agent.py来源核查 2026-09-08
- backend/packages/harness/deerflow/agents/middlewares/loop_detection_middleware.py来源核查 2026-09-08
- backend/packages/harness/deerflow/agents/middlewares/_bounded_dict.py来源核查 2026-09-08
- backend/packages/harness/deerflow/config/loop_detection_config.py来源核查 2026-09-08
- backend/packages/harness/deerflow/sandbox/local/local_sandbox_provider.py来源核查 2026-09-08
- backend/app/gateway/auth_middleware.py来源核查 2026-09-08
- backend/app/gateway/csrf_middleware.py来源核查 2026-09-08
- docker/docker-compose.yaml来源核查 2026-09-08