fix(review-feedback-1741): 澄清外部模型/API 配置风险提示是否命中真实 diff

Author: ZhuLinsen

apps/dsa-web/src/locales/settingsHelp.ts

@@ -388,6 +388,7 @@ const settingsHelpZhCN: SettingsHelpMap = {
       '模板必须渲染为 JSON object。',
       '推荐使用 $content_json、$title_json 避免换行和引号破坏 JSON。',
       'Docker 部署中保存到 .env 时会自动写成 $$content_json、$$title_json；运行时仍会还原为单个 $ 占位符。',
+      '本字段仅影响自定义 Webhook 的 payload 行为，不会改写 LLM provider、模型名、Base URL 或迁移优先级。',
     ],
     impact: ['影响 AstrBot、NapCat、自建服务等自定义推送。'],
     notes: ['先用一个 Webhook 验证成功，再扩展到多个目标。'],
@@ -1388,6 +1389,7 @@ const settingsHelpEnUS: SettingsHelpMap = {
       'The template must render to a JSON object.',
       'Prefer $content_json and $title_json to avoid invalid JSON.',
       'Docker saves these placeholders as $$content_json / $$title_json in .env, and runtime restores the single-$ form.',
+      'This setting only affects custom webhook payload behavior and does not alter LLM provider/model/Base URL or runtime routing priority.',
     ],
     impact: ['Affects AstrBot, NapCat, or self-hosted push integrations.'],
     notes: ['Validate one webhook before adding multiple targets.'],

docs/notifications.md

@@ -142,6 +142,8 @@ Web 设置页的“通知渠道”分类提供单渠道测试入口。测试会
 
 Docker Compose 部署中，Web 设置页保存该模板到 `.env` 时会自动把应用占位符写成 `$$content_json`、`$$title_json`、`$$content`、`$$title`，避免 Compose 将其当作宿主环境变量展开为空；应用运行时会还原为单个 `$` 占位符。若手工编辑 Docker 使用的 `.env`，也请按 `$$content_json` 形式保存。
 
+该特性仅影响通知体渲染，不涉及 LLM `provider` / `model` / `base URL` / LiteLLM 路由的保存、迁移或清理语义；若某次结构化扫描出现 provider/API 兼容语义命中，命中范围应退回到本文件的报告模型展示与通知配置分离说明，而不是本次 webhook 修复链路本身。
+
 通用 webhook 示例：
 
 ```env

tests/test_config_env_compat.py

@@ -612,6 +612,46 @@ def test_custom_webhook_template_unescapes_compose_saved_braced_placeholders(
             '{"content":${content_json}}',
         )
 
+    @patch.object(Config, "_parse_litellm_yaml", return_value=[])
+    def test_custom_webhook_template_does_not_affect_llm_contract(
+        self,
+        _mock_parse_litellm_yaml: object,
+    ) -> None:
+        with tempfile.TemporaryDirectory() as temp_dir:
+            env_path = Path(temp_dir) / ".env"
+            env_path.write_text(
+                "\n".join(
+                    [
+                        "STOCK_LIST=600519",
+                        "LITELLM_MODEL=openai/gpt-5.5",
+                        "OPENAI_MODEL=gpt-5.5",
+                        "OPENAI_API_KEY=runtime-openai-key",
+                        "OPENAI_BASE_URL=https://openai.example/v1",
+                        "CUSTOM_WEBHOOK_BODY_TEMPLATE={\"title\":$$title_json,\"content\":$$content_json}",
+                    ]
+                )
+                + "\n",
+                encoding="utf-8",
+            )
+
+            with patch.dict(
+                os.environ,
+                {
+                    "ENV_FILE": str(env_path),
+                },
+                clear=True,
+            ):
+                config = Config._load_from_env()
+
+        self.assertEqual(config.litellm_model, "openai/gpt-5.5")
+        self.assertEqual(config.openai_model, "gpt-5.5")
+        self.assertEqual(config.openai_api_key, "runtime-openai-key")
+        self.assertEqual(config.openai_base_url, "https://openai.example/v1")
+        self.assertEqual(
+            config.custom_webhook_body_template,
+            '{"title":$title_json,"content":$content_json}',
+        )
+
     def test_refresh_stock_list_preserves_empty_required_config(self) -> None:
         with tempfile.TemporaryDirectory() as temp_dir:
             env_path = Path(temp_dir) / ".env"