jarvis-ai-assistant 0.2.3__tar.gz → 0.2.4__tar.gz

{jarvis_ai_assistant-0.2.3/src/jarvis_ai_assistant.egg-info → jarvis_ai_assistant-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jarvis-ai-assistant
-Version: 0.2.3
+Version: 0.2.4
 Summary: Jarvis: An AI assistant that uses tools to interact with the system
 Home-page: https://github.com/skyfireitdiy/Jarvis
 Author: skyfire
@@ -143,6 +143,22 @@ Jarvis 的定位是**个人开发者的高效助理**，旨在将研发流程中
 3.  **迭代完善**: 根据 “补充用户群体”、“增加工作流对比”、“再增加一个例子” 等一系列追加指令，Jarvis 通过多次 `PATCH` 操作，逐步、精确地将新内容添加到本文档的指定位置。
 4.  **人机协作**: 在整个过程中，人类提供高层次的目标和方向，Jarvis 负责具体的探索、总结和代码（文档）修改任务，将一个模糊的想法快速落地为结构清晰的文档。
 
+### Vibe Working: 一种更直觉的工作流
+
+Jarvis 的核心理念与一种新兴的人机协作模式 **"Vibe Working"** (氛围式工作)不谋而合。这个概念源于AI研究者Andrej Karpathy，指的是利用大语言模型（LLM），将人类头脑中模糊、直觉性的想法（即“Vibe”）高效转化为具体的、结构化的成果。
+
+这不再是传统的“指令-执行”模式，而是一种**对话式、迭代式**的共同创造过程。
+
+*   **从一个“感觉”开始**: 传统的自动化需要精确的输入和规则。而使用 Jarvis，你可以从一个模糊的目标开始，比如 `jca "给我写个脚本，监控这个网站的变化"` 或者 `jca "重构 'user' 模块，让它看起来更清爽"`。你提供的是方向和“感觉”，而不是详细的规格书。
+
+*   **迭代中逼近完美**: Jarvis (或其背后的LLM) 会提供一个初步的实现。这个版本可能不完美，但它是一个坚实的起点。接下来，你通过反馈来指导它，比如 `“这个地方的逻辑不对，应该先检查A再处理B”` 或者 `“变量名能再语义化一点吗？”`。通过这种快速的反馈循环，AI的产出将逐步逼近你的真实意图。
+
+*   **人与AI的角色转变**:
+    *   **你 (人类)**: 扮演**创意总监、品味判断者和方向引领者**。你负责提供愿景、经验和高层次的判断力，确保最终结果的质量和方向。
+    *   **Jarvis (AI)**: 扮演**强大的执行伙伴和灵感催化剂**。它负责处理所有繁重、重复和技术性的细节，并能提供意想不到的解决方案，激发你的新想法。
+
+Jarvis 正是为这种工作流而设计的工具。它通过无缝的命令行集成和强大的本地交互能力，将 "Vibe Working" 从一个抽象概念，变为了开发者触手可及的日常生产力工具，让你能更专注于**高价值的创造性思考**，而非琐碎的实现细节。
+
 ### 👥 目标用户
 
 **谁适合使用 Jarvis？**
@@ -197,6 +213,7 @@ Jarvis 包含一系列专注于不同任务的工具。以下是主要命令及
 | `jarvis-platform-manager` | `jpm` | 管理和测试不同的大语言模型平台 |
 | `jarvis-rag` | `jrg` | 构建和查询本地化的RAG知识库 |
 | `jarvis-smart-shell` | `jss` | 实验性的智能Shell功能 |
+| `jarvis-stats` | `jst` | 通用统计模块，支持记录和可视化任意指标数据 |
 
 更多详细用法和参数，请查阅我们的 [**使用指南**](docs/jarvis_book/4.使用指南.md)。
 
@@ -240,7 +257,7 @@ ENV:
 
 Jarvis 支持多种平台，包括 **Kimi**, **通义千问**, **OpenAI** 等。详细的配置选项、模型组设置以及所有可用参数，请参阅 [**使用指南**](docs/jarvis_book/4.使用指南.md)。
 
-> **模型推荐**: 目前效果最好的模型是 `gemini-1.5-pro`，可以通过国内代理商购买，例如 [FoxiAI](https://foxi-ai.top)。
+> **模型推荐**: 目前效果较好的模型是 `claude-opus-4-20250514`，可以通过国内代理商购买，例如 [FoxiAI](https://foxi-ai.top)。
 
 ---
 

{jarvis_ai_assistant-0.2.3 → jarvis_ai_assistant-0.2.4}/README.md

@@ -59,6 +59,22 @@ Jarvis 的定位是**个人开发者的高效助理**，旨在将研发流程中
 3.  **迭代完善**: 根据 “补充用户群体”、“增加工作流对比”、“再增加一个例子” 等一系列追加指令，Jarvis 通过多次 `PATCH` 操作，逐步、精确地将新内容添加到本文档的指定位置。
 4.  **人机协作**: 在整个过程中，人类提供高层次的目标和方向，Jarvis 负责具体的探索、总结和代码（文档）修改任务，将一个模糊的想法快速落地为结构清晰的文档。
 
+### Vibe Working: 一种更直觉的工作流
+
+Jarvis 的核心理念与一种新兴的人机协作模式 **"Vibe Working"** (氛围式工作)不谋而合。这个概念源于AI研究者Andrej Karpathy，指的是利用大语言模型（LLM），将人类头脑中模糊、直觉性的想法（即“Vibe”）高效转化为具体的、结构化的成果。
+
+这不再是传统的“指令-执行”模式，而是一种**对话式、迭代式**的共同创造过程。
+
+*   **从一个“感觉”开始**: 传统的自动化需要精确的输入和规则。而使用 Jarvis，你可以从一个模糊的目标开始，比如 `jca "给我写个脚本，监控这个网站的变化"` 或者 `jca "重构 'user' 模块，让它看起来更清爽"`。你提供的是方向和“感觉”，而不是详细的规格书。
+
+*   **迭代中逼近完美**: Jarvis (或其背后的LLM) 会提供一个初步的实现。这个版本可能不完美，但它是一个坚实的起点。接下来，你通过反馈来指导它，比如 `“这个地方的逻辑不对，应该先检查A再处理B”` 或者 `“变量名能再语义化一点吗？”`。通过这种快速的反馈循环，AI的产出将逐步逼近你的真实意图。
+
+*   **人与AI的角色转变**:
+    *   **你 (人类)**: 扮演**创意总监、品味判断者和方向引领者**。你负责提供愿景、经验和高层次的判断力，确保最终结果的质量和方向。
+    *   **Jarvis (AI)**: 扮演**强大的执行伙伴和灵感催化剂**。它负责处理所有繁重、重复和技术性的细节，并能提供意想不到的解决方案，激发你的新想法。
+
+Jarvis 正是为这种工作流而设计的工具。它通过无缝的命令行集成和强大的本地交互能力，将 "Vibe Working" 从一个抽象概念，变为了开发者触手可及的日常生产力工具，让你能更专注于**高价值的创造性思考**，而非琐碎的实现细节。
+
 ### 👥 目标用户
 
 **谁适合使用 Jarvis？**
@@ -113,6 +129,7 @@ Jarvis 包含一系列专注于不同任务的工具。以下是主要命令及
 | `jarvis-platform-manager` | `jpm` | 管理和测试不同的大语言模型平台 |
 | `jarvis-rag` | `jrg` | 构建和查询本地化的RAG知识库 |
 | `jarvis-smart-shell` | `jss` | 实验性的智能Shell功能 |
+| `jarvis-stats` | `jst` | 通用统计模块，支持记录和可视化任意指标数据 |
 
 更多详细用法和参数，请查阅我们的 [**使用指南**](docs/jarvis_book/4.使用指南.md)。
 
@@ -156,7 +173,7 @@ ENV:
 
 Jarvis 支持多种平台，包括 **Kimi**, **通义千问**, **OpenAI** 等。详细的配置选项、模型组设置以及所有可用参数，请参阅 [**使用指南**](docs/jarvis_book/4.使用指南.md)。
 
-> **模型推荐**: 目前效果最好的模型是 `gemini-1.5-pro`，可以通过国内代理商购买，例如 [FoxiAI](https://foxi-ai.top)。
+> **模型推荐**: 目前效果较好的模型是 `claude-opus-4-20250514`，可以通过国内代理商购买，例如 [FoxiAI](https://foxi-ai.top)。
 
 ---
 

{jarvis_ai_assistant-0.2.3 → jarvis_ai_assistant-0.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "jarvis-ai-assistant"
-version = "0.2.3"
+version = "0.2.4"
 description = "Jarvis: An AI assistant that uses tools to interact with the system"
 readme = "README.md"
 authors = [{ name = "skyfire", email = "skyfireitdiy@hotmail.com" }]
@@ -90,6 +90,8 @@ jarvis-methodology = "jarvis.jarvis_methodology.main:main"
 jm = "jarvis.jarvis_methodology.main:main"
 jarvis-rag = "jarvis.jarvis_rag.cli:main"
 jrg = "jarvis.jarvis_rag.cli:main"
+jarvis-stats = "jarvis.jarvis_stats.cli:main"
+jst = "jarvis.jarvis_stats.cli:main"
 
 [[tool.uv.index]]
 url = "https://artsz.zte.com.cn/artifactory/api/pypi/public-pypi-virtual/simple"

{jarvis_ai_assistant-0.2.3 → jarvis_ai_assistant-0.2.4}/setup.py

@@ -3,11 +3,11 @@ from setuptools import setup, find_packages  # type: ignore
 
 setup(
     name="jarvis-ai-assistant",
-    version="0.2.3",
+    version="0.2.4",
     author="skyfire",
     author_email="skyfireitdiy@hotmail.com",
     description="An AI assistant that uses various tools to interact with the system",
-    long_description=open("README.md").read(),
+    long_description=open("README.md", encoding="utf-8").read(),
     long_description_content_type="text/markdown",
     url="https://github.com/skyfireitdiy/Jarvis",
     packages=find_packages(where="src"),
@@ -78,6 +78,8 @@ setup(
             "jm=jarvis.jarvis_methodology.main:main",
             "jarvis-rag=jarvis.jarvis_rag.cli:main",
             "jrg=jarvis.jarvis_rag.cli:main",
+            "jarvis-stats=jarvis.jarvis_stats.cli:main",
+            "jst=jarvis.jarvis_stats.cli:main",
         ],
     },
     python_requires=">=3.9,<3.13",

{jarvis_ai_assistant-0.2.3 → jarvis_ai_assistant-0.2.4}/src/jarvis/__init__.py

@@ -1,4 +1,4 @@
 # -*- coding: utf-8 -*-
 """Jarvis AI Assistant"""
 
-__version__ = "0.2.3"
+__version__ = "0.2.4"

{jarvis_ai_assistant-0.2.3 → jarvis_ai_assistant-0.2.4}/src/jarvis/jarvis_agent/edit_file_handler.py

@@ -55,6 +55,11 @@ class EditFileHandler(OutputHandler):
         patches = self._parse_patches(response)
         if not patches:
             return False, "未找到有效的文件编辑指令"
+        
+        # 记录 edit_file 工具调用统计
+        from jarvis.jarvis_stats.stats import StatsManager
+        stats_manager = StatsManager()
+        stats_manager.increment("edit_file", group="tool")
 
         results = []
 

{jarvis_ai_assistant-0.2.3 → jarvis_ai_assistant-0.2.4}/src/jarvis/jarvis_agent/jarvis.py

@@ -24,7 +24,7 @@ from jarvis.jarvis_tools.registry import ToolRegistry
 from jarvis.jarvis_utils.config import get_data_dir
 from jarvis.jarvis_utils.utils import init_env
 
-app = typer.Typer(help="Jarvis AI assistant")
+app = typer.Typer(help="Jarvis AI 助手")
 
 
 def _load_tasks() -> Dict[str, str]:
@@ -91,19 +91,13 @@ def _select_task(tasks: Dict[str, str]) -> str:
                 selected_task = tasks[task_names[choice - 1]]
                 PrettyOutput.print(f"将要执行任务:\n {selected_task}", OutputType.INFO)
                 # 询问是否需要补充信息
-                need_additional = user_confirm(
-                    "需要为此任务添加补充信息吗？", default=False
-                )
+                need_additional = user_confirm("需要为此任务添加补充信息吗？", default=False)
                 if need_additional:
                     additional_input = get_multiline_input("请输入补充信息：")
                     if additional_input:
-                        selected_task = (
-                            f"{selected_task}\n\n补充信息:\n{additional_input}"
-                        )
+                        selected_task = f"{selected_task}\n\n补充信息:\n{additional_input}"
                 return selected_task
-            PrettyOutput.print(
-                "无效的选择。请选择列表中的一个号码。", OutputType.WARNING
-            )
+            PrettyOutput.print("无效的选择。请选择列表中的一个号码。", OutputType.WARNING)
 
         except (KeyboardInterrupt, EOFError):
             return ""
@@ -121,7 +115,16 @@ def _handle_edit_mode(edit: bool, config_file: Optional[str]) -> None:
         if config_file
         else Path(os.path.expanduser("~/.jarvis/config.yaml"))
     )
-    editors = ["nvim", "vim", "vi"]
+    # 根据操作系统选择合适的编辑器
+    import platform
+
+    if platform.system() == "Windows":
+        # 优先级：终端工具 -> 代码编辑器 -> 通用文本编辑器
+        editors = ["nvim", "vim", "nano", "code", "notepad++", "notepad"]
+    else:
+        # 优先级：终端工具 -> 代码编辑器 -> 通用文本编辑器
+        editors = ["nvim", "vim", "vi", "nano", "emacs", "code", "gedit", "kate"]
+
     editor = next((e for e in editors if shutil.which(e)), None)
 
     if editor:
@@ -133,7 +136,7 @@ def _handle_edit_mode(edit: bool, config_file: Optional[str]) -> None:
             raise typer.Exit(code=1)
     else:
         PrettyOutput.print(
-            "No suitable editor found (nvim, vim, vi).", OutputType.ERROR
+            f"No suitable editor found. Tried: {', '.join(editors)}", OutputType.ERROR
         )
         raise typer.Exit(code=1)
 
@@ -186,30 +189,24 @@ def run_cli(
     llm_type: str = typer.Option(
         "normal",
         "--llm_type",
-        help="LLM type to use, choices are 'normal' and 'thinking'",
-    ),
-    task: Optional[str] = typer.Option(
-        None, "-t", "--task", help="Directly input task content from command line"
+        help="使用的LLM类型，可选值：'normal'（普通）或 'thinking'（思考模式）",
     ),
+    task: Optional[str] = typer.Option(None, "-t", "--task", help="从命令行直接输入任务内容"),
     model_group: Optional[str] = typer.Option(
-        None, "--model_group", help="Model group to use, overriding config"
-    ),
-    config_file: Optional[str] = typer.Option(
-        None, "-f", "--config", help="Path to custom config file"
+        None, "--llm_group", help="使用的模型组，覆盖配置文件中的设置"
     ),
+    config_file: Optional[str] = typer.Option(None, "-f", "--config", help="自定义配置文件路径"),
     restore_session: bool = typer.Option(
         False,
         "--restore-session",
-        help="Restore session from .jarvis/saved_session.json",
-    ),
-    edit: bool = typer.Option(
-        False, "-e", "--edit", help="Edit the configuration file"
+        help="从 .jarvis/saved_session.json 恢复会话",
     ),
+    edit: bool = typer.Option(False, "-e", "--edit", help="编辑配置文件"),
 ) -> None:
     """Jarvis AI assistant command-line interface."""
     if ctx.invoked_subcommand is not None:
         return
-        
+
     _handle_edit_mode(edit, config_file)
 
     init_env("欢迎使用 Jarvis AI 助手，您的智能助理已准备就绪！", config_file=config_file)

{jarvis_ai_assistant-0.2.3 → jarvis_ai_assistant-0.2.4}/src/jarvis/jarvis_agent/main.py

@@ -10,7 +10,7 @@ from jarvis.jarvis_utils.input import get_multiline_input
 from jarvis.jarvis_utils.output import OutputType, PrettyOutput
 from jarvis.jarvis_utils.utils import init_env
 
-app = typer.Typer(help="Jarvis AI assistant")
+app = typer.Typer(help="Jarvis AI 助手")
 
 
 def load_config(config_path: str) -> dict:
@@ -40,21 +40,21 @@ def load_config(config_path: str) -> dict:
 @app.command()
 def cli(
     config_file: Optional[str] = typer.Option(
-        None, "-f", "--config", help="Path to agent config file"
+        None, "-f", "--config", help="代理配置文件路径"
     ),
     agent_definition: Optional[str] = typer.Option(
-        None, "-c", "--agent_definition", help="Path to agent definition file"
+        None, "-c", "--agent_definition", help="代理定义文件路径"
     ),
     task: Optional[str] = typer.Option(
-        None, "-t", "--task", help="Initial task to execute"
+        None, "-t", "--task", help="初始任务内容"
     ),
     llm_type: str = typer.Option(
         "normal",
         "--llm_type",
-        help="LLM type to use, overriding config",
+        help="使用的LLM类型，覆盖配置文件中的设置",
     ),
     model_group: Optional[str] = typer.Option(
-        None, "--model_group", help="Model group to use, overriding config"
+        None, "--llm_group", help="使用的模型组，覆盖配置文件中的设置"
     ),
 ):
     """Main entry point for Jarvis agent"""