docs(v8): clarify AI force-disable and clean up AI env vars

[yuki-takei]

概要

GROWI v8.0.x のアップグレードガイドと環境変数リファレンスの AI 関連記述を、日英そろえて整理します。起点は 2 つの issue です。

• [8.0.0]環境変数「AI_ENABLED=false」でAI機能を強制無効にできない growi#11638 — AI_ENABLED=false 単体では AI 機能を強制無効にできない件
• chore(app): remove orphaned openai:serviceType / openai:apiKey config keys growi#11651 — OPENAI_SERVICE_TYPE / OPENAI_API_KEY は dead config なので削除

変更内容

admin-guide/upgrading/80x.md（ja / en）

• 「[注意] 環境変数だけで AI 機能の有効・無効を固定する」小節を追加。
  • AI_ENABLED は初期値のみで、設定解決は「環境変数 → 管理画面(DB)保存値」の順で DB が優先されるため、AI_ENABLED=false だけでは管理画面から再有効化できてしまうことを明記。
  • 強制無効かつ管理画面からも変更不可にするには AI_USES_ONLY_ENV_VARS_FOR_SOME_OPTIONS=true を併用する必要があることを記載（[8.0.0]環境変数「AI_ENABLED=false」でAI機能を強制無効にできない growi#11638 の報告者要望に対応）。

admin-guide/admin-cookbook/env-vars.md（ja / en）

• 旧「GROWI AI オプション」と「GROWI AI Agent オプション」の 2 見出しを 1 つに統合。
• v8.0 で廃止された旧アシスタント系 OPENAI_*（OPENAI_CHAT_ASSISTANT_* / OPENAI_SEARCH_ASSISTANT_* / OPENAI_THREAD_DELETION_* / OPENAI_VECTOR_STORE_FILE_DELETION_* / OPENAI_LIMIT_LEARNABLE_PAGE_COUNT_PER_ASSISTANT）を削除。
• OPENAI_SERVICE_TYPE / OPENAI_API_KEY を削除。現行の suggest-path-agentic は AI_PROVIDERS / AI_PROVIDER_API_KEYS / AI_ALLOWED_MODELS のみを参照し、この 2 キーはどこからも読まれない dead config のため（chore(app): remove orphaned openai:serviceType / openai:apiKey config keys growi#11651）。
• 現行の suggest-path-agentic 用 env を追記: AI_SUGGEST_PATH_AGENT_PROVIDER_OPTIONS / AI_TOOLS_SUGGEST_PATH_AGENTIC_SEARCH_LIMIT / AI_TOOLS_SUGGEST_PATH_AGENTIC_CHILD_LISTING_LIMIT / AI_TOOLS_SUGGEST_PATH_AGENTIC_TIMEOUT_MS。

確認

• 追記・削除した env は growilabs/growi の v8.0.0 タグの config-definition.ts と照合済み。
• textlint 通過。

🤖 Generated with Claude Code