na-tools 1.2.0

Nekro Agent 跨平台自动部署 CLI 工具

NA-Tools

Nekro Agent 跨平台自动部署 CLI 工具

支持 macOS / Linux，提供一键安装、更新、备份、恢复和配置管理。

安装

# 需要 Python 3.10+
pip install -e .

# 或使用 uv
uv sync

命令

命令	说明
na-tools install	安装 Nekro Agent（Docker 检测 → 配置 → 部署）
na-tools bind	绑定已安装的 NA 实例到管理列表
na-tools remove	卸载并移除指定的 NA 实例
na-tools update	更新服务到最新版本
na-tools backup	备份数据和配置
na-tools restore [file]	从备份恢复（不指定文件则从列表选择）
na-tools config	快捷配置 nekro-agent.yaml
na-tools status	查看服务状态
na-tools logs [service]	查看服务日志
na-tools list	列出所有已安装的 Nekro Agent 及序号
na-tools use <id/path>	切换当前激活的数据目录

快速开始

# 一键安装
na-tools install

# 绑定已安装的 NA 实例（适用于从其他方式安装的或迁移的 NA）
na-tools bind --data-dir /path/to/nekro_data

# 配置模型 API
na-tools config model

# 添加管理员
na-tools config admin --add 12345678

# 更新到最新版
na-tools update

# 备份数据
na-tools backup

# 恢复备份（交互式选择）
na-tools restore

# 移除 NA 实例（保留数据目录）
na-tools remove --keep-data

# 查看多开或所有安装实例
na-tools list

# 切换到另一个安装实例
na-tools use 1

# 查看状态
na-tools status

跨平台支持

功能	Linux	macOS
Docker 安装	✅ 自动	⚠️ 引导
服务部署	✅	✅
备份恢复	✅	✅
配置管理	✅	✅