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>
53 lines
2.5 KiB
Markdown
53 lines
2.5 KiB
Markdown
# 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/`](examples/http-chat/) |
|
||
| **内嵌 DeerFlowClient** | 上层本身是 Python，进程内直接当 SDK 调 | `from deerflow.client import DeerFlowClient` | [`examples/embedded-chat/`](examples/embedded-chat/) |
|
||
|
||
> 还有第三种：LangGraph SDK（`langgraph_sdk.get_client(url=".../api")`，graph id `lead_agent`），用于接入 LangGraph 生态工具链。需要的话照 HTTP 示例的鉴权流程拿 cookie 即可。
|
||
|
||
## 前置：先把 DeerFlow 跑起来
|
||
|
||
在**仓库根目录**：
|
||
|
||
```bash
|
||
make dev # 起 Gateway(8001) + 前端(3000) + nginx(2026)，统一入口 http://localhost:2026
|
||
```
|
||
|
||
确保 `config.yaml` 里至少配了一个可用模型 + API key。
|
||
|
||
## 鉴权（HTTP 模式必读）
|
||
|
||
Gateway 是 **fail-closed** 的——除少数公开路径外所有请求都要带会话 cookie：
|
||
|
||
1. `GET /api/v1/auth/setup-status` → 是否还没管理员
|
||
2. 首次 `POST /api/v1/auth/initialize`（JSON `{email,password}`）建第一个管理员；之后 `POST /api/v1/auth/login/local`（**表单** `username`=邮箱 + `password`）
|
||
3. 成功后 Session 里有 `access_token`(HttpOnly) + `csrf_token` 两个 cookie
|
||
4. **所有写请求**（POST/PUT/DELETE/PATCH）必须带 `X-CSRF-Token` 头 = `csrf_token` 值
|
||
|
||
> 多租户：当前 `docs/multi-tenant-redesign` 分支的 API Key 鉴权中间件尚未接入，外部系统暂时只能走会话 cookie。等 `Authorization: Bearer dfk_live_...` 落地后再补无人值守接入。
|
||
|
||
## 新建一个应用
|
||
|
||
```bash
|
||
mkdir apps/my-app
|
||
# 放你的代码；HTTP 模式参照 examples/http-chat，内嵌模式参照 examples/embedded-chat
|
||
```
|