Prismor
在 AI agent 执行工具调用之前拦截:密钥外泄、提示注入、供应链风险,本地仪表盘可观测、可审批、可阻断。
- Star 数
- ★ 583
- 最近更新
- 今天
- License
- Apache-2.0
- 主语言
- Python
- FA 评分
- 61/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code · OpenAI API · Claude API
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 安全工程师在团队刚引入 Claude Code 时,先用 prismor mode apply dev-safe --observe 观察两周,再逐条把高风险规则切成 enforce。
- 不适合
- 希望开箱即拦截、不愿先做策略调优的团队
- 无法接受在 agent 与模型之间插入代理的团队
- 官网
- prismor.dev ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-20最新版本 v1.79.0(2026-11-20)近 7 天每天 +13.7 ★
- 源码审查
- 61/100 · 存在缺口
这个 Agent 能做什么,适合哪些场景?
Prismor 是一个自托管的 AI agent 运行时控制平面,通过 pip 安装后在终端运行。它为 Claude Code、Codex、Cursor、Gemini CLI、Copilot、OpenCode 等编码 agent 安装原生 hook 或插件,把每一次工具调用规范化为统一事件,交给同一套 YAML 策略引擎在调用真正执行前给出 allow / warn / block 判定。除 hook 之外,它还提供 MCP Gateway(统一代理所有 MCP 服务器并扫描返回内容中的注入)、框架 SDK 适配器(OpenAI Agents SDK、LangChain/LangGraph、CrewAI 等)、eval-server 和 LLM Proxy,覆盖没有 hook 协议的 agent。所有发现写入本地 SQLite/JSONL 会话库,可通过 prismor dashboard 的本地 Web 界面或终端查看,并用哈希链加 Ed25519 签名形成可验证的审计轨迹。默认全部为 observe 模式,只有策略中显式设为 enforce 的规则才会真正阻断。
安装后 prismor install-hooks --agent all 会向各 agent 的 hooks 配置(如 <workspace>/.claude/settings.json、.cursor/hooks.json、.codex/hooks.json)写入 hook-dispatch 条目,在 PreToolUse / PostToolUse / UserPromptSubmit 时机接收事件。工具调用进入 dispatcher 后由策略引擎按 .prismor/policy.yaml 中的规则评估,每条规则可单独设置 mode: observe 或 enforce,并支持 org → project → repo 的分层覆盖与不可覆盖的安全底线。执行前检查包括语义注入检测(prismor semantic-check,正则预筛加 LLM 裁判)、出站控制、MCP guardrails、tool tags、IAM、会话级 scoped agent 规则和 Docker 沙箱。密钥保护方面提供 Sweep and Cloak(占位符替换、输出清洗)、env guard 和 canary 蜜罐文件;供应链方面 prismor supplychain 包装 npm/pip/cargo/go 安装,按年龄、维护者数量、安装脚本和 IOC 评分(<30 允许、30–59 警告、≥60 阻断)。判定结果写入会话存储,可经 prismor dashboard、prismor traces 查看,prismor trail verify 校验审计链未被篡改。
- 安全工程师在团队刚引入 Claude Code 时,先用 prismor mode apply dev-safe --observe 观察两周,再逐条把高风险规则切成 enforce。
- DevOps 团队给 CI 或开发者机器的 npm/pip 加上 prismor supplychain 别名,防止 agent 从被投毒或被劫持的维护者账号安装恶意包。
- 合规负责人需要向审计方证明 agent 行为未被篡改:运行 prismor attest verify 校验包含 OWASP LLM/Agentic、NIST AI RMF、EU AI Act 覆盖映射的 Ed25519 签名包。
- 多 agent 共用一个工作区时,用 IAM 为每个 agent 分配命名身份和最小权限配置,避免一个 agent 改了另一个 agent 的配置。
- 想管控一个无法挂 hook 的 agent,把它指向 prismor proxy(ANTHROPIC_BASE_URL / OPENAI_BASE_URL),让模型提出的每一次 tool_calls 都经过同一套规则判定。
- 刚装好 Prismor 时用 prismor analyze-history 回放磁盘上已有的会话记录,看清哪些历史操作在新规则下会被拦截。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
pip install prismorpip install "prismor[pii]"
- 配置文件
.prismor/policy.yaml
如何安装或部署这个 Agent?
前置条件:Python 环境(通过 pip 安装);如需供应链管控,本机需存在 npm / pip / cargo / go 等包管理器。
pip install prismor
prismor setup若系统受 PEP 668 保护,README 指向 docs/installation.md 给出了 pipx、Skill、curl 与 git clone 等替代安装方式。
安装 hook(可按作用域和初始姿态选择):
prismor install-hooks --agent all --scope project --mode observe非交互式配置语义裁判:
prismor setup --non-interactive --judge claude
prismor setup --non-interactive --judge codex
prismor setup --non-interactive --judge api --judge-model gpt-4o-mini可选 PII 检测需额外安装扩展:
pip install "prismor[pii]"如何使用这个 Agent?
安装后先选治理姿态,再启动本地仪表盘查看发现:
prismor mode list
prismor mode explain dev-safe
prismor mode apply dev-safe
prismor dashboard策略在 .prismor/policy.yaml 中按规则配置执行模式:
# .prismor/policy.yaml
settings:
default_mode: observe # 全局默认,未单独设置的规则走这里
rules:
- id: destructive-rm-rf
mode: enforce # 该规则阻断,其余仍只观测发生误拦时用 allow 放开窄例外,供应链安装走 prismor 包装:
prismor allow destructive-rm-rf --pattern '<literal>'
prismor supplychain npm install express
prismor supplychain npm install @tanstack/react-router # 命中 IOC,直接阻断
prismor supplychain harden --dry-run验证审计链并做健康检查:
prismor trail verify
prismor doctor临时停用有三种互不叠加的层级,常用的是软停用:
prismor uninstall-hooks --agent claude --scope project
prismor uninstall-hooks --agent all --scope user
PRISMOR_LOCAL_DRY_RUN=1
prismor scope clear <session-id>这个 Agent 有哪些优点和局限?
- 一套 YAML 策略引擎同时供 hook、MCP Gateway、框架 SDK 适配器、eval-server、LLM Proxy 使用,规则写一次即可覆盖不同接入面,并有 tests/test_surface_conformance.py 校验各接入面判定一致。
- 覆盖 agent 数量广:Claude Code、Codex、Cursor、Gemini CLI、Copilot CLI、Kiro、OpenClaw、Hermes、OpenHands 等有原生 hook 或插件,另有 Aider、Trae 等配置扫描模式。
- 默认全部 observe、按规则逐条转 enforce,并且 setup 的 enforce 模式从“什么都不拦”开始让人显式勾选,降低上线即误伤的风险。
- 供应链评分加 IOC 匹配包装 npm/pip/cargo/go,并可用 harden 写入 .npmrc / pip.conf 等文件,即使绕过别名、在 CI 或 IDE 插件里也生效。
- 审计可验证:哈希链加 Ed25519 签名的轨迹(prismor trail verify)与签名证明包(prismor attest verify),且有独立的无依赖回执校验器供 SIEM 使用。
- 完全自托管,仪表盘绑定本地 127.0.0.1,会话数据存在本地 SQLite/JSONL,不需要把日志发到云端。
- 默认不阻断任何东西,所有规则初始为 observe,真正防护需要人工逐条选择并调优策略,投入不小。
- 拦截逻辑分散在三个互不叠加的层级(hook 安装、PRISMOR_LOCAL_DRY_RUN、scoped agent 规则),排障时容易只关掉其中一层而以为已完全停用;scoped 规则硬编码为 enforce,卸载 hook 也不解除。
- 语义裁判依赖外部 LLM(Claude CLI、Codex CLI 或 litellm 模型加密钥),会带来额外延迟与成本,且默认只用启发式。
- 供应链管控需要把包管理器通过别名或 prismor supplychain 前缀调用才生效,绕过别名时只能靠 harden 的配置文件兜底。
- 集成面多、文档篇幅大(CLI 参考、各 agent 集成矩阵、分层策略等),新用户需要一定时间才能建立完整心智模型。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Prismor 当前 | 61 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 583 | 今天 | Python | Codex · Claude Code · OpenAI API · Claude API |
| HOL Guard | 80 · 表现良好 | 命令行工具免费版 + 付费版 | ★ 1.1k | 今天 | Rust | Codex · Claude Code |
| Orca AI 事件档案库 | 60 · 存在缺口 | — | ★ 329 | 9 天前 | HTML | — |
| Cordum Agent Control Plane | 75 · 存在缺口 | 自托管服务免费 | ★ 507 | 3 天前 | Go | Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
证据显示默认 observe、显式选择 enforce、自保护规则强制生效、unlock 需人工密码窗口、dashboard 仅监听 127.0.0.1 并做 Host/CSRF 校验、审计链 Ed25519 签名,这些是实打实的权限收敛与确认机制。扣分点:curl 安装脚本会发送匿名安装统计(可 opt-out),dashboard 依赖 CDN/Google Fonts(FAQ 自述),依赖安全仅靠 PyYAML 硬性检查与 OSV 查询,未见锁文件或依赖审计证据;来源归属仅靠 README 徽章与 marketplace.json 中的邮箱,发布者身份未经验证。
CLI 对 PyYAML 缺失给出明确报错并退出,hook 失败会 fail-open 但文档明确说明,block 消息带规则 id 与修复命令,自洽性较好。扣分:依赖可用性只覆盖 PyYAML 与可选 extras,未见完整依赖清单/版本约束;Windows 上 cloak 不可用、Codex 需一次性信任步骤,属于环境相关可靠性缺口。
README 与 AGENT_INTEGRATIONS 覆盖大量 agent 与框架,SKILL.md 给出触发→命令→恢复的决策树,场景与受众分层清晰(getting-started 面向非安全专家)。扣分:capability_boundaries 虽在 modes 中声明残余风险,但样本中未见完整 modes 文档;trigger_precision 依赖 SKILL.md 表格,未见对误触发的量化;环境适配在 Windows/macOS system install 上有明确未完成项。
LICENSE 为完整 Apache-2.0,SECURITY.md 提供私密披露渠道,安装文档分平台详尽,FAQ 与 glossary 结构清晰。扣分:未见 CHANGELOG 或版本策略文档(仅 README 提及升级兼容),维护责任仅靠 marketplace.json 邮箱与 SECURITY 邮箱,发布者未经验证,信息架构在样本中只覆盖部分 docs。
输出可用性较好:block 消息含规则 id 与 prismor allow 修复命令,dashboard 与 CLI 提供会话/发现视图。扣分:marginal_value 依赖规则质量,样本未见规则命中率或误报数据;cost_benefit 方面 hook 每调用一次、dashboard 依赖外部资源、可选 LLM judge 会产生额外成本,未见性能预算证据。
文档对自身局限有诚实表述(如 'we could not find' 的措辞、fail-open 说明、Windows 未支持项),事实与推断有一定分离。扣分:大量能力声明(17 个 agent 拦截、MCP mirror verified)仅靠 README 表格与生成脚本,样本中无对应测试或日志佐证;跨源佐证有限,未见独立第三方验证。
- curl 安装脚本会发送匿名安装统计,需设置 PRISMOR_NO_TELEMETRY=1 或 DO_NOT_TRACK=1 关闭。
- dashboard 从 CDN 加载图表库与 Google Fonts,离线或受限网络下可能无法正常显示。
- hook 失败时 fail-open,agent 会把 hook 失败视为非阻断,可能造成'已安装但未筛查'的错觉。
- Windows 上 cloak 不可用,Codex 需一次性信任 hook,否则不筛查任何调用。
- 发布者身份未经验证,安装前应自行核对 PyPI 包与 GitHub 发布产物的 provenance 证明。
- 样本中未见完整依赖清单与锁文件,依赖安全需自行审计。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
What's Changed * sandbox: say when the egress allowlist only logs; docs add egress mode enforce by @Ar9av in https://github.com/PrismorSec/prismor/pull/977 * telemetry: ship path from structured evidence under full capture by @Ar9av in https://github.com/PrismorSec/prismor/pull/980 * fix(staged-exec): cut untrusted_content false positives by @Ar9av in https://github.com/PrismorSec/prismor/pull/981 Full Changelog: https://github.com/PrismorSec/prismor/compare/v1.78.0...v1.79.0在 GitHub 查看 ↗ -
发布说明摘录
What's Changed * sandbox: fail closed in enforce mode; only a person can turn it off by @Ar9av in https://github.com/PrismorSec/prismor/pull/975 * Context panel: limit source, model switches, subagents; drain the usage spool by @Ar9av in https://github.com/PrismorSec/prismor/pull/976 Full Changelog: https://github.com/PrismorSec/prismor/compare/v1.77.0...v1.78.0在 GitHub 查看 ↗ -
发布说明摘录
What's Changed * feat: allowed models and spend budgets per session, agent, user, device by @Ar9av in https://github.com/PrismorSec/prismor/pull/952 * cloak: Vault/OpenBao, Infisical and AWS Secrets Manager sources by @Ar9av in https://github.com/PrismorSec/prismor/pull/953 * Org vault: sync secrets the console seals to this device by @Ar9av in https://github.com/PrismorSec/prismor/pull/954 * ci: Claude auto code review on PRs by @Ar9av in https://github.com/PrismorSec/prismor/pull/955 …在 GitHub 查看 ↗
常见问题
装好之后它会立刻拦截 agent 吗?
它支持哪些 agent?
语义提示注入检测需要自己准备 API key 吗?
数据会发到外部吗?
误拦了正常操作怎么放开?
Prismor 官网是什么?
Prismor 免费吗?
Prismor 开源吗?
Prismor 安全吗?
Prismor 还在维护吗?
Prismor 是谁开发的?
谢谢反馈,我们会据此改进页面。