jarvis-ai-assistant 0.1.222__py3-none-any.whl → 0.7.0__py3-none-any.whl

jarvis/jarvis_utils/config.py

@@ -1,10 +1,9 @@
 # -*- coding: utf-8 -*-
 import os
 from functools import lru_cache
-from typing import Any, Dict, List
+from typing import Any, Dict, List, Optional, cast
 
-import torch
-import yaml  # type: ignore
+import yaml
 
 from jarvis.jarvis_utils.builtin_replace_map import BUILTIN_REPLACE_MAP
 
@@ -38,7 +37,7 @@ def get_git_commit_prompt() -> str:
     返回:
         str: Git提交信息生成提示模板，如果未配置则返回空字符串
     """
-    return GLOBAL_CONFIG_DATA.get("JARVIS_GIT_COMMIT_PROMPT", "")
+    return cast(str, GLOBAL_CONFIG_DATA.get("JARVIS_GIT_COMMIT_PROMPT", ""))
 
 
 # 输出窗口预留大小
@@ -77,24 +76,15 @@ def get_replace_map() -> dict:
         return {**BUILTIN_REPLACE_MAP, **file_map}
 
 
-def get_max_token_count() -> int:
-    """
-    获取模型允许的最大token数量。
-
-    返回:
-        int: 模型能处理的最大token数量。
-    """
-    return int(GLOBAL_CONFIG_DATA.get("JARVIS_MAX_TOKEN_COUNT", "960000"))
-
-
-def get_max_input_token_count() -> int:
+def get_max_input_token_count(model_group_override: Optional[str] = None) -> int:
     """
     获取模型允许的最大输入token数量。
 
     返回:
         int: 模型能处理的最大输入token数量。
     """
-    return int(GLOBAL_CONFIG_DATA.get("JARVIS_MAX_INPUT_TOKEN_COUNT", "32000"))
+    config = _get_resolved_model_config(model_group_override)
+    return int(config.get("JARVIS_MAX_INPUT_TOKEN_COUNT", "32000"))
 
 
 def get_shell_name() -> str:
@@ -111,51 +101,120 @@ def get_shell_name() -> str:
     4. 如果都未配置，则默认返回bash
     """
     shell_path = GLOBAL_CONFIG_DATA.get("SHELL", os.getenv("SHELL", "/bin/bash"))
-    return os.path.basename(shell_path).lower()
+    return cast(str, os.path.basename(shell_path).lower())
+
+
+def _apply_llm_group_env_override(group_config: Dict[str, Any]) -> None:
+    """如果模型组配置中包含ENV，则应用环境变量覆盖"""
+    if "ENV" in group_config and isinstance(group_config["ENV"], dict):
+        os.environ.update(
+            {str(k): str(v) for k, v in group_config["ENV"].items() if v is not None}
+        )
 
 
-def get_normal_platform_name() -> str:
+def _get_resolved_model_config(
+    model_group_override: Optional[str] = None,
+) -> Dict[str, Any]:
+    """
+    解析并合并模型配置，处理模型组。
+
+    优先级顺序:
+    - 当通过 model_group_override（例如命令行 -g/--llm-group）指定组时：
+        1. JARVIS_LLM_GROUP 中定义的组配置
+        2. 仅当组未提供对应键时，回退到顶层环境变量 (JARVIS_PLATFORM, JARVIS_MODEL, JARVIS_MAX_INPUT_TOKEN_COUNT)
+        3. 代码中的默认值
+    - 当未显式指定组时（使用默认组或未设置）：
+        1. 顶层环境变量 (JARVIS_PLATFORM, JARVIS_MODEL, JARVIS_MAX_INPUT_TOKEN_COUNT)
+        2. JARVIS_LLM_GROUP 中定义的组配置
+        3. 代码中的默认值
+
+    返回:
+        Dict[str, Any]: 解析后的模型配置字典
+    """
+    group_config = {}
+    model_group_name = model_group_override or GLOBAL_CONFIG_DATA.get(
+        "JARVIS_LLM_GROUP"
+    )
+    # The format is a list of single-key dicts: [{'group_name': {...}}, ...]
+    model_groups = GLOBAL_CONFIG_DATA.get("JARVIS_LLM_GROUPS", [])
+
+    if model_group_name and isinstance(model_groups, list):
+        for group_item in model_groups:
+            if isinstance(group_item, dict) and model_group_name in group_item:
+                group_config = group_item[model_group_name]
+                break
+    
+    _apply_llm_group_env_override(group_config)
+
+    # Start with group config
+    resolved_config = group_config.copy()
+
+    # 覆盖策略：
+    # - 若通过 CLI 传入了 model_group_override，则优先使用组内配置；
+    #   仅当组未提供对应键时，才回落到顶层 GLOBAL_CONFIG_DATA。
+    # - 若未传入 override（即使用默认组），保持原有行为：由顶层键覆盖组配置。
+    override_keys = [
+        "JARVIS_PLATFORM",
+        "JARVIS_MODEL",
+        "JARVIS_MAX_INPUT_TOKEN_COUNT",
+    ]
+    for key in override_keys:
+        if key in GLOBAL_CONFIG_DATA:
+            if model_group_override is None:
+                # 未显式指定组：顶层覆盖组
+                resolved_config[key] = GLOBAL_CONFIG_DATA[key]
+            else:
+                # 显式指定组：仅在组未定义该键时回退到顶层
+                if key not in resolved_config:
+                    resolved_config[key] = GLOBAL_CONFIG_DATA[key]
+
+    return resolved_config
+
+
+def get_normal_platform_name(model_group_override: Optional[str] = None) -> str:
     """
     获取正常操作的平台名称。
 
     返回：
         str: 平台名称，默认为'yuanbao'
     """
-    return GLOBAL_CONFIG_DATA.get("JARVIS_PLATFORM", "yuanbao")
+    config = _get_resolved_model_config(model_group_override)
+    return cast(str, config.get("JARVIS_PLATFORM", "yuanbao"))
 
 
-def get_normal_model_name() -> str:
+def get_normal_model_name(model_group_override: Optional[str] = None) -> str:
     """
     获取正常操作的模型名称。
 
     返回：
-        str: 模型名称，默认为'deep_seek'
+        str: 模型名称，默认为'deep_seek_v3'
     """
-    return GLOBAL_CONFIG_DATA.get("JARVIS_MODEL", "deep_seek_v3")
+    config = _get_resolved_model_config(model_group_override)
+    return cast(str, config.get("JARVIS_MODEL", "deep_seek_v3"))
 
 
-def get_thinking_platform_name() -> str:
+def _deprecated_platform_name_v1(model_group_override: Optional[str] = None) -> str:
     """
     获取思考操作的平台名称。
 
     返回：
-        str: 平台名称，默认为'yuanbao'
+        str: 平台名称，默认为正常操作平台
     """
-    return GLOBAL_CONFIG_DATA.get(
-        "JARVIS_THINKING_PLATFORM", GLOBAL_CONFIG_DATA.get("JARVIS_PLATFORM", "yuanbao")
-    )
+    _get_resolved_model_config(model_group_override)
+    # Fallback to normal platform if thinking platform is not specified
+    return get_normal_platform_name(model_group_override)
 
 
-def get_thinking_model_name() -> str:
+def _deprecated_model_name_v1(model_group_override: Optional[str] = None) -> str:
     """
     获取思考操作的模型名称。
 
     返回：
-        str: 模型名称，默认为'deep_seek'
+        str: 模型名称，默认为正常操作模型
     """
-    return GLOBAL_CONFIG_DATA.get(
-        "JARVIS_THINKING_MODEL", GLOBAL_CONFIG_DATA.get("JARVIS_MODEL", "deep_seek")
-    )
+    _get_resolved_model_config(model_group_override)
+    # Fallback to normal model if thinking model is not specified
+    return get_normal_model_name(model_group_override)
 
 
 def is_execute_tool_confirm() -> bool:
@@ -165,7 +224,7 @@ def is_execute_tool_confirm() -> bool:
     返回：
         bool: 如果需要确认则返回True，默认为False
     """
-    return GLOBAL_CONFIG_DATA.get("JARVIS_EXECUTE_TOOL_CONFIRM", False) == True
+    return cast(bool, GLOBAL_CONFIG_DATA.get("JARVIS_EXECUTE_TOOL_CONFIRM", False))
 
 
 def is_confirm_before_apply_patch() -> bool:
@@ -175,7 +234,24 @@ def is_confirm_before_apply_patch() -> bool:
     返回：
         bool: 如果需要确认则返回True，默认为False
     """
-    return GLOBAL_CONFIG_DATA.get("JARVIS_CONFIRM_BEFORE_APPLY_PATCH", False) == True
+    return cast(bool, GLOBAL_CONFIG_DATA.get("JARVIS_CONFIRM_BEFORE_APPLY_PATCH", False))
+
+
+def get_patch_format() -> str:
+    """
+    获取补丁格式。
+
+    - "search": 仅使用精确匹配的 `SEARCH` 模式。此模式对能力较弱的模型更稳定，因为它要求代码片段完全匹配。
+    - "search_range": 仅使用 `SEARCH_START` 和 `SEARCH_END` 的范围匹配模式。此模式对能力较强的模型更灵活，因为它允许在代码块内部进行修改，而不要求整个块完全匹配。
+    - "all": 同时支持以上两种模式（默认）。
+
+    返回:
+        str: "all", "search", or "search_range"
+    """
+    mode = GLOBAL_CONFIG_DATA.get("JARVIS_PATCH_FORMAT", "all")
+    if mode in ["all", "search", "search_range"]:
+        return cast(str, mode)
+    return "all"
 
 
 def get_data_dir() -> str:
@@ -187,18 +263,19 @@ def get_data_dir() -> str:
              如果未设置或为空，则使用~/.jarvis作为默认值
     """
     return os.path.expanduser(
-        GLOBAL_CONFIG_DATA.get("JARVIS_DATA_PATH", "~/.jarvis").strip()
+        cast(str, GLOBAL_CONFIG_DATA.get("JARVIS_DATA_PATH", "~/.jarvis")).strip()
     )
 
 
-def get_max_big_content_size() -> int:
+def get_max_big_content_size(model_group_override: Optional[str] = None) -> int:
     """
     获取最大大内容大小。
 
     返回：
-        int: 最大大内容大小
+        int: 最大大内容大小，为最大输入token数量的5倍
     """
-    return int(GLOBAL_CONFIG_DATA.get("JARVIS_MAX_BIG_CONTENT_SIZE", "160000"))
+    max_input_tokens = get_max_input_token_count(model_group_override)
+    return max_input_tokens * 5
 
 
 def get_pretty_output() -> bool:
@@ -208,7 +285,13 @@ def get_pretty_output() -> bool:
     返回：
         bool: 如果启用PrettyOutput则返回True，默认为True
     """
-    return GLOBAL_CONFIG_DATA.get("JARVIS_PRETTY_OUTPUT", False) == True
+    import platform
+
+    # Windows系统强制设置为False
+    if platform.system() == "Windows":
+        return False
+
+    return cast(bool, GLOBAL_CONFIG_DATA.get("JARVIS_PRETTY_OUTPUT", True))
 
 
 def is_use_methodology() -> bool:
@@ -218,7 +301,7 @@ def is_use_methodology() -> bool:
     返回：
         bool: 如果启用方法论则返回True，默认为True
     """
-    return GLOBAL_CONFIG_DATA.get("JARVIS_USE_METHODOLOGY", True) == True
+    return cast(bool, GLOBAL_CONFIG_DATA.get("JARVIS_USE_METHODOLOGY", True))
 
 
 def is_use_analysis() -> bool:
@@ -228,7 +311,111 @@ def is_use_analysis() -> bool:
     返回：
         bool: 如果启用任务分析则返回True，默认为True
     """
-    return GLOBAL_CONFIG_DATA.get("JARVIS_USE_ANALYSIS", True) == True
+    return cast(bool, GLOBAL_CONFIG_DATA.get("JARVIS_USE_ANALYSIS", True))
+
+
+def get_tool_load_dirs() -> List[str]:
+    """
+    获取工具加载目录。
+
+    返回:
+        List[str]: 工具加载目录列表
+    """
+    return [
+        os.path.expanduser(os.path.expandvars(str(p)))
+        for p in GLOBAL_CONFIG_DATA.get("JARVIS_TOOL_LOAD_DIRS", [])
+        if p
+    ]
+
+
+def get_methodology_dirs() -> List[str]:
+    """
+    获取方法论加载目录。
+
+    返回:
+        List[str]: 方法论加载目录列表
+    """
+    return [
+        os.path.expanduser(os.path.expandvars(str(p)))
+        for p in GLOBAL_CONFIG_DATA.get("JARVIS_METHODOLOGY_DIRS", [])
+        if p
+    ]
+
+
+def get_agent_definition_dirs() -> List[str]:
+    """
+    获取 agent 定义的加载目录。
+
+    返回:
+        List[str]: agent 定义加载目录列表
+    """
+    return [
+        os.path.expanduser(os.path.expandvars(str(p)))
+        for p in GLOBAL_CONFIG_DATA.get("JARVIS_AGENT_DEFINITION_DIRS", [])
+        if p
+    ]
+
+
+def get_multi_agent_dirs() -> List[str]:
+    """
+    获取 multi_agent 的加载目录。
+
+    返回:
+        List[str]: multi_agent 加载目录列表
+    """
+    return [
+        os.path.expanduser(os.path.expandvars(str(p)))
+        for p in GLOBAL_CONFIG_DATA.get("JARVIS_MULTI_AGENT_DIRS", [])
+        if p
+    ]
+
+
+def get_roles_dirs() -> List[str]:
+    """
+    获取 roles 的加载目录。
+
+    返回:
+        List[str]: roles 加载目录列表
+    """
+    return [
+        os.path.expanduser(os.path.expandvars(str(p)))
+        for p in GLOBAL_CONFIG_DATA.get("JARVIS_ROLES_DIRS", [])
+        if p
+    ]
+
+
+def get_after_tool_call_cb_dirs() -> List[str]:
+    """
+    获取工具调用后回调函数实现目录。
+
+    返回:
+        List[str]: 工具调用后回调函数实现目录列表
+    """
+    return [
+        os.path.expanduser(os.path.expandvars(str(p)))
+        for p in GLOBAL_CONFIG_DATA.get("JARVIS_AFTER_TOOL_CALL_CB_DIRS", [])
+        if p
+    ]
+
+
+def get_central_methodology_repo() -> str:
+    """
+    获取中心方法论Git仓库地址。
+
+    返回:
+        str: 中心方法论Git仓库地址，如果未配置则返回空字符串
+    """
+    return cast(str, GLOBAL_CONFIG_DATA.get("JARVIS_CENTRAL_METHODOLOGY_REPO", ""))
+
+
+def get_central_tool_repo() -> str:
+    """
+    获取中心工具Git仓库地址。
+
+    返回:
+        str: 中心工具Git仓库地址，如果未配置则返回空字符串
+    """
+    return cast(str, GLOBAL_CONFIG_DATA.get("JARVIS_CENTRAL_TOOL_REPO", ""))
 
 
 def is_print_prompt() -> bool:
@@ -238,7 +425,27 @@ def is_print_prompt() -> bool:
     返回：
         bool: 如果打印提示则返回True，默认为True
     """
-    return GLOBAL_CONFIG_DATA.get("JARVIS_PRINT_PROMPT", False) == True
+    return cast(bool, GLOBAL_CONFIG_DATA.get("JARVIS_PRINT_PROMPT", False))
+
+
+def is_print_error_traceback() -> bool:
+    """
+    获取是否在错误输出时打印回溯调用链。
+
+    返回：
+        bool: 如果打印回溯则返回True，默认为False（不打印）
+    """
+    return GLOBAL_CONFIG_DATA.get("JARVIS_PRINT_ERROR_TRACEBACK", False) is True
+
+
+def is_force_save_memory() -> bool:
+    """
+    获取是否强制保存记忆。
+
+    返回：
+        bool: 如果强制保存记忆则返回True，默认为False
+    """
+    return GLOBAL_CONFIG_DATA.get("JARVIS_FORCE_SAVE_MEMORY", False) is True
 
 
 def is_enable_static_analysis() -> bool:
@@ -251,6 +458,50 @@ def is_enable_static_analysis() -> bool:
     return GLOBAL_CONFIG_DATA.get("JARVIS_ENABLE_STATIC_ANALYSIS", True) is True
 
 
+def is_enable_build_validation() -> bool:
+    """
+    获取是否启用构建验证。
+
+    返回：
+        bool: 如果启用构建验证则返回True，默认为True
+    """
+    return GLOBAL_CONFIG_DATA.get("JARVIS_ENABLE_BUILD_VALIDATION", True) is True
+
+
+def is_enable_impact_analysis() -> bool:
+    """
+    获取是否启用编辑影响范围分析。
+
+    返回：
+        bool: 如果启用影响范围分析则返回True，默认为True
+    """
+    return GLOBAL_CONFIG_DATA.get("JARVIS_ENABLE_IMPACT_ANALYSIS", True) is True
+
+
+def get_build_validation_timeout() -> int:
+    """
+    获取构建验证的超时时间（秒）。
+
+    返回：
+        int: 超时时间，默认为30秒
+    """
+    return int(GLOBAL_CONFIG_DATA.get("JARVIS_BUILD_VALIDATION_TIMEOUT", 30))
+
+
+def get_git_check_mode() -> str:
+    """
+    获取Git校验模式。
+
+    返回:
+        str: "strict" 或 "warn"，默认为 "strict"
+    """
+    mode = GLOBAL_CONFIG_DATA.get("JARVIS_GIT_CHECK_MODE", "strict")
+    try:
+        return str(mode)
+    except Exception:
+        return "strict"
+
+
 def get_mcp_config() -> List[Dict[str, Any]]:
     """
     获取MCP配置列表。
@@ -258,7 +509,7 @@ def get_mcp_config() -> List[Dict[str, Any]]:
     返回:
         List[Dict[str, Any]]: MCP配置项列表，如果未配置则返回空列表
     """
-    return GLOBAL_CONFIG_DATA.get("JARVIS_MCP", [])
+    return cast(List[Dict[str, Any]], GLOBAL_CONFIG_DATA.get("JARVIS_MCP", []))
 
 
 # ==============================================================================
@@ -266,14 +517,65 @@ def get_mcp_config() -> List[Dict[str, Any]]:
 # ==============================================================================
 
 
-def get_rag_config() -> Dict[str, Any]:
-    """
-    获取RAG框架的配置。
+DEFAULT_RAG_GROUPS = [
+    {
+        "text": {
+            "embedding_model": "BAAI/bge-m3",
+            "rerank_model": "BAAI/bge-reranker-v2-m3",
+            "use_bm25": True,
+            "use_rerank": True,
+        }
+    },
+    {
+        "code": {
+            "embedding_model": "Qodo/Qodo-Embed-1-1.5B",
+            "use_bm25": False,
+            "use_rerank": False,
+        }
+    },
+]
+
+
+def _get_resolved_rag_config(
+    rag_group_override: Optional[str] = None,
+) -> Dict[str, Any]:
+    """
+    解析并合并RAG配置，处理RAG组。
+
+    优先级顺序:
+    1. JARVIS_RAG 中的顶级设置 (embedding_model, etc.)
+    2. JARVIS_RAG_GROUP 中定义的组配置
+    3. 代码中的默认值
 
     返回:
-        Dict[str, Any]: RAG配置字典
+        Dict[str, Any]: 解析后的RAG配置字典
     """
-    return GLOBAL_CONFIG_DATA.get("JARVIS_RAG", {})
+    group_config = {}
+    rag_group_name = rag_group_override or GLOBAL_CONFIG_DATA.get("JARVIS_RAG_GROUP")
+    rag_groups = GLOBAL_CONFIG_DATA.get("JARVIS_RAG_GROUPS", DEFAULT_RAG_GROUPS)
+
+    if rag_group_name and isinstance(rag_groups, list):
+        for group_item in rag_groups:
+            if isinstance(group_item, dict) and rag_group_name in group_item:
+                group_config = group_item[rag_group_name]
+                break
+
+    # Start with group config
+    resolved_config = group_config.copy()
+
+    # Override with specific settings from the top-level JARVIS_RAG dict
+    top_level_rag_config = GLOBAL_CONFIG_DATA.get("JARVIS_RAG", {})
+    if isinstance(top_level_rag_config, dict):
+        for key in [
+            "embedding_model",
+            "rerank_model",
+            "use_bm25",
+            "use_rerank",
+        ]:
+            if key in top_level_rag_config:
+                resolved_config[key] = top_level_rag_config[key]
+
+    return resolved_config
 
 
 def get_rag_embedding_model() -> str:
@@ -283,7 +585,8 @@ def get_rag_embedding_model() -> str:
     返回:
         str: 嵌入模型的名称
     """
-    return get_rag_config().get("embedding_model", "BAAI/bge-base-zh-v1.5")
+    config = _get_resolved_rag_config()
+    return cast(str, config.get("embedding_model", "BAAI/bge-m3"))
 
 
 def get_rag_rerank_model() -> str:
@@ -293,7 +596,8 @@ def get_rag_rerank_model() -> str:
     返回:
         str: rerank模型的名称
     """
-    return get_rag_config().get("rerank_model", "BAAI/bge-reranker-base")
+    config = _get_resolved_rag_config()
+    return cast(str, config.get("rerank_model", "BAAI/bge-reranker-v2-m3"))
 
 
 def get_rag_embedding_cache_path() -> str:
@@ -314,3 +618,256 @@ def get_rag_vector_db_path() -> str:
         str: 数据库路径
     """
     return ".jarvis/rag/vectordb"
+
+
+def get_rag_use_bm25() -> bool:
+    """
+    获取RAG是否使用BM25。
+
+    返回:
+        bool: 如果使用BM25则返回True，默认为True
+    """
+    config = _get_resolved_rag_config()
+    return config.get("use_bm25", True) is True
+
+
+def get_rag_use_rerank() -> bool:
+    """
+    获取RAG是否使用rerank。
+
+    返回:
+        bool: 如果使用rerank则返回True，默认为True
+    """
+    config = _get_resolved_rag_config()
+    return config.get("use_rerank", True) is True
+
+
+# ==============================================================================
+# Web Search Configuration
+# ==============================================================================
+
+
+def get_web_search_platform_name() -> Optional[str]:
+    """
+    获取Web搜索使用的平台名称。
+
+    返回:
+        Optional[str]: 平台名称，如果未配置则返回None
+    """
+    return GLOBAL_CONFIG_DATA.get("JARVIS_WEB_SEARCH_PLATFORM")
+
+
+def get_web_search_model_name() -> Optional[str]:
+    """
+    获取Web搜索使用的模型名称。
+
+    返回:
+        Optional[str]: 模型名称，如果未配置则返回None
+    """
+    return GLOBAL_CONFIG_DATA.get("JARVIS_WEB_SEARCH_MODEL")
+
+
+# ==============================================================================
+# Tool Configuration
+# ==============================================================================
+
+
+def _get_resolved_tool_config(
+    tool_group_override: Optional[str] = None,
+) -> Dict[str, Any]:
+    """
+    解析并合并工具配置，处理工具组。
+
+    优先级顺序:
+    1. JARVIS_TOOL_GROUP 中定义的组配置
+    2. 默认配置（所有工具都启用）
+
+    返回:
+        Dict[str, Any]: 解析后的工具配置字典，包含 'use' 和 'dont_use' 列表
+    """
+    group_config = {}
+    tool_group_name = tool_group_override or GLOBAL_CONFIG_DATA.get("JARVIS_TOOL_GROUP")
+    tool_groups = GLOBAL_CONFIG_DATA.get("JARVIS_TOOL_GROUPS", [])
+
+    if tool_group_name and isinstance(tool_groups, list):
+        for group_item in tool_groups:
+            if isinstance(group_item, dict) and tool_group_name in group_item:
+                group_config = group_item[tool_group_name]
+                break
+
+    # 如果没有找到配置组，返回默认配置（空列表表示使用所有工具）
+    return group_config.copy() if group_config else {"use": [], "dont_use": []}
+
+
+def get_tool_use_list() -> List[str]:
+    """
+    获取要使用的工具列表。
+
+    返回:
+        List[str]: 要使用的工具名称列表，空列表表示使用所有工具
+    """
+    config = _get_resolved_tool_config()
+    return cast(List[str], config.get("use", []))
+
+
+def get_tool_dont_use_list() -> List[str]:
+    """
+    获取不使用的工具列表。
+
+    返回:
+        List[str]: 不使用的工具名称列表
+    """
+    config = _get_resolved_tool_config()
+    return cast(List[str], config.get("dont_use", []))
+
+
+def get_tool_filter_threshold() -> int:
+    """
+    获取AI工具筛选的阈值。
+
+    返回:
+        int: 当工具数量超过此阈值时，触发AI筛选。默认为30
+    """
+    return int(GLOBAL_CONFIG_DATA.get("JARVIS_TOOL_FILTER_THRESHOLD", 30))
+
+def get_plan_max_depth() -> int:
+    """
+    获取任务规划的最大层数。
+    
+    返回:
+        int: 最大规划层数，默认为2（可通过 GLOBAL_CONFIG_DATA['JARVIS_PLAN_MAX_DEPTH'] 配置）
+    """
+    try:
+        return int(GLOBAL_CONFIG_DATA.get("JARVIS_PLAN_MAX_DEPTH", 2))
+    except Exception:
+        return 2
+
+
+def is_plan_enabled() -> bool:
+    """
+    获取是否默认启用任务规划。
+
+    返回:
+        bool: 如果启用任务规划则返回True，默认为True
+    """
+    return GLOBAL_CONFIG_DATA.get("JARVIS_PLAN_ENABLED", True) is True
+
+
+def get_auto_summary_rounds() -> int:
+    """
+    获取基于对话轮次的自动总结阈值。
+
+    返回:
+        int: 轮次阈值，默认20
+    """
+    try:
+        return int(GLOBAL_CONFIG_DATA.get("JARVIS_AUTO_SUMMARY_ROUNDS", 50))
+    except Exception:
+        return 50
+
+
+
+
+
+def get_script_execution_timeout() -> int:
+    """
+    获取脚本执行的超时时间（秒）。
+
+    返回:
+        int: 超时时间，默认为300秒（5分钟）
+    """
+    return int(GLOBAL_CONFIG_DATA.get("JARVIS_SCRIPT_EXECUTION_TIMEOUT", 300))
+
+
+def is_enable_git_repo_jca_switch() -> bool:
+    """
+    是否启用：在初始化环境前检测Git仓库并提示可切换到代码开发模式（jca）
+    默认开启
+    """
+    return GLOBAL_CONFIG_DATA.get("JARVIS_ENABLE_GIT_JCA_SWITCH", True) is True
+
+
+def is_enable_builtin_config_selector() -> bool:
+    """
+    是否启用：在进入默认通用代理前，列出可用配置（agent/multi_agent/roles）供选择
+    默认开启
+    """
+    return (
+        GLOBAL_CONFIG_DATA.get("JARVIS_ENABLE_STARTUP_CONFIG_SELECTOR", True) is True
+    )
+
+
+def is_save_session_history() -> bool:
+    """
+    是否保存会话记录。
+
+    返回:
+        bool: 如果要保存会话记录则返回True, 默认为False
+    """
+    return GLOBAL_CONFIG_DATA.get("JARVIS_SAVE_SESSION_HISTORY", False) is True
+
+
+def is_immediate_abort() -> bool:
+    """
+    是否启用立即中断：当在对话过程中检测到用户中断信号时，立即停止输出并返回。
+    默认关闭
+    """
+    return GLOBAL_CONFIG_DATA.get("JARVIS_IMMEDIATE_ABORT", False) is True
+
+
+def is_non_interactive() -> bool:
+    """
+    获取是否启用非交互模式。
+    
+    返回：
+        bool: 如果启用非交互模式则返回True，默认为False
+    """
+    # 优先读取环境变量，确保 CLI 标志生效且不被配置覆盖
+    try:
+        import os
+        v = os.getenv("JARVIS_NON_INTERACTIVE")
+        if v is not None:
+            val = str(v).strip().lower()
+            if val in ("1", "true", "yes", "on"):
+                return True
+            if val in ("0", "false", "no", "off"):
+                return False
+    except Exception:
+        # 忽略环境变量解析异常，回退到配置
+        pass
+    return GLOBAL_CONFIG_DATA.get("JARVIS_NON_INTERACTIVE", False) is True
+
+
+def is_skip_predefined_tasks() -> bool:
+    """
+    是否跳过预定义任务加载。
+    
+    返回：
+        bool: 如果跳过预定义任务加载则返回True，默认为False
+    """
+    return GLOBAL_CONFIG_DATA.get("JARVIS_SKIP_PREDEFINED_TASKS", False) is True
+
+
+def get_addon_prompt_threshold() -> int:
+    """
+    获取附加提示的触发阈值（字符数）。
+    
+    当消息长度超过此阈值时，会自动添加默认的附加提示。
+    
+    返回:
+        int: 触发阈值，默认为1024
+    """
+    try:
+        return int(GLOBAL_CONFIG_DATA.get("JARVIS_ADDON_PROMPT_THRESHOLD", 1024))
+    except Exception:
+        return 1024
+
+
+def is_enable_intent_recognition() -> bool:
+    """
+    获取是否启用意图识别功能。
+    
+    返回:
+        bool: 是否启用意图识别，默认为True（可通过 GLOBAL_CONFIG_DATA['JARVIS_ENABLE_INTENT_RECOGNITION'] 配置）
+    """
+    return GLOBAL_CONFIG_DATA.get("JARVIS_ENABLE_INTENT_RECOGNITION", True) is True