pi-guardrails

给 AI 代理装刹车,危险命令和环境文件先拦下

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 评测安全 🍴 复刻 38 🐛 待处理 6 👀 关注 2
GitHub ↗
GitHub 星标 ★ 305
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费,无付费计划

项目预览

pi-guardrails 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类评测安全
开发团队aliou
定价模式🏷️完全免费
价格说明开源免费,无付费计划
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
主要语言TypeScript
GitHub 星标★ 305
上线时间2026-02-18 00:00:00
代码更新2026-11-03
仓库体积681 KB
本站数据更新2026-11-04
维护状态活跃
收录时间2026-09-16
浏览次数1

项目介绍

pi-guardrails 是给 Pi 编程代理加的一层安全钩子(security hooks)。当 AI 代理自动执行命令、读写文件时,很容易误删数据、泄露 .env 密钥或跑出破坏性操作。这个项目在代理执行动作前做拦截检查:阻止危险命令、保护环境变量文件、对具有破坏性的命令加一道闸门。它用 TypeScript 编写,接入方式轻量,核心能力包括命令黑名单/白名单校验、敏感文件路径保护、破坏性操作二次确认或直接拒绝,以及可扩展的钩子机制。适合把 AI 代理放进真实开发环境、又不想让它乱来的团队,相当于给自动执行加了个安全带。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-09-16 · 当前星标 ★ 305

核心亮点

  • 在命令真正执行前拦截,能挡住 rm -rf、覆盖配置等破坏性操作
  • 专门保护 .env 等敏感文件,降低密钥被代理误读误传的风险
  • TypeScript 实现,钩子机制可扩展,方便按团队规则定制拦截策略

不足之处

  • 早期项目,规则覆盖面和绕过场景的测试深度有待验证
  • 只针对 Pi 生态,换其他代理框架无法直接复用

适用场景

  • 让 AI 代理在本地仓库自动改代码、跑命令时防止误删
  • CI 或自动化流程中限制代理只能执行安全命令
  • 团队统一给多个代理实例加敏感文件访问保护

替代项目

gitleaks、pre-commit、danger

上一篇:trustmebro

下一篇:guardrails-llm-filter

同类项目推荐

WorldLens 开源

给自动驾驶世界模型做全科体检,从生成到重建一测到底

[CVPR 2026 Oral] WorldLens: Full-Spectrum Evaluations of Driving World Models in Rea···

★ 258 2026-08-09
llm-coding-benchmark 开源

自动跑编码题,横向比出哪个大模型写代码更强

Simple benchmark to test the most popular open source and commercial LLMs with autom···

★ 371 2026-09-16
awesome-ml-monitoring 开源

找ML监控工具,看这个清单就够了

A curated list of awesome open source tools and commercial products for monitoring d···

★ 96 2026-08-09
awesome-typesafe-jev 开源

一页看全 System One 的 SDK、演示与评测

Awesome Jev: a source-backed field guide to TypeSafe's System One model, with SDKs, ···

★ 614 2026-10-25
dep-scan 开源

扫依赖和镜像,查漏洞与许可证风险,出 SBOM

OWASP dep-scan is a next-generation security and risk audit tool based on known vuln···

★ 1324 2026-10-23
search-arena 开源

量化分析搜索增强大模型,看清能力边界

⚔️ [ICLR 2026] Official code of "Search Arena: Analyzing Search-Augmented LLMs".

★ 62 2026-08-09
awesome-ai-testing 开源

一页清单看懂 AI 测试工具,选型不再东拼西凑

A curated list of AI-powered testing tools, frameworks, and resources for QA enginee···

★ 170 2026-09-25
vestige 开源

给AI智能体装黑匣子,每步操作可查可证

Think before doing, prove before saving. Vestige is the local-first cognitive operat···

★ 660 2026-10-10
Zero-Breach-Toolkit 开源

离线自查设备是否留有已知间谍软件痕迹

Free, open-source check for traces of mercenary spyware (Pegasus, Predator, Graphite···

★ 4373 2026-10-29