Question 1

wipeCollectorStorage で「TypeError: files is not iterable」が発生する AnythingLLM collector の起動時クラッシュを修正するには？

Accepted Answer

クラッシュは、collector/hotdir または collector/storage/tmp が存在しないか読み取り不能なときに発生します。たとえば、それを削除した後や、それらのフォルダを含まないカスタムボリュームをマウントした場合などです。
即時の回避策: 必要なディレクトリを再作成し、collector を再起動します:
mkdir -p collector/hotdir collector/storage/tmp
touch collector/hotdir/__HOTDIR__.md collector/storage/tmp/.placeholder
Docker の場合、コンテナを起動する前にマウントされたボリューム内に両方のディレクトリが存在することを確認し、その後でコンテナを再ビルド/再作成します。
恒久的なコード修正: collector/utils/files/index.js 内で、wipeCollectorStorage のすべてのガードを resolve(); から return resolve(); に変更します。これには存在しないディレクトリのチェックと、両方の readdir エラーコールバックが含まれます。これにより、files が undefined のときに for (const file of files) へ実行が続くのを防ぎます。
必要に応じて、ネストされた一時ディレクトリも削除する必要がある場合は、fs.rmSync(file, { recursive: true, force: true }) を使用します。

Question 2

Math.round を使用した後に toFixed(decimals) が末尾のゼロしか表示しないのはなぜですか？また、decimals パラメータを無視するパーセンテージ関数を修正するにはどうすればよいですか？

Accepted Answer

このバグは、フォーマットする前に丸め処理を行っていることが原因です。`Math.round(input * 100)` が値を整数に丸めてしまうため、`toFixed(decimals)` は意味のないゼロを付加するしかなくなります（例えば、`toPercentString(0.8567, 2)` は "85.67%" ではなく "86.00%" を返します）。フォーマットするまでは完全な精度を保持するように修正します: `const percentage = input * 100; return (decimals > 0 ? percentage.toFixed(decimals) : Math.round(percentage).toString()) + "%";`。これにより、デフォルトの `decimals = 0` のパスや `null`/`NaN` の入力（引き続き空文字列を返します）の既存の動作は維持されつつ、`decimals > 0` が正しく機能するようになります。

Question 3

AnythingLLM がシステムプロンプト変数を展開するとき、なぜ $$ と $& は壊れるのですか？

Accepted Answer

JavaScript の String.prototype.replace() は、文字列置換における $$、$&、$`、$' を特殊なパターンとして扱います。server/models/systemPromptVariables.js で、次を置き換えます。

result = result.replace(match, value);

を、保存された値がリテラルとして挿入されるように置換関数へ置き換えます。

result = result.replace(match, () => value);

その後、Node/dev サーバーを再起動します。これにより、{workspace.name} や {user.bio} などの静的変数、ワークスペース変数、ユーザー変数が修正されます。このバグは master commit 3c7e73b8 で再現されました。PR fix(server): keep $$ and $& intact when expanding prompt variables を含むリリースへアップグレードするか、上記のパッチを適用してください。

Question 4

Node.js 20におけるAnythingLLMチャットおよびDeepSeekモデルリストでの「Premature close」エラーの修正方法

Accepted Answer

このエラーは、OpenAI SDK v4が`node-fetch@2`をバンドルしていることが原因で、最近のNode.jsセキュリティアップデート（例：Node v20.19.2）以降、gzipエンコードされたレスポンスでクラッシュします。これによりチャットリクエスト（`Invalid response body... Premature close`）と`/v1/models`のフェッチが失敗し、古いモデルへのフォールバックと続く400エラーが発生します。修正方法は、SDKにネイティブfetchを使用させることです：1) `require('openai/shims/web');`を含む`server/fix-node-fetch.cjs`を作成します。2) `NODE_OPTIONS='--require=./fix-node-fetch.cjs'`でサーバーを起動します。シム適用後、DeepSeekモデルリストが正しく読み込まれ（例：deepseek-flash、deepseek-v4-pro）、チャットが動作します。恒久的な修正：ネイティブfetchを使用するv6に`openai`依存関係をアップグレードします。

Question 5

macOSでAnythingLLM Desktopの「Document Processor Unavailable」エラーを修正する方法

Accepted Answer

このエラーは、macOS のネットワークフィルターまたは VPN（例: LuLu ファイアウォール）が、宛先が `0.0.0.0` となっている接続をブロックした場合に発生します。AnythingLLM のサーバーは `http://0.0.0.0:${COLLECTOR_PORT}` でドキュメントコレクターに接続しますが、フィルターがその書き込みを切断する（EPIPE/broken pipe）ため、コレクターが正常であっても `/api/system/document-processing-status` は 503 を返します。

**修正方法（1行のコード変更）:** `server/utils/collectorApi/index.js` で、`0.0.0.0` の代わりにループバックに明示的に接続します:
```diff
- this.endpoint = `http://0.0.0.0:${CollectorApi.getCollectorPort()}`;
+ this.endpoint = `http://127.0.0.1:${CollectorApi.getCollectorPort()}`;
```
`0.0.0.0` はバインドアドレスであり、有効な宛先ではありません。`127.0.0.1` は、コレクターが `127.0.0.1` と `0.0.0.0` のどちらにバインドしていても機能し、Docker ではサーバーとコレクターがコンテナのループバックを共有します。`parseNvidiaNimBasePath` にある同様の `localhost → 0.0.0.0` の書き換えパターンも修正する必要があります。

**回避策（コード変更なし）:** LuLu（または `0.0.0.0` をブロックしている VPN/フィルター）を一時的に無効にします。注意: `0.0.0.0` に対する LuLu の許可ルールを追加しても（グローバルな `* → 0.0.0.0:*` の Allow ルールであっても）効果はありません。LuLu を無効にすることでのみ解決します。`curl http://0.0.0.0:8888/`（broken pipe = ブロックされている）と `curl http://127.0.0.1:8888/`（OK）で確認できます。

AnythingLLM

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト