statewright

给 AI 智能体套上状态机护栏,防止跑偏越权

开源 🏷️定价信息待确认 ✅ 目前可打开 智能体 🍴 复刻 25
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 511
维护状态 活跃
是否开源 开源
定价模式 🏷️定价信息待确认

项目预览

statewright 项目界面预览图
图片来源:项目官网

项目数据

分类智能体
开发团队statewright
定价模式🏷️定价信息待确认
价格说明定价信息待确认
访问状态✅ 目前可打开
是否开源是
开源协议NOASSERTION
主要语言JavaScript
GitHub 星标★ 511
上线时间2026-05-03 00:00:00
代码更新2026-11-01
仓库体积8.0 MB
本站数据更新2026-11-02
维护状态活跃
收录时间2026-09-16
浏览次数1

项目介绍

Statewright 是一个用 Rust 编写的 AI 智能体状态机护栏库,核心目标是把智能体的行为约束在显式定义的状态机中,避免大模型自由发挥导致不可控操作。它解决的是智能体在复杂任务中容易跑偏、越权或陷入死循环的问题:通过状态、转移条件和守卫规则,明确智能体在什么阶段能做什么、不能做什么。核心能力包括状态定义与转移校验、对工具调用或动作的前置守卫、非法转移拦截,以及可嵌入现有智能体循环的轻量运行时。相比仅靠提示词约束,状态机护栏把控制逻辑从自然语言移到代码层,更可测试、可审计。Rust 实现带来低开销和高并发安全,适合对可靠性和性能有要求的智能体系统。项目目前处于早期,星标约 491,API 和文档仍在演进。

Star 增长趋势

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

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

使用教程

难度:进阶 约 45 分钟 部署方式:容器部署 5 步

环境要求

  • Docker
  • 一个支持的智能体宿主

安装与启动步骤

  1. 1先看它的抽象

    它把智能体每个阶段定义成工具、检查与迁移。

  2. 2自托管起服务

    进自托管目录起容器。

    cd self-hosted && docker compose up --build
  3. 3写一份流程定义

    按它的格式描述阶段与迁移条件。

  4. 4接一个宿主

    支持多个编码智能体,也可接自定义宿主。

  5. 5故意卡一次迁移

    让检查不通过,看它是否真拦住。

如何确认成功

定义两阶段流程后,第一阶段未通过检查时智能体无法迁移到第二阶段,通过后能正常推进

注意事项

  • 它给智能体的工作流加上阶段、检查与迁移约束,避免一步跳到底。
  • 抽象层在宿主之上,换编码智能体不用重写流程。
  • 检查条件写太松等于没有约束。
  • 自托管版用容器起,配置都在仓库里。

核心亮点

  • 用显式状态机约束智能体行为,比纯提示词更可测试、可审计
  • Rust 实现,运行时开销低,适合高并发或性能敏感场景
  • 提供守卫与非法转移拦截,能有效防止越权和死循环

不足之处

  • 项目处于早期,API 和文档可能不稳定
  • 生态和集成示例较少,接入现有智能体框架需一定改造

适用场景

  • 多步骤任务型智能体,需要严格阶段流转控制
  • 涉及敏感操作的工具调用智能体,需要前置权限守卫
  • 需要可审计、可回放智能体决策路径的生产系统

替代项目

LangGraph、Burr

上一篇:Code-as-World

下一篇:evolving-agents

同类项目推荐

Mini-Agent 开源

一个极简智能体模板,让你快速跑通核心执行流程。

A minimal yet professional single agent demo project that showcases the core executi···

★ 3069 2026-08-09
cetus 开源

一个 App 管好所有 AI 编程代理,定时跑、快速开、隔离审查。

One macOS app for Claude Code, Codex, and every agent runtime you use — scheduled r···

★ 149 2026-08-09
AutoHarness 开源

自动构建智能体安全护栏,让AI行为可控可信

AutoHarness: Automated Harness Engineering for AI Agents

★ 467 2026-08-09
mue-x 开源

让 AI 自己改代码,越用越聪明

The first self-evolving AI agent. Rewrites its own source code in real-time. 6 AST m···

★ 280 2026-08-09
hackingBuddyGPT 开源

用LLM写50行代码,自动搞定渗透测试

Helping Ethical Hackers use LLMs in 50 Lines of Code or less..

★ 1295 2026-08-09
pi_agent_rust 开源

用 Rust 打造极速安全的 AI 编程助手,让编码效率飞起

High-performance AI coding agent CLI written in Rust with zero unsafe code

★ 1954 2026-08-09
LocalAGI 开源

本地跑自主AI,隐私安全不花钱

LocalAGI:Locally run AGI powered by LLaMA, ChatGLM and more. | 基于 ChatGLM, LLaMA···

★ 81 2026-08-09
jarvis-assistant-vocal 开源

说法语就能控灯光、开直播、打电话的本地语音助手

Assistant vocal local en francais : Claude ou Ollama (offline), domotique Hue, OBS, ···

★ 545 2026-09-15
agent-smith 开源

让 AI 代理自动完成渗透测试,省时省力

"Never send a human to do a machine's job" - Open Source AI hacking agent

★ 149 2026-08-09