https://github.com/kangvcar/ais
🤖 AI驱动的智能终端助手，自动分析命令错误、提供智能解决方案并教授命令行知 识。具备智能错误检测、交互式学习系统、多AI服务商支持，以及Linux/macOS的无缝Shell集成。
https://github.com/kangvcar/ais
ai assistant cli command shell
Last synced: 11 months ago
JSON representation
🤖 AI驱动的智能终端助手，自动分析命令错误、提供智能解决方案并教授命令行知 识。具备智能错误检测、交互式学习系统、多AI服务商支持，以及Linux/macOS的无缝Shell集成。
- Host: GitHub
- URL: https://github.com/kangvcar/ais
- Owner: kangvcar
- License: mit
- Created: 2025-07-09T06:05:33.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-07-18T07:06:49.000Z (11 months ago)
- Last Synced: 2025-07-18T08:22:04.216Z (11 months ago)
- Topics: ai, assistant, cli, command, shell
- Language: Python
- Homepage: https://kangvcar.github.io/ais/
- Size: 739 KB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# AIS - 上下文感知的错误分析学习助手
**让每次报错都是成长**
[](https://python.org)
[](LICENSE)
[](https://github.com/kangvcar/ais)
[](https://github.com/kangvcar/ais/actions)
[📖 安装指南](#installation) · [🚀 快速开始](#quickstart) · [🤝 贡献](#contributing)
---
## 概述
AIS通过深度Shell集成架构，实现多维上下文感知和智能错误分析，自动收集执行环境信息并进行精准问题定位，在终端内直接提供基于上下文的解决方案和系统化学习指导，消除传统错误处理中的搜索跳转和盲目试错，显著提升问题解决效率和技能积累速度。
### 🌟 核心特性
#### 🔍 智能错误分析
- **自动检测** - 命令失败时自动分析错误原因
- **上下文感知** - 结合当前目录、Git状态、项目类型等环境信息
- **个性化建议** - 基于用户技能水平提供针对性解决方案
- **安全等级** - 每个建议都标注风险等级，确保操作安全
#### 📚 智能学习系统
- **交互式教学** - 解释"为什么"而不只是"怎么做"
- **主题学习** - 深入学习Git、Docker、Vim等专题知识
- **渐进式内容** - 根据用户水平调整教学深度
- **实践导向** - 提供可执行的命令示例和最佳实践
#### 🎯 多模式交互
- **问答模式** - `ais ask` 快速获取问题答案
- **学习模式** - `ais learn` 系统学习命令行知识
- **分析模式** - 自动或手动分析命令错误
#### 🔌 强大的集成能力
- **Shell集成** - 支持Bash、Zsh自动错误捕获
- **多AI支持** - 兼容OpenAI、Ollama、Claude等多种AI服务
- **隐私保护** - 本地数据存储，敏感信息自动过滤
- **跨平台** - 支持Linux、macOS
---
### 系统要求
- **Python**: 3.8+ （推荐 3.11+）
- **操作系统**: Linux, macOS
- **网络**: 需要网络连接以下载依赖和AI服务
- **空间**: 至少 100MB 可用空间
### ⚡ 一键安装（推荐）
```bash
# 智能安装 - 自动检测环境并选择最佳方式
curl -sSL https://raw.githubusercontent.com/kangvcar/ais/main/scripts/install.sh | bash
# 国内用户可使用Gitee镜像（更快更稳定）
curl -sSL https://gitee.com/kangvcar/ais/raw/main/scripts/install.sh | bash
```
**安装脚本会自动：**
- 🔍 检测当前环境（个人/团队/容器）
- 🎯 选择最佳安装方式（pipx用户级/系统级/容器化）
- 📦 安装pipx和AIS
- 🔧 配置shell集成
- ✅ 执行健康检查
### 🗑️ 一键卸载
```bash
# 智能卸载 - 自动检测安装方式并完全清理
curl -sSL https://raw.githubusercontent.com/kangvcar/ais/main/scripts/uninstall.sh | bash
# 国内用户可使用Gitee镜像
curl -sSL https://gitee.com/kangvcar/ais/raw/main/scripts/uninstall.sh | bash
```
**卸载脚本会自动：**
- 🔍 检测AIS安装方式（pipx用户级/系统级）
- 🗑️ 卸载AIS包和依赖
- 🧹 清理shell集成配置
- 📁 可选择保留或删除用户数据
- ✅ 验证卸载完成
### 🎯 分场景安装
🐳 Docker容器（推荐 - 零配置）
```bash
# 直接运行最新版本
docker run -it --rm kangvcar/ais:latest
# 或者交互式使用
docker run -it --rm -v $(pwd):/workspace kangvcar/ais:latest bash
# 使用Docker Compose（推荐用于持久化配置）
curl -O https://raw.githubusercontent.com/kangvcar/ais/main/docker-compose.yml
docker-compose up -d ais
docker-compose exec ais bash
```
**优势**: 零配置启动，环境隔离，跨平台一致性，支持ARM64架构
👨💻 个人开发者（Python环境）
```bash
# 用户级安装（最安全）
curl -sSL https://raw.githubusercontent.com/kangvcar/ais/main/scripts/install.sh | bash -s -- --user
# 国内用户可使用Gitee镜像
curl -sSL https://gitee.com/kangvcar/ais/raw/main/scripts/install.sh | bash -s -- --user
# 或手动安装
pipx install ais-terminal
ais setup
```
**优势**: 最高安全性，独立虚拟环境，无需sudo权限
🏢 团队/企业环境
```bash
# 系统级安装（所有用户可用）
curl -sSL https://raw.githubusercontent.com/kangvcar/ais/main/scripts/install.sh | bash -s -- --system
# 国内用户可使用Gitee镜像
curl -sSL https://gitee.com/kangvcar/ais/raw/main/scripts/install.sh | bash -s -- --system
```
**优势**: 所有用户可用，保持安全隔离，集中管理和更新
🐳 容器/云环境
```bash
# Docker容器化安装
curl -sSL https://raw.githubusercontent.com/kangvcar/ais/main/scripts/docker-install.sh | bash
# 或直接运行
docker run -it --rm ais-terminal:latest
```
**优势**: 环境一致性，快速部署，易于扩展，完全隔离
🔧 开发者/贡献者
```bash
# 源码安装
git clone https://github.com/kangvcar/ais.git
cd ais
pipx install -e .
# 或使用虚拟环境
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
```
**优势**: 实时修改效果，完整开发工具链，易于调试
### ✅ 验证安装
```bash
# 检查版本
ais --version
# 测试基本功能
ais ask "你好，AIS！"
# 测试自动错误分析（故意输错命令）
mkdirr /tmp/test
```
---
### 基础配置
```bash
# 查看当前配置
ais config
# 设置API提供商（可选）
ais config set provider=openai
ais config set api_key="your-api-key"
# 调整分析级别
ais config set analysis_level=detailed
```
### 核心功能体验
#### 💬 AI问答
```bash
ais ask "如何查看系统内存使用情况？"
ais ask "Docker容器如何挂载目录？"
ais ask "Git合并冲突如何解决？"
```
#### 📖 主题学习
```bash
ais learn git # 学习Git版本控制
ais learn docker # 学习容器化技术
ais learn vim # 学习文本编辑器
ais learn ssh # 学习远程连接
```
#### 🔍 智能错误分析
```bash
# 这些错误命令会自动触发AI分析
pytho --version # 拼写错误
ls /not/exist # 路径不存在
git statuss # 命令错误
```
#### 📊 历史管理
```bash
ais history # 查看最近的命令记录
ais history --failed-only # 只显示失败的命令
ais history 3 # 查看第3条记录的详细分析
```
---
## 📚 详细功能
### 智能问答 - `ais ask`
快速获取技术问题的答案，支持编程、运维、工具使用等各类问题：
```bash
ais ask "Linux文件权限755表示什么？"
ais ask "如何优化Python脚本性能？"
ais ask "Nginx配置反向代理的步骤？"
```
### 知识学习 - `ais learn`
系统学习命令行工具和概念：
```bash
ais learn # 查看所有可学习主题
ais learn git # Git版本控制完整教程
ais learn docker # 容器化技术深度学习
ais learn linux # Linux系统管理基础
```
### AI服务商管理
支持多种AI服务商，灵活切换：
```bash
# 查看可用服务商
ais provider-list
# 添加本地Ollama服务
ais provider-add ollama \
--url http://localhost:11434/v1/chat/completions \
--model llama3
# 切换服务商
ais provider-use ollama
```
### Shell集成配置
AIS支持自动错误分析，需要配置Shell集成：
```bash
# 自动配置
ais setup
# 测试集成是否正常工作
ais test-integration
```
---
## ⚙️ 高级配置
### 上下文收集设置
控制错误分析时收集的上下文信息量：
```bash
# 设置上下文级别
ais config set context_level=minimal # 基本信息
ais config set context_level=standard # 标准信息（默认）
ais config set context_level=detailed # 详细信息
# 控制自动分析
ais config set auto_analysis=true # 开启自动分析
ais config set auto_analysis=false # 关闭自动分析
```
### 隐私和安全
AIS重视用户隐私和数据安全：
- **本地存储** - 所有数据存储在本地SQLite数据库
- **敏感信息过滤** - 自动过滤密码、密钥等敏感信息
- **可配置的上下文级别** - 用户可控制信息收集范围
- **开源透明** - 完全开源，代码公开透明
---
## 🏗️ 项目架构
```
ais/
├── src/ais/ # 主要源代码
│ ├── cli/ # CLI界面模块
│ │ ├── main.py # 主CLI入口
│ │ └── interactive.py # 交互式菜单
│ ├── core/ # 核心功能模块
│ │ ├── ai.py # AI交互模块
│ │ ├── config.py # 配置管理
│ │ ├── context.py # 上下文收集
│ │ └── database.py # 数据库操作
│ ├── ui/ # 用户界面
│ │ └── panels.py # 显示面板
│ └── utils/ # 工具函数
├── scripts/ # 安装和部署脚本
├── tests/ # 测试文件
├── docs/ # 文档目录
└── pyproject.toml # 项目配置
```
### 核心模块
- **CLI模块** (`src/ais/cli/`): 命令行接口和交互式界面
- **Core模块** (`src/ais/core/`): AI服务集成、配置管理、上下文收集、数据库操作
- **UI模块** (`src/ais/ui/`): Rich库显示面板和格式化
---
---
## 🧪 开发和测试
### 开发环境设置
```bash
# 克隆仓库
git clone https://github.com/kangvcar/ais.git
cd ais
# 创建虚拟环境
python3 -m venv .venv
source .venv/bin/activate
# 安装开发版本和依赖
pip install -e ".[dev]"
# 设置pre-commit
pre-commit install
```
### 运行测试
```bash
# 运行所有测试
python -m pytest tests/ -v
# 运行覆盖率测试
python -m pytest --cov=ais tests/
# 代码质量检查
source .venv/bin/activate && black src/ tests/
source .venv/bin/activate && flake8 src/ tests/ --max-line-length=79
```
---
我们欢迎所有形式的贡献！
### 如何参与
1. **Fork** 这个仓库
2. 创建你的特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交你的更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开一个 **Pull Request**
### 开发规范
- 遵循 [PEP 8](https://pep8.org/) 代码风格
- 为新功能添加测试用例
- 更新相关文档
- 提交信息使用清晰的描述
### 代码质量
确保代码符合项目标准：
```bash
# 自动代码格式化
source .venv/bin/activate && autopep8 --in-place --aggressive --aggressive --max-line-length=79 src/ tests/ -r
# 运行所有质量检查
python -m pytest tests/ -v
source .venv/bin/activate && black src/ tests/
source .venv/bin/activate && flake8 src/ tests/ --max-line-length=79
```
---
## 🆘 获取帮助
### 自助资源
```bash
# 一键诊断
ais doctor
# 详细调试
ais --debug --version
# 查看所有帮助
ais help-all
```
### 社区支持
- 📚 [完整文档](docs/)
- 💬 [GitHub Discussions](https://github.com/kangvcar/ais/discussions) - 交流讨论
- 🐛 [GitHub Issues](https://github.com/kangvcar/ais/issues) - 问题反馈
- 📧 [邮件支持](mailto:ais@example.com) - 直接联系
### 报告问题
报告问题时请提供：
- 操作系统和版本
- Python版本 (`python3 --version`)
- AIS版本 (`ais --version`)
- 安装方式（pipx/Docker/源码）
- 完整错误信息
- 复现步骤
---
## 📝 许可证
本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。
---
## 🎉 鸣谢
感谢所有为这个项目做出贡献的开发者们！
### 技术栈
- **Python 3.8+** - 核心语言
- **Click** - 命令行界面框架
- **Rich** - 终端美化和格式化
- **SQLModel** - 数据库ORM
- **httpx** - HTTP客户端
- **pytest** - 测试框架
---
**🎉 让AI成为你的终端伙伴，让命令行学习变得简单而有趣！**
如果觉得有用，请给我们点个 ⭐️ 支持！
[](https://github.com/kangvcar/ais/stargazers)
[](https://github.com/kangvcar/ais/network/members)
[回到顶部](#ais---上下文感知的错误分析学习助手)