nightly-build

🌙 夜间自动运维的晨间简报助手

基于 Node.js 的本地自动化运维技能,定时执行技能审计、系统健康检查与日志清理,为开发者提供一站式晨间简报。

收藏
5.1k
安装
1.3k
版本
v1.1.0
CLS 安全性认证2026-05-19
点击查看完整报告 >

使用说明

核心用法

Nightly Build 是一款面向开发者的本地自动化运维工具,通过定时任务(cron)在夜间执行系统维护任务,并于次日早晨生成结构化报告。用户可通过三条核心命令与技能交互::nightly report 查看最近一次构建报告,,nightly run 手动触发任务执行(适用于测试场景),nightly config 配置具体任务项。技能内置五项自动化任务:Skill Audit(运行 npm audit 检测技能依赖安全)、Auto-Update(拉取 Git 仓库最新变更)、Cleanup(清理 7 天以上临时文件与旧日志)、Health Check(验证磁盘空间与系统负载)、Briefing(汇总生成晨间报告)。

显著优点

零外部依赖:仅使用 Node.js 内置模块(child_processfspathurl),彻底规避供应链攻击风险。**数据完全本地化**:所有处理均在本地完成,报告与日志分别存储于 memory/nightly-report.mdmemory/nightly.log,无网络传输。**安全设计严谨**:命令均为硬编码的信息获取类操作(git remote updatedf -huptime` 等),无破坏性指令;60 秒超时机制防止命令挂起;完善的 try-catch 错误处理避免敏感信息泄露。权限匹配精准:申请的权限(文件系统读写、系统命令执行)与功能完全对应,无过度授权。运维场景闭环:覆盖开发者日常维护的完整链路——从依赖安全、代码同步到磁盘监控、日志治理,实现"睡前启动、晨起看报"的无感体验。

潜在缺点与局限性

来源可信度受限:开发者 0xraini 为个人账号,所属组织 openclaw 规模较小,项目 Stars 数与许可证信息未明确,属于 T3 来源。系统命令执行风险:使用 execSync 执行 gitnpmdf 等系统命令,虽经硬编码处理,但仍依赖宿主环境命令可用性与版本兼容性。跨平台适配待验证vm_stat 为 macOS 特有命令,Linux/Windows 环境可能需额外适配。配置灵活性不足:cron 表达式需手动编辑 JSON 配置,缺乏交互式配置向导。生产环境适用性有限:官方明确建议不用于生产服务器关键任务,多用户共享环境需额外权限配置。日志清理策略固定:7 天清理阈值不可配置,特殊场景下可能不符合合规保留要求。

适合的目标群体

本地开发环境维护者:需要定期审计技能依赖、同步代码仓库、监控磁盘空间的个人开发者。小型团队技术负责人:希望建立轻量级夜间巡检机制,降低人工运维成本。DevOps 初学者:通过阅读源码学习安全命令执行、错误处理、定时任务设计的实践案例。隐私敏感型用户:拒绝云端服务、坚持数据本地化的安全意识较强群体。

使用风险

环境依赖风险:若宿主机未安装 Git 或 Node.js 版本过低,命令执行将失败。磁盘空间误判df -h 解析依赖特定输出格式,非标准 Unix 环境可能解析异常。并发执行冲突:手动 nightly run 与定时任务重叠时可能产生资源竞争(建议加锁机制)。日志累积风险:若技能本身异常退出,日志文件可能持续增长(需外部监控兜底)。权限扩散风险:文件系统读写权限覆盖整个 SKILLS_DIR,路径遍历攻击理论上存在利用空间(需验证 WORKSPACE_DIR 环境变量过滤)。

安全解读

核心用法

Nightly Build 是一款面向 Claude 生态的自动化维护 Skill,核心定位是「夜间无人值守运维」。用户通过简单的 cron 配置即可让系统在凌晨自动执行一系列维护任务,次日早晨获得一份结构化晨报。

主要命令 trio:

  • nightly run — 手动触发完整任务流,适合首次配置验证或临时执行
  • nightly report — 调取最近一次执行的结果摘要,快速回顾系统状态
  • nightly config — 交互式开关各子任务(技能审计、Git 同步、磁盘清理等)

五项自动化任务:
1. Skill Audit:运行 npm audit 扫描已安装技能的安全漏洞

2. Auto-Update:自动拉取技能 Git 仓库的最新代码

3. Cleanup:清理临时文件与过期日志,释放磁盘空间

4. Health Check:检测磁盘剩余空间与系统负载(CPU/内存)

5. Briefing:将上述结果聚合为一份人类可读的晨报

---

显著优点

  • 零值守自动化:一次配置,每日自动运行,彻底解放手动维护负担
  • 一站式运维:将分散的工具(npm audit、git pull、df、uptime)整合为统一工作流
  • 晨报摘要:将技术输出转化为高层摘要,降低信息噪音
  • 纯 Node.js 内置:零第三方依赖,依赖攻击面极小
  • 开源可审计:代码透明,用户可自行审查执行逻辑

---

潜在缺点与局限性

  • 命令注入风险:大量使用 execSync 执行 shell 命令(git、npm、df 等),若环境变量被篡改可能导致任意代码执行
  • 路径遍历隐患:依赖 WORKSPACE_DIR 环境变量拼接路径,缺乏严格边界校验
  • T3 来源可信度:个人开发者社区项目,长期维护、安全响应速度存不确定性
  • 错误信息泄露:异常时可能暴露系统路径和命令细节
  • 平台局限性:Health Check 命令(如 vm_stat)主要针对 macOS/Linux,Windows 兼容性未明

---

适合人群

  • 运行多技能、多 Git 仓库的 Claude 重度用户
  • 习惯 Unix 哲学、愿意用 cron 编排自动化的开发者
  • 能接受「社区项目」风险等级,并愿意定期审查代码的技术人员
  • 不适合:安全敏感环境、完全零技术背景用户、追求企业级 SLA 保障的场景

---

常规风险

| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 代码执行 | 中 | execSync 调用系统命令,需用户明确授权 Bash 权限 |
| 路径遍历 | 中 | 环境变量控制文件访问边界,建议手动校验 |
| 信息泄露 | 低 | 错误处理可能暴露系统路径,建议脱敏配置 |
| 供应链 | 极低 | 无第三方依赖,仅间接访问 GitHub/npm registry |

建议缓解措施:
1. 在隔离环境(如 Docker、受限用户)中运行

2. 定期审查 0xraini/nightly-build 仓库更新

3. 配置前手动检查 WORKSPACE_DIR 指向,避免指向敏感目录

4. 启用前使用 nightly run 手动验证,观察实际执行行为

nightly-build 内容

scripts文件夹
手动下载zip · 4.6 kB
nightly.mjstext/javascript
请选择文件