自动更新工具 - 免费版
概述
自动更新工具免费版帮助个人开发者实现项目的智能自动更新。支持版本检查、差异更新、自动备份与一键回滚,确保更新过程安全可靠。适合个人项目、脚自动更新工具-免费版与配置文件的版本管理。
核心能力
1. 版本检查
定期检查远程版本库,对比当前版本,发现新版本时通知用户。
输出: 返回版本检查的执行结果,包含操作状态和输出数据。
- 执行此能力时使用
input_params参数,支持创建/查询/导出操作
2. 差异更新
只下载变更的文件,减少更新时间和带宽消耗。
输出: 返回差异更新的执行结果,包含操作状态和输出数据。
- 执行此能力时使用
input_params参数,支持创建/查询/导出操作
3. 自动备份
更新前自动备份当前版本,确保可回滚。
输出: 返回自动备份的执行结果,包含操作状态和输出数据。
- 执行此能力时使用
input_params参数,支持创建/查询/导出操作
4. 一键回滚
更新出现问题后,一键恢复到之前的版本。
输出: 返回一键回滚的执行结果,包含操作状态和输出数据。
- 执行此能力时使用
input_params参数,支持创建/查询/导出操作
5. 更新日志
记录每次更新的版本号、时间、变更内容。
输出: 返回更新日志的执行结果,包含操作状态和输出数据。
- 执行此能力时使用
input_params参数,支持创建/查询/导出操作
6. 定时检查
按设定间隔自动检查更新,无需人工干预。
输出: 返回定时检查的执行结果,包含操作状态和输出数据。
技术参数：使用input_params和output_format参数控制执行行为,支持json/text/csv输出格式。
能力覆盖范围：本skill的核心能力覆盖以下场景关键词：智能自动更新工具、支持版本检查、差异更新与回滚、适合个人项目维护、免费版、面向个人开发者与、小型项目等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。
使用场景
场景一:个人项目自动更新
为个人项目添加自动更新功能。
# 检查更新
./auto-updater check \
--current "1.0.0" \
--remote "https://api.example.com/releases/latest"
# 输出:
# 当前版本: 1.0.0
# 最新版本: 1.1.0
# 有新版本可用!
# 变更内容:
# - 修复登录问题
# - 新增导出功能
# - 性能优化
# 执行更新
./auto-updater update \
--current "1.0.0" \
--target "1.1.0" \
--backup-dir ~/backups \
--diff-only
# 输出:
# 正在备份当前版本...
# 备份完成: ~/backups/v1.0.0_20250115.tar.gz
# 正在下载差异文件...
# 下载: 3 个文件 (共 125KB)
# 正在应用更新...
# 更新完成: 1.0.0 -> 1.1.0
场景二:配置文件同步
同步远程配置文件到本地。
# 配置同步
./auto-updater sync \
--source "https://config.example.com/rules.json" \
--target "./config/rules.json" \
--backup \
--on-change "reload-service.sh"
# 输出:
# 检查配置更新...
# 远程版本: 2025-01-15T10:00:00Z
# 本地版本: 2025-01-14T10:00:00Z
# 发现更新!
# 备份旧配置...
# 下载新配置...
# 配置已更新
# 执行变更回调: reload-service.sh
场景三:回滚更新
更新后发现问题,回滚到之前的版本。
# 查看更新历史
./auto-updater history
# 版本 更新时间 状态
# 1.1.0 2025-01-15 10:30 当前版本
# 1.0.0 2025-01-01 09:00 已备份
# 0.9.0 2024-12-15 09:00 已备份
# 回滚到 1.0.0
./auto-updater rollback --to "1.0.0"
# 输出:
# 正在回滚: 1.1.0 -> 1.0.0
# 恢复备份: ~/backups/v1.0.0_20250101.tar.gz
# 回滚完成
# 当前版本: 1.0.0
不适用场景
以下场景自动更新工具-免费版不适合处理：
- 无明确技术栈的模糊需求
- 纯架构设计决策
- 运维部署管理
触发条件
需要代码生成、编程辅助、调试测试、开发部署时使用。不适用于非本工具能力范围的需求。
快速开始
- 阅读## 核心能力章节了解skill功能
- 按## 依赖说明配置环境
- 执行所需能力对应的命令
- 参考## 错误处理章节处理异常
- 查看## FAQ解答常见疑问
初始化
# 创建更新配置
cat > update-config.json << 'EOF'
{
"currentVersion": "1.0.0",
"remoteUrl": "https://api.example.com/releases",
"checkInterval": "24h",
"backupDir": "~/backups",
"diffOnly": true,
"autoBackup": true
}
EOF
# 首次检查
./auto-updater check --config update-config.json
设置定时检查
# 添加 cron 定时检查
crontab -e
# 每天早上 9 点检查更新
0 9 * * * /path/to/auto-updater check --config /path/to/update-config.json
结果处理: 执行完成后,查看输出结果确认操作状态。成功时输出包含处理摘要和结果数据;失败时根据错误信息排查问题,查阅错误处理章节获取恢复步骤。
示例
更新配置格式
{
example.com/releases",
"checkInterval": "24h",
"backupDir": "~/backups",
"diffOnly": true,
"autoBackup": true,
"onUpdate": "post-update.sh",
"exclude": ["*.log", "tmp/*", ".env"]
}
命令参数
| 命令 | 说明 | 示例 |
|---|---|---|
check |
检查更新 | ./auto-updater check --config config.json |
update |
执行更新 | ./auto-updater update --target 1.1.0 |
rollback |
回滚版本 | ./auto-updater rollback --to 1.0.0 |
history |
查看历史 | ./auto-updater history |
sync |
同步文件 | ./auto-updater sync --source URL --target PATH |
备份策略
| 策略 | 说明 | 保留数量 |
|---|---|---|
| 自动备份 | 更新前自动备份 | 最近 5 个版本 |
| 手动备份 | 手动触发备份 | 无限制 |
| 定期清理 | 自动清理旧备份 | 保留最近 30 天 |
优选实践
- 更新前必备份:始终启用
autoBackup,确保可回滚 - 差异更新优先:大项目使用
diffOnly,减少下载量 - 排除临时文件:配置
exclude排除日志、缓存等文件 - 更新后验证:更新后运行测试或健康检查,确认功能正常
- 定期清理备份:旧备份占用空间,设置合理保留策略
- 低峰期更新:定时检查设在业务低峰期,避免影响使用
常见问题
Q: 更新失败怎么办?
A: 如果更新过程中失败,工具会自动回滚到更新前状态。如果更新成功后发现问题,使用 rollback 命令手动回滚到之前的版本。备份文件在 backupDir 中。
Q: 差异更新如何工作?
A: 工具对比当前版本与目标版本的文件清单,只下载有变更的文件。通过文件的哈希值判断是否变更。对于大项目,差异更新可减少 80% 以上的下载量。
依赖详情
A: 免费版只通知有更新可用,需要手动执行 update 命令。自动安装需要配置 onUpdate 回调脚本,在脚本中实现自动更新逻辑。
Q: 如何查看更新日志?
A: 使用 ./auto-updater history 查看更新历史,包含版本号、更新时间、状态。更新日志存储在 ~/.auto-updater/history.log。
依赖说明
运行环境
- Agent平台: 支持 SKILL.md 的任意 AI Agent(Claude Code / Cursor / Codex / Gemini CLI 等)
- 操作系统: Windows / macOS / Linux
- Shell 环境: Bash 或兼容 Shell
第三方依赖
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| curl | CLI工具 | 必需 | 系统自带 |
| jq | CLI工具 | JSON处理推荐 | 包管理器安装 |
| tar | CLI工具 | 备份必需 | 系统自带 |
| rsync | CLI工具 | 差异更新推荐 | 包管理器安装 |
| LLM API | API | 必需 | 由Agent内置LLM提供 |
API Key 配置
- 远程版本库:如果需要认证,通过环境变量配置
UPDATE_API_TOKEN - 私有仓库:配置
UPDATE_AUTH_HEADER - 本 Skill 核心功能无需 API Key
可用性分类
- 分类: MD+execute(Markdown指令 + 命令行执行)
- 说明: 通过自然语言指令驱动 Agent 执行版本检查与更新操作
- 限制: 免费版不支持批量更新、灰度发布与企业级回滚策略
错误处理
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案 |
已知限制
- 需LLM支持,无LLM环境不可用
- 复杂业务场景建议结合人工经验判断
- 执行效率受模型能力与网络环境影响
安全注意事项
| 风险类型 | 防范措施 |
|---|---|
| API密钥泄露 | 通过环境变量配置，禁止硬编码到代码或配置文件中 |
| 命令执行风险 | 仅执行白名单命令，避免拼接用户输入到命令行参数中 |
| 网络通信安全 | 使用HTTPS协议，验证SSL证书有效性 |
| 敏感数据暴露 | 输出结果中不包含密钥、令牌等敏感信息 |
使用前请确认已阅读依赖说明章节，确保运行环境满足安全要求。
核心功能
- 自动化执行: 基于指令驱动的自动化流程
- 文件处理: 支持多种文件格式的读取、解析和写入操作
- API集成: 通过标准化接口调用外部服务并处理响应
- 命令执行: 在安全沙箱中执行系统命令并收集结果
- 信息检索: 快速搜索和过滤目标数据
