fix(config): expose cua idle timeout in dashboard (#8075)

* fix(config): expose cua idle timeout in dashboard

* fix(config): remove exposed cua ttl setting

* fix(config): centralize cua idle timeout default

Author: zouyonghe

astrbot/core/computer/booters/cua_defaults.py

@@ -2,6 +2,7 @@
     "image": "linux",
     "os_type": "linux",
     "ttl": 3600,
+    "idle_timeout": 0,
     "telemetry_enabled": False,
     "local": True,
     "api_key": "",

astrbot/core/config/default.py

@@ -178,8 +178,7 @@
             "shipyard_neo_ttl": 3600,
             "cua_image": CUA_DEFAULT_CONFIG["image"],
             "cua_os_type": CUA_DEFAULT_CONFIG["os_type"],
-            "cua_ttl": CUA_DEFAULT_CONFIG["ttl"],
-            "cua_idle_timeout": 0,
+            "cua_idle_timeout": CUA_DEFAULT_CONFIG["idle_timeout"],
             "cua_telemetry_enabled": CUA_DEFAULT_CONFIG["telemetry_enabled"],
             "cua_local": CUA_DEFAULT_CONFIG["local"],
             "cua_api_key": CUA_DEFAULT_CONFIG["api_key"],
@@ -3348,10 +3347,10 @@
                             "provider_settings.sandbox.booter": "cua",
                         },
                     },
-                    "provider_settings.sandbox.cua_ttl": {
-                        "description": "CUA Sandbox TTL",
+                    "provider_settings.sandbox.cua_idle_timeout": {
+                        "description": "CUA Idle Timeout",
                         "type": "int",
-                        "hint": "CUA 沙箱生存时间（秒）。当前作为会话配置保存，具体生效取决于 CUA SDK。",
+                        "hint": "Idle timeout for CUA sandbox sessions in seconds. When greater than 0, AstrBot proactively shuts down an idle CUA sandbox after that amount of inactivity; 0 disables it.",
                         "condition": {
                             "provider_settings.computer_use_runtime": "sandbox",
                             "provider_settings.sandbox.booter": "cua",

dashboard/src/i18n/locales/en-US/features/config-metadata.json

@@ -194,9 +194,9 @@
             "description": "CUA OS Type",
             "hint": "CUA sandbox operating system type. Defaults to linux."
           },
-          "cua_ttl": {
-            "description": "CUA Sandbox TTL",
-            "hint": "CUA sandbox time-to-live in seconds. Actual behavior depends on the installed CUA SDK."
+          "cua_idle_timeout": {
+            "description": "CUA Idle Timeout",
+            "hint": "Idle timeout for CUA sandbox sessions in seconds. When greater than 0, AstrBot proactively shuts down an idle CUA sandbox after that amount of inactivity; 0 disables it."
           },
           "cua_telemetry_enabled": {
             "description": "CUA Telemetry",

dashboard/src/i18n/locales/ru-RU/features/config-metadata.json

@@ -194,9 +194,9 @@
                         "description": "Тип ОС CUA",
                         "hint": "Тип операционной системы песочницы CUA. По умолчанию linux."
                     },
-                    "cua_ttl": {
-                        "description": "TTL песочницы CUA",
-                        "hint": "Время жизни песочницы CUA в секундах. Фактическое поведение зависит от установленного CUA SDK."
+                    "cua_idle_timeout": {
+                        "description": "Таймаут простоя CUA",
+                        "hint": "Таймаут простоя сессии песочницы CUA в секундах. Если значение больше 0, AstrBot автоматически завершит неактивную песочницу CUA после указанного времени бездействия; 0 отключает автоочистку."
                     },
                     "cua_telemetry_enabled": {
                         "description": "Телеметрия CUA",

dashboard/src/i18n/locales/zh-CN/features/config-metadata.json

@@ -196,9 +196,9 @@
             "description": "CUA 操作系统类型",
             "hint": "CUA 沙箱操作系统类型，默认 linux。"
           },
-          "cua_ttl": {
-            "description": "CUA Sandbox 存活时间(秒)",
-            "hint": "CUA 沙箱生存时间（秒）。当前作为会话配置保存，具体生效取决于 CUA SDK。"
+          "cua_idle_timeout": {
+            "description": "CUA 空闲超时(秒)",
+            "hint": "CUA 沙箱空闲超时时间（秒）。大于 0 时，AstrBot 会在会话空闲达到该时长后主动关闭 CUA 沙箱；0 表示禁用。"
           },
           "cua_telemetry_enabled": {
             "description": "CUA 遥测",

tests/unit/test_cua_computer_use.py

@@ -273,8 +273,8 @@ def test_cua_default_config_matches_booter_defaults():
     assert booter.api_key == CUA_DEFAULT_CONFIG["api_key"]
     assert sandbox_defaults["cua_image"] == CUA_DEFAULT_CONFIG["image"]
     assert sandbox_defaults["cua_os_type"] == CUA_DEFAULT_CONFIG["os_type"]
-    assert sandbox_defaults["cua_ttl"] == CUA_DEFAULT_CONFIG["ttl"]
-    assert sandbox_defaults["cua_idle_timeout"] == 0
+    assert "cua_ttl" not in sandbox_defaults
+    assert sandbox_defaults["cua_idle_timeout"] == CUA_DEFAULT_CONFIG["idle_timeout"]
     assert (
         sandbox_defaults["cua_telemetry_enabled"]
         == CUA_DEFAULT_CONFIG["telemetry_enabled"]
@@ -1383,7 +1383,8 @@ def test_cua_is_exposed_in_sandbox_config_metadata():
     assert "CUA" in booter["labels"]
     assert "provider_settings.sandbox.cua_image" in items
     assert "provider_settings.sandbox.cua_os_type" in items
-    assert "provider_settings.sandbox.cua_ttl" in items
+    assert "provider_settings.sandbox.cua_ttl" not in items
+    assert "provider_settings.sandbox.cua_idle_timeout" in items
     assert "provider_settings.sandbox.cua_telemetry_enabled" in items
     assert "provider_settings.sandbox.cua_local" in items
     assert "provider_settings.sandbox.cua_api_key" in items