jarvis-ai-assistant


Namejarvis-ai-assistant JSON
Version 0.3.7 PyPI version JSON
download
home_pagehttps://github.com/skyfireitdiy/Jarvis
SummaryJarvis: An AI assistant that uses tools to interact with the system
upload_time2025-08-09 14:31:57
maintainerNone
docs_urlNone
authorskyfire
requires_python<3.13,>=3.9
licenseMIT License Copyright (c) 2025 skyfire Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
keywords jarvis ai assistant tools automation
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls. 
            # 🤖 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 负责具体的探索、总结和代码（文档）修改任务，将一个模糊的想法快速落地为结构清晰的文档。

### 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>

### 系统要求
- **Linux**: 完全支持。
- **Windows**: 完全支持（需要 PowerShell）。

### 安装

#### 一键安装 (推荐)
只需一行命令即可完成所有安装和配置：

**Linux/macOS:**
```bash
bash -c "$(curl -fsSL https://raw.githubusercontent.com/skyfireitdiy/Jarvis/main/scripts/install.sh)"
```

**Windows (PowerShell):**
```powershell
iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/skyfireitdiy/Jarvis/main/scripts/install.ps1'))
```

> 该脚本会自动检测Python环境、克隆项目、安装依赖并设置好路径。

#### 手动安装
```bash
# 1. 克隆仓库
git clone https://github.com/skyfireitdiy/Jarvis

# 2. 进入项目目录
cd Jarvis

# 3. 安装项目为可编辑模式
pip3 install -e .
```
> **提示**: 使用 `-e .` (可编辑模式) 安装后，您对源码的任何修改都会立刻生效，非常适合开发者。

或者从PyPI安装 (可能不是最新版):
```bash
pip3 install jarvis-ai-assistant
```

**通过 uv 安装 (推荐)**
```bash
# 1. 安装 uv (如果未安装)
curl -LsSf https://astral.sh/uv/install.sh | sh

# 2. 克隆仓库
git clone https://github.com/skyfireitdiy/Jarvis

# 3. 进入项目目录
cd Jarvis

# 4. 创建虚拟环境并安装
uv venv

# 安装基础功能
uv pip install .

# 可选: 安装RAG功能(包含PyTorch等较重的依赖)
# uv pip install .[rag]
```

> **提示**: 安装完成后，建议将虚拟环境激活命令添加到您的 shell 配置文件中:
> - Bash/Zsh: 在 ~/.bashrc 或 ~/.zshrc 中添加 `source /path/to/Jarvis/.venv/bin/activate`
> - Fish: 在 ~/.config/fish/config.fish 中添加 `source /path/to/Jarvis/.venv/bin/activate.fish`

### 基本使用
Jarvis 包含一系列专注于不同任务的工具。以下是主要命令及其快捷方式：

| 命令 | 快捷方式 | 功能描述 |
|------|----------|----------|
| `jarvis` | `jvs` | 通用AI代理，适用于多种任务 |
| `jarvis-agent` | `ja` | AI代理基础功能，处理会话和任务 |
| `jarvis-code-agent` | `jca` | 专注于代码分析、修改和生成的代码代理 |
| `jarvis-code-review` | `jcr` | 智能代码审查工具 |
| `jarvis-git-commit` | `jgc` | 自动化分析代码变更并生成规范的Git提交信息 |
| `jarvis-git-squash` | `jgs` | Git提交历史整理工具 |
| `jarvis-platform-manager` | `jpm` | 管理和测试不同的大语言模型平台 |
| `jarvis-multi-agent` | `jma` | 多智能体协作系统 |
| `jarvis-tool` | `jt` | 工具管理与调用系统 |
| `jarvis-methodology` | `jm` | 方法论知识库管理 |
| `jarvis-rag` | `jrg` | 构建和查询本地化的RAG知识库 |
| `jarvis-smart-shell` | `jss` | 实验性的智能Shell功能 |
| `jarvis-stats` | `jst` | 通用统计模块，支持记录和可视化任意指标数据 |
| `jarvis-memory-organizer` | `jmo` | 记忆管理工具，支持整理、合并、导入导出记忆 |

更多详细用法和参数，请查阅我们的 [**使用指南**](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)。

> **模型推荐**: 目前效果较好的模型是 `claude-opus-4-20250514`，可以通过国内代理商购买，例如 [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)

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/skyfireitdiy/Jarvis",
    "name": "jarvis-ai-assistant",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "<3.13,>=3.9",
    "maintainer_email": null,
    "keywords": "jarvis, ai, assistant, tools, automation",
    "author": "skyfire",
    "author_email": "skyfire <skyfireitdiy@hotmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/db/3f/6f3448a89920af8af853e18fc069373499f7226b3153ef01073863981ebf/jarvis_ai_assistant-0.3.7.tar.gz",
    "platform": null,
    "description": "# \ud83e\udd16 Jarvis AI \u52a9\u624b\n<p align=\"center\">\n  <img src=\"docs/images/jarvis-logo.png\" alt=\"Jarvis Logo\" width=\"200\"/>\n</p>\n<div align=\"center\">\n\n[![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)\n\n*\u60a8\u7684\u667a\u80fd\u5f00\u53d1\u548c\u7cfb\u7edf\u4ea4\u4e92\u52a9\u624b*\n\n[\u5feb\u901f\u5f00\u59cb](#quick-start) \u2022 [\u6838\u5fc3\u529f\u80fd](#core-features) \u2022 [\u914d\u7f6e\u8bf4\u660e](#configuration) \u2022 [Jarvis Book](#jarvis-book) \u2022 [\u6280\u672f\u7ec6\u8282](docs/technical_documentation.md) \u2022 [Wiki\u6587\u6863](docs/jarvis_book/1.\u9879\u76ee\u4ecb\u7ecd.md) \u2022 [\u8d21\u732e\u6307\u5357](#contributing) \u2022 [\u8bb8\u53ef\u8bc1](#license)\n</div>\n\n---\n\n## \ud83c\udfaf \u5b9a\u4f4d\u4e0e\u4f18\u52bf\n\nJarvis \u7684\u5b9a\u4f4d\u662f**\u4e2a\u4eba\u5f00\u53d1\u8005\u7684\u9ad8\u6548\u52a9\u7406**\uff0c\u65e8\u5728\u5c06\u7814\u53d1\u6d41\u7a0b\u4e2d\u4e00\u6b21\u6027\u3001\u788e\u7247\u5316\u7684\u5de5\u4f5c\u53d8\u5f97\u66f4\u52a0\u6d41\u7545\u548c\u9ad8\u6548\u3002\u8fd9\u4e0e `workflow` \u5f62\u5f0f\u7684 `Agent` \u5e73\u53f0\uff08\u5982 Dify\uff09\u6709\u7740\u672c\u8d28\u533a\u522b\uff0c\u4e13\u6ce8\u4e8e\u63d0\u5347\u4e2a\u4eba\u751f\u4ea7\u529b\u3002\n\n### Jarvis \u7684\u6838\u5fc3\u4f18\u52bf\n\n1.  **\u8bbf\u95ee\u672c\u5730\u8d44\u6e90**: Jarvis \u80fd\u591f\u76f4\u63a5\u4e0e\u60a8\u7684\u672c\u5730\u73af\u5883\u4ea4\u4e92\uff0c\u6267\u884c\u8bf8\u5982**\u8f6f\u4ef6\u5f00\u53d1\u3001\u4ee3\u7801\u4fee\u590d\u3001\u73af\u5883\u642d\u5efa**\u7b49\u9700\u8981\u672c\u5730\u6587\u4ef6\u7cfb\u7edf\u548c\u5de5\u5177\u94fe\u7684\u590d\u6742\u4efb\u52a1\u3002\n2.  **\u7eaf\u7cb9\u7684\u547d\u4ee4\u884c\u4f53\u9a8c**: \u4f5c\u4e3a\u4e00\u6b3e\u7eaf\u547d\u4ee4\u884c\u5de5\u5177\uff0cJarvis \u53ef\u4ee5\u65e0\u7f1d\u96c6\u6210\u5230\u60a8\u559c\u7231\u7684\u4efb\u4f55IDE\u3001\u7ec8\u7aef\u6216SSH\u4f1a\u8bdd\u4e2d\uff0c\u4e0d\u5e72\u6270\u60a8\u73b0\u6709\u7684\u5de5\u4f5c\u6d41\u7a0b\u3002\n3.  **Python\u5305\u5f62\u5f0f\u63d0\u4f9b**: Jarvis \u4ee5\u6807\u51c6\u7684Python\u5305\u5f62\u5f0f\u5206\u53d1\uff0c\u53ef\u4ee5\u8f7b\u677e\u5730\u4f5c\u4e3a\u4f9d\u8d56\u9879\u96c6\u6210\u5230\u60a8\u81ea\u5df1\u6784\u5efa\u7684AI\u5e94\u7528\u6216\u81ea\u52a8\u5316\u811a\u672c\u4e2d\u3002\n\n### \ud83d\udca1 Jarvis \u7684\u4ef7\u503c\uff1a\u5de5\u4f5c\u6d41\u5bf9\u6bd4\n\n#### \u793a\u4f8b\u4e00\uff1a\u5f00\u53d1\u65b0\u529f\u80fd\n\n**\u4f20\u7edf\u5de5\u4f5c\u6d41 (\u6ca1\u6709 Jarvis):**\n\n1.  **\u7406\u89e3\u9700\u6c42**: \u9605\u8bfb\u9700\u6c42\u6587\u6863\uff0c\u5728\u4ee3\u7801\u5e93\u4e2d\u5168\u5c40\u641c\u7d22\uff0c\u5b9a\u4f4d\u53ef\u80fd\u9700\u8981\u4fee\u6539\u7684\u6587\u4ef6\u548c\u51fd\u6570\u3002\n2.  **\u5207\u6362\u4e0a\u4e0b\u6587**: \u5728IDE\u3001\u6d4f\u89c8\u5668\uff08\u67e5\u8d44\u6599\uff09\u3001\u7ec8\u7aef\uff08\u6267\u884c\u547d\u4ee4\uff09\u4e4b\u95f4\u53cd\u590d\u5207\u6362\u3002\n3.  **\u7f16\u5199\u4ee3\u7801**: \u624b\u52a8\u7f16\u5199\u65b0\u529f\u80fd\u3001\u5355\u5143\u6d4b\u8bd5\u548c\u76f8\u5173\u6587\u6863\u3002\n4.  **\u8c03\u8bd5**: \u53cd\u590d\u8fd0\u884c\u3001\u6253\u5370\u65e5\u5fd7\u3001\u8bbe\u7f6e\u65ad\u70b9\u6765\u5b9a\u4f4d\u548c\u4fee\u590dbug\u3002\n5.  **\u4ee3\u7801\u63d0\u4ea4**: \u624b\u52a8\u68c0\u67e5\u4ee3\u7801\u53d8\u66f4\uff0c\u64b0\u5199\u7b26\u5408\u56e2\u961f\u89c4\u8303\u7684 Git Commit Message\u3002\n> \u8fd9\u4e2a\u8fc7\u7a0b\u4e0d\u4ec5\u8017\u65f6\uff0c\u800c\u4e14\u9891\u7e41\u7684\u4e0a\u4e0b\u6587\u5207\u6362\u6781\u6613\u6253\u65ad\u5fc3\u6d41\uff0c\u6d88\u8017\u5927\u91cf\u7cbe\u529b\u3002\n\n**Jarvis \u589e\u5f3a\u5de5\u4f5c\u6d41:**\n\n1.  **\u4efb\u52a1\u542f\u52a8**: \u5728\u9879\u76ee\u6839\u76ee\u5f55\uff0c\u7528\u81ea\u7136\u8bed\u8a00\u5411 `jca` (\u4ee3\u7801\u52a9\u7406) \u63cf\u8ff0\u9700\u6c42\uff1a`jca \"\u4e3a 'user' \u6a21\u5757\u589e\u52a0 'profile' \u63a5\u53e3\uff0c\u9700\u8981\u5305\u542b\u7528\u6237\u4fe1\u606f\u67e5\u8be2\u548c\u66f4\u65b0\u529f\u80fd\"`\u3002\n2.  **AI \u5206\u6790\u4e0e\u7f16\u7801**:\n    *   Jarvis \u81ea\u52a8\u5206\u6790\u4ee3\u7801\u7ed3\u6784\uff0c\u5b9a\u4f4d\u76f8\u5173\u6587\u4ef6 (`user/service.py`, `user/controller.py`, `tests/test_user.py`)\u3002\n    *   \u81ea\u52a8\u751f\u6210\u65b0\u63a5\u53e3\u7684\u4ee3\u7801\u3001\u5fc5\u8981\u7684\u5355\u5143\u6d4b\u8bd5\uff0c\u5e76\u63d0\u51fa\u4fee\u6539\u65b9\u6848\u3002\n3.  **\u4eba\u673a\u534f\u4f5c\u4e0e\u8fed\u4ee3**:\n    *   \u4f60\u5ba1\u67e5 AI \u751f\u6210\u7684\u4ee3\u7801\uff0c\u5e76\u63d0\u51fa\u4fee\u6539\u610f\u89c1\uff1a`\"\u5b57\u6bb5\u540d\u9700\u8981\u7528\u9a7c\u5cf0\u5f0f\"` \u6216 `\"\u589e\u52a0\u4e00\u4e2a\u8f93\u5165\u6821\u9a8c\"`\u3002\n    *   Jarvis \u6839\u636e\u53cd\u9988\u5feb\u901f\u8fed\u4ee3\uff0c\u66f4\u65b0\u4ee3\u7801\u3002\n4.  **\u81ea\u52a8\u5316\u63d0\u4ea4**:\n    *   \u5b8c\u6210\u5f00\u53d1\u540e\uff0c\u6267\u884c `jgc` (Git \u63d0\u4ea4\u52a9\u7406)\u3002\n    *   Jarvis \u81ea\u52a8\u5206\u6790\u4ee3\u7801\u53d8\u66f4\uff0c\u751f\u6210\u4e00\u6761\u89c4\u8303\u7684 Git Commit Message (\u4f8b\u5982: `feat(user): add user profile api with query and update`)\u3002\n> \u901a\u8fc7 Jarvis\uff0c\u6574\u4e2a\u6d41\u7a0b\u4ece\u201c\u624b\u52a8\u6267\u884c\u201d\u53d8\u4e3a\u4e86\u201c\u76d1\u7763\u548c\u6307\u5bfc\u201d\uff0c\u5f00\u53d1\u8005\u53ef\u4ee5\u5c06\u7cbe\u529b\u96c6\u4e2d\u5728**\u67b6\u6784\u8bbe\u8ba1\u548c\u4ee3\u7801\u5ba1\u67e5**\u7b49\u9ad8\u4ef7\u503c\u6d3b\u52a8\u4e0a\uff0c\u800c\u4e0d\u662f\u7e41\u7410\u7684\u7f16\u7801\u548c\u8c03\u8bd5\u7ec6\u8282\u3002\n\n#### \u793a\u4f8b\u4e8c\uff1a\u7528 Jarvis \u5b8c\u5584\u672c\u6587\u6863\n\n\u60a8\u6b63\u5728\u9605\u8bfb\u7684\u8fd9\u90e8\u5206\u6587\u6863\uff0c\u5176\u8bde\u751f\u8fc7\u7a0b\u672c\u8eab\u5c31\u662f Jarvis \u4ef7\u503c\u7684\u4f53\u73b0\u3002\n\n1.  **\u521d\u59cb\u6307\u4ee4**: `\u201c\u5728README.md\u4e2d\u8865\u5145jarvis\u7684\u7528\u6237\u7fa4\u4f53\u548c\u5e94\u7528\u573a\u666f\u7b49\u4fe1\u606f\u201d`\n2.  **\u63a2\u7d22\u4e0e\u5b66\u4e60**: Jarvis \u4f7f\u7528 `fd` \u548c `read_code` \u5de5\u5177\uff0c\u5206\u6790\u4e86 `docs/` \u76ee\u5f55\u4e0b\u7684\u8bf4\u660e\u6587\u6863\uff0c\u5feb\u901f\u5b66\u4e60\u4e86\u9879\u76ee\u7684\u6838\u5fc3\u5b9a\u4f4d\u548c\u529f\u80fd\u3002\n3.  **\u8fed\u4ee3\u5b8c\u5584**: \u6839\u636e \u201c\u8865\u5145\u7528\u6237\u7fa4\u4f53\u201d\u3001\u201c\u589e\u52a0\u5de5\u4f5c\u6d41\u5bf9\u6bd4\u201d\u3001\u201c\u518d\u589e\u52a0\u4e00\u4e2a\u4f8b\u5b50\u201d \u7b49\u4e00\u7cfb\u5217\u8ffd\u52a0\u6307\u4ee4\uff0cJarvis \u901a\u8fc7\u591a\u6b21 `PATCH` \u64cd\u4f5c\uff0c\u9010\u6b65\u3001\u7cbe\u786e\u5730\u5c06\u65b0\u5185\u5bb9\u6dfb\u52a0\u5230\u672c\u6587\u6863\u7684\u6307\u5b9a\u4f4d\u7f6e\u3002\n4.  **\u4eba\u673a\u534f\u4f5c**: \u5728\u6574\u4e2a\u8fc7\u7a0b\u4e2d\uff0c\u4eba\u7c7b\u63d0\u4f9b\u9ad8\u5c42\u6b21\u7684\u76ee\u6807\u548c\u65b9\u5411\uff0cJarvis \u8d1f\u8d23\u5177\u4f53\u7684\u63a2\u7d22\u3001\u603b\u7ed3\u548c\u4ee3\u7801\uff08\u6587\u6863\uff09\u4fee\u6539\u4efb\u52a1\uff0c\u5c06\u4e00\u4e2a\u6a21\u7cca\u7684\u60f3\u6cd5\u5feb\u901f\u843d\u5730\u4e3a\u7ed3\u6784\u6e05\u6670\u7684\u6587\u6863\u3002\n\n### Vibe Working: \u4e00\u79cd\u66f4\u76f4\u89c9\u7684\u5de5\u4f5c\u6d41\n\nJarvis \u7684\u6838\u5fc3\u7406\u5ff5\u4e0e\u4e00\u79cd\u65b0\u5174\u7684\u4eba\u673a\u534f\u4f5c\u6a21\u5f0f **\"Vibe Working\"** (\u6c1b\u56f4\u5f0f\u5de5\u4f5c)\u4e0d\u8c0b\u800c\u5408\u3002\u8fd9\u4e2a\u6982\u5ff5\u6e90\u4e8eAI\u7814\u7a76\u8005Andrej Karpathy\uff0c\u6307\u7684\u662f\u5229\u7528\u5927\u8bed\u8a00\u6a21\u578b\uff08LLM\uff09\uff0c\u5c06\u4eba\u7c7b\u5934\u8111\u4e2d\u6a21\u7cca\u3001\u76f4\u89c9\u6027\u7684\u60f3\u6cd5\uff08\u5373\u201cVibe\u201d\uff09\u9ad8\u6548\u8f6c\u5316\u4e3a\u5177\u4f53\u7684\u3001\u7ed3\u6784\u5316\u7684\u6210\u679c\u3002\n\n\u8fd9\u4e0d\u518d\u662f\u4f20\u7edf\u7684\u201c\u6307\u4ee4-\u6267\u884c\u201d\u6a21\u5f0f\uff0c\u800c\u662f\u4e00\u79cd**\u5bf9\u8bdd\u5f0f\u3001\u8fed\u4ee3\u5f0f**\u7684\u5171\u540c\u521b\u9020\u8fc7\u7a0b\u3002\n\n*   **\u4ece\u4e00\u4e2a\u201c\u611f\u89c9\u201d\u5f00\u59cb**: \u4f20\u7edf\u7684\u81ea\u52a8\u5316\u9700\u8981\u7cbe\u786e\u7684\u8f93\u5165\u548c\u89c4\u5219\u3002\u800c\u4f7f\u7528 Jarvis\uff0c\u4f60\u53ef\u4ee5\u4ece\u4e00\u4e2a\u6a21\u7cca\u7684\u76ee\u6807\u5f00\u59cb\uff0c\u6bd4\u5982 `jca \"\u7ed9\u6211\u5199\u4e2a\u811a\u672c\uff0c\u76d1\u63a7\u8fd9\u4e2a\u7f51\u7ad9\u7684\u53d8\u5316\"` \u6216\u8005 `jca \"\u91cd\u6784 'user' \u6a21\u5757\uff0c\u8ba9\u5b83\u770b\u8d77\u6765\u66f4\u6e05\u723d\"`\u3002\u4f60\u63d0\u4f9b\u7684\u662f\u65b9\u5411\u548c\u201c\u611f\u89c9\u201d\uff0c\u800c\u4e0d\u662f\u8be6\u7ec6\u7684\u89c4\u683c\u4e66\u3002\n\n*   **\u8fed\u4ee3\u4e2d\u903c\u8fd1\u5b8c\u7f8e**: Jarvis (\u6216\u5176\u80cc\u540e\u7684LLM) \u4f1a\u63d0\u4f9b\u4e00\u4e2a\u521d\u6b65\u7684\u5b9e\u73b0\u3002\u8fd9\u4e2a\u7248\u672c\u53ef\u80fd\u4e0d\u5b8c\u7f8e\uff0c\u4f46\u5b83\u662f\u4e00\u4e2a\u575a\u5b9e\u7684\u8d77\u70b9\u3002\u63a5\u4e0b\u6765\uff0c\u4f60\u901a\u8fc7\u53cd\u9988\u6765\u6307\u5bfc\u5b83\uff0c\u6bd4\u5982 `\u201c\u8fd9\u4e2a\u5730\u65b9\u7684\u903b\u8f91\u4e0d\u5bf9\uff0c\u5e94\u8be5\u5148\u68c0\u67e5A\u518d\u5904\u7406B\u201d` \u6216\u8005 `\u201c\u53d8\u91cf\u540d\u80fd\u518d\u8bed\u4e49\u5316\u4e00\u70b9\u5417\uff1f\u201d`\u3002\u901a\u8fc7\u8fd9\u79cd\u5feb\u901f\u7684\u53cd\u9988\u5faa\u73af\uff0cAI\u7684\u4ea7\u51fa\u5c06\u9010\u6b65\u903c\u8fd1\u4f60\u7684\u771f\u5b9e\u610f\u56fe\u3002\n\n*   **\u4eba\u4e0eAI\u7684\u89d2\u8272\u8f6c\u53d8**:\n    *   **\u4f60 (\u4eba\u7c7b)**: \u626e\u6f14**\u521b\u610f\u603b\u76d1\u3001\u54c1\u5473\u5224\u65ad\u8005\u548c\u65b9\u5411\u5f15\u9886\u8005**\u3002\u4f60\u8d1f\u8d23\u63d0\u4f9b\u613f\u666f\u3001\u7ecf\u9a8c\u548c\u9ad8\u5c42\u6b21\u7684\u5224\u65ad\u529b\uff0c\u786e\u4fdd\u6700\u7ec8\u7ed3\u679c\u7684\u8d28\u91cf\u548c\u65b9\u5411\u3002\n    *   **Jarvis (AI)**: \u626e\u6f14**\u5f3a\u5927\u7684\u6267\u884c\u4f19\u4f34\u548c\u7075\u611f\u50ac\u5316\u5242**\u3002\u5b83\u8d1f\u8d23\u5904\u7406\u6240\u6709\u7e41\u91cd\u3001\u91cd\u590d\u548c\u6280\u672f\u6027\u7684\u7ec6\u8282\uff0c\u5e76\u80fd\u63d0\u4f9b\u610f\u60f3\u4e0d\u5230\u7684\u89e3\u51b3\u65b9\u6848\uff0c\u6fc0\u53d1\u4f60\u7684\u65b0\u60f3\u6cd5\u3002\n\nJarvis \u6b63\u662f\u4e3a\u8fd9\u79cd\u5de5\u4f5c\u6d41\u800c\u8bbe\u8ba1\u7684\u5de5\u5177\u3002\u5b83\u901a\u8fc7\u65e0\u7f1d\u7684\u547d\u4ee4\u884c\u96c6\u6210\u548c\u5f3a\u5927\u7684\u672c\u5730\u4ea4\u4e92\u80fd\u529b\uff0c\u5c06 \"Vibe Working\" \u4ece\u4e00\u4e2a\u62bd\u8c61\u6982\u5ff5\uff0c\u53d8\u4e3a\u4e86\u5f00\u53d1\u8005\u89e6\u624b\u53ef\u53ca\u7684\u65e5\u5e38\u751f\u4ea7\u529b\u5de5\u5177\uff0c\u8ba9\u4f60\u80fd\u66f4\u4e13\u6ce8\u4e8e**\u9ad8\u4ef7\u503c\u7684\u521b\u9020\u6027\u601d\u8003**\uff0c\u800c\u975e\u7410\u788e\u7684\u5b9e\u73b0\u7ec6\u8282\u3002\n\n### \ud83d\udc65 \u76ee\u6807\u7528\u6237\n\n**\u8c01\u9002\u5408\u4f7f\u7528 Jarvis\uff1f**\n\n*   **\u4e2a\u4eba\u5f00\u53d1\u8005\u548c\u6781\u5ba2**: \u5e0c\u671b\u901a\u8fc7AI\u63d0\u5347\u4e2a\u4eba\u5f00\u53d1\u3001\u5b66\u4e60\u548c\u63a2\u7d22\u6548\u7387\u7684\u7528\u6237\u3002\n*   **\u9700\u8981\u5904\u7406\u788e\u7247\u5316\u4efb\u52a1\u7684\u5de5\u7a0b\u5e08**: \u9762\u5bf9\u5404\u79cd\u4e00\u6b21\u6027\u3001\u975e\u6807\u51c6\u5316\u7684\u6280\u672f\u4efb\u52a1\uff0c\u4f8b\u5982\u5feb\u901f\u7f16\u5199\u811a\u672c\u3001\u8c03\u8bd5\u4ee3\u7801\u3001\u642d\u5efa\u65b0\u73af\u5883\u7b49\u3002\n*   **AI\u5e94\u7528\u63a2\u7d22\u8005**: \u5e0c\u671b\u6709\u4e00\u4e2a\u7075\u6d3b\u7684\u672c\u5730\u6846\u67b6\u6765\u5b9e\u9a8c\u548c\u96c6\u6210\u4e0d\u540c\u7684\u5927\u8bed\u8a00\u6a21\u578b\u548c\u5de5\u5177\u3002\n\n**\u8c01\u53ef\u80fd\u4e0d\u9002\u5408\uff1f**\n\n*   **\u5bfb\u6c42\u56fa\u5b9a\u5de5\u4f5c\u6d41\u81ea\u52a8\u5316\u7684\u4eba**: \u5982\u679c\u60a8\u7684\u9700\u6c42\u662f\u9ad8\u5ea6\u56fa\u5b9a\u548c\u91cd\u590d\u7684\uff0c\u4f8b\u5982\u201c\u6bcf\u5929\u5b9a\u65f6\u6293\u53d6\u6570\u636e\u5e76\u751f\u6210\u62a5\u544a\u201d\uff0c\u90a3\u4e48\u7f16\u5199\u4e00\u4e2a\u4e13\u95e8\u7684\u3001\u529f\u80fd\u5355\u4e00\u7684\u811a\u672c\u53ef\u80fd\u662f\u66f4\u76f4\u63a5\u3001\u66f4\u9ad8\u6548\u7684\u89e3\u51b3\u65b9\u6848\u3002Jarvis \u66f4\u64c5\u957f\u5904\u7406\u591a\u53d8\u548c\u63a2\u7d22\u6027\u7684\u4efb\u52a1\u3002\n*   **\u4f01\u4e1a\u7ea7\u56e2\u961f\u534f\u4f5c\u8005**: Jarvis \u88ab\u8bbe\u8ba1\u4e3a\u4e2a\u4eba\u5de5\u5177\uff0c\u4e0d\u5305\u542b\u56e2\u961f\u7ba1\u7406\u3001\u6743\u9650\u63a7\u5236\u7b49\u9762\u5411\u4f01\u4e1a\u7ea7\u534f\u4f5c\u7684\u529f\u80fd\u3002\n\n\u603b\u4e4b\uff0cJarvis \u662f\u4e3a\u6bcf\u4e00\u4f4d\u5f00\u53d1\u8005\u91cf\u8eab\u6253\u9020\u7684\u4e2a\u4eba\u52a9\u624b\uff0c\u800c\u975e\u7528\u4e8e\u56e2\u961f\u534f\u4f5c\u7684\u96c6\u4e2d\u5f0f\u5e73\u53f0\u3002\n\n---\n\n## \ud83d\ude80 \u5feb\u901f\u5f00\u59cb <a id=\"quick-start\"></a>\n\n### \u7cfb\u7edf\u8981\u6c42\n- **Linux**: \u5b8c\u5168\u652f\u6301\u3002\n- **Windows**: \u5b8c\u5168\u652f\u6301\uff08\u9700\u8981 PowerShell\uff09\u3002\n\n### \u5b89\u88c5\n\n#### \u4e00\u952e\u5b89\u88c5 (\u63a8\u8350)\n\u53ea\u9700\u4e00\u884c\u547d\u4ee4\u5373\u53ef\u5b8c\u6210\u6240\u6709\u5b89\u88c5\u548c\u914d\u7f6e\uff1a\n\n**Linux/macOS:**\n```bash\nbash -c \"$(curl -fsSL https://raw.githubusercontent.com/skyfireitdiy/Jarvis/main/scripts/install.sh)\"\n```\n\n**Windows (PowerShell):**\n```powershell\niex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/skyfireitdiy/Jarvis/main/scripts/install.ps1'))\n```\n\n> \u8be5\u811a\u672c\u4f1a\u81ea\u52a8\u68c0\u6d4bPython\u73af\u5883\u3001\u514b\u9686\u9879\u76ee\u3001\u5b89\u88c5\u4f9d\u8d56\u5e76\u8bbe\u7f6e\u597d\u8def\u5f84\u3002\n\n#### \u624b\u52a8\u5b89\u88c5\n```bash\n# 1. \u514b\u9686\u4ed3\u5e93\ngit clone https://github.com/skyfireitdiy/Jarvis\n\n# 2. \u8fdb\u5165\u9879\u76ee\u76ee\u5f55\ncd Jarvis\n\n# 3. \u5b89\u88c5\u9879\u76ee\u4e3a\u53ef\u7f16\u8f91\u6a21\u5f0f\npip3 install -e .\n```\n> **\u63d0\u793a**: \u4f7f\u7528 `-e .` (\u53ef\u7f16\u8f91\u6a21\u5f0f) \u5b89\u88c5\u540e\uff0c\u60a8\u5bf9\u6e90\u7801\u7684\u4efb\u4f55\u4fee\u6539\u90fd\u4f1a\u7acb\u523b\u751f\u6548\uff0c\u975e\u5e38\u9002\u5408\u5f00\u53d1\u8005\u3002\n\n\u6216\u8005\u4ecePyPI\u5b89\u88c5 (\u53ef\u80fd\u4e0d\u662f\u6700\u65b0\u7248):\n```bash\npip3 install jarvis-ai-assistant\n```\n\n**\u901a\u8fc7 uv \u5b89\u88c5 (\u63a8\u8350)**\n```bash\n# 1. \u5b89\u88c5 uv (\u5982\u679c\u672a\u5b89\u88c5)\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n# 2. \u514b\u9686\u4ed3\u5e93\ngit clone https://github.com/skyfireitdiy/Jarvis\n\n# 3. \u8fdb\u5165\u9879\u76ee\u76ee\u5f55\ncd Jarvis\n\n# 4. \u521b\u5efa\u865a\u62df\u73af\u5883\u5e76\u5b89\u88c5\nuv venv\n\n# \u5b89\u88c5\u57fa\u7840\u529f\u80fd\nuv pip install .\n\n# \u53ef\u9009: \u5b89\u88c5RAG\u529f\u80fd(\u5305\u542bPyTorch\u7b49\u8f83\u91cd\u7684\u4f9d\u8d56)\n# uv pip install .[rag]\n```\n\n> **\u63d0\u793a**: \u5b89\u88c5\u5b8c\u6210\u540e\uff0c\u5efa\u8bae\u5c06\u865a\u62df\u73af\u5883\u6fc0\u6d3b\u547d\u4ee4\u6dfb\u52a0\u5230\u60a8\u7684 shell \u914d\u7f6e\u6587\u4ef6\u4e2d:\n> - Bash/Zsh: \u5728 ~/.bashrc \u6216 ~/.zshrc \u4e2d\u6dfb\u52a0 `source /path/to/Jarvis/.venv/bin/activate`\n> - Fish: \u5728 ~/.config/fish/config.fish \u4e2d\u6dfb\u52a0 `source /path/to/Jarvis/.venv/bin/activate.fish`\n\n### \u57fa\u672c\u4f7f\u7528\nJarvis \u5305\u542b\u4e00\u7cfb\u5217\u4e13\u6ce8\u4e8e\u4e0d\u540c\u4efb\u52a1\u7684\u5de5\u5177\u3002\u4ee5\u4e0b\u662f\u4e3b\u8981\u547d\u4ee4\u53ca\u5176\u5feb\u6377\u65b9\u5f0f\uff1a\n\n| \u547d\u4ee4 | \u5feb\u6377\u65b9\u5f0f | \u529f\u80fd\u63cf\u8ff0 |\n|------|----------|----------|\n| `jarvis` | `jvs` | \u901a\u7528AI\u4ee3\u7406\uff0c\u9002\u7528\u4e8e\u591a\u79cd\u4efb\u52a1 |\n| `jarvis-agent` | `ja` | AI\u4ee3\u7406\u57fa\u7840\u529f\u80fd\uff0c\u5904\u7406\u4f1a\u8bdd\u548c\u4efb\u52a1 |\n| `jarvis-code-agent` | `jca` | \u4e13\u6ce8\u4e8e\u4ee3\u7801\u5206\u6790\u3001\u4fee\u6539\u548c\u751f\u6210\u7684\u4ee3\u7801\u4ee3\u7406 |\n| `jarvis-code-review` | `jcr` | \u667a\u80fd\u4ee3\u7801\u5ba1\u67e5\u5de5\u5177 |\n| `jarvis-git-commit` | `jgc` | \u81ea\u52a8\u5316\u5206\u6790\u4ee3\u7801\u53d8\u66f4\u5e76\u751f\u6210\u89c4\u8303\u7684Git\u63d0\u4ea4\u4fe1\u606f |\n| `jarvis-git-squash` | `jgs` | Git\u63d0\u4ea4\u5386\u53f2\u6574\u7406\u5de5\u5177 |\n| `jarvis-platform-manager` | `jpm` | \u7ba1\u7406\u548c\u6d4b\u8bd5\u4e0d\u540c\u7684\u5927\u8bed\u8a00\u6a21\u578b\u5e73\u53f0 |\n| `jarvis-multi-agent` | `jma` | \u591a\u667a\u80fd\u4f53\u534f\u4f5c\u7cfb\u7edf |\n| `jarvis-tool` | `jt` | \u5de5\u5177\u7ba1\u7406\u4e0e\u8c03\u7528\u7cfb\u7edf |\n| `jarvis-methodology` | `jm` | \u65b9\u6cd5\u8bba\u77e5\u8bc6\u5e93\u7ba1\u7406 |\n| `jarvis-rag` | `jrg` | \u6784\u5efa\u548c\u67e5\u8be2\u672c\u5730\u5316\u7684RAG\u77e5\u8bc6\u5e93 |\n| `jarvis-smart-shell` | `jss` | \u5b9e\u9a8c\u6027\u7684\u667a\u80fdShell\u529f\u80fd |\n| `jarvis-stats` | `jst` | \u901a\u7528\u7edf\u8ba1\u6a21\u5757\uff0c\u652f\u6301\u8bb0\u5f55\u548c\u53ef\u89c6\u5316\u4efb\u610f\u6307\u6807\u6570\u636e |\n| `jarvis-memory-organizer` | `jmo` | \u8bb0\u5fc6\u7ba1\u7406\u5de5\u5177\uff0c\u652f\u6301\u6574\u7406\u3001\u5408\u5e76\u3001\u5bfc\u5165\u5bfc\u51fa\u8bb0\u5fc6 |\n\n\u66f4\u591a\u8be6\u7ec6\u7528\u6cd5\u548c\u53c2\u6570\uff0c\u8bf7\u67e5\u9605\u6211\u4eec\u7684 [**\u4f7f\u7528\u6307\u5357**](docs/jarvis_book/4.\u4f7f\u7528\u6307\u5357.md)\u3002\n\n---\n\n## \ud83c\udf1f \u6838\u5fc3\u529f\u80fd <a id=\"core-features\"></a>\n\n- **\ud83c\udd93 \u96f6\u6210\u672c\u63a5\u5165**: \u65e0\u7f1d\u96c6\u6210\u817e\u8baf\u5143\u5b9d\u3001Kimi\u7b49\u4f18\u8d28\u6a21\u578b\uff0c\u65e0\u9700\u652f\u4ed8API\u8d39\u7528\u3002\n- **\ud83d\udee0\ufe0f \u5de5\u5177\u9a71\u52a8**: \u5185\u7f6e\u4e30\u5bcc\u5de5\u5177\u96c6\uff0c\u6db5\u76d6\u811a\u672c\u6267\u884c\u3001\u4ee3\u7801\u5f00\u53d1\u3001\u7f51\u9875\u641c\u7d22\u3001\u7ec8\u7aef\u64cd\u4f5c\u7b49\u3002\n- **\ud83e\udd16 \u4eba\u673a\u534f\u4f5c**: \u652f\u6301\u5b9e\u65f6\u4ea4\u4e92\uff0c\u7528\u6237\u53ef\u968f\u65f6\u4ecb\u5165\u6307\u5bfc\uff0c\u786e\u4fddAI\u884c\u4e3a\u7b26\u5408\u9884\u671f\u3002\n- **\ud83d\udd0c \u9ad8\u5ea6\u53ef\u6269\u5c55**: \u652f\u6301\u81ea\u5b9a\u4e49\u5de5\u5177\u3001\u6a21\u578b\u5e73\u53f0\u548cMCP\uff0c\u8f7b\u677e\u6253\u9020\u4e2a\u6027\u5316\u5de5\u4f5c\u6d41\u3002\n- **\ud83e\udde0 RAG \u589e\u5f3a**: \u5185\u7f6eRAG\u529f\u80fd\uff0c\u53ef\u5c06\u672c\u5730\u6587\u6863\u4f5c\u4e3a\u77e5\u8bc6\u5e93\uff0c\u5b9e\u73b0\u7cbe\u51c6\u95ee\u7b54\u3002\n\n### \u89c6\u9891\u6f14\u793a\n- [\u4f7f\u7528`jca`\u4e3aJarvis\u5feb\u901f\u6269\u5c55\u529f\u80fd](https://www.bilibili.com/video/BV1TCgLzvE6Q/)\n- [10\u5206\u949f\u642d\u5efaaarch64\u5bb9\u5668\u5316Rust\u5f00\u53d1\u73af\u5883](https://www.bilibili.com/video/BV1K3ghzkEzZ/)\n- [`jarvis-code-agent` \u529f\u80fd\u6f14\u793a](https://www.bilibili.com/video/BV1KugbzKE6U/)\n\n---\n\n## \u2699\ufe0f \u914d\u7f6e\u8bf4\u660e <a id=\"configuration\"></a>\n\nJarvis \u7684\u4e3b\u8981\u914d\u7f6e\u6587\u4ef6\u4f4d\u4e8e `~/.jarvis/config.yaml`\u3002\u60a8\u53ef\u4ee5\u5728\u6b64\u6587\u4ef6\u4e2d\u914d\u7f6e\u6a21\u578b\u3001\u5e73\u53f0\u548c\u5176\u4ed6\u884c\u4e3a\u3002\n\n**\u57fa\u672c\u914d\u7f6e\u793a\u4f8b (\u817e\u8baf\u5143\u5b9d):**\n```yaml\n# ~/.jarvis/config.yaml\n\n# \u4f7f\u7528\u7684\u6a21\u578b\u5e73\u53f0\nJARVIS_PLATFORM: yuanbao\nJARVIS_MODEL: deep_seek_v3\n\n# \u7528\u4e8e\u201c\u601d\u8003\u201d\u6b65\u9aa4\u7684\u6a21\u578b\uff0c\u901a\u5e38\u9009\u62e9\u80fd\u529b\u66f4\u5f3a\u7684\u6a21\u578b\nJARVIS_THINKING_PLATFORM: yuanbao\nJARVIS_THINKING_MODEL: deep_seek\n\n# \u5e73\u53f0\u6240\u9700\u7684\u73af\u5883\u53d8\u91cf\nENV:\n  YUANBAO_COOKIES: \"\u5728\u6b64\u5904\u7c98\u8d34\u60a8\u7684\u5143\u5b9dCookies\"\n```\n\nJarvis \u652f\u6301\u591a\u79cd\u5e73\u53f0\uff0c\u5305\u62ec **Kimi**, **\u901a\u4e49\u5343\u95ee**, **OpenAI** \u7b49\u3002\u8be6\u7ec6\u7684\u914d\u7f6e\u9009\u9879\u3001\u6a21\u578b\u7ec4\u8bbe\u7f6e\u4ee5\u53ca\u6240\u6709\u53ef\u7528\u53c2\u6570\uff0c\u8bf7\u53c2\u9605 [**\u4f7f\u7528\u6307\u5357**](docs/jarvis_book/4.\u4f7f\u7528\u6307\u5357.md)\u3002\n\n> **\u6a21\u578b\u63a8\u8350**: \u76ee\u524d\u6548\u679c\u8f83\u597d\u7684\u6a21\u578b\u662f `claude-opus-4-20250514`\uff0c\u53ef\u4ee5\u901a\u8fc7\u56fd\u5185\u4ee3\u7406\u5546\u8d2d\u4e70\uff0c\u4f8b\u5982 [FoxiAI](https://foxi-ai.top)\u3002\n\n---\n\n## \ud83d\udee0\ufe0f \u6269\u5c55\u5f00\u53d1 <a id=\"extensions\"></a>\n\nJarvis \u88ab\u8bbe\u8ba1\u4e3a\u9ad8\u5ea6\u53ef\u6269\u5c55\u7684\u6846\u67b6\u3002\u60a8\u53ef\u4ee5\u8f7b\u677e\u5730\uff1a\n- **\u6dfb\u52a0\u65b0\u5de5\u5177**: \u5728 `~/.jarvis/tools/` \u76ee\u5f55\u4e0b\u521b\u5efa\u65b0\u7684\u5de5\u5177\u5b9e\u73b0\u3002\n- **\u96c6\u6210\u65b0LLM\u5e73\u53f0**: \u5728 `~/.jarvis/platforms/` \u76ee\u5f55\u4e0b\u6dfb\u52a0\u65b0\u7684\u5e73\u53f0\u9002\u914d\u5668\u3002\n- **\u5b9a\u4e49MCP**: \u901a\u8fc7\u914d\u7f6e\u6587\u4ef6\u96c6\u6210\u5916\u90e8\u6216\u81ea\u5b9a\u4e49\u7684\u547d\u4ee4\u534f\u8bae\u3002\n\n\u6709\u5173\u6269\u5c55\u5f00\u53d1\u7684\u8be6\u7ec6\u6307\u5357\u548c[**\u6280\u672f\u7ec6\u8282**](docs/technical_documentation.md)\uff0c\u8bf7\u8bbf\u95ee\u6211\u4eec\u7684 [**\u5f00\u53d1\u8005\u6587\u6863**](docs/jarvis_book/5.\u529f\u80fd\u6269\u5c55.md)\u3002\n\n---\n\n## \ud83d\udcd6 Jarvis Book <a id=\"jarvis-book\"></a>\n\n\u6b22\u8fce\u9605\u8bfb Jarvis \u7684\u5b98\u65b9\u6587\u6863\uff0c\u8fd9\u672c\u5f00\u6e90\u4e66\u7c4d\u65e8\u5728\u4e3a\u60a8\u63d0\u4f9b\u4ece\u5165\u95e8\u5230\u7cbe\u901a\u7684\u5168\u65b9\u4f4d\u6307\u5357\u3002\n\n- **[\u7b2c\u4e00\u7ae0\uff1a\u9879\u76ee\u4ecb\u7ecd](docs/jarvis_book/1.\u9879\u76ee\u4ecb\u7ecd.md)**\n- **[\u7b2c\u4e8c\u7ae0\uff1a\u5feb\u901f\u5f00\u59cb](docs/jarvis_book/2.\u5feb\u901f\u5f00\u59cb.md)**\n- **[\u7b2c\u4e09\u7ae0\uff1a\u6838\u5fc3\u6982\u5ff5\u4e0e\u67b6\u6784](docs/jarvis_book/3.\u6838\u5fc3\u6982\u5ff5\u4e0e\u67b6\u6784.md)**\n- **[\u7b2c\u56db\u7ae0\uff1a\u4f7f\u7528\u6307\u5357](docs/jarvis_book/4.\u4f7f\u7528\u6307\u5357.md)**\n- **[\u7b2c\u4e94\u7ae0\uff1a\u529f\u80fd\u6269\u5c55](docs/jarvis_book/5.\u529f\u80fd\u6269\u5c55.md)**\n- **[\u7b2c\u516d\u7ae0\uff1a\u9ad8\u7ea7\u4e3b\u9898](docs/jarvis_book/6.\u9ad8\u7ea7\u4e3b\u9898.md)**\n- **[\u7b2c\u4e03\u7ae0\uff1a\u53c2\u4e0e\u8d21\u732e](docs/jarvis_book/7.\u53c2\u4e0e\u8d21\u732e.md)**\n- **[\u7b2c\u516b\u7ae0\uff1a\u5e38\u89c1\u95ee\u9898](docs/jarvis_book/8.\u5e38\u89c1\u95ee\u9898.md)**\n- **[\u7b2c\u4e5d\u7ae0\uff1a\u9644\u5f55](docs/jarvis_book/9.\u9644\u5f55.md)**\n\n---\n\n## \ud83e\udd1d \u8d21\u732e\u6307\u5357 <a id=\"contributing\"></a>\n\n\u6211\u4eec\u6b22\u8fce\u4efb\u4f55\u5f62\u5f0f\u7684\u8d21\u732e\uff01\n1. Fork \u672c\u4ed3\u5e93\n2. \u521b\u5efa\u60a8\u7684\u7279\u6027\u5206\u652f (`git checkout -b feature/AmazingFeature`)\n3. \u63d0\u4ea4\u60a8\u7684\u66f4\u6539 (`git commit -m 'Add some AmazingFeature'`)\n4. \u63a8\u9001\u5230\u5206\u652f (`git push origin feature/AmazingFeature`)\n5. \u5f00\u542f\u4e00\u4e2a Pull Request\n\n---\n\n## \u26a0\ufe0f \u514d\u8d23\u58f0\u660e <a id=\"disclaimer\"></a>\n\n- **\u6a21\u578b\u4f7f\u7528\u98ce\u9669**: \u9891\u7e41\u4f7f\u7528\u901a\u8fc7\u975e\u5b98\u65b9API\uff08\u5982\u817e\u8baf\u5143\u5b9d\u3001Kimi\u3001\u901a\u4e49\u5343\u95ee\u7b49\uff09\u63a5\u5165\u7684\u6a21\u578b\u53ef\u80fd\u4f1a\u5bfc\u81f4\u60a8\u7684\u8d26\u6237\u88ab\u5e73\u53f0\u5c01\u7981\u3002\u8bf7\u5408\u7406\u4f7f\u7528\uff0c\u5e76\u81ea\u884c\u627f\u62c5\u76f8\u5e94\u98ce\u9669\u3002\n- **\u547d\u4ee4\u6267\u884c\u98ce\u9669**: Jarvis\u5177\u5907\u6267\u884c\u7cfb\u7edf\u547d\u4ee4\u7684\u80fd\u529b\u3002\u8bf7\u786e\u4fdd\u60a8\u4e86\u89e3\u5c06\u8981\u6267\u884c\u7684\u547d\u4ee4\uff0c\u5e76\u907f\u514d\u8f93\u5165\u53ef\u80fd\u5bfc\u81f4\u7cfb\u7edf\u98ce\u9669\u7684\u6307\u4ee4\u3002\u4e3a\u4e86\u589e\u5f3a\u5b89\u5168\u6027\uff0c\u60a8\u53ef\u4ee5\u5728\u914d\u7f6e\u6587\u4ef6\u4e2d\u542f\u7528\u5de5\u5177\u6267\u884c\u786e\u8ba4\uff08`JARVIS_EXECUTE_TOOL_CONFIRM: true`\uff09\uff0c\u4ee5\u4fbf\u5728\u6267\u884c\u6bcf\u4e2a\u5de5\u5177\u524d\u8fdb\u884c\u624b\u52a8\u786e\u8ba4\u3002\n\n---\n\n## \ud83d\udcc4 \u8bb8\u53ef\u8bc1 <a id=\"license\"></a>\n\n\u672c\u9879\u76ee\u91c7\u7528 MIT \u8bb8\u53ef\u8bc1 - \u8be6\u89c1 [LICENSE](LICENSE) \u6587\u4ef6\u3002\n\n---\n<div align=\"center\">\n\u7531 Jarvis \u56e2\u961f\u7528 \u2764\ufe0f \u5236\u4f5c\n</div>\n\n![Jarvis\u6280\u672f\u652f\u6301\u7fa4](docs/images/wechat.png)\n",
    "bugtrack_url": null,
    "license": "MIT License\n        \n        Copyright (c) 2025 skyfire\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.",
    "summary": "Jarvis: An AI assistant that uses tools to interact with the system",
    "version": "0.3.7",
    "project_urls": {
        "Homepage": "https://github.com/skyfireitdiy/Jarvis"
    },
    "split_keywords": [
        "jarvis",
        " ai",
        " assistant",
        " tools",
        " automation"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "8cf212d3c54f89b8e63e3429011db6b612d24421668d74c2101cbfee10662a63",
                "md5": "32211a7d3e6fa71a338c5df49e2900a3",
                "sha256": "af67163bc41e75f20877cc643971dd20b5ced276d0eb984240dcf01edc3de06f"
            },
            "downloads": -1,
            "filename": "jarvis_ai_assistant-0.3.7-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "32211a7d3e6fa71a338c5df49e2900a3",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<3.13,>=3.9",
            "size": 1078931,
            "upload_time": "2025-08-09T14:31:55",
            "upload_time_iso_8601": "2025-08-09T14:31:55.737855Z",
            "url": "https://files.pythonhosted.org/packages/8c/f2/12d3c54f89b8e63e3429011db6b612d24421668d74c2101cbfee10662a63/jarvis_ai_assistant-0.3.7-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "db3f6f3448a89920af8af853e18fc069373499f7226b3153ef01073863981ebf",
                "md5": "1c4849e65e422e80b65a3a459e566952",
                "sha256": "7bd965e8ffa6ca69cff8f33380975c70916c84abdb6d2ad0bd6cf319bdb3719d"
            },
            "downloads": -1,
            "filename": "jarvis_ai_assistant-0.3.7.tar.gz",
            "has_sig": false,
            "md5_digest": "1c4849e65e422e80b65a3a459e566952",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<3.13,>=3.9",
            "size": 1014163,
            "upload_time": "2025-08-09T14:31:57",
            "upload_time_iso_8601": "2025-08-09T14:31:57.550705Z",
            "url": "https://files.pythonhosted.org/packages/db/3f/6f3448a89920af8af853e18fc069373499f7226b3153ef01073863981ebf/jarvis_ai_assistant-0.3.7.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-08-09 14:31:57",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "skyfireitdiy",
    "github_project": "Jarvis",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "jarvis-ai-assistant"
}
skyfire
Elapsed time: 0.53785s