Oversight (v0.5.9)

Oversight 是一款终端安全情报工具和智能代码分页器，旨在 shell 脚本和软件包升级流在你的系统上执行之前对其进行审计。它通过实时启发式分析和交互式审查，弥合了盲目信任与繁琐的人工审计之间的鸿沟。

---

亮点

• 静态与启发式审计引擎：使用模块化正则表达式模式和香农熵评估脚本缓冲区，以捕获混淆字符串、打包的二进制文件和可疑的生命周期链。
• 智能分页器回退：当某个流通过分析且零风险标记时，Oversight 会作为响应式文本分页器运行，支持平滑的行滚动、翻页和鼠标滚轮支持。
• 多包 Git Diff 分离：动态地将批量升级流隔离到专用的软件包标签页中，同时处理本地构建文件，如 PKGBUILD 和 .install 脚本。
• 实时 Shell 拦截：为 Zsh、Bash 和 Fish 提供可选轻量级钩子，可拦截高风险命令并在执行前提示进行分析。

---

快速安装

通过 Arch 用户仓库 (AUR)

yay -S oversight-git

从源码安装

git clone https://github.com/Rakosn1cek/oversight.git
cd oversight
chmod +x install.sh
./install.sh

---

快速开始

# Audit a local shell script
oversight ./install.sh

# Audit a remote script safely in memory
oversight https://raw.githubusercontent.com/example/repo/main/install.sh

# Pipe git diffs or manual pages directly
git diff | oversight

包管理器集成

要在软件包升级期间将 Oversight 用作 diff 分页器，请将别名添加到你的 shell 配置文件中：

# For Yay (~/.zshrc or ~/.bashrc)
alias yay="yay --diffpager oversight"

对于 Paru，请将以下行添加到 ~/.config/paru/paru.conf：

[options]
Pager = oversight
CombinedUpgrade

---

关键控制参考

按键 / 输入	上下文	操作
↓ / ↑	分页模式 / 标签页	逐行滚动视口
↓ / ↑	发现视图	在已标记的发现之间导航
j / k	所有视图	逐行滚动视口
PageDown / Space	所有视图	将视口向下滚动一页
PageUp / b	所有视图	将视口向上滚动一页
d / u	所有视图	将视口向下或向上滚动半页
Home / g / ←	所有视图	跳转到流的顶部
End / G	所有视图	跳转到流的底部
Tab / 0-9	多包	循环或跳转到软件包标签页
s	发现视图	切换所选发现的抑制状态
鼠标滚轮	所有视图	平滑滚动视口 3 行
q / Esc	所有视图	退出 Oversight

---

完整文档

有关详细的架构指南、自定义签名编写（rules.json）、全局系统分页器配置和故障排除，请访问官方文档网站：

👉 https://rakosn1cek.github.io/oversight/

---

社区与贡献

欢迎贡献、提交规则和反馈。

• 在 Discord (Rakosn1cek Hub) 上讨论和提问
• 在 GitHub 上提交 issue 或发起讨论

许可证

MIT © 2026 Rakosn1cek。任何再分发或衍生作品均需注明出处。