jarvis-ai-assistant 0.7.8__py3-none-any.whl → 1.0.2__py3-none-any.whl

jarvis/jarvis_data/config_schema.json

@@ -4,7 +4,7 @@
   "description": "Jarvis系统配置模式",
   "type": "object",
   "properties": {
-    "JARVIS_MCP": {
+    "mcp": {
       "type": "array",
       "description": "MCP工具配置列表",
       "default": [],
@@ -13,17 +13,11 @@
         "oneOf": [
           {
             "type": "object",
-            "required": [
-              "type",
-              "base_url"
-            ],
+            "required": ["type", "base_url"],
             "properties": {
               "type": {
                 "type": "string",
-                "enum": [
-                  "sse",
-                  "streamable"
-                ],
+                "enum": ["sse", "streamable"],
                 "description": "MCP客户端类型"
               },
               "base_url": {
@@ -55,16 +49,11 @@
           },
           {
             "type": "object",
-            "required": [
-              "type",
-              "command"
-            ],
+            "required": ["type", "command"],
             "properties": {
               "type": {
                 "type": "string",
-                "enum": [
-                  "stdio"
-                ],
+                "enum": ["stdio"],
                 "description": "MCP客户端类型"
               },
               "command": {
@@ -107,154 +96,240 @@
       },
       "default": {}
     },
-    "JARVIS_GIT_COMMIT_PROMPT": {
+    "git_commit_prompt": {
       "type": "string",
       "description": "Git提交信息生成提示模板",
       "default": ""
     },
-    "JARVIS_MAX_INPUT_TOKEN_COUNT": {
+    "max_input_token_count": {
       "type": "number",
       "description": "模型能处理的最大输入token数量。其他token限制基于此值计算：最大token数量=此值×100，最大大内容尺寸=此值×5",
       "default": 32000
     },
-    "JARVIS_PLATFORM": {
+    "platform": {
       "type": "string",
       "description": "常规操作平台名称",
       "default": "openai"
     },
-    "JARVIS_MODEL": {
+    "model": {
       "type": "string",
       "description": "常规操作模型名称",
       "default": "gpt-5"
     },
-    "JARVIS_CHEAP_PLATFORM": {
+    "cheap_platform": {
       "type": "string",
-      "description": "廉价操作的平台名称。如未配置，则使用 JARVIS_PLATFORM 的值",
+      "description": "廉价操作的平台名称。如未配置，则使用 platform 的值",
       "default": ""
     },
-    "JARVIS_CHEAP_MODEL": {
+    "cheap_model": {
       "type": "string",
-      "description": "廉价操作的模型名称。如未配置，则使用 JARVIS_MODEL 的值",
+      "description": "廉价操作的模型名称。如未配置，则使用 model 的值",
       "default": ""
     },
-    "JARVIS_SMART_PLATFORM": {
+    "cheap_max_input_token_count": {
+      "type": "number",
+      "description": "廉价模型允许的最大输入token数量。如未配置，则使用 max_input_token_count 的值",
+      "default": 0
+    },
+    "smart_platform": {
       "type": "string",
-      "description": "智能操作的平台名称。如未配置，则使用 JARVIS_PLATFORM 的值",
+      "description": "智能操作的平台名称。如未配置，则使用 platform 的值",
       "default": ""
     },
-    "JARVIS_SMART_MODEL": {
+    "smart_model": {
       "type": "string",
-      "description": "智能操作的模型名称。如未配置，则使用 JARVIS_MODEL 的值",
+      "description": "智能操作的模型名称。如未配置，则使用 model 的值",
       "default": ""
     },
-    "JARVIS_WEB_SEARCH_PLATFORM": {
+    "smart_max_input_token_count": {
+      "type": "number",
+      "description": "智能模型允许的最大输入token数量。如未配置，则使用 max_input_token_count 的值",
+      "default": 0
+    },
+    "web_search_platform": {
       "type": "string",
       "description": "Web搜索使用的平台名称",
       "default": ""
     },
-    "JARVIS_WEB_SEARCH_MODEL": {
+    "web_search_model": {
       "type": "string",
       "description": "Web搜索使用的模型名称",
       "default": ""
     },
-    "JARVIS_LLM_GROUP": {
+    "llms": {
+      "type": "object",
+      "description": "可复用的LLM配置定义，可以在llm_groups中通过引用名称来使用",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "platform": {
+            "type": "string",
+            "description": "平台名称",
+            "default": "openai"
+          },
+          "model": {
+            "type": "string",
+            "description": "模型名称"
+          },
+          "max_input_token_count": {
+            "type": "number",
+            "description": "最大输入token数量",
+            "default": 32000
+          },
+          "llm_config": {
+            "type": "object",
+            "description": "LLM特定的配置参数，会传递给LLM客户端",
+            "additionalProperties": true,
+            "default": {}
+          }
+        },
+        "required": [
+          "platform",
+          "model"
+        ]
+      },
+      "default": {}
+    },
+    "embeddings": {
+      "type": "object",
+      "description": "可复用的嵌入模型配置定义，可以在rag_groups中通过引用名称来使用",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "embedding_model": {
+            "type": "string",
+            "description": "嵌入模型的名称"
+          },
+          "embedding_type": {
+            "type": "string",
+            "description": "嵌入模型的实现类型，如 'LocalEmbeddingModel', 'OpenAIEmbeddingModel', 'CohereEmbeddingModel', 'EdgeFnEmbeddingModel' 等"
+          },
+          "embedding_max_length": {
+            "type": "number",
+            "description": "嵌入模型的最大输入长度（token数），用于文档分割"
+          },
+          "embedding_config": {
+            "type": "object",
+            "description": "嵌入模型的额外配置参数，会传递给模型的构造函数",
+            "additionalProperties": true,
+            "default": {}
+          }
+        },
+        "required": [
+          "embedding_model",
+          "embedding_type"
+        ]
+      },
+      "default": {}
+    },
+    "rerankers": {
+      "type": "object",
+      "description": "可复用的重排模型配置定义，可以在rag_groups中通过引用名称来使用",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "rerank_model": {
+            "type": "string",
+            "description": "重排模型的名称"
+          },
+          "reranker_type": {
+            "type": "string",
+            "description": "重排模型的实现类型，如 'LocalReranker', 'CohereReranker', 'JinaReranker', 'EdgeFnReranker' 等"
+          },
+          "reranker_max_length": {
+            "type": "number",
+            "description": "重排模型的最大输入长度（token数）"
+          },
+          "reranker_config": {
+            "type": "object",
+            "description": "重排模型的额外配置参数，会传递给模型的构造函数",
+            "additionalProperties": true,
+            "default": {}
+          }
+        },
+        "required": [
+          "rerank_model",
+          "reranker_type"
+        ]
+      },
+      "default": {}
+    },
+    "llm_group": {
       "type": "string",
       "description": "选择一个预定义的模型组",
       "default": ""
     },
-    "JARVIS_LLM_GROUPS": {
-      "type": "array",
-      "description": "预定义的模型配置组",
-      "default": [],
-      "items": {
+    "llm_groups": {
+      "type": "object",
+      "description": "预定义的模型配置组，使用组名作为 key。每个组必须通过 normal_llm、cheap_llm、smart_llm 引用 llms 中定义的配置，不再支持直接定义 platform、model 等参数",
+      "additionalProperties": {
         "type": "object",
-        "additionalProperties": {
-          "type": "object",
-          "properties": {
-            "JARVIS_PLATFORM": {
-              "type": "string",
-              "default": "openai"
-            },
-            "JARVIS_MODEL": {
-              "type": "string",
-              "default": "gpt-5"
-            },
-            "JARVIS_MAX_INPUT_TOKEN_COUNT": {
-              "type": "number",
-              "default": 32000
-            },
-            "JARVIS_CHEAP_PLATFORM": {
-              "type": "string",
-              "description": "廉价操作的平台名称。如未配置，则使用 JARVIS_PLATFORM 的值"
-            },
-            "JARVIS_CHEAP_MODEL": {
-              "type": "string",
-              "description": "廉价操作的模型名称。如未配置，则使用 JARVIS_MODEL 的值"
-            },
-            "JARVIS_SMART_PLATFORM": {
-              "type": "string",
-              "description": "智能操作的平台名称。如未配置，则使用 JARVIS_PLATFORM 的值"
-            },
-            "JARVIS_SMART_MODEL": {
-              "type": "string",
-              "description": "智能操作的模型名称。如未配置，则使用 JARVIS_MODEL 的值"
-            },
-            "ENV": {
-              "type": "object",
-              "description": "该模型组特定的环境变量，会覆盖全局 ENV 配置",
-              "additionalProperties": {
-                "type": "string"
-              }
-            }
+        "properties": {
+          "normal_llm": {
+            "type": "string",
+            "description": "引用 llms 中定义的常规操作LLM配置名称（必需）"
           },
-          "required": [
-            "JARVIS_PLATFORM",
-            "JARVIS_MODEL"
-          ]
-        }
-      }
+          "cheap_llm": {
+            "type": "string",
+            "description": "引用 llms 中定义的廉价操作LLM配置名称（可选）"
+          },
+          "smart_llm": {
+            "type": "string",
+            "description": "引用 llms 中定义的智能操作LLM配置名称（可选）"
+          },
+          "ENV": {
+            "type": "object",
+            "description": "该模型组特定的环境变量，会覆盖全局 ENV 配置",
+            "additionalProperties": {
+              "type": "string"
+            }
+          }
+        },
+        "required": ["normal_llm"]
+      },
+      "default": {}
     },
-    "JARVIS_EXECUTE_TOOL_CONFIRM": {
+    "execute_tool_confirm": {
       "type": "boolean",
       "description": "执行工具前是否需要确认",
       "default": false
     },
-    "JARVIS_TOOL_FILTER_THRESHOLD": {
+    "tool_filter_threshold": {
       "type": "number",
       "description": "AI工具筛选阈值：当可用工具数量超过此值时触发AI筛选",
       "default": 30
     },
-    "JARVIS_SCRIPT_EXECUTION_TIMEOUT": {
+    "script_execution_timeout": {
       "type": "number",
       "description": "脚本执行的超时时间（秒），仅在非交互模式下生效。",
       "default": 300
     },
-    "JARVIS_CONFIRM_BEFORE_APPLY_PATCH": {
+    "confirm_before_apply_patch": {
       "type": "boolean",
       "description": "应用补丁前是否需要确认",
       "default": false
     },
-    "JARVIS_DATA_PATH": {
+    "data_path": {
       "type": "string",
       "description": "Jarvis数据存储目录路径",
       "default": "~/.jarvis"
     },
-    "JARVIS_PRETTY_OUTPUT": {
+    "pretty_output": {
       "type": "boolean",
       "description": "是否启用美化输出",
       "default": true
     },
-    "JARVIS_USE_METHODOLOGY": {
+    "use_methodology": {
       "type": "boolean",
       "description": "是否启用方法论",
       "default": true
     },
-    "JARVIS_USE_ANALYSIS": {
+    "use_analysis": {
       "type": "boolean",
       "description": "是否启用任务分析",
       "default": true
     },
-    "JARVIS_TOOL_LOAD_DIRS": {
+    "tool_load_dirs": {
       "type": "array",
       "description": "自定义工具加载目录",
       "items": {
@@ -262,7 +337,7 @@
       },
       "default": []
     },
-    "JARVIS_METHODOLOGY_DIRS": {
+    "methodology_dirs": {
       "type": "array",
       "description": "方法论加载目录",
       "items": {
@@ -270,7 +345,7 @@
       },
       "default": []
     },
-    "JARVIS_AGENT_DEFINITION_DIRS": {
+    "agent_definition_dirs": {
       "type": "array",
       "description": "agent 定义加载目录",
       "items": {
@@ -278,7 +353,7 @@
       },
       "default": []
     },
-    "JARVIS_MULTI_AGENT_DIRS": {
+    "multi_agent_dirs": {
       "type": "array",
       "description": "multi_agent 加载目录",
       "items": {
@@ -286,7 +361,7 @@
       },
       "default": []
     },
-    "JARVIS_ROLES_DIRS": {
+    "roles_dirs": {
       "type": "array",
       "description": "roles 加载目录",
       "items": {
@@ -294,7 +369,7 @@
       },
       "default": []
     },
-    "JARVIS_AFTER_TOOL_CALL_CB_DIRS": {
+    "after_tool_call_cb_dirs": {
       "type": "array",
       "description": "工具调用后回调函数实现目录",
       "items": {
@@ -302,103 +377,97 @@
       },
       "default": []
     },
-    "JARVIS_CENTRAL_METHODOLOGY_REPO": {
+    "central_methodology_repo": {
       "type": "string",
       "description": "中心方法论仓库路径或Git仓库地址。支持本地目录（含git子路径）：若为本地目录将直接加入方法论加载路径；若为Git URL则会克隆到数据目录后加载。",
       "default": ""
     },
-    "JARVIS_CENTRAL_TOOL_REPO": {
+    "central_tool_repo": {
       "type": "string",
       "description": "中心工具仓库路径或Git仓库地址。支持本地目录（含git子路径）：若为本地目录将直接加载其中的工具；若为Git URL则会克隆到数据目录并加载。",
       "default": ""
     },
-    "JARVIS_PRINT_PROMPT": {
+    "print_prompt": {
       "type": "boolean",
       "description": "是否打印提示",
       "default": false
     },
-    "JARVIS_PRINT_ERROR_TRACEBACK": {
+    "print_error_traceback": {
       "type": "boolean",
       "description": "是否在错误输出时打印回溯调用链",
       "default": false
     },
-    "JARVIS_ENABLE_STATIC_ANALYSIS": {
+    "enable_static_analysis": {
       "type": "boolean",
       "description": "是否启用静态代码分析",
       "default": true
     },
-    "JARVIS_ENABLE_BUILD_VALIDATION": {
+    "enable_build_validation": {
       "type": "boolean",
       "description": "是否启用构建验证。在代码编辑后自动验证代码能否成功编译/构建，确保编辑不会破坏项目构建。",
       "default": true
     },
-    "JARVIS_BUILD_VALIDATION_TIMEOUT": {
+    "build_validation_timeout": {
       "type": "number",
       "description": "构建验证的超时时间（秒）。当构建验证执行时间超过此值时，将终止验证并报告超时。",
-      "default": 600
+      "default": 30
     },
-    "JARVIS_ENABLE_IMPACT_ANALYSIS": {
+    "enable_impact_analysis": {
       "type": "boolean",
       "description": "是否启用编辑影响范围分析。分析代码编辑的影响范围，识别可能受影响的文件、函数、测试等，帮助评估编辑风险。",
       "default": true
     },
-    "JARVIS_FORCE_SAVE_MEMORY": {
+    "force_save_memory": {
       "type": "boolean",
       "description": "是否强制保存记忆",
       "default": false
     },
-    "JARVIS_ENABLE_GIT_JCA_SWITCH": {
+    "enable_git_jca_switch": {
       "type": "boolean",
       "description": "在初始化环境前检测Git仓库并提示可切换到代码开发模式（jca）",
       "default": true
     },
-    "JARVIS_ENABLE_STARTUP_CONFIG_SELECTOR": {
+    "enable_startup_config_selector": {
       "type": "boolean",
       "description": "在进入默认通用代理前，列出可用配置（agent/multi_agent/roles）供选择",
       "default": true
     },
-    "JARVIS_IMMEDIATE_ABORT": {
+    "immediate_abort": {
       "type": "boolean",
       "description": "是否启用立即中断：在对话迭代中检测到中断信号时立即返回",
       "default": false
     },
-    "JARVIS_SAVE_SESSION_HISTORY": {
+    "save_session_history": {
       "type": "boolean",
       "description": "是否保存会话记录",
       "default": false
     },
-    "JARVIS_SKIP_PREDEFINED_TASKS": {
+    "skip_predefined_tasks": {
       "type": "boolean",
       "description": "是否跳过预定义任务加载（不读取 pre-command 列表）",
       "default": false
     },
-    "JARVIS_ADDON_PROMPT_THRESHOLD": {
+    "addon_prompt_threshold": {
       "type": "number",
       "description": "附加提示的触发阈值（字符数）。当消息长度超过此值时，会自动添加默认的附加提示",
       "default": 1024
     },
-    "JARVIS_ENABLE_INTENT_RECOGNITION": {
+    "enable_intent_recognition": {
       "type": "boolean",
       "description": "是否启用意图识别功能。用于智能上下文推荐中的LLM意图提取和语义分析",
       "default": true
     },
-    "JARVIS_ENABLE_MEMORY_ORGANIZER": {
+    "enable_memory_organizer": {
       "type": "boolean",
       "description": "是否启用自动记忆整理功能。在任务完成后自动检测记忆库状态，当记忆数量超过200条且存在重叠时提示用户整理",
       "default": false
     },
-    "JARVIS_GIT_CHECK_MODE": {
-      "type": "string",
-      "enum": ["strict", "warn"],
-      "description": "Git 配置校验模式：strict 表示严格模式（默认），缺失配置时直接退出；warn 表示警告模式，仅提示并继续运行",
-      "default": "strict"
-    },
-    "JARVIS_TOOL_GROUP": {
+    "tool_group": {
       "type": "string",
       "description": "选择一个预定义的工具配置组",
       "default": ""
     },
-    "JARVIS_TOOL_GROUPS": {
+    "tool_groups": {
       "type": "array",
       "description": "预定义的工具配置组",
       "default": [],
@@ -425,70 +494,98 @@
         }
       }
     },
-    "JARVIS_RAG_GROUP": {
+    "rag_group": {
       "type": "string",
       "description": "选择一个预定义的RAG配置组",
       "default": ""
     },
-    "JARVIS_RAG_GROUPS": {
-      "type": "array",
-      "description": "预定义的RAG配置组",
-      "default": [
-        {
-          "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
-          }
-        }
-      ],
-      "items": {
+    "rag_groups": {
+      "type": "object",
+      "description": "预定义的RAG配置组，使用组名作为 key。每个组必须通过 embedding 引用 embeddings 中定义的配置，可选通过 reranker 引用 rerankers 中定义的配置，不再支持直接定义 embedding_model、embedding_type 等参数",
+      "additionalProperties": {
         "type": "object",
-        "additionalProperties": {
-          "type": "object",
-          "properties": {
-            "embedding_model": {
-              "type": "string",
-              "default": "BAAI/bge-m3"
-            },
-            "rerank_model": {
-              "type": "string",
-              "default": "BAAI/bge-reranker-v2-m3"
-            },
-            "use_bm25": {
-              "type": "boolean",
-              "default": true
-            },
-            "use_rerank": {
-              "type": "boolean",
-              "default": true
-            }
+        "properties": {
+          "embedding": {
+            "type": "string",
+            "description": "引用 embeddings 中定义的嵌入模型配置名称（必需）"
+          },
+          "reranker": {
+            "type": "string",
+            "description": "引用 rerankers 中定义的重排模型配置名称（可选）"
+          },
+          "use_bm25": {
+            "type": "boolean",
+            "default": true,
+            "description": "是否使用BM25进行检索"
+          },
+          "use_rerank": {
+            "type": "boolean",
+            "default": true,
+            "description": "是否使用重排模型"
           }
+        },
+        "required": ["embedding"]
+      },
+      "default": {
+        "text": {
+          "embedding": "default-text-embedding",
+          "reranker": "default-text-reranker",
+          "use_bm25": true,
+          "use_rerank": true
+        },
+        "code": {
+          "embedding": "default-code-embedding",
+          "use_bm25": false,
+          "use_rerank": false
         }
       }
     },
-    "JARVIS_RAG": {
+    "rag": {
       "type": "object",
-      "description": "RAG框架的顶层配置。注意：此处的设置将覆盖任何由JARVIS_RAG_GROUP选择的组配置。",
+      "description": "RAG框架的顶层配置。注意：此处的设置将覆盖任何由rag_group选择的组配置。",
       "properties": {
         "embedding_model": {
           "type": "string",
           "default": "BAAI/bge-m3",
           "description": "用于RAG的嵌入模型的名称, 默认为 'BAAI/bge-m3'"
         },
+        "embedding_type": {
+          "type": "string",
+          "default": "LocalEmbeddingModel",
+          "description": "嵌入模型的实现类型，如 'LocalEmbeddingModel', 'OpenAIEmbeddingModel', 'CohereEmbeddingModel', 'EdgeFnEmbeddingModel' 等，默认为 'LocalEmbeddingModel'"
+        },
+        "embedding_max_length": {
+          "type": "number",
+          "default": 512,
+          "description": "嵌入模型的最大输入长度（token数），用于文档分割，默认为 512"
+        },
+        "embedding_config": {
+          "type": "object",
+          "description": "嵌入模型的额外配置参数，会传递给模型的构造函数。对于在线模型，可包含 api_key 等参数",
+          "additionalProperties": true,
+          "default": {}
+        },
         "rerank_model": {
           "type": "string",
           "default": "BAAI/bge-reranker-v2-m3",
           "description": "用于RAG的rerank模型的名称, 默认为 'BAAI/bge-reranker-v2-m3'"
         },
+        "reranker_type": {
+          "type": "string",
+          "default": "LocalReranker",
+          "description": "重排模型的实现类型，如 'LocalReranker', 'CohereReranker', 'JinaReranker', 'EdgeFnReranker' 等，默认为 'LocalReranker'"
+        },
+        "reranker_max_length": {
+          "type": "number",
+          "default": 512,
+          "description": "重排模型的最大输入长度（token数），默认为 512"
+        },
+        "reranker_config": {
+          "type": "object",
+          "description": "重排模型的额外配置参数，会传递给模型的构造函数。对于在线模型，可包含 api_key 等参数",
+          "additionalProperties": true,
+          "default": {}
+        },
         "use_bm25": {
           "type": "boolean",
           "default": true,
@@ -502,12 +599,18 @@
       },
       "default": {
         "embedding_model": "BAAI/bge-m3",
+        "embedding_type": "LocalEmbeddingModel",
+        "embedding_max_length": 512,
+        "embedding_config": {},
         "rerank_model": "BAAI/bge-reranker-v2-m3",
+        "reranker_type": "LocalReranker",
+        "reranker_max_length": 512,
+        "reranker_config": {},
         "use_bm25": true,
         "use_rerank": true
       }
     },
-    "JARVIS_REPLACE_MAP": {
+    "replace_map": {
       "type": "object",
       "description": "自定义替换映射表配置",
       "additionalProperties": {
@@ -526,47 +629,37 @@
             "description": "Description of the replacement"
           }
         },
-        "required": [
-          "template"
-        ]
+        "required": ["template"]
       },
       "default": {}
     },
-    "OPENAI_API_KEY": {
-      "type": "string",
-      "description": "OpenAI API Key"
-    },
-    "OPENAI_API_BASE": {
-      "type": "string",
-      "description": "OpenAI API Base URL"
-    },
-    "KIMI_API_KEY": {
-      "type": "string",
-      "description": "Kimi API Key"
-    },
-    "TONGYI_COOKIES": {
-      "type": "string",
-      "description": "Tongyi Cookies"
-    },
-    "YUANBAO_COOKIES": {
-      "type": "string",
-      "description": "Yuanbao Cookies"
-    },
-    "AI8_API_KEY": {
-      "type": "string",
-      "description": "AI8 API Key"
-    },
     "SHELL": {
       "type": "string",
       "description": "系统Shell路径，用于获取当前使用的shell类型",
       "default": "/bin/bash"
     },
-    "JARVIS_CONVERSATION_TURN_THRESHOLD": {
+    "conversation_turn_threshold": {
       "type": "number",
       "description": "对话轮次阈值，用于触发总结。当对话轮次超过此值时，系统会自动触发对话总结",
       "default": 50,
       "minimum": 1,
       "maximum": 1000
+    },
+    "diff_visualization_mode": {
+      "type": "string",
+      "description": "Diff可视化模式。side_by_side: 左右分栏对比显示；unified: 统一diff格式；syntax: 语法高亮模式；compact: 紧凑模式",
+      "enum": ["side_by_side", "unified", "syntax", "compact"],
+      "default": "side_by_side"
+    },
+    "diff_show_line_numbers": {
+      "type": "boolean",
+      "description": "是否在 diff 中显示行号",
+      "default": true
+    },
+    "diff_large_file_threshold": {
+      "type": "number",
+      "description": "大文件阈值（超过此行数只显示统计）",
+      "default": 300
     }
   },
   "additionalProperties": true