From 6d91528b7c3c528cb55adca69bfa1e9c343f6349 Mon Sep 17 00:00:00 2001
From: caoxiaozhu <caoxiaozhu@users.noreply.github.com>
Date: Sat, 9 May 2026 08:25:54 +0000
Subject: [PATCH] =?UTF-8?q?feat:=20=E6=B7=BB=E5=8A=A0=20Docker=20=E7=8E=AF?=
 =?UTF-8?q?=E5=A2=83=E8=BD=AE=E8=AF=A2=E7=9B=91=E5=90=AC=E6=94=AF=E6=8C=81?=
 =?UTF-8?q?=E5=B9=B6=E4=BC=98=E5=8C=96=E6=B8=B2=E6=9F=93=E8=AE=BE=E7=BD=AE?=
 =?UTF-8?q?=E5=8D=A1=E7=89=87=E6=A0=B7=E5=BC=8F?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 web/src/assets/styles/views/settings-view.css | 20 ++++++++-----
 web/src/views/SettingsView.vue                |  3 +-
 web/src/views/scripts/SettingsView.js         |  4 +--
 web/tests/settings-rendering-section.test.mjs | 30 +++++++++++++++++++
 web/vite.config.js                            | 30 ++++++++++++-------
 5 files changed, 64 insertions(+), 23 deletions(-)
 create mode 100644 web/tests/settings-rendering-section.test.mjs

diff --git a/web/src/assets/styles/views/settings-view.css b/web/src/assets/styles/views/settings-view.css
index 60ae7f5..74cd20d 100644
--- a/web/src/assets/styles/views/settings-view.css
+++ b/web/src/assets/styles/views/settings-view.css
@@ -530,14 +530,18 @@
   text-align: right;
 }
 
-.switch-group {
-  display: grid;
-  gap: 12px;
-}
-
-.switch-row {
-  width: 100%;
-  display: flex;
+.switch-group {
+  display: grid;
+  gap: 12px;
+}
+
+.rendering-settings-card .switch-group {
+  margin-bottom: 24px;
+}
+
+.switch-row {
+  width: 100%;
+  display: flex;
   align-items: center;
   justify-content: space-between;
   gap: 16px;
diff --git a/web/src/views/SettingsView.vue b/web/src/views/SettingsView.vue
index a36cb62..d33485a 100644
--- a/web/src/views/SettingsView.vue
+++ b/web/src/views/SettingsView.vue
@@ -404,11 +404,10 @@
           </template>
 
           <template v-else-if="activeSection === 'rendering'">
-            <section class="settings-card">
+            <section class="settings-card rendering-settings-card">
               <div class="card-head">
                 <div>
                   <h4>ONLYOFFICE 服务配置</h4>
-                  <p>维护文件渲染开关、文档服务对外地址和 JWT 密钥。后端回调地址继续由部署配置管理。</p>
                 </div>
               </div>
 
diff --git a/web/src/views/scripts/SettingsView.js b/web/src/views/scripts/SettingsView.js
index b505d09..9ff5ac5 100644
--- a/web/src/views/scripts/SettingsView.js
+++ b/web/src/views/scripts/SettingsView.js
@@ -38,9 +38,9 @@ const SECTION_DEFINITIONS = [
   {
     id: 'rendering',
     label: '文件渲染',
-    title: 'ONLYOFFICE 文件渲染配置',
+    title: '文件渲染',
     desc: '文档预览服务与访问密钥',
-    longDesc: '集中管理 ONLYOFFICE 文件渲染开关、文档服务地址和 JWT 密钥。服务端内部回调地址继续由部署配置维护。',
+    longDesc: '维护文件渲染开关、文档服务对外地址和 JWT 密钥，后端回调地址继续由部署配置管理。',
     actionLabel: '保存文件渲染配置'
   },
   {
diff --git a/web/tests/settings-rendering-section.test.mjs b/web/tests/settings-rendering-section.test.mjs
new file mode 100644
index 0000000..ce27c43
--- /dev/null
+++ b/web/tests/settings-rendering-section.test.mjs
@@ -0,0 +1,30 @@
+import assert from 'node:assert/strict'
+import { readFileSync } from 'node:fs'
+
+const settingsScript = readFileSync(new URL('../src/views/scripts/SettingsView.js', import.meta.url), 'utf8')
+const settingsView = readFileSync(new URL('../src/views/SettingsView.vue', import.meta.url), 'utf8')
+const settingsStyles = readFileSync(new URL('../src/assets/styles/views/settings-view.css', import.meta.url), 'utf8')
+
+function testRenderingSectionUsesConciseToolbarTitle() {
+  assert.match(settingsScript, /title:\s*'文件渲染'/)
+  assert.doesNotMatch(settingsScript, /title:\s*'ONLYOFFICE 文件渲染配置'/)
+}
+
+function testRenderingCardRemovesDuplicatedDescription() {
+  assert.match(settingsView, /<h4>ONLYOFFICE 服务配置<\/h4>/)
+  assert.doesNotMatch(settingsView, /维护文件渲染开关、文档服务对外地址和 JWT 密钥。后端回调地址继续由部署配置管理。/)
+}
+
+function testRenderingSectionAddsSpacingBetweenSwitchAndInputs() {
+  assert.match(settingsView, /<section class="settings-card rendering-settings-card">/)
+  assert.match(settingsStyles, /\.rendering-settings-card \.switch-group \{\s*margin-bottom: 24px;\s*\}/)
+}
+
+function run() {
+  testRenderingSectionUsesConciseToolbarTitle()
+  testRenderingCardRemovesDuplicatedDescription()
+  testRenderingSectionAddsSpacingBetweenSwitchAndInputs()
+  console.log('settings rendering section tests passed')
+}
+
+run()
diff --git a/web/vite.config.js b/web/vite.config.js
index b6e2d9a..c9f4bb9 100644
--- a/web/vite.config.js
+++ b/web/vite.config.js
@@ -8,12 +8,13 @@ import { fileURLToPath } from 'node:url'
 import { defineConfig } from 'vite'
 import vue from '@vitejs/plugin-vue'
 
-const __dirname = path.dirname(fileURLToPath(import.meta.url))
-const rootDir = path.resolve(__dirname, '..')
-const envFile = path.join(rootDir, '.env')
-const envExampleFile = path.join(rootDir, '.env.example')
-const adminSecretDir = path.join(rootDir, 'server', '.secrets')
-const adminSecretFile = path.join(adminSecretDir, 'admin.json')
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const rootDir = path.resolve(__dirname, '..')
+const envFile = path.join(rootDir, '.env')
+const envExampleFile = path.join(rootDir, '.env.example')
+const preferPollingWatcher = fs.existsSync('/.dockerenv') || process.env.VITE_USE_POLLING === 'true'
+const adminSecretDir = path.join(rootDir, 'server', '.secrets')
+const adminSecretFile = path.join(adminSecretDir, 'admin.json')
 const adminScryptOptions = { N: 16384, r: 8, p: 1 }
 const adminScryptKeyLength = 64
 let backendStartPromise = null
@@ -1022,11 +1023,18 @@ function localSetupPlugin() {
 
 export default defineConfig({
   envDir: '..',
-  server: {
-    watch: {
-      ignored: [
-        envFile,
-        envExampleFile,
+  server: {
+    watch: {
+      ...(preferPollingWatcher
+        ? {
+            // Docker bind mounts can miss fs events for Vue SFCs, which leaves Vite serving stale templates.
+            usePolling: true,
+            interval: 250
+          }
+        : {}),
+      ignored: [
+        envFile,
+        envExampleFile,
         path.join(rootDir, 'server', 'logs', '**')
       ]
     },