jarvis-ai-assistant 0.2.2__py3-none-any.whl → 0.2.4__py3-none-any.whl

jarvis/jarvis_utils/utils.py

@@ -77,6 +77,186 @@ def _check_git_updates() -> bool:
     return check_and_update_git_repo(str(script_dir))
 
 
+def _show_usage_stats() -> None:
+    """显示Jarvis使用统计信息"""
+    try:
+        from jarvis.jarvis_stats.stats import StatsManager
+        from jarvis.jarvis_utils.output import OutputType, PrettyOutput
+        from datetime import datetime
+
+        stats_manager = StatsManager()
+
+        # 获取所有可用的指标
+        all_metrics = stats_manager.list_metrics()
+
+        # 根据指标名称和标签自动分类
+        categorized_stats: Dict[str, Dict[str, Any]] = {
+            "tool": {"title": "🔧 工具调用", "metrics": {}, "suffix": "次"},
+            "code": {"title": "📝 代码修改", "metrics": {}, "suffix": "次"},
+            "lines": {"title": "📊 代码行数", "metrics": {}, "suffix": "行"},
+            "commit": {"title": "💾 提交统计", "metrics": {}, "suffix": "个"},
+            "command": {"title": "📱 命令使用", "metrics": {}, "suffix": "次"},
+        }
+
+        # 遍历所有指标，获取统计数据
+        for metric in all_metrics:
+            # 获取该指标的所有数据
+            stats_data = stats_manager.get_stats(
+                metric_name=metric,
+                start_time=datetime(2000, 1, 1),
+                end_time=datetime.now(),
+            )
+
+            if stats_data and isinstance(stats_data, dict) and "records" in stats_data:
+                # 按照标签分组统计
+                tag_totals: Dict[str, float] = {}
+                for record in stats_data["records"]:
+                    tags = record.get("tags", {})
+                    group = tags.get("group", "other")
+                    tag_totals[group] = tag_totals.get(group, 0) + record["value"]
+
+                # 根据标签将指标分配到相应类别
+                for group, total in tag_totals.items():
+                    if total > 0:
+                        if group == "tool":
+                            categorized_stats["tool"]["metrics"][metric] = int(total)
+                        elif group == "code_agent":
+                            # 根据指标名称细分
+                            if metric.startswith("code_lines_"):
+                                categorized_stats["lines"]["metrics"][metric] = int(
+                                    total
+                                )
+                            elif "commit" in metric:
+                                categorized_stats["commit"]["metrics"][metric] = int(
+                                    total
+                                )
+                            else:
+                                categorized_stats["code"]["metrics"][metric] = int(
+                                    total
+                                )
+                        elif group == "command":
+                            categorized_stats["command"]["metrics"][metric] = int(total)
+
+        # 构建输出
+        has_data = False
+        stats_output = []
+
+        for category, data in categorized_stats.items():
+            if data["metrics"]:
+                has_data = True
+                stats_output.append((data["title"], data["metrics"], data["suffix"]))
+
+        # 显示统计信息
+        if has_data:
+            # 构建统计信息字符串
+            stats_lines = ["📊 Jarvis 使用统计"]
+
+            for title, stats, suffix in stats_output:
+                if stats:
+                    stats_lines.append(f"\n{title}:")
+                    for metric, count in sorted(
+                        stats.items(), key=lambda x: x[1], reverse=True
+                    ):
+                        # 美化指标名称
+                        display_name = metric.replace("_", " ").title()
+                        stats_lines.append(f"  • {display_name}: {count:,} {suffix}")
+
+            # 总结统计
+            total_tools = sum(
+                count
+                for title, stats, _ in stats_output
+                if "工具" in title
+                for metric, count in stats.items()
+            )
+            total_changes = sum(
+                count
+                for title, stats, _ in stats_output
+                if "代码修改" in title
+                for metric, count in stats.items()
+            )
+
+            if total_tools > 0 or total_changes > 0:
+                stats_lines.append(
+                    f"\n📈 总计: 工具调用 {total_tools:,} 次, 代码修改 {total_changes:,} 次"
+                )
+
+            # 计算节省的时间
+            # 基于经验估算：
+            # - 每次工具调用平均节省5分钟（相比手动操作）
+            # - 每行代码修改平均节省60秒（考虑思考、编写、测试时间）
+            # - 每次提交平均节省15分钟（考虑整理、描述、检查时间）
+            # - 每个命令调用平均节省5分钟（相比手动执行）
+
+            time_saved_minutes = 0
+
+            # 工具调用节省的时间
+            time_saved_minutes += total_tools * 5
+
+            # 代码行数节省的时间（每行修改节省60秒）
+            total_lines = sum(
+                count
+                for title, stats, _ in stats_output
+                if "代码行数" in title
+                for metric, count in stats.items()
+            )
+            time_saved_minutes += total_lines * 1  # 60秒 = 1分钟
+
+            # 提交节省的时间
+            total_commits = sum(
+                count
+                for title, stats, _ in stats_output
+                if "提交统计" in title
+                for metric, count in stats.items()
+            )
+            time_saved_minutes += total_commits * 15
+
+            # 命令调用节省的时间
+            total_commands = sum(
+                count
+                for title, stats, _ in stats_output
+                if "命令使用" in title
+                for metric, count in stats.items()
+            )
+            time_saved_minutes += total_commands * 5
+
+            # 转换为更友好的格式
+            if time_saved_minutes > 0:
+                hours = int(time_saved_minutes // 60)
+                minutes = int(time_saved_minutes % 60)
+
+                if hours > 24:
+                    days = hours // 24
+                    remaining_hours = hours % 24
+                    time_str = f"{days} 天 {remaining_hours} 小时 {minutes} 分钟"
+                elif hours > 0:
+                    time_str = f"{hours} 小时 {minutes} 分钟"
+                else:
+                    time_str = f"{minutes} 分钟"
+
+                stats_lines.append(f"\n⏱️  节省时间: 约 {time_str}")
+
+                # 根据节省的时间给出鼓励信息
+                if hours >= 100:
+                    stats_lines.append(
+                        "🎉 您已经通过 Jarvis 节省了超过100小时的开发时间！"
+                    )
+                elif hours >= 40:
+                    stats_lines.append("🚀 相当于节省了一整周的工作时间！")
+                elif hours >= 8:
+                    stats_lines.append("💪 相当于节省了一个工作日的时间！")
+                elif hours >= 1:
+                    stats_lines.append("✨ 积少成多，继续保持！")
+
+            # 一次性输出所有统计信息
+            PrettyOutput.print("\n".join(stats_lines), OutputType.INFO)
+    except Exception as e:
+        # 输出错误信息以便调试
+        import traceback
+
+        PrettyOutput.print(f"统计显示出错: {str(e)}", OutputType.ERROR)
+        PrettyOutput.print(traceback.format_exc(), OutputType.ERROR)
+
+
 def init_env(welcome_str: str, config_file: Optional[str] = None) -> None:
     """初始化Jarvis环境
 
@@ -99,7 +279,11 @@ def init_env(welcome_str: str, config_file: Optional[str] = None) -> None:
     g_config_file = config_file
     load_config()
 
-    # 5. 检查git更新
+    # 5. 显示历史统计数据（仅在显示欢迎信息时显示）
+    if welcome_str:
+        _show_usage_stats()
+
+    # 6. 检查git更新
     if _check_git_updates():
         os.execv(sys.executable, [sys.executable] + sys.argv)
         sys.exit(0)
@@ -243,14 +427,7 @@ def generate_default_config(schema_path: str, output_path: str) -> None:
 
     default_config = _generate_from_schema(schema)
 
-    # 添加schema声明
-    rel_schema_path = Path(
-        os.path.relpath(
-            Path(schema_path),
-            start=Path(output_path).parent,
-        )
-    )
-    content = f"# yaml-language-server: $schema={rel_schema_path}\n"
+    content = f"# yaml-language-server: $schema={schema}\n"
     content += yaml.dump(default_config, allow_unicode=True, sort_keys=False)
 
     with open(output_path, "w", encoding="utf-8") as f:
@@ -386,35 +563,19 @@ def get_file_line_count(filename: str) -> int:
         return 0
 
 
-def _get_cmd_stats() -> Dict[str, int]:
-    """从数据目录获取命令调用统计"""
-    stats_file = Path(get_data_dir()) / "cmd_stat.yaml"
-    if stats_file.exists():
-        try:
-            with open(stats_file, "r", encoding="utf-8") as f:
-                return yaml.safe_load(f) or {}
-        except Exception as e:
-            PrettyOutput.print(f"加载命令调用统计失败: {str(e)}", OutputType.WARNING)
-    return {}
-
-
-def _update_cmd_stats(cmd_name: str) -> None:
-    """更新命令调用统计"""
-    stats = _get_cmd_stats()
-    stats[cmd_name] = stats.get(cmd_name, 0) + 1
-    stats_file = Path(get_data_dir()) / "cmd_stat.yaml"
-    try:
-        with open(stats_file, "w", encoding="utf-8") as f:
-            yaml.safe_dump(stats, f, allow_unicode=True)
-    except Exception as e:
-        PrettyOutput.print(f"保存命令调用统计失败: {str(e)}", OutputType.WARNING)
-
-
 def count_cmd_usage() -> None:
     """统计当前命令的使用次数"""
     import sys
+    import os
+    from jarvis.jarvis_stats.stats import StatsManager
 
-    _update_cmd_stats(sys.argv[0])
+    # 从完整路径中提取命令名称
+    cmd_path = sys.argv[0]
+    cmd_name = os.path.basename(cmd_path)
+
+    # 使用 StatsManager 记录命令使用统计
+    stats_manager = StatsManager()
+    stats_manager.increment(cmd_name, group="command")
 
 
 def is_context_overflow(
@@ -433,7 +594,9 @@ def get_loc_stats() -> str:
         str: loc命令输出的原始字符串，失败时返回空字符串
     """
     try:
-        result = subprocess.run(["loc"], capture_output=True, text=True)
+        result = subprocess.run(
+            ["loc"], capture_output=True, text=True, encoding="utf-8", errors="replace"
+        )
         return result.stdout if result.returncode == 0 else ""
     except FileNotFoundError:
         return ""
@@ -445,6 +608,9 @@ def copy_to_clipboard(text: str) -> None:
     参数:
         text: 要复制的文本
     """
+    print("--- 剪贴板内容开始 ---")
+    print(text)
+    print("--- 剪贴板内容结束 ---")
     # 尝试使用 xsel
     try:
         process = subprocess.Popen(
@@ -496,6 +662,8 @@ def _pull_git_repo(repo_path: Path, repo_type: str):
             cwd=repo_path,
             capture_output=True,
             text=True,
+            encoding="utf-8",
+            errors="replace",
             check=True,
             timeout=10,
         )
@@ -512,6 +680,8 @@ def _pull_git_repo(repo_path: Path, repo_type: str):
             cwd=repo_path,
             capture_output=True,
             text=True,
+            encoding="utf-8",
+            errors="replace",
             check=True,
             timeout=10,
         )
@@ -528,6 +698,8 @@ def _pull_git_repo(repo_path: Path, repo_type: str):
             cwd=repo_path,
             capture_output=True,
             text=True,
+            encoding="utf-8",
+            errors="replace",
             check=True,
             timeout=10,
         )
@@ -555,11 +727,15 @@ def _pull_git_repo(repo_path: Path, repo_type: str):
         after_hash = after_hash_result.stdout.strip()
 
         if before_hash != after_hash:
-            PrettyOutput.print(f"{repo_type}库 '{repo_path.name}' 已更新。", OutputType.SUCCESS)
+            PrettyOutput.print(
+                f"{repo_type}库 '{repo_path.name}' 已更新。", OutputType.SUCCESS
+            )
             if pull_result.stdout.strip():
                 PrettyOutput.print(pull_result.stdout.strip(), OutputType.INFO)
         else:
-            PrettyOutput.print(f"{repo_type}库 '{repo_path.name}' 已是最新版本。", OutputType.INFO)
+            PrettyOutput.print(
+                f"{repo_type}库 '{repo_path.name}' 已是最新版本。", OutputType.INFO
+            )
 
     except FileNotFoundError:
         PrettyOutput.print(

{jarvis_ai_assistant-0.2.2.dist-info → jarvis_ai_assistant-0.2.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jarvis-ai-assistant
-Version: 0.2.2
+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
@@ -37,7 +37,7 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Requires-Python: >=3.9
+Requires-Python: >=3.9,<3.13
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: requests==2.32.3
@@ -58,6 +58,8 @@ Requires-Dist: pyyaml>=5.3.1
 Requires-Dist: ddgs==9.0.2
 Requires-Dist: lxml==6.0.0
 Requires-Dist: markdownify>=1.1.0
+Requires-Dist: typer
+Requires-Dist: pathspec
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: black; extra == "dev"
@@ -73,7 +75,6 @@ Requires-Dist: chromadb; extra == "rag"
 Requires-Dist: diskcache; extra == "rag"
 Requires-Dist: sentence-transformers==2.7.0; extra == "rag"
 Requires-Dist: torch>=2.6; extra == "rag"
-Requires-Dist: typer; extra == "rag"
 Requires-Dist: unstructured[md]; extra == "rag"
 Requires-Dist: rank-bm25; extra == "rag"
 Dynamic: author
@@ -87,15 +88,94 @@ Dynamic: requires-python
 </p>
 <div align="center">
 
-[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 *您的智能开发和系统交互助手*
 
-[快速开始](#quick-start) • [核心功能](#core-features) • [配置说明](#configuration) • [Jarvis Book](#jarvis-book) • [技术细节](docs/technical_documentation.md) • [Wiki文档](https://deepwiki.com/skyfireitdiy/Jarvis) • [贡献指南](#contributing) • [许可证](#license)
+[快速开始](#quick-start) • [核心功能](#core-features) • [配置说明](#configuration) • [Jarvis Book](#jarvis-book) • [技术细节](docs/technical_documentation.md) • [Wiki文档](docs/jarvis_book/1.项目介绍.md) • [贡献指南](#contributing) • [许可证](#license)
 </div>
 
 ---
 
+## 🎯 定位与优势
+
+Jarvis 的定位是**个人开发者的高效助理**，旨在将研发流程中一次性、碎片化的工作变得更加流畅和高效。这与 `workflow` 形式的 `Agent` 平台（如 Dify）有着本质区别，专注于提升个人生产力。
+
+### Jarvis 的核心优势
+
+1.  **访问本地资源**: Jarvis 能够直接与您的本地环境交互，执行诸如**软件开发、代码修复、环境搭建**等需要本地文件系统和工具链的复杂任务。
+2.  **纯粹的命令行体验**: 作为一款纯命令行工具，Jarvis 可以无缝集成到您喜爱的任何IDE、终端或SSH会话中，不干扰您现有的工作流程。
+3.  **Python包形式提供**: Jarvis 以标准的Python包形式分发，可以轻松地作为依赖项集成到您自己构建的AI应用或自动化脚本中。
+
+### 💡 Jarvis 的价值：工作流对比
+
+#### 示例一：开发新功能
+
+**传统工作流 (没有 Jarvis):**
+
+1.  **理解需求**: 阅读需求文档，在代码库中全局搜索，定位可能需要修改的文件和函数。
+2.  **切换上下文**: 在IDE、浏览器（查资料）、终端（执行命令）之间反复切换。
+3.  **编写代码**: 手动编写新功能、单元测试和相关文档。
+4.  **调试**: 反复运行、打印日志、设置断点来定位和修复bug。
+5.  **代码提交**: 手动检查代码变更，撰写符合团队规范的 Git Commit Message。
+> 这个过程不仅耗时，而且频繁的上下文切换极易打断心流，消耗大量精力。
+
+**Jarvis 增强工作流:**
+
+1.  **任务启动**: 在项目根目录，用自然语言向 `jca` (代码助理) 描述需求：`jca "为 'user' 模块增加 'profile' 接口，需要包含用户信息查询和更新功能"`。
+2.  **AI 分析与编码**:
+    *   Jarvis 自动分析代码结构，定位相关文件 (`user/service.py`, `user/controller.py`, `tests/test_user.py`)。
+    *   自动生成新接口的代码、必要的单元测试，并提出修改方案。
+3.  **人机协作与迭代**:
+    *   你审查 AI 生成的代码，并提出修改意见：`"字段名需要用驼峰式"` 或 `"增加一个输入校验"`。
+    *   Jarvis 根据反馈快速迭代，更新代码。
+4.  **自动化提交**:
+    *   完成开发后，执行 `jgc` (Git 提交助理)。
+    *   Jarvis 自动分析代码变更，生成一条规范的 Git Commit Message (例如: `feat(user): add user profile api with query and update`)。
+> 通过 Jarvis，整个流程从“手动执行”变为了“监督和指导”，开发者可以将精力集中在**架构设计和代码审查**等高价值活动上，而不是繁琐的编码和调试细节。
+
+#### 示例二：用 Jarvis 完善本文档
+
+您正在阅读的这部分文档，其诞生过程本身就是 Jarvis 价值的体现。
+
+1.  **初始指令**: `“在README.md中补充jarvis的用户群体和应用场景等信息”`
+2.  **探索与学习**: Jarvis 使用 `fd` 和 `read_code` 工具，分析了 `docs/` 目录下的说明文档，快速学习了项目的核心定位和功能。
+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？**
+
+*   **个人开发者和极客**: 希望通过AI提升个人开发、学习和探索效率的用户。
+*   **需要处理碎片化任务的工程师**: 面对各种一次性、非标准化的技术任务，例如快速编写脚本、调试代码、搭建新环境等。
+*   **AI应用探索者**: 希望有一个灵活的本地框架来实验和集成不同的大语言模型和工具。
+
+**谁可能不适合？**
+
+*   **寻求固定工作流自动化的人**: 如果您的需求是高度固定和重复的，例如“每天定时抓取数据并生成报告”，那么编写一个专门的、功能单一的脚本可能是更直接、更高效的解决方案。Jarvis 更擅长处理多变和探索性的任务。
+*   **企业级团队协作者**: Jarvis 被设计为个人工具，不包含团队管理、权限控制等面向企业级协作的功能。
+
+总之，Jarvis 是为每一位开发者量身打造的个人助手，而非用于团队协作的集中式平台。
+
+---
+
 ## 🚀 快速开始 <a id="quick-start"></a>
 
 ### 系统要求
@@ -133,8 +213,9 @@ Jarvis 包含一系列专注于不同任务的工具。以下是主要命令及
 | `jarvis-platform-manager` | `jpm` | 管理和测试不同的大语言模型平台 |
 | `jarvis-rag` | `jrg` | 构建和查询本地化的RAG知识库 |
 | `jarvis-smart-shell` | `jss` | 实验性的智能Shell功能 |
+| `jarvis-stats` | `jst` | 通用统计模块，支持记录和可视化任意指标数据 |
 
-更多详细用法和参数，请查阅我们的 [**Wiki 文档**](https://deepwiki.com/skyfireitdiy/Jarvis)。
+更多详细用法和参数，请查阅我们的 [**使用指南**](docs/jarvis_book/4.使用指南.md)。
 
 ---
 
@@ -174,7 +255,9 @@ ENV:
   YUANBAO_COOKIES: "在此处粘贴您的元宝Cookies"
 ```
 
-Jarvis 支持多种平台，包括 **Kimi**, **通义千问**, **OpenAI** 等。详细的配置选项、模型组设置以及所有可用参数，请参阅 [**配置文档**](https://deepwiki.com/skyfireitdiy/Jarvis)。
+Jarvis 支持多种平台，包括 **Kimi**, **通义千问**, **OpenAI** 等。详细的配置选项、模型组设置以及所有可用参数，请参阅 [**使用指南**](docs/jarvis_book/4.使用指南.md)。
+
+> **模型推荐**: 目前效果较好的模型是 `claude-opus-4-20250514`，可以通过国内代理商购买，例如 [FoxiAI](https://foxi-ai.top)。
 
 ---
 
@@ -185,7 +268,7 @@ Jarvis 被设计为高度可扩展的框架。您可以轻松地：
 - **集成新LLM平台**: 在 `~/.jarvis/platforms/` 目录下添加新的平台适配器。
 - **定义MCP**: 通过配置文件集成外部或自定义的命令协议。
 
-有关扩展开发的详细指南和[**技术细节**](docs/technical_documentation.md)，请访问我们的 [**开发者文档**](https://deepwiki.com/skyfireitdiy/Jarvis)。
+有关扩展开发的详细指南和[**技术细节**](docs/technical_documentation.md)，请访问我们的 [**开发者文档**](docs/jarvis_book/5.功能扩展.md)。
 
 ---
 
@@ -197,7 +280,7 @@ Jarvis 被设计为高度可扩展的框架。您可以轻松地：
 - **[第二章：快速开始](docs/jarvis_book/2.快速开始.md)**
 - **[第三章：核心概念与架构](docs/jarvis_book/3.核心概念与架构.md)**
 - **[第四章：使用指南](docs/jarvis_book/4.使用指南.md)**
-- **[第五章：工具开发](docs/jarvis_book/5.工具开发.md)**
+- **[第五章：功能扩展](docs/jarvis_book/5.功能扩展.md)**
 - **[第六章：高级主题](docs/jarvis_book/6.高级主题.md)**
 - **[第七章：参与贡献](docs/jarvis_book/7.参与贡献.md)**
 - **[第八章：常见问题](docs/jarvis_book/8.常见问题.md)**
@@ -216,6 +299,13 @@ Jarvis 被设计为高度可扩展的框架。您可以轻松地：
 
 ---
 
+## ⚠️ 免责声明 <a id="disclaimer"></a>
+
+- **模型使用风险**: 频繁使用通过非官方API（如腾讯元宝、Kimi、通义千问等）接入的模型可能会导致您的账户被平台封禁。请合理使用，并自行承担相应风险。
+- **命令执行风险**: Jarvis具备执行系统命令的能力。请确保您了解将要执行的命令，并避免输入可能导致系统风险的指令。为了增强安全性，您可以在配置文件中启用工具执行确认（`JARVIS_EXECUTE_TOOL_CONFIRM: true`），以便在执行每个工具前进行手动确认。
+
+---
+
 ## 📄 许可证 <a id="license"></a>
 
 本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件。

{jarvis_ai_assistant-0.2.2.dist-info → jarvis_ai_assistant-0.2.4.dist-info}/RECORD

@@ -1,20 +1,20 @@
-jarvis/__init__.py,sha256=rtajFgNEXT7gc8K28B_xDpASjeMEaIwc9yBA9fWhG6E,73
+jarvis/__init__.py,sha256=S61oLarYay1rhLcBt-WbaPF2ViSt-gtq-aUNYUXQS9s,73
 jarvis/jarvis_agent/__init__.py,sha256=BmBbMUsCwe_0znrwxSipaKj-MuOgJTZvLbyKzBFfpic,22559
 jarvis/jarvis_agent/builtin_input_handler.py,sha256=Qs4LAr4xdKLBJpQE81YP4CkucAop86ms0iVoKa1nnso,2468
-jarvis/jarvis_agent/edit_file_handler.py,sha256=ml1o-BE2Ca1-ybPlKuhstLQYwdJag39o0_-PXTUvFaE,11646
-jarvis/jarvis_agent/jarvis.py,sha256=PQ2dHPWeCAHL4JCk-_oYa26pP2bIWUdokkO-VW7-6h0,8185
-jarvis/jarvis_agent/main.py,sha256=IM9_AsCmTw4QYLp3AMF97kRGctQC2pEIZls6zxZgUSQ,3319
+jarvis/jarvis_agent/edit_file_handler.py,sha256=a-SFLZs4FNjyVIkEi1PwPj7KT9np_ItMeaRNUoGHEWU,11858
+jarvis/jarvis_agent/jarvis.py,sha256=L2sI-Y7gxqH6M4E4F2GlNoZcxxvz_f72rxvjh7bxuZE,8443
+jarvis/jarvis_agent/main.py,sha256=56pLVy6v-3ZdyPCcWXdRkgbjmYsoIfC7zrA6B7sYivU,3334
 jarvis/jarvis_agent/output_handler.py,sha256=P7oWpXBGFfOsWq7cIhS_z9crkQ19ES7qU5pM92KKjAs,1172
 jarvis/jarvis_agent/prompt_builder.py,sha256=PH1fPDVa8z_RXkoXHJFNDf8PQjUoLNLYwkh2lC__p40,1705
-jarvis/jarvis_agent/prompts.py,sha256=e8i-3kaGr96mlzL3UUhQUHFDfbJSoE4xiF9TDksNDm4,7720
+jarvis/jarvis_agent/prompts.py,sha256=VLQtz75X5qExQkSwYlJYQzNLpDMdByr4FaY71POVLMI,8713
 jarvis/jarvis_agent/protocols.py,sha256=JWnJDikFEuwvFUv7uzXu0ggJ4O9K2FkMnfVCwIJ5REw,873
 jarvis/jarvis_agent/session_manager.py,sha256=DnvI9rWkVmkyO1XfKZyo9lTn4ajg4ccwzEkoRHFPOJM,2925
 jarvis/jarvis_agent/shell_input_handler.py,sha256=1IboqdxcJuoIqRpmDU10GugR9fWXUHyCEbVF4nIWbyo,1328
 jarvis/jarvis_agent/tool_executor.py,sha256=nIq-sPNgrtimtM-IHpN09cWmId8jDzWRdCFoRzXnnoo,1721
 jarvis/jarvis_code_agent/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-jarvis/jarvis_code_agent/code_agent.py,sha256=n0_sOXuGgzSQKLUj64ap0lWqKR67RZPnO3jpl2YD7MI,18681
+jarvis/jarvis_code_agent/code_agent.py,sha256=BQvXXN4zjJd7xlZEqqEZmB9KBGNDrzDglRM8QblkpbU,29414
 jarvis/jarvis_code_agent/lint.py,sha256=LZPsfyZPMo7Wm7LN4osZocuNJwZx1ojacO3MlF870x8,4009
-jarvis/jarvis_code_analysis/code_review.py,sha256=3oRxB4Ks2lbnzQpPWFU6cpwpVz1sWtQ7OAT-kwZOUSI,32150
+jarvis/jarvis_code_analysis/code_review.py,sha256=TMov1pqDe1bg0vM1ndnYeW9ejHrRN_jMroo3T4L9yag,32368
 jarvis/jarvis_code_analysis/checklists/__init__.py,sha256=LIXAYa1sW3l7foP6kohLWnE98I_EQ0T7z5bYKHq6rJA,78
 jarvis/jarvis_code_analysis/checklists/c_cpp.py,sha256=9t62bMqs6qTkFSio4SKkj88qyb5ZubWrw3MxJBQ4X1A,1317
 jarvis/jarvis_code_analysis/checklists/csharp.py,sha256=ShPXrl2_UPAnGaCHAG2wLl90COG3HK2XCSr1UK2dxN4,2420
@@ -35,15 +35,15 @@ jarvis/jarvis_code_analysis/checklists/shell.py,sha256=aRFYhQQvTgbYd-uY5pc8UHIUA
 jarvis/jarvis_code_analysis/checklists/sql.py,sha256=vR0T6qC7b4dURjJVAd7kSVxyvZEQXPG1Jqc2sNTGp5c,2355
 jarvis/jarvis_code_analysis/checklists/swift.py,sha256=TPx4I6Gupvs6tSerRKmTSKEPQpOLEbH2Y7LXg1uBgxc,2566
 jarvis/jarvis_code_analysis/checklists/web.py,sha256=25gGD7pDadZQybNFvALYxWvK0VRjGQb1NVJQElwjyk0,3943
-jarvis/jarvis_data/config_schema.json,sha256=XpQ7aaHMW-YCuFrnaAEjMWrnv6a8B7MqGjm2XgrvtgQ,8573
+jarvis/jarvis_data/config_schema.json,sha256=4HnTn0BUBEyohAOzj70BhtHMIQiwzwTXIQ3dn652JTg,10539
 jarvis/jarvis_data/tiktoken/9b5ad71b2ce5302211f9c61530b329a4922fc6a4,sha256=Ijkht27pm96ZW3_3OFE-7xAPtR0YyTWXoRO8_-hlsqc,1681126
 jarvis/jarvis_git_squash/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-jarvis/jarvis_git_squash/main.py,sha256=8_ADMTGi8Z41mqKCed4zHOd3nZCqEDWfqVLWpnYvCnE,2263
-jarvis/jarvis_git_utils/git_commiter.py,sha256=fJ97nvvDt-0E8E4PbeMvptx_yoJXFAObhaPVb3mjO_g,12676
+jarvis/jarvis_git_squash/main.py,sha256=6PECdAbTbrsJBRLK1pXBh4hdJ_LADh-XXSic1xJi97E,2255
+jarvis/jarvis_git_utils/git_commiter.py,sha256=M6SnhF_GJktO0mIT8_Y4J4Zin7-w3V_MJADndfQ9_QU,13550
 jarvis/jarvis_mcp/__init__.py,sha256=OPMtjD-uq9xAaKCRIDyKIosaFfBe1GBPu1az-mQ0rVM,2048
-jarvis/jarvis_mcp/sse_mcp_client.py,sha256=AhYLPQb0mE9-6ZQw1JesRNyEy0esJumNEFb5LyzyIn0,22612
+jarvis/jarvis_mcp/sse_mcp_client.py,sha256=neKrgFxwLDPWjVrl9uDt1ricNwbLZbv1ZEFh0IkmqZk,22656
 jarvis/jarvis_mcp/stdio_mcp_client.py,sha256=APYUksYKlMx7AVNODKOLrTkKZPnp4kqTQIYIuNDDKko,11286
-jarvis/jarvis_mcp/streamable_mcp_client.py,sha256=1OZpsG82U2MLbGuojllJAblFUAMmp1N0i5fsKM4n5Ts,14453
+jarvis/jarvis_mcp/streamable_mcp_client.py,sha256=sP0KEsxVcXGht0eA7a_m-ECtZAk39s4PL9OUdm35x2Y,14467
 jarvis/jarvis_methodology/main.py,sha256=6QF8hH3vB6rfxim0fPR34uVPf41zVpb4ZLqrFN2qONg,10983
 jarvis/jarvis_multi_agent/__init__.py,sha256=kCgtAX7VvliyEOQxIj2DvNjRAuh6bpNaOtDn60nzph4,6089
 jarvis/jarvis_multi_agent/main.py,sha256=EUJCLjiN6ZZkOTmRS13oeTquo3tXD-cdO_QvaEPCK_c,1715
@@ -54,54 +54,59 @@ jarvis/jarvis_platform/human.py,sha256=cSN8Lqf0ts2_pPfS2_v7PaWxQKqcW_3bSmhRTHey7
 jarvis/jarvis_platform/kimi.py,sha256=HzNcdQ3tO2ndHk02mfD9DeeGP7JVFnQ1pbkAVF21jjA,14222
 jarvis/jarvis_platform/openai.py,sha256=ccGqsU2cFfd5324P7SH1tSmFABpvto8fytmxQGkr3BA,6412
 jarvis/jarvis_platform/registry.py,sha256=1bMy0YZUa8NLzuZlKfC4CBtpa0iniypTxUZk0Hv6g9Y,8415
-jarvis/jarvis_platform/tongyi.py,sha256=d0l2S9P80CF1OgloCI9qXa1Qnfy6yMYjsmuOVAEW99I,22021
+jarvis/jarvis_platform/tongyi.py,sha256=22NPrJDrd4Zag2oWlytZ9--vA3hLJhJ2YJ-kM5RwLQ8,22212
 jarvis/jarvis_platform/yuanbao.py,sha256=FbkpMs_hUL8bGJHbWivQEynnU892-5qPsMe0xASGXkI,22673
 jarvis/jarvis_platform_manager/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 jarvis/jarvis_platform_manager/main.py,sha256=V320cEk2CP-NhmdNr0dED77VOUTJ6ODYL0YXC7wLZzw,17513
 jarvis/jarvis_platform_manager/service.py,sha256=hQGWQ2qAlzm_C_lNQDuLORQ4rmjR1P1-V3ou7l2Bv0s,13622
 jarvis/jarvis_rag/__init__.py,sha256=HRTXgnQxDuaE9x-e3r6SYqhJ5d4DSI_rrIxy2IGY6qk,320
 jarvis/jarvis_rag/cache.py,sha256=Tqx_Oe-AhuWlMXHGHUaIuG6OEHoHBVZq7mL3kldtFFU,2723
-jarvis/jarvis_rag/cli.py,sha256=q1W7XWZ7u7oMckqeNUX7YQoiQ3PzT3Rh-FZvTeG_U3I,13159
+jarvis/jarvis_rag/cli.py,sha256=bIQKibp8swJDyfFBXaiX5C20LHN_2W2knO2I-MQp58c,15620
 jarvis/jarvis_rag/embedding_manager.py,sha256=BoV6Vr_3F4zbjBAOQ1FdEBnJXGPwBkv1IEkdRP9CgFw,3338
 jarvis/jarvis_rag/llm_interface.py,sha256=eZHibNHD5dFK9yolr3hYNNhAEZUsPA-cIf1uHapI2h8,4338
-jarvis/jarvis_rag/query_rewriter.py,sha256=JM1Q23zZISze77BleRgTPgNAtLUtLAXkEo3G70kaTK8,2190
-jarvis/jarvis_rag/rag_pipeline.py,sha256=9yeNRv6qOS2zo7o0b0u3gFmiW_XSivesvPKVJ8e5DlE,6209
+jarvis/jarvis_rag/query_rewriter.py,sha256=rmXj-j3jjsOR-Dj9Hk5exfCJqZ4uCxMFfvybzurpj5w,4047
+jarvis/jarvis_rag/rag_pipeline.py,sha256=MSVfTVqDRK1_m0SMeOBcqirAyrd8GsVC27vanMbUCUY,10598
 jarvis/jarvis_rag/reranker.py,sha256=wYUDIMHQL8_tFcQ7GFn_zYHTE1AbKk4a9TRoN2lKtA8,1767
-jarvis/jarvis_rag/retriever.py,sha256=B6oq1SAh7QAE9G5o0sXyNtLjFodukd8p-Was2QJZXg0,7637
+jarvis/jarvis_rag/retriever.py,sha256=vI-T_L6zdGOm2YCq98CEx0cevz8lKp0iVfjV4nQ3oJs,7681
 jarvis/jarvis_smart_shell/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-jarvis/jarvis_smart_shell/main.py,sha256=MXUVaXvT9zOxykbQphCGEXUCRhdOhEthQxHba_D4oiE,6015
+jarvis/jarvis_smart_shell/main.py,sha256=ReCC9bWPlgl84ylI0uvdzlE3J6fS0XzFSLOpQQyDcMY,6008
+jarvis/jarvis_stats/__init__.py,sha256=jJzgP43nxzLbNGs8Do4Jfta1PNCJMf1Oq9YTPd6EnFM,342
+jarvis/jarvis_stats/cli.py,sha256=o62mfyfQRRWEEDsiORhqF4RUZjDsB2OPXEvbN8I_qxA,10127
+jarvis/jarvis_stats/stats.py,sha256=vN4qhugldKJwpw0yBUwCt7rnGonXElwq_DjuwmGiioc,13978
+jarvis/jarvis_stats/storage.py,sha256=jGHgudtx-N-EgEWFUbbg13-K5t2iORsRwd-1_WMRdKk,10708
+jarvis/jarvis_stats/visualizer.py,sha256=Zj-HPB0ZLx66L9Fk6taOmII-C0xQssWC4Gb6Rfp0XoA,13561
 jarvis/jarvis_tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 jarvis/jarvis_tools/ask_user.py,sha256=M6DdLNryCE8y1JcdZHEifUgZkPUEPNKc-zDW5p0Mb1k,2029
 jarvis/jarvis_tools/base.py,sha256=tFVmK6ppsImW2BzHZmrNmMRiOJdW-4aZP6Me3VxdYcA,1194
 jarvis/jarvis_tools/edit_file.py,sha256=hM345E9rxS-EkqCZpwwizL6fmPdTadtB798tEO5Ce3g,10417
 jarvis/jarvis_tools/execute_script.py,sha256=gMarE5yCCSPU6Dp6HlcL2KT-2xCzR-1p-oQNlYOJK58,6157
 jarvis/jarvis_tools/file_analyzer.py,sha256=aVe1jBSp0YmlypihxrGADJpYrU_7CxDETxGUNySuSlI,4044
-jarvis/jarvis_tools/generate_new_tool.py,sha256=ppMRuTYUZ0c02rHo7xi8DCGiDVPZTANVp9nS7bvkqqo,7819
+jarvis/jarvis_tools/generate_new_tool.py,sha256=uaWKlDMGjetvvwKTj0_AVTdmd14IktRbU3cpzKCBiIQ,8728
 jarvis/jarvis_tools/methodology.py,sha256=_K4GIDUodGEma3SvNRo7Qs5rliijgNespVLyAPN35JU,5233
 jarvis/jarvis_tools/read_code.py,sha256=EnI-R-5HyIQYhMD391nZWXHIuHHBF-OJIRE0QpLcPX4,6417
 jarvis/jarvis_tools/read_webpage.py,sha256=NmDUboVZd4CGHBPRFK6dp3uqVhuGopW1bOi3TcaLDF4,2092
-jarvis/jarvis_tools/registry.py,sha256=etJicnDvmfvu3MZwF4LiufKL63sV812FUZOpBBS28DU,28195
+jarvis/jarvis_tools/registry.py,sha256=WSR8DxC5VSSQVLU42Pgc97_eAo5EQhmO0que1CzAVpc,28703
 jarvis/jarvis_tools/rewrite_file.py,sha256=eG_WKg6cVAXmuGwUqlWkcuyay5S8DOzEi8vZCmX3O8w,7255
-jarvis/jarvis_tools/search_web.py,sha256=qh3MomJNDzpw5JTBbJWxzJmIdmuUt2SZNqJNc8LJrO4,5829
-jarvis/jarvis_tools/virtual_tty.py,sha256=KKr3jpvQWWMPr2o40hlmN6fuXJCN8H4_ma5QU40Citc,16089
+jarvis/jarvis_tools/search_web.py,sha256=zh6EYLQPIQneoz27Hheh-fifMeMNhrTVldXKMSsMz2Y,5801
+jarvis/jarvis_tools/virtual_tty.py,sha256=LTsg1PlsPvgaLShUaxpAKwTpyjXRr0l0qSREI7Q-fBc,26349
 jarvis/jarvis_tools/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-jarvis/jarvis_tools/cli/main.py,sha256=ZOvdC6wEOTdhTJy8ZDF_AKlH0jBmVcbOrU-8JPK2gWM,4703
+jarvis/jarvis_tools/cli/main.py,sha256=3kizOkAmld3ZiTnSoUx4Xo2XO7BnrPnyITKCMBFod1w,7765
 jarvis/jarvis_utils/__init__.py,sha256=67h0ldisGlh3oK4DAeNEL2Bl_VsI3tSmfclasyVlueM,850
 jarvis/jarvis_utils/builtin_replace_map.py,sha256=4BurljGuiG_I93EBs7mlFlPm9wYC_4CmdTG5tQWpF6g,1712
-jarvis/jarvis_utils/config.py,sha256=YcPGjCSJ2_2CKtlY8ecyqaovKVb65XcQ5WNizjwmdVs,10689
+jarvis/jarvis_utils/config.py,sha256=nXeQPEhZZw8UMPOsVNFGEh7SscTSe_1f9oDQwrLhfMo,12950
 jarvis/jarvis_utils/embedding.py,sha256=oEOEM2qf16DMYwPsQe6srET9BknyjOdY2ef0jsp3Or8,2714
 jarvis/jarvis_utils/file_processors.py,sha256=XiM248SHS7lLgQDCbORVFWqinbVDUawYxWDOsLXDxP8,3043
-jarvis/jarvis_utils/git_utils.py,sha256=_b4-5uWOTVFjAB48QbRJNBR7PTD_jzi7-5V5M_wjXFo,21740
-jarvis/jarvis_utils/globals.py,sha256=QKeiiWhUlu9HE7SzAn0lKaeaXQF1uhmLXPZTeLKyGPQ,4048
+jarvis/jarvis_utils/git_utils.py,sha256=dkC0HcUdm_rF5vXNoLByne3mGykZEviD3Lo_SYbwROU,21667
+jarvis/jarvis_utils/globals.py,sha256=INBGXbDkXOQa0AE7L6JhR5gr-TAZMsE5y4yK1sbB98U,4643
 jarvis/jarvis_utils/http.py,sha256=eRhV3-GYuWmQ0ogq9di9WMlQkFcVb1zGCrySnOgT1x0,4392
-jarvis/jarvis_utils/input.py,sha256=V2w3xV0MO73c4Y4XY_yy9jVNg7MmN76FmAnpKRiJUog,9160
+jarvis/jarvis_utils/input.py,sha256=g0Xa1TNZHxLaYduREV_Wc55iqHD6djN73YFJbR83gUg,9488
 jarvis/jarvis_utils/methodology.py,sha256=V2Y0mbamrWBhhCK-3foAM1hKewOEcIDcXO-Sv_AU-kQ,9106
 jarvis/jarvis_utils/output.py,sha256=E_J_RYXtkOgRiDSHCRE9QPHY8WQmmhIotQtIQru8GZA,10888
 jarvis/jarvis_utils/tag.py,sha256=f211opbbbTcSyzCDwuIK_oCnKhXPNK-RknYyGzY1yD0,431
-jarvis/jarvis_utils/utils.py,sha256=G6UuiBrPlWLpau1LbSGStrlAHCHG8JufINLD_bwtjTE,20006
-jarvis_ai_assistant-0.2.2.dist-info/licenses/LICENSE,sha256=AGgVgQmTqFvaztRtCAXsAMryUymB18gZif7_l2e1XOg,1063
-jarvis_ai_assistant-0.2.2.dist-info/METADATA,sha256=I2MdBpFwqLwq8kSfG--5ULCddP6OL-ZRHARbmyG6EQ8,9255
-jarvis_ai_assistant-0.2.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-jarvis_ai_assistant-0.2.2.dist-info/entry_points.txt,sha256=nXgfarEvf9Zelwvl6yGa4Zmqpsa7dDTahlzHRHL8qvM,1178
-jarvis_ai_assistant-0.2.2.dist-info/top_level.txt,sha256=1BOxyWfzOP_ZXj8rVTDnNCJ92bBGB0rwq8N1PCpoMIs,7
-jarvis_ai_assistant-0.2.2.dist-info/RECORD,,
+jarvis/jarvis_utils/utils.py,sha256=3DbUczVY9kzyAwbpA4mk9AuTUOG0L4Oviw-Cjdn0bF0,27289
+jarvis_ai_assistant-0.2.4.dist-info/licenses/LICENSE,sha256=AGgVgQmTqFvaztRtCAXsAMryUymB18gZif7_l2e1XOg,1063
+jarvis_ai_assistant-0.2.4.dist-info/METADATA,sha256=GdY7W685Ylx4SOOUTNw9WeFXNeRkiTA1WWISdXxfJeo,16641
+jarvis_ai_assistant-0.2.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+jarvis_ai_assistant-0.2.4.dist-info/entry_points.txt,sha256=8cwi1VxZGU5UeSZMFiH-jG6NK95Asjukj5SBLBrGiGo,1257
+jarvis_ai_assistant-0.2.4.dist-info/top_level.txt,sha256=1BOxyWfzOP_ZXj8rVTDnNCJ92bBGB0rwq8N1PCpoMIs,7
+jarvis_ai_assistant-0.2.4.dist-info/RECORD,,

{jarvis_ai_assistant-0.2.2.dist-info → jarvis_ai_assistant-0.2.4.dist-info}/entry_points.txt

@@ -11,6 +11,7 @@ jarvis-multi-agent = jarvis.jarvis_multi_agent.main:main
 jarvis-platform-manager = jarvis.jarvis_platform_manager.main:main
 jarvis-rag = jarvis.jarvis_rag.cli:main
 jarvis-smart-shell = jarvis.jarvis_smart_shell.main:main
+jarvis-stats = jarvis.jarvis_stats.cli:main
 jarvis-tool = jarvis.jarvis_tools.cli.main:main
 jca = jarvis.jarvis_code_agent.code_agent:main
 jcr = jarvis.jarvis_code_analysis.code_review:main
@@ -21,5 +22,6 @@ jma = jarvis.jarvis_multi_agent.main:main
 jpm = jarvis.jarvis_platform_manager.main:main
 jrg = jarvis.jarvis_rag.cli:main
 jss = jarvis.jarvis_smart_shell.main:main
+jst = jarvis.jarvis_stats.cli:main
 jt = jarvis.jarvis_tools.cli.main:main
 jvs = jarvis.jarvis_agent.jarvis:main