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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jarvis-ai-assistant
-Version: 0.2.2
+Version: 0.2.3
 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,78 @@ 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 负责具体的探索、总结和代码（文档）修改任务，将一个模糊的想法快速落地为结构清晰的文档。
+
+### 👥 目标用户
+
+**谁适合使用 Jarvis？**
+
+*   **个人开发者和极客**: 希望通过AI提升个人开发、学习和探索效率的用户。
+*   **需要处理碎片化任务的工程师**: 面对各种一次性、非标准化的技术任务，例如快速编写脚本、调试代码、搭建新环境等。
+*   **AI应用探索者**: 希望有一个灵活的本地框架来实验和集成不同的大语言模型和工具。
+
+**谁可能不适合？**
+
+*   **寻求固定工作流自动化的人**: 如果您的需求是高度固定和重复的，例如“每天定时抓取数据并生成报告”，那么编写一个专门的、功能单一的脚本可能是更直接、更高效的解决方案。Jarvis 更擅长处理多变和探索性的任务。
+*   **企业级团队协作者**: Jarvis 被设计为个人工具，不包含团队管理、权限控制等面向企业级协作的功能。
+
+总之，Jarvis 是为每一位开发者量身打造的个人助手，而非用于团队协作的集中式平台。
+
+---
+
 ## 🚀 快速开始 <a id="quick-start"></a>
 
 ### 系统要求
@@ -134,7 +198,7 @@ Jarvis 包含一系列专注于不同任务的工具。以下是主要命令及
 | `jarvis-rag` | `jrg` | 构建和查询本地化的RAG知识库 |
 | `jarvis-smart-shell` | `jss` | 实验性的智能Shell功能 |
 
-更多详细用法和参数，请查阅我们的 [**Wiki 文档**](https://deepwiki.com/skyfireitdiy/Jarvis)。
+更多详细用法和参数，请查阅我们的 [**使用指南**](docs/jarvis_book/4.使用指南.md)。
 
 ---
 
@@ -174,7 +238,9 @@ ENV:
   YUANBAO_COOKIES: "在此处粘贴您的元宝Cookies"
 ```
 
-Jarvis 支持多种平台，包括 **Kimi**, **通义千问**, **OpenAI** 等。详细的配置选项、模型组设置以及所有可用参数，请参阅 [**配置文档**](https://deepwiki.com/skyfireitdiy/Jarvis)。
+Jarvis 支持多种平台，包括 **Kimi**, **通义千问**, **OpenAI** 等。详细的配置选项、模型组设置以及所有可用参数，请参阅 [**使用指南**](docs/jarvis_book/4.使用指南.md)。
+
+> **模型推荐**: 目前效果最好的模型是 `gemini-1.5-pro`，可以通过国内代理商购买，例如 [FoxiAI](https://foxi-ai.top)。
 
 ---
 
@@ -185,7 +251,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 +263,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 +282,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.3/README.md

@@ -0,0 +1,217 @@
+# 🤖 Jarvis AI 助手
+<p align="center">
+  <img src="docs/images/jarvis-logo.png" alt="Jarvis Logo" width="200"/>
+</p>
+<div align="center">
+
+[![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文档](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 负责具体的探索、总结和代码（文档）修改任务，将一个模糊的想法快速落地为结构清晰的文档。
+
+### 👥 目标用户
+
+**谁适合使用 Jarvis？**
+
+*   **个人开发者和极客**: 希望通过AI提升个人开发、学习和探索效率的用户。
+*   **需要处理碎片化任务的工程师**: 面对各种一次性、非标准化的技术任务，例如快速编写脚本、调试代码、搭建新环境等。
+*   **AI应用探索者**: 希望有一个灵活的本地框架来实验和集成不同的大语言模型和工具。
+
+**谁可能不适合？**
+
+*   **寻求固定工作流自动化的人**: 如果您的需求是高度固定和重复的，例如“每天定时抓取数据并生成报告”，那么编写一个专门的、功能单一的脚本可能是更直接、更高效的解决方案。Jarvis 更擅长处理多变和探索性的任务。
+*   **企业级团队协作者**: Jarvis 被设计为个人工具，不包含团队管理、权限控制等面向企业级协作的功能。
+
+总之，Jarvis 是为每一位开发者量身打造的个人助手，而非用于团队协作的集中式平台。
+
+---
+
+## 🚀 快速开始 <a id="quick-start"></a>
+
+### 系统要求
+- **Linux**: 完全支持。
+- **Windows**: 未经充分测试，建议在 [WSL](https://docs.microsoft.com/en-us/windows/wsl/install) 中使用。
+
+### 安装
+
+#### 一键安装 (推荐)
+只需一行命令即可完成所有安装和配置：
+```bash
+bash -c "$(curl -fsSL https://raw.githubusercontent.com/skyfireitdiy/Jarvis/main/scripts/install.sh)"
+```
+> 该脚本会自动检测Python环境、克隆项目、安装依赖并设置好路径。
+
+#### 手动安装
+```bash
+git clone https://github.com/skyfireitdiy/Jarvis
+cd Jarvis
+pip3 install -e .
+```
+或者从PyPI安装 (可能不是最新版):
+```bash
+pip3 install jarvis-ai-assistant
+```
+
+### 基本使用
+Jarvis 包含一系列专注于不同任务的工具。以下是主要命令及其快捷方式：
+
+| 命令 | 快捷方式 | 功能描述 |
+|------|----------|----------|
+| `jarvis` | `jvs` | 通用AI代理，适用于多种任务 |
+| `jarvis-code-agent` | `jca` | 专注于代码分析、修改和生成的代码代理 |
+| `jarvis-git-commit` | `jgc` | 自动化分析代码变更并生成规范的Git提交信息 |
+| `jarvis-platform-manager` | `jpm` | 管理和测试不同的大语言模型平台 |
+| `jarvis-rag` | `jrg` | 构建和查询本地化的RAG知识库 |
+| `jarvis-smart-shell` | `jss` | 实验性的智能Shell功能 |
+
+更多详细用法和参数，请查阅我们的 [**使用指南**](docs/jarvis_book/4.使用指南.md)。
+
+---
+
+## 🌟 核心功能 <a id="core-features"></a>
+
+- **🆓 零成本接入**: 无缝集成腾讯元宝、Kimi等优质模型，无需支付API费用。
+- **🛠️ 工具驱动**: 内置丰富工具集，涵盖脚本执行、代码开发、网页搜索、终端操作等。
+- **🤖 人机协作**: 支持实时交互，用户可随时介入指导，确保AI行为符合预期。
+- **🔌 高度可扩展**: 支持自定义工具、模型平台和MCP，轻松打造个性化工作流。
+- **🧠 RAG 增强**: 内置RAG功能，可将本地文档作为知识库，实现精准问答。
+
+### 视频演示
+- [使用`jca`为Jarvis快速扩展功能](https://www.bilibili.com/video/BV1TCgLzvE6Q/)
+- [10分钟搭建aarch64容器化Rust开发环境](https://www.bilibili.com/video/BV1K3ghzkEzZ/)
+- [`jarvis-code-agent` 功能演示](https://www.bilibili.com/video/BV1KugbzKE6U/)
+
+---
+
+## ⚙️ 配置说明 <a id="configuration"></a>
+
+Jarvis 的主要配置文件位于 `~/.jarvis/config.yaml`。您可以在此文件中配置模型、平台和其他行为。
+
+**基本配置示例 (腾讯元宝):**
+```yaml
+# ~/.jarvis/config.yaml
+
+# 使用的模型平台
+JARVIS_PLATFORM: yuanbao
+JARVIS_MODEL: deep_seek_v3
+
+# 用于“思考”步骤的模型，通常选择能力更强的模型
+JARVIS_THINKING_PLATFORM: yuanbao
+JARVIS_THINKING_MODEL: deep_seek
+
+# 平台所需的环境变量
+ENV:
+  YUANBAO_COOKIES: "在此处粘贴您的元宝Cookies"
+```
+
+Jarvis 支持多种平台，包括 **Kimi**, **通义千问**, **OpenAI** 等。详细的配置选项、模型组设置以及所有可用参数，请参阅 [**使用指南**](docs/jarvis_book/4.使用指南.md)。
+
+> **模型推荐**: 目前效果最好的模型是 `gemini-1.5-pro`，可以通过国内代理商购买，例如 [FoxiAI](https://foxi-ai.top)。
+
+---
+
+## 🛠️ 扩展开发 <a id="extensions"></a>
+
+Jarvis 被设计为高度可扩展的框架。您可以轻松地：
+- **添加新工具**: 在 `~/.jarvis/tools/` 目录下创建新的工具实现。
+- **集成新LLM平台**: 在 `~/.jarvis/platforms/` 目录下添加新的平台适配器。
+- **定义MCP**: 通过配置文件集成外部或自定义的命令协议。
+
+有关扩展开发的详细指南和[**技术细节**](docs/technical_documentation.md)，请访问我们的 [**开发者文档**](docs/jarvis_book/5.功能扩展.md)。
+
+---
+
+## 📖 Jarvis Book <a id="jarvis-book"></a>
+
+欢迎阅读 Jarvis 的官方文档，这本开源书籍旨在为您提供从入门到精通的全方位指南。
+
+- **[第一章：项目介绍](docs/jarvis_book/1.项目介绍.md)**
+- **[第二章：快速开始](docs/jarvis_book/2.快速开始.md)**
+- **[第三章：核心概念与架构](docs/jarvis_book/3.核心概念与架构.md)**
+- **[第四章：使用指南](docs/jarvis_book/4.使用指南.md)**
+- **[第五章：功能扩展](docs/jarvis_book/5.功能扩展.md)**
+- **[第六章：高级主题](docs/jarvis_book/6.高级主题.md)**
+- **[第七章：参与贡献](docs/jarvis_book/7.参与贡献.md)**
+- **[第八章：常见问题](docs/jarvis_book/8.常见问题.md)**
+- **[第九章：附录](docs/jarvis_book/9.附录.md)**
+
+---
+
+## 🤝 贡献指南 <a id="contributing"></a>
+
+我们欢迎任何形式的贡献！
+1. Fork 本仓库
+2. 创建您的特性分支 (`git checkout -b feature/AmazingFeature`)
+3. 提交您的更改 (`git commit -m 'Add some AmazingFeature'`)
+4. 推送到分支 (`git push origin feature/AmazingFeature`)
+5. 开启一个 Pull Request
+
+---
+
+## ⚠️ 免责声明 <a id="disclaimer"></a>
+
+- **模型使用风险**: 频繁使用通过非官方API（如腾讯元宝、Kimi、通义千问等）接入的模型可能会导致您的账户被平台封禁。请合理使用，并自行承担相应风险。
+- **命令执行风险**: Jarvis具备执行系统命令的能力。请确保您了解将要执行的命令，并避免输入可能导致系统风险的指令。为了增强安全性，您可以在配置文件中启用工具执行确认（`JARVIS_EXECUTE_TOOL_CONFIRM: true`），以便在执行每个工具前进行手动确认。
+
+---
+
+## 📄 许可证 <a id="license"></a>
+
+本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件。
+
+---
+<div align="center">
+由 Jarvis 团队用 ❤️ 制作
+</div>
+
+![Jarvis技术支持群](docs/images/wechat.png)

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "jarvis-ai-assistant"
-version = "0.2.2"
+version = "0.2.3"
 description = "Jarvis: An AI assistant that uses tools to interact with the system"
 readme = "README.md"
 authors = [{ name = "skyfire", email = "skyfireitdiy@hotmail.com" }]
@@ -40,8 +40,10 @@ dependencies = [
     "ddgs==9.0.2",
     "lxml==6.0.0",
     "markdownify>=1.1.0",
+    "typer",
+    "pathspec",
 ]
-requires-python = ">=3.9"
+requires-python = ">=3.9,<3.13"
 
 [project.optional-dependencies]
 dev = ["pytest", "black", "isort", "mypy", "build", "twine"]
@@ -53,7 +55,6 @@ rag = [
     "diskcache",
     "sentence-transformers==2.7.0",
     "torch>=2.6",
-    "typer",
     "unstructured[md]",
     "rank-bm25",
 ]
@@ -61,6 +62,9 @@ rag = [
 [project.urls]
 Homepage = "https://github.com/skyfireitdiy/Jarvis"
 
+[tool.isort]
+profile = "black"
+
 [project.scripts]
 jarvis = "jarvis.jarvis_agent.jarvis:main"
 jvs = "jarvis.jarvis_agent.jarvis:main"

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

@@ -3,7 +3,7 @@ from setuptools import setup, find_packages  # type: ignore
 
 setup(
     name="jarvis-ai-assistant",
-    version="0.2.2",
+    version="0.2.3",
     author="skyfire",
     author_email="skyfireitdiy@hotmail.com",
     description="An AI assistant that uses various tools to interact with the system",
@@ -35,6 +35,7 @@ setup(
         "ddgs==9.0.2",
         "lxml==6.0.0",
         "markdownify>=1.1.0",
+        "typer",
     ],
     extras_require={
         "dev": ["pytest", "black", "isort", "mypy", "build", "twine"],
@@ -46,9 +47,9 @@ setup(
             "diskcache",
             "sentence-transformers==2.7.0",
             "torch>=2.6",
-            "typer",
             "unstructured[md]",
             "rank-bm25",
+            "pathspec",
         ],
     },
     entry_points={
@@ -79,7 +80,7 @@ setup(
             "jrg=jarvis.jarvis_rag.cli:main",
         ],
     },
-    python_requires=">=3.9",
+    python_requires=">=3.9,<3.13",
     classifiers=[
         "Development Status :: 3 - Alpha",
         "Intended Audience :: Developers",

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

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

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

@@ -113,6 +113,31 @@ TASK_ANALYSIS_PROMPT = f"""<task_analysis>
            "stderr": f"操作失败: {{str(e)}}"
        }}
    ```
+4. **在工具中调用大模型**：如果工具需要调用大模型来完成子任务（例如，生成代码、分析文本等），为了避免干扰主对话流程，建议创建一个独立的大模型实例。
+   ```python
+    # 通过 agent 实例获取模型配置
+    agent = args.get("agent")
+    if not agent:
+        return {{"success": False, "stderr": "Agent not found."}}
+    
+    current_model = agent.model
+    platform_name = current_model.platform_name()
+    model_name = current_model.name()
+
+    # 创建独立的模型实例
+    from jarvis.jarvis_platform.registry import PlatformRegistry
+    llm = PlatformRegistry().create_platform(platform_name)
+    if not llm:
+        return {{"success": False, "stderr": f"Platform {{platform_name}} not found."}}
+    
+    llm.set_model_name(model_name)
+    llm.set_suppress_output(True) # 工具内的调用通常不需要流式输出
+
+    # 使用新实例调用大模型
+    PrettyOutput.print("正在执行子任务...", OutputType.INFO)
+    response = llm.chat_until_success("你的提示词")
+    PrettyOutput.print("子任务完成", OutputType.SUCCESS)
+   ```
 </tool_requirements>
 <methodology_requirements>
 方法论格式要求:
@@ -139,10 +164,7 @@ arguments:
     from jarvis.jarvis_utils.output import PrettyOutput, OutputType
     class 工具名称:
         name = "工具名称"
-        description = "Tool for text transformation"
-                Tool description
-        适用场景：1. 格式化文本; 2. 处理标题; 3. 标准化输出
-        \"\"\"
+        description = "Tool description"
         parameters = {{
             "type": "object",
             "properties": {{

{jarvis_ai_assistant-0.2.2 → jarvis_ai_assistant-0.2.3}/src/jarvis/jarvis_data/config_schema.json

@@ -141,38 +141,47 @@
       "description": "思考操作模型名称",
       "default": "deep_seek"
     },
-    "JARVIS_MODEL_GROUP": {
+    "JARVIS_LLM_GROUP": {
       "type": "string",
-      "description": "选择一个预定义的模型组"
+      "description": "选择一个预定义的模型组",
+      "default": ""
     },
-    "JARVIS_MODEL_GROUPS": {
+    "JARVIS_LLM_GROUPS": {
       "type": "array",
       "description": "预定义的模型配置组",
+      "default": [],
       "items": {
         "type": "object",
         "additionalProperties": {
           "type": "object",
           "properties": {
             "JARVIS_PLATFORM": {
-              "type": "string"
+              "type": "string",
+              "default": "yuanbao"
             },
             "JARVIS_MODEL": {
-              "type": "string"
+              "type": "string",
+              "default": "deep_seek_v3"
             },
             "JARVIS_THINKING_PLATFORM": {
-              "type": "string"
+              "type": "string",
+              "default": "yuanbao"
             },
             "JARVIS_THINKING_MODEL": {
-              "type": "string"
+              "type": "string",
+              "default": "deep_seek"
             },
             "JARVIS_MAX_TOKEN_COUNT": {
-              "type": "number"
+              "type": "number",
+              "default": 960000
             },
             "JARVIS_MAX_INPUT_TOKEN_COUNT": {
-              "type": "number"
+              "type": "number",
+              "default": 32000
             },
             "JARVIS_MAX_BIG_CONTENT_SIZE": {
-              "type": "number"
+              "type": "number",
+              "default": 160000
             }
           },
           "required": [
@@ -235,9 +244,43 @@
       "description": "是否启用静态代码分析",
       "default": true
     },
+    "JARVIS_RAG_GROUP": {
+      "type": "string",
+      "description": "选择一个预定义的RAG配置组",
+      "default": ""
+    },
+    "JARVIS_RAG_GROUPS": {
+      "type": "array",
+      "description": "预定义的RAG配置组",
+      "default": [],
+      "items": {
+        "type": "object",
+        "additionalProperties": {
+          "type": "object",
+          "properties": {
+            "embedding_model": {
+              "type": "string",
+              "default": "BAAI/bge-base-zh-v1.5"
+            },
+            "rerank_model": {
+              "type": "string",
+              "default": "BAAI/bge-reranker-base"
+            },
+            "use_bm25": {
+              "type": "boolean",
+              "default": true
+            },
+            "use_rerank": {
+              "type": "boolean",
+              "default": true
+            }
+          }
+        }
+      }
+    },
     "JARVIS_RAG": {
       "type": "object",
-      "description": "RAG框架的配置",
+      "description": "RAG框架的顶层配置。注意：此处的设置将覆盖任何由JARVIS_RAG_GROUP选择的组配置。",
       "properties": {
         "embedding_model": {
           "type": "string",
@@ -248,11 +291,23 @@
           "type": "string",
           "default": "BAAI/bge-reranker-base",
           "description": "用于RAG的rerank模型的名称, 默认为 'BAAI/bge-reranker-base'"
+        },
+        "use_bm25": {
+          "type": "boolean",
+          "default": true,
+          "description": "是否在RAG中为检索使用BM25, 默认为 true"
+        },
+        "use_rerank": {
+          "type": "boolean",
+          "default": true,
+          "description": "是否在RAG中为检索使用rerank, 默认为 true"
         }
       },
       "default": {
         "embedding_model": "BAAI/bge-base-zh-v1.5",
-        "rerank_model": "BAAI/bge-reranker-base"
+        "rerank_model": "BAAI/bge-reranker-base",
+        "use_bm25": true,
+        "use_rerank": true
       }
     },
     "JARVIS_REPLACE_MAP": {