nezha-agent 0.1.5

基于大语言模型的命令行代码助手

nezha

nezha 是一个命令行 AI 助手工具，支持模型选择、对话、计划生成、配置初始化等多种智能操作，适合开发者和 AI 爱好者快速集成和使用。

主要特性

• 支持多种大语言模型（LLM），包括预置和用户自定义模型
• 模型可配置、可切换
• 命令行交互式体验，支持对话 (chat)、计划 (plan) 等多种命令
• 支持通过 init 命令初始化或重置配置
• 配置灵活，支持用户自定义模型参数和安全设置
• 内置安全层，提供不同级别的操作确认和路径限制
• 适合二次开发和集成

安装方法

通过 pip 安装（推荐）

pip install nezha-agent

源码安装

git clone https://github.com/echovic/nezha.git
cd nezha
pip install .

快速开始

初始化配置 (可选)

nezha init

查看和管理模型

# 查看所有可用模型
nezha models list

# 交互式选择并设置默认模型
nezha models select

# 添加新模型配置
nezha models add

启动对话

nezha chat

生成计划

nezha plan "帮我写一个发送邮件的 Python 脚本"

配置说明

• 默认配置文件位于 ~/.config/nezha/config.yaml (路径可能因操作系统而异，请参考 platformdirs 文档)
• 可通过 nezha init 命令生成或重置配置文件
• 支持自定义模型列表及参数
• 安全相关配置位于 config/security_config.yaml，详情请参考 安全层设计与使用指南

自动化发布流程

项目使用 GitHub Actions 实现了自动化的版本管理和发布流程，简化了发布过程。

自动版本管理

当代码推送到 main 分支时，系统会根据提交信息自动确定版本增量类型：

• 提交包含 "BREAKING CHANGE" 或 "major" 时，增加主版本号
• 提交包含 "feat"、"feature" 或 "minor" 时，增加次版本号
• 其他情况增加修订版本号

自动发布过程

工作流程会自动执行以下操作：

1. 自动更新 pyproject.toml 中的版本号
2. 提交版本更新到仓库
3. 创建并推送新版本的 git tag
4. 构建 Python 包
5. 发布到 PyPI

使用方法

只需正常开发和提交代码，在提交信息中使用关键词控制版本增量。当代码合并到 main 分支后，工作流程会自动执行所有步骤。

如果不希望某次提交触发发布，可以在提交信息中添加 "[skip ci]"。

贡献指南

欢迎提交 issue 和 PR！如需贡献代码，请遵循本项目的代码规范。

联系方式

• 邮箱：[e-mail]
• Issues：https://github.com/echovic/nezha/issues