Question 1

Paperless-ngxがllama.cppをembeddingsに使用する際に、'input (681 tokens) is too large to process. increase the physical batch size'というエラーで失敗するのはなぜですか？

Accepted Answer

このエラーは、埋め込みバックエンド（llama.cpp）が、設定された物理バッチサイズ（`-b 512`）よりも大きな入力を受け取ったために発生します。修正するには、llama.cppコマンドのバッチサイズを少なくとも1024に増やしてください（例：`-b 1024`）。または、より大きな入力サイズをサポートする埋め込みモデルを使用してください。Paperless-ngxは現在、`RAG_CHUNK_SIZE`を1024にハードコードしており、コンテキストウィンドウが小さいモデルではこの問題が発生する可能性があります。将来のアップデートでこの値を調整できるようになるかもしれません。

Question 2

PAPERLESS_DB_OPTIONS JSON が無視され、データベースのタイムアウトが適用されない場合、paperless.W001 を修正するにはどうすればよいですか？

Accepted Answer

paperless-ngx v3.3.0 では、警告に示されている JSON 形式を使用しないでください：

# v3.3.0 では解析されず、オプションは黙って無視されます
PAPERLESS_DB_OPTIONS='{"timeout": "60"}'

代わりに key=value 構文を使用してください。SQLite の場合：

PAPERLESS_DB_OPTIONS=timeout=60

PostgreSQL の場合、接続タイムアウトオプションは timeout ではなく connect_timeout です：

PAPERLESS_DB_OPTIONS=connect_timeout=60

Docker の場合：

docker run -e PAPERLESS_DB_OPTIONS=timeout=60 ...
# PostgreSQL:
docker run -e PAPERLESS_DB_OPTIONS=connect_timeout=60 ...

移行後は PAPERLESS_DB_TIMEOUT を完全に削除してください。空の値（PAPERLESS_DB_TIMEOUT=）に設定しないでください。v3.3.0 では ValueError: invalid literal for int() with base 10: '' で失敗するためです。古い変数は、v3.2 で削除されると警告に書かれているにもかかわらず、v3.3.0 でもまだ機能しますが、正しい PAPERLESS_DB_OPTIONS 形式を使用すると警告が消え、設定が適用されます。

Question 3

なぜPaperless-ngxでbulk editを使用するときにタグが保存されないのですか？

Accepted Answer

Paperless-ngx を ASGI（例：Granian）で、PostgreSQL と psycopg3 を使用して実行する場合の既知の問題。バルクの modify_tags 操作が静かに失敗します。これは、M2M 書き込みがコミットされない別のデータベーストランザクションで発生するためです。回避策：ドキュメント詳細ビュー（PATCH /api/documents/{id}/）からタグを編集すると、操作は成功します。あるいは、可能であれば WSGI サーバー（例：Gunicorn）に切り替えて、非同期/同期の境界問題を回避してください。恒久的な修正については、GitHub の issue #12699 を追跡してください。

Question 4

gpt-oss:20b や qwen3:14b などの思考対応 Ollama モデルで Paperless-ngx の AI 提案が HTTP 500 を返す問題は、どのように修正すればよいですか？

Accepted Answer

この障害は、Ollama/LlamaIndex 統合が呼び出しごとの `think=False` オプションを正しく処理できず、`message.content` が空のままになるために発生します。その結果、Paperless-ngx は期待される JSON レスポンスを解析する際に失敗します。

Paperless-ngx 3.1.3 での一時的な回避策：
1. AI/LLM 設定を開きます。
2. Ollama モデルを `gpt-oss:20b` または `qwen3:14b` から、`llama3.1:8b` や `gemma3:12b` などの thinking 機能を持たないモデルに変更します。
3. 保存して Suggest を再試行します。

Ollama を直接呼び出す場合は、`"think": false` を送信する代わりに `think` パラメータを省略してください：

```bash
curl http://<ollama>:11434/api/chat -d '{
  "model": "gpt-oss:20b",
  "messages": [{"role":"user","content":"Return JSON with a field name set to test."}],
  "stream": false,
  "format": {"type":"object","properties":{"name":{"type":"string"}},"required":["name"]}
}'
```

恒久的な修正：更新された Ollama/LlamaIndex の修正 `fix(ollama): honor per-call think=False` を含む Paperless-ngx リリースにアップグレードしてください。Docker の場合：

```bash
docker compose pull
docker compose up -d
```

アップグレード後、`gpt-oss:20b` または `qwen3:14b` に戻し、AI の提案機能を再度テストしてください。

Question 5

Paperless-ngx を 3.0 にアップグレードした後、高度なクエリを使用する保存済みビューで "Error listing search results" が発生する問題の修正方法

Accepted Answer

Paperless-ngx 3.0 では検索バックエンドが切り替わり(Whoosh → Tantivy)、保存済みビューで以前は有効だった高度なクエリ構文の一部が機能しなくなりました。回避策は2つあります:

1. `AND NOT field:value` という構文を否定演算子 `-field:value` に置き換えてください。たとえば、`AND NOT title:2024` を `AND -title:2024` に変更します。

2. `title:*202[0-3]` のようなワイルドカード/正規表現の文字クラスパターンは削除してください。新しい検索バックエンドではワイルドカードがまだサポートされていません。代わりに値を明示的に列挙してください。

正しくパースされ、フィルタリングされる書き換え後のクエリ例:
tag:steuer AND tag:valentin AND (title:2025 OR (-title:2024 AND -title:2023 AND -title:2022 AND -title:2021 AND -title:2019 AND -title:2018 AND created:2025))

影響を受ける各 Saved View を編集し、クエリ文字列を適切に更新してください。以前の `AND NOT` の動作とワイルドカードの完全なサポートは、上流の Tantivy の修正と今後の Paperless-ngx のリリースに依存します。

Paperless-ngx

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト