1445043649
7dfc9968fe
apps/：新增「基于 DeerFlow 的应用」目录，与 backend/、frontend/ 平级， 位于「app 消费 deerflow、不反向依赖」边界的正确侧。含两种集成示例： - examples/http-chat —— HTTP Gateway (REST+SSE)，含登录/CSRF/建线程/流式对话 - examples/embedded-chat —— 进程内直接调 DeerFlowClient README 说明边界规则、两种模式、鉴权流程及新建应用约定。 runtime/store：修复 make_store 缺失的 database 段回退。原先 store 工厂只读 legacy 的 checkpointer 段，导致仅配 database:postgres 时，checkpointer 走了 Postgres、但 store 仍回退 InMemoryStore（并打出误导性的「线程列表会丢失」告警， 实际线程在 threads_meta 表里、本就持久）。现对齐 checkpointer 工厂的优先级： checkpointer 段 → database 段 → InMemoryStore；postgres 分支同样剥掉 +asyncpg 方言前缀，使一个 DATABASE_URL 同时满足 SQLAlchemy 与 LangGraph 的 psycopg store。 告警文案也修正为「跨线程 store 数据会丢失」。 tests：新增 test_store_provider.py（3 例，TDD）覆盖 database→postgres 回退、 无配置时的内存回退、以及 checkpointer 段优先级。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
apps/ — 基于 DeerFlow 的应用
这个目录用于存放消费 DeerFlow 智能体能力的上层应用。每个应用一个子文件夹。
为什么放在这里
DeerFlow 的代码有一条严格的依赖方向（见根 CLAUDE.md）：
backend/packages/harness/deerflow/ ← 可发布的 Agent 框架（deerflow.*）
backend/app/ ← Gateway / IM 通道（app.*）
apps/ ← 你的应用（消费 deerflow，不反向依赖） ← 本目录
规则：app 可以依赖 deerflow，deerflow 不能依赖 app / apps。本目录放在 backend/ 之外、与 frontend/ 平级，天然符合这条边界。
两种集成模式
| 模式 | 适用场景 | 怎么连 | 示例 |
|---|---|---|---|
| HTTP Gateway（REST+SSE） | 上层是别的服务 / 多语言 | 调 http://localhost:2026/api/* |
examples/http-chat/ |
| 内嵌 DeerFlowClient | 上层本身是 Python，进程内直接当 SDK 调 | from deerflow.client import DeerFlowClient |
examples/embedded-chat/ |
还有第三种：LangGraph SDK（
langgraph_sdk.get_client(url=".../api")，graph idlead_agent），用于接入 LangGraph 生态工具链。需要的话照 HTTP 示例的鉴权流程拿 cookie 即可。
前置：先把 DeerFlow 跑起来
在仓库根目录：
make dev # 起 Gateway(8001) + 前端(3000) + nginx(2026)，统一入口 http://localhost:2026
确保 config.yaml 里至少配了一个可用模型 + API key。
鉴权（HTTP 模式必读）
Gateway 是 fail-closed 的——除少数公开路径外所有请求都要带会话 cookie：
GET /api/v1/auth/setup-status→ 是否还没管理员- 首次
POST /api/v1/auth/initialize（JSON{email,password}）建第一个管理员；之后POST /api/v1/auth/login/local（表单username=邮箱 +password） - 成功后 Session 里有
access_token(HttpOnly) +csrf_token两个 cookie - 所有写请求（POST/PUT/DELETE/PATCH）必须带
X-CSRF-Token头 =csrf_token值
多租户：当前
docs/multi-tenant-redesign分支的 API Key 鉴权中间件尚未接入，外部系统暂时只能走会话 cookie。等Authorization: Bearer dfk_live_...落地后再补无人值守接入。
新建一个应用
mkdir apps/my-app
# 放你的代码；HTTP 模式参照 examples/http-chat，内嵌模式参照 examples/embedded-chat