pi-warden

给 Pi 代理加护栏,写文件守规则,假完成和死循环当场抓出

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 自动化工作流 🍴 复刻 32 🐛 待处理 4 👀 关注 2
GitHub ↗
GitHub 星标 ★ 177
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费,无在线服务

项目预览

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

项目数据

分类自动化工作流
开发团队DevMortimer
定价模式🏷️完全免费
价格说明开源免费,无在线服务
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言TypeScript
技术栈/模型agent-guardrails,guardrails,pi-extension,pi-package,typesafe
GitHub 星标★ 177
上线时间2026-09-16 00:00:00
代码更新2026-11-06
仓库体积9.9 MB
本站数据更新2026-11-10
维护状态活跃
收录时间2026-09-26
浏览次数2

项目介绍

pi-warden 是给 Pi 编码代理加装的护栏扩展,核心思路是“引导而非打断”。它在代理每次写文件时自动执行项目规则,只拦截真正难以撤销的高风险操作——官方在真实会话中测得每 1000 次调用仅约 3 次触发硬拦截,尽量不干扰正常流程。除了写操作约束,它还能识别代理未经验证就宣称“完成了”的虚假结论,以及陷入重复循环卡死的情况,并会裁剪过长的工具输出,降低上下文占用。项目基于 pi-typesafe 构建,用 TypeScript 编写,属于自动化工作流分类,适合已经在用 Pi 做代码生成或批量修改、又担心代理乱写文件或假报成功的团队。它把规则检查前置到写入环节,让代理在既定边界内自主工作,而不是频繁弹窗要求确认。

Star 增长趋势

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

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

技术标签

核心亮点

  • 写操作实时执行项目规则,把约束前置到落盘前而非事后检查
  • 硬拦截率极低,实测每千次调用约 3 次,正常流程几乎无感
  • 能识别未验证的“已完成”声明和卡死循环,并裁剪工具输出节省上下文

不足之处

  • 仅适配 Pi 生态,脱离 Pi 的代理框架无法直接复用
  • 项目处于早期,规则配置方式与文档完善度有待观察

适用场景

  • 用 Pi 代理批量重构代码时,防止它违反项目命名或目录规范
  • 让代理长时间自主跑任务,避免它假报完成或陷入重复循环
  • 在大型仓库中控制代理工具输出长度,减少上下文被日志淹没

替代项目

OpenHands、Aider、SWE-agent

上一篇:rssh

下一篇:obsei

同类项目推荐

CyberScraper-2077 开源

用大白话指挥 AI 爬网页,不用写解析规则,要啥直接说。

A Powerful web scraper powered by LLM | OpenAI, Gemini & Ollama

★ 3298 2026-08-09
ars0n-framework-v2 开源

AI 帮你跑赏金流程,新手也能像老手一样挖洞

AI Native Bug Bounty Hunting Framework Designed to Help Beginners Compete w/ the Pro···

★ 875 2026-10-08
Semi-Auto-NovelAI-to-Pixiv 开源

批量生成、处理并上传 Pixiv,解放双手的 NovelAI 量产神器

带有 WebUI 的 NovelAI 量产工具, 实现了批量文生图; 批量图生图; 视频转绘; 分块重绘; 批···

★ 433 2026-08-09
puppeteer-render-text 开源

用 Chrome 引擎把文本变成高清图片,排版效果与浏览器一致。

Robust text renderer using headless chrome.

★ 65 2026-08-09
testdriverai 开源

让 AI 直接操作电脑,用大白话完成端到端测试

Computer-Use SDK for E2E QA Testing

★ 355 2026-08-09
woml 开源

用可读文档写自动化,流程像代码一样可版本管理

Build automated workflows, apps, and AI agents with WOML

★ 174 2026-10-07
screencap 开源

macOS 屏幕活动自动记忆,让 AI 助手知道你在干什么

A lightweight, macOS-native activity memory for you and your agents

★ 126 2026-10-18
anymd 开源

本地把任意文件秒变干净 Markdown,直接喂给 AI

Any file → clean Markdown for AI agents: PDF, Word, PowerPoint, Excel, EPUB, HTML a···

★ 1068 2026-09-28