Prismor

在 AI agent 执行工具调用之前拦截:密钥外泄、提示注入、供应链风险,本地仪表盘可观测、可审批、可阻断。

Star 数
★ 583
最近更新
今天
License
Apache-2.0
主语言
Python

30 秒速览

运行形态
命令行工具自托管服务网页应用
可在哪里用
通用 · 跨平台Codex · Claude Code · OpenAI API · Claude API
费用
软件免费,模型调用费用自付
上手难度
低 · 几分钟可跑通
开始前需要
Python(pip)npm / pip / cargo / go 包管理器(用于供应链管控)Shell / 命令行网络访问本地文件系统MCP Server
典型场景
安全工程师在团队刚引入 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 ★

这个 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 校验审计链未被篡改。

  1. 安全工程师在团队刚引入 Claude Code 时,先用 prismor mode apply dev-safe --observe 观察两周,再逐条把高风险规则切成 enforce。
  2. DevOps 团队给 CI 或开发者机器的 npm/pip 加上 prismor supplychain 别名,防止 agent 从被投毒或被劫持的维护者账号安装恶意包。
  3. 合规负责人需要向审计方证明 agent 行为未被篡改:运行 prismor attest verify 校验包含 OWASP LLM/Agentic、NIST AI RMF、EU AI Act 覆盖映射的 Ed25519 签名包。
  4. 多 agent 共用一个工作区时,用 IAM 为每个 agent 分配命名身份和最小权限配置,避免一个 agent 改了另一个 agent 的配置。
  5. 想管控一个无法挂 hook 的 agent,把它指向 prismor proxy(ANTHROPIC_BASE_URL / OPENAI_BASE_URL),让模型提出的每一次 tool_calls 都经过同一套规则判定。
  6. 刚装好 Prismor 时用 prismor analyze-history 回放磁盘上已有的会话记录,看清哪些历史操作在新规则下会被拦截。

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

安装 / 启动命令
  • pip install prismor
  • pip 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?

FollowAgents 源码审查 · FARS-2.1
存在缺口
61/ 100 五分制 3.1 / 5
本评测基于 2026年11月11日 的源码;此后该项目发布了 5 个正式版本,尚未复审。分数与结论只代表评测时的版本。 最近版本 ↓
信任安全 17/29
可靠稳定 8/14
适用触发 14/18
规范维护 11/18
有效结果 7/13
证据核验 4/8
查看各维度的扣分理由
信任安全17 / 29 · 2.9/5

证据显示默认 observe、显式选择 enforce、自保护规则强制生效、unlock 需人工密码窗口、dashboard 仅监听 127.0.0.1 并做 Host/CSRF 校验、审计链 Ed25519 签名,这些是实打实的权限收敛与确认机制。扣分点:curl 安装脚本会发送匿名安装统计(可 opt-out),dashboard 依赖 CDN/Google Fonts(FAQ 自述),依赖安全仅靠 PyYAML 硬性检查与 OSV 查询,未见锁文件或依赖审计证据;来源归属仅靠 README 徽章与 marketplace.json 中的邮箱,发布者身份未经验证。

可靠稳定8 / 14 · 2.9/5

CLI 对 PyYAML 缺失给出明确报错并退出,hook 失败会 fail-open 但文档明确说明,block 消息带规则 id 与修复命令,自洽性较好。扣分:依赖可用性只覆盖 PyYAML 与可选 extras,未见完整依赖清单/版本约束;Windows 上 cloak 不可用、Codex 需一次性信任步骤,属于环境相关可靠性缺口。

适用触发14 / 18 · 3.9/5

README 与 AGENT_INTEGRATIONS 覆盖大量 agent 与框架,SKILL.md 给出触发→命令→恢复的决策树,场景与受众分层清晰(getting-started 面向非安全专家)。扣分:capability_boundaries 虽在 modes 中声明残余风险,但样本中未见完整 modes 文档;trigger_precision 依赖 SKILL.md 表格,未见对误触发的量化;环境适配在 Windows/macOS system install 上有明确未完成项。

规范维护11 / 18 · 3.1/5

LICENSE 为完整 Apache-2.0,SECURITY.md 提供私密披露渠道,安装文档分平台详尽,FAQ 与 glossary 结构清晰。扣分:未见 CHANGELOG 或版本策略文档(仅 README 提及升级兼容),维护责任仅靠 marketplace.json 邮箱与 SECURITY 邮箱,发布者未经验证,信息架构在样本中只覆盖部分 docs。

有效结果7 / 13 · 2.7/5

输出可用性较好:block 消息含规则 id 与 prismor allow 修复命令,dashboard 与 CLI 提供会话/发现视图。扣分:marginal_value 依赖规则质量,样本未见规则命中率或误报数据;cost_benefit 方面 hook 每调用一次、dashboard 依赖外部资源、可选 LLM judge 会产生额外成本,未见性能预算证据。

证据核验4 / 8 · 2.5/5

文档对自身局限有诚实表述(如 '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 证明。
  • 样本中未见完整依赖清单与锁文件,依赖安全需自行审计。
证据充分度:低 评估于 2026年11月11日 审查版本 44641100dc7e 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/prismor.svg?lang=zh)](https://followagents.com/zh/agents/prismor)
<a href="https://followagents.com/zh/agents/prismor"><img src="https://followagents.com/badge/prismor.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v1.79.0
    发布说明摘录
    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 查看 ↗
  2. v1.78.0
    发布说明摘录
    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 查看 ↗
  3. v1.77.0
    发布说明摘录
    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 吗?
不会。默认所有规则是 observe,只记录发现不阻断;只有你在 .prismor/policy.yaml 中把某条规则或 settings.default_mode 设为 enforce 才会实时拦截,且策略中的 enforce 优先于 hook 安装时的 --mode 参数。
它支持哪些 agent?
Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot CLI、Kiro、Crush、Goose、Grok Build、OpenHands、Qwen Code、Continue CLI、OpenCode、OpenClaw、Hermes、Antigravity 等通过原生 hook 或插件拦截;Aider、Trae、Warp、Roo Code 等目前只做配置扫描;生产框架侧支持 OpenAI Agents SDK、LangChain/LangGraph、CrewAI、Pydantic AI、AutoGen Core、Google ADK 等。
语义提示注入检测需要自己准备 API key 吗?
不一定。裁判可以用你已有的 Claude Code CLI 或 Codex CLI 登录(--judge claude / --judge codex),也可以走 --judge api 配任意 litellm 模型加密钥。未配置裁判时只跑启发式预筛。
数据会发到外部吗?
核心是自托管的:策略、会话库、审计链都在本地,仪表盘起在 127.0.0.1。只有在你启用语义裁判(会调用所配置的 LLM)、可选的 Live Telemetry 企业控制面链接,或 telemetry sinks 转发时,数据才会离开本机,且这些均为可选。
误拦了正常操作怎么放开?
阻断信息会直接打印最窄的解除命令,例如 prismor allow <rule> --pattern '<literal>';也可以把该规则改回 observe。agent 自身无法编辑 Prismor 配置,需要人工用密码门控的 prismor unlock 打开限时窗口。
Prismor 官网是什么?
Prismor 的 GitHub 仓库填写的官网是 https://prismor.dev。这个链接由仓库作者设置;源码在 GitHub(PrismorSec/prismor)。
Prismor 免费吗?
软件本身免费,但 Prismor 要调用 AI 模型,模型的调用费用由你向模型服务商支付(也可以接本地模型)。
Prismor 开源吗?
开源。源码在 GitHub(PrismorSec/prismor),许可证是 Apache-2.0。
Prismor 安全吗?
FollowAgents 的 FARS 评审(2026年11月11日)给 Prismor 的“信任与安全”打了 17/29 分。评审检查的 8 项安全措施没有完全缺失的。评审之后仓库已有更新。
Prismor 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-20,在最近 30 天内。最新版本是 v1.79.0(2026-11-20)。
Prismor 是谁开发的?
Prismor 由 GitHub 账号 PrismorSec 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念