Question 1

DeerFlowでGATEWAY_PORTが空であることが原因の「ValueError: invalid literal for int() with base 10: ''」を修正するにはどうすればよいですか？

Accepted Answer

ゲートウェイが失敗する原因は、`os.getenv("GATEWAY_PORT", "8001")` が変数が未設定の場合にのみデフォルト値を返すためです。空だが定義されている変数は `""` となり、`int("")` は `ValueError` を発生させます。

即時の回避策: 変数を未設定にするか、有効な数値のポートを指定してください:

```bash
unset GATEWAY_PORT
uv run uvicorn app.gateway.app:app --port 8001
```

または明示的に設定します:

```bash
GATEWAY_PORT=8001 GATEWAY_HOST=0.0.0.0 uv run uvicorn app.gateway.app:app --port 8001
```

Docker では `-e GATEWAY_PORT=` を使用しないでください。変数を省略するか、値を渡してください:

```bash
docker run -e GATEWAY_PORT=8001 ...
```

Docker Compose では、未設定のシェル変数が空文字列に展開されるのを防ぐため、デフォルト値を指定してください:

```yaml
GATEWAY_PORT: ${PORT:-8001}
GATEWAY_HOST: ${GATEWAY_HOST:-0.0.0.0}
```

`backend/app/gateway/config.py` における恒久的なコード修正: `None` と `""` のみを未設定として扱い、`GATEWAY_PORT=0` は保持します:

```python
port_raw = os.getenv("GATEWAY_PORT")
port = 8001 if port_raw is None or port_raw == "" else int(port_raw)
host = os.getenv("GATEWAY_HOST") or "0.0.0.0"
```

Question 2

ディレクトリスキャン中にファイルが削除された場合にアップロードリスティングが 500 FileNotFoundError を返す問題を修正する方法

Accepted Answer

`backend/packages/harness/deerflow/uploads/manager.py` の `list_files_in_dir` にパッチを当て、ファイルシステムの競合を許容するようにしてください。`os.scandir()` の後で `entry.stat(follow_symlinks=False)` を `try/except OSError` で囲み、`ENOENT`、`ENOTDIR`、`ELOOP` などの一時的なルックアップエラーではそのエントリをスキップし、`EACCES` のようなオペレーショナルエラーは再送出してください。また、`os.scandir` の前または実行中にディレクトリが消えた場合は、それまでに収集したエントリを返すことで対処してください。

例:
```python
try:
    st = entry.stat(follow_symlinks=False)
except OSError as e:
    if e.errno in (errno.ENOENT, errno.ENOTDIR, errno.ELOOP):
        continue
    raise
```

これを防ぐために `entry.is_file()` に依存しないでください。POSIX では、ファイルシステムを再確認せずに `scandir` からキャッシュされた `d_type` を使用する場合があります。`stat()` が `FileNotFoundError` を送出する状況をシミュレートし、消えたエントリがスキップされ、残りのファイルが返されることを検証する回帰テストを追加してください。

Question 3

Python 3.13にアップグレードした後、RunJournal.flush()がスレッド間のミドルウェアイベントをドロップする問題を修正する方法

Accepted Answer

Python 3.13.16以降および3.14.8以降では、`asyncio.to_thread()`がイベントループに制御を譲らずに再開することがあります。そのため、ワーカーから`call_soon_threadsafe()`でキューに入れられたコールバックは、`RunJournal.flush()`がバッファをチェックする時点でまだ保留中の可能性があります。`flush()`は空のバッファを検出し、`_detach_runtime_dependencies()`がジャーナルを閉じ、後続のコールバックは`_closed`で早期リターンしてしまい、最後のミドルウェアイベントが静かに失われます。

`flush()`を修正するには、ドレイン前に一度制御を譲り、その後でクローズ状態を再チェックします：

```python
async def flush(self):
    # Let cross-thread call_soon_threadsafe callbacks land on the owner loop.
    await asyncio.sleep(0)

if self._closed:
        return

# Existing buffer-drain/queue-join logic follows here.
```

`_detach_runtime_dependencies()`の前に`await journal.flush()`を維持してください。observability/auditパスでも同様に、`flush()`がキューにジョインする前に保留中の外部スレッドからのUsage/Auditのエンキューをドレインし、ワーカーをクローズ済みとマークする前にシャットダウンをフェンスしてください。

以下で検証してください：

```bash
cd backend
PYTHONPATH=. uv run pytest tests/test_run_journal.py::test_cross_thread_middleware_events_are_serialized_on_owner_loop
```

このリグレッションは、gh-105836/GH-141696によるCPythonの`_chain_future`の変更が原因です。Python 3.12.15では追加のループ反復が強制されるため、Python 3.12へのピン留めは一時的な回避策となります。`await asyncio.sleep(0)`フェンスを追加することで、3.12、3.13、3.14のすべてで修正されます。

Question 4

globフィルターにスペース、引用符、またはドル記号が含まれている場合に、E2Bのgrepがexit code 2で失敗する問題を修正するにはどうすればよいですか？

Accepted Answer

E2B issue #6528 の修正（`fix(e2b): quote grep filename filters`）を含むリリースにアップグレードしてください。このバグは、`E2BSandbox.grep()` が `--include=release *.txt` のようなクォートされていないシェル引数を構築するため、シェルがそれを分割または展開してしまうことが原因で発生します。アダプターにパッチを適用する際は、引数の一部だけでなく引数全体をシェルクォートしてください。`sh -c` で実行されるコマンドに追加する前に、`shlex.quote(f"--include={glob}")` を使用してください。トランスポートがサポートしている場合は、`["grep", f"--include={glob}", ...]` のような argv 配列を渡すことを優先してください。これにより、ワイルドカードのセマンティクスを維持しながら、スペース、アポストロフィ、ダブルクォート、リテラルな `$` 文字が保持されます。一時的な回避策として、`*.txt` のようなシェルメタ文字を含まない glob を使用し、一致するパスを Python でフィルタリングしてください。

Question 5

Helm 経由で DeerFlow をデプロイする際に、Live Browser WebSocket 接続が失敗する（404 / 101 Switching Protocols が返されない）のはなぜですか？

Accepted Answer

Helmチャートのnginx ConfigMap（`deploy/helm/deer-flow/templates/configmap-nginx.yaml`）には、Live Browserエンドポイント`/api/threads/<thread_id>/browser/stream`専用のlocationがありません。リクエストは汎用のthreads locationに振り分けられ、そこで`Upgrade: websocket`が削除され、`Connection`が`close`に書き換えられるため、Gatewayには通常のHTTPリクエストが届き、WebSocketハンドシェイクが完了しません。

修正方法：`configmap-nginx.yaml`のnginxテンプレートに、Docker/ローカルのnginx設定に既に存在するものと同じ、専用のlocationブロックを追加します：

```nginx
location ~ ^/api/threads/[^/]+/browser/stream {
    proxy_pass http://gateway;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_read_timeout 3600s;
}
```

その後、`helm upgrade`で再デプロイします（または`helm template`で再レンダリングしてnginxポッドを再起動します）。ハンドシェイクが成功すると`HTTP/1.1 101 Switching Protocols`が返されます。なお、`make dev`とDockerスタックには既にこのlocationが含まれているため、このバグはHelmでデプロイされた環境でのみ発生します。Gatewayはアップグレード後も認証とスレッドの所有権を引き続き強制します。

deer-flow

概要

README プレビュー

FAQ (5)

同类型项目

tensorflow

superpowers

everything-claude-code

flutter