尧图网站建设 
tirith shell钩子深度指南zsh/bash/fish命令拦截机制与毫秒级性能优化揭秘【免费下载链接】tirithTerminal security for developers and AI agents. Intercepts homograph URLs, pipe-to-shell, ANSI injection, obfuscated payloads, data exfiltration, and malicious AI skills/configs before they execute.项目地址: https://gitcode.com/gh_mirrors/tir/tirithtirith是一款面向开发者和 AI Agent 的终端安全工具它的 shell 钩子shell hook机制能在你按下回车键的那一刻拦截危险命令——同形异义 URL、pipe-to-shell、ANSI 转义注入、混淆载荷等威胁都赶在执行之前被识别和阻断。本文带你深入 zsh、bash、fish 三种 shell 的拦截实现原理并揭秘它如何将检查延迟压缩到毫秒级的设计细节。一、tirith shell钩子是什么为什么需要它传统终端防护依赖用户眼明手快但复制粘贴一条curl ... | bash或从 AI 工具里粘贴一段带隐藏 ANSI 序列的命令肉眼几乎无法识别。tirith 的思路是把安全检查嵌入 shell 本身——你敲的每一个命令都要先经过一次安检才能执行。它的核心保证来自一份钩子一致性契约允许的命令恰好执行一次不吞、不重被阻断的命令绝不执行降级必须可见绝不静默失效⚠️ 上图为项目封面占位说明——tirith 官方只有一个封面图下文不再重复引用。二、一键安装tirith.sh 加载器入口非常简洁一个统一的加载器 shell/tirith.sh 会探测当前 shell 类型通过ZSH_VERSION、BASH_VERSION、FISH_VERSION环境变量然后自动 source 对应的钩子文件Shell钩子文件拦截方式zshshell/lib/zsh-hook.zsh重写 ZLEaccept-linewidgetbashshell/lib/bash-hook.bash绑定 Enter 键 / DEBUG trap 双模式fishshell/lib/fish-hook.fish绑定 Enter 绑定安装后在提示符中还能看到TIRITH_STATUS变量实时展示保护等级blocks/degraded/off详细配置见 docs/prompt-status.md。三、zsh 钩子劫持 accept-line 的精髓zsh 的实现堪称教科书级别。钩子文件 shell/lib/zsh-hook.zsh 做了三件关键的事1. 保存并替换 accept-line widget。你按回车的动作在 zsh 里对应accept-linewidgettirith 先把它备份为_tirith_original_accept_line再装上一个检查函数_tirith_accept_line输入命令 → 备份缓冲区 → 调用 tirith check → 根据退出码决定放行/阻断/请求批准2. 执行回执协议Protocol v3。这是最值得称道的设计检查通过后tirith 会签发一个 64 位十六进制的一次性令牌receipt token并与父进程 PID 绑定。命令交付前再校验一次缓冲区没被篡改——防止检查的是 A 命令、执行的却是 B 命令。令牌走完Prepared → Armed → Consuming → Committed生命周期后即作废重放、命令漂移、过期都会被拒绝。3. 粘贴内容同样受检。钩子还重写了bracketed-pastewidget把粘贴进编辑区的内容送入tirith paste分析——AI 提示注入里常见的看起来无害的粘贴命令也逃不过。退出码语义清晰0放行1阻断2警告但放行3严格警告需确认。四、bash 钩子enter 与 preexec 双模式bash 没有 zsh 那么优雅的 widget 机制shell/lib/bash-hook.bash 因此提供了两种模式enter 模式默认SSH 环境除外用bind -x把回车绑定到一个检查函数能真正阻断命令并拦截粘贴。preexec 模式基于 DEBUG trap 的告警模式只能警告不能阻断。这里的工程细节很有故事性早期 enter 模式直接绑定bind -x会导致命令被吞掉检查函数跑完但行永不被接受。0.4.1 版本改用readline 宏方案——回车触发检查函数后再执行一个受保护的 accept-line 子序列只有检查器明确放行时才会接受行外部注入的回车字节无法绕过检查器直接执行命令。更妙的是能力门控tirith setup/tirith doctor会启动一个一次性 PTY 自检验证允许的命令恰好交付一次 危险命令确实被拦把结论缓存到state-dir/bash-enter-capability。钩子启动时只需读这个几十字节的缓存文件一次小文件读取完全 init 安全据此自动选择 enter 或回退到 preexec——用能力探测代替版本号猜测。五、fish 钩子Enter 绑定 同样的回执协议shell/lib/fish-hook.fish 结构与 zsh 版本同构绑定 Enter 事件检查命令并支持粘贴拦截。三个 shell 钩子共享同一套安全设计语言可执行文件钉死pinsource 时立即解析 tirith 的绝对路径此后任意命令改写PATH都无法劫持钩子️辅助命令同样钉死mktemp、rm、wc等都被解析为绝对路径并校验可执行性忽略别名与函数私有捕获文件与 tirith 子进程的全部交互通过umask 077的临时文件完成敏感数据不经过 argv防重入 防继承双 source 守卫检测_TIRITH_*_LOADED是否被恶意 export攻击者从父进程注入的状态一律视为无效六、毫秒级性能优化揭秘数字说话拦截最怕拖慢日常操作。tirith 的答案是给每个热路径都写上硬性性能预算并在 CI 中强制执行——预算表 crates/tirith-core/benches/budgets.txt 值得每个做性能工程的团队学习tier1_no_match 2000 ns # 实测 314 ns full_analysis_clean_command 5000000 ns # 实测 936 μsp95 契约 5 ms byte_scan_hostile_64k 5000000 ns # 64KiB 恶意控制字符最坏情况预算文件头部的注释解释了一个经典陷阱单纯的环比 115% 告警回答不了够不够快——连续 8 次 14% 的退化会让总延迟翻倍到 2.9 倍却永远不触发告警。所以 tirith 同时使用绝对天花板抓数量级回归 相对告警抓 15% 漂移人工评审且任何新热路径必须带着预算进场不允许无预算混入。分层扫描也是关键先跑极轻量的 Tier-1 字节扫描10 个样本约 31 纳秒/条命中才升级为完整分析。完整分析 p95 契约 5 毫秒、p50 目标 3 毫秒大头花在向上遍历到仓库根做策略发现上——这也是为什么full_analysis_web3_with_cwd单独列出了预算否则祖先目录遍历的性能回归在所有测试里都不可见。提示符侧的 prompt-status 命令同样克制冷缓存约 10 毫秒热缓存30 秒 TTL亚毫秒级读一个 JSON 文件加二进制启动开销目标是可提示延迟不增大。七、钩子守护的威胁面一览威胁类型典型例子拦截点pipe-to-shellcurl xxx \| bash命令预检同形异义 URL西里尔字母伪装域名同形字符检测ANSI 注入终端转义序列偷改命令字节扫描混淆载荷base64/十六进制编码执行反混淆 完整分析数据外泄把~/.ssh发到陌生端点敏感资产识别恶意 AI 技能/配置MCP 配置投毒配置文件规则规则与解释的完整清单见 crates/tirith-core/src/rules/人类可读说明在 crates/tirith-core/assets/data/rule_explanations.toml。八、质量如何保证Rust 原生 PTY 测试台钩子代码最忌看着对用起来错。tirith 用 Rust 写的PTY 测试驱动 拉起一个一次性真实 shell完全隔离的 HOME/XDG 环境直接发送按键字节断言一致性契约的每一条不变量。判定恰好执行一次的真相来源不是嘈杂的终端回显而是命令往标记文件里追加的行数——文件系统副作用比终端文本可靠得多。完整覆盖矩阵见 docs/shell-hook-conformance.md。九、快速上手如果你想在本地体验完整能力从仓库克隆后即可安装钩子仓库地址https://gitcode.com/gh_mirrors/tir/tirith克隆并构建 tirith运行tirith init把输出 eval 进当前 shell或写进 rc 文件检查$TIRITH_STATUS是否为blocks用tirith doctor自检钩子健康状态日常调参建议想确认 enter 模式自检结论tirith doctor --simulate-enter想临时降级为只告警设置TIRITH_BASH_MODEpreexec提示符集成Starship 等参考 docs/prompt-status.md结语tirith 的 shell 钩子系统展示了终端安全的一个成熟范式用 widget/键绑定把检查嵌入命令生命周期、用一次性回执令牌防篡改、用能力探测代替版本猜测、用可强制执行的预算表守住毫秒级延迟。对新手而言安装只需一行tirith init对工程师而言shell/lib/ 下三个钩子文件 一致性契约文档 性能预算表是一份值得反复研读的钩子工程教材。【免费下载链接】tirithTerminal security for developers and AI agents. Intercepts homograph URLs, pipe-to-shell, ANSI injection, obfuscated payloads, data exfiltration, and malicious AI skills/configs before they execute.项目地址: https://gitcode.com/gh_mirrors/tir/tirith创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 tirith shell钩子深度指南：zsh/bash/fish命令拦截机制与毫秒级性能优化揭秘
tirith shell钩子深度指南zsh/bash/fish命令拦截机制与毫秒级性能优化揭秘【免费下载链接】tirithTerminal security for developers and AI agents. Intercepts homograph URLs, pipe-to-shell, ANSI injection, obfuscated payloads, data exfiltration, and malicious AI skills/configs before they execute.项目地址: https://gitcode.com/gh_mirrors/tir/tirithtirith是一款面向开发者和 AI Agent 的终端安全工具它的 shell 钩子shell hook机制能在你按下回车键的那一刻拦截危险命令——同形异义 URL、pipe-to-shell、ANSI 转义注入、混淆载荷等威胁都赶在执行之前被识别和阻断。本文带你深入 zsh、bash、fish 三种 shell 的拦截实现原理并揭秘它如何将检查延迟压缩到毫秒级的设计细节。一、tirith shell钩子是什么为什么需要它传统终端防护依赖用户眼明手快但复制粘贴一条curl ... | bash或从 AI 工具里粘贴一段带隐藏 ANSI 序列的命令肉眼几乎无法识别。tirith 的思路是把安全检查嵌入 shell 本身——你敲的每一个命令都要先经过一次安检才能执行。它的核心保证来自一份钩子一致性契约允许的命令恰好执行一次不吞、不重被阻断的命令绝不执行降级必须可见绝不静默失效⚠️ 上图为项目封面占位说明——tirith 官方只有一个封面图下文不再重复引用。二、一键安装tirith.sh 加载器入口非常简洁一个统一的加载器 shell/tirith.sh 会探测当前 shell 类型通过ZSH_VERSION、BASH_VERSION、FISH_VERSION环境变量然后自动 source 对应的钩子文件Shell钩子文件拦截方式zshshell/lib/zsh-hook.zsh重写 ZLEaccept-linewidgetbashshell/lib/bash-hook.bash绑定 Enter 键 / DEBUG trap 双模式fishshell/lib/fish-hook.fish绑定 Enter 绑定安装后在提示符中还能看到TIRITH_STATUS变量实时展示保护等级blocks/degraded/off详细配置见 docs/prompt-status.md。三、zsh 钩子劫持 accept-line 的精髓zsh 的实现堪称教科书级别。钩子文件 shell/lib/zsh-hook.zsh 做了三件关键的事1. 保存并替换 accept-line widget。你按回车的动作在 zsh 里对应accept-linewidgettirith 先把它备份为_tirith_original_accept_line再装上一个检查函数_tirith_accept_line输入命令 → 备份缓冲区 → 调用 tirith check → 根据退出码决定放行/阻断/请求批准2. 执行回执协议Protocol v3。这是最值得称道的设计检查通过后tirith 会签发一个 64 位十六进制的一次性令牌receipt token并与父进程 PID 绑定。命令交付前再校验一次缓冲区没被篡改——防止检查的是 A 命令、执行的却是 B 命令。令牌走完Prepared → Armed → Consuming → Committed生命周期后即作废重放、命令漂移、过期都会被拒绝。3. 粘贴内容同样受检。钩子还重写了bracketed-pastewidget把粘贴进编辑区的内容送入tirith paste分析——AI 提示注入里常见的看起来无害的粘贴命令也逃不过。退出码语义清晰0放行1阻断2警告但放行3严格警告需确认。四、bash 钩子enter 与 preexec 双模式bash 没有 zsh 那么优雅的 widget 机制shell/lib/bash-hook.bash 因此提供了两种模式enter 模式默认SSH 环境除外用bind -x把回车绑定到一个检查函数能真正阻断命令并拦截粘贴。preexec 模式基于 DEBUG trap 的告警模式只能警告不能阻断。这里的工程细节很有故事性早期 enter 模式直接绑定bind -x会导致命令被吞掉检查函数跑完但行永不被接受。0.4.1 版本改用readline 宏方案——回车触发检查函数后再执行一个受保护的 accept-line 子序列只有检查器明确放行时才会接受行外部注入的回车字节无法绕过检查器直接执行命令。更妙的是能力门控tirith setup/tirith doctor会启动一个一次性 PTY 自检验证允许的命令恰好交付一次 危险命令确实被拦把结论缓存到state-dir/bash-enter-capability。钩子启动时只需读这个几十字节的缓存文件一次小文件读取完全 init 安全据此自动选择 enter 或回退到 preexec——用能力探测代替版本号猜测。五、fish 钩子Enter 绑定 同样的回执协议shell/lib/fish-hook.fish 结构与 zsh 版本同构绑定 Enter 事件检查命令并支持粘贴拦截。三个 shell 钩子共享同一套安全设计语言可执行文件钉死pinsource 时立即解析 tirith 的绝对路径此后任意命令改写PATH都无法劫持钩子️辅助命令同样钉死mktemp、rm、wc等都被解析为绝对路径并校验可执行性忽略别名与函数私有捕获文件与 tirith 子进程的全部交互通过umask 077的临时文件完成敏感数据不经过 argv防重入 防继承双 source 守卫检测_TIRITH_*_LOADED是否被恶意 export攻击者从父进程注入的状态一律视为无效六、毫秒级性能优化揭秘数字说话拦截最怕拖慢日常操作。tirith 的答案是给每个热路径都写上硬性性能预算并在 CI 中强制执行——预算表 crates/tirith-core/benches/budgets.txt 值得每个做性能工程的团队学习tier1_no_match 2000 ns # 实测 314 ns full_analysis_clean_command 5000000 ns # 实测 936 μsp95 契约 5 ms byte_scan_hostile_64k 5000000 ns # 64KiB 恶意控制字符最坏情况预算文件头部的注释解释了一个经典陷阱单纯的环比 115% 告警回答不了够不够快——连续 8 次 14% 的退化会让总延迟翻倍到 2.9 倍却永远不触发告警。所以 tirith 同时使用绝对天花板抓数量级回归 相对告警抓 15% 漂移人工评审且任何新热路径必须带着预算进场不允许无预算混入。分层扫描也是关键先跑极轻量的 Tier-1 字节扫描10 个样本约 31 纳秒/条命中才升级为完整分析。完整分析 p95 契约 5 毫秒、p50 目标 3 毫秒大头花在向上遍历到仓库根做策略发现上——这也是为什么full_analysis_web3_with_cwd单独列出了预算否则祖先目录遍历的性能回归在所有测试里都不可见。提示符侧的 prompt-status 命令同样克制冷缓存约 10 毫秒热缓存30 秒 TTL亚毫秒级读一个 JSON 文件加二进制启动开销目标是可提示延迟不增大。七、钩子守护的威胁面一览威胁类型典型例子拦截点pipe-to-shellcurl xxx \| bash命令预检同形异义 URL西里尔字母伪装域名同形字符检测ANSI 注入终端转义序列偷改命令字节扫描混淆载荷base64/十六进制编码执行反混淆 完整分析数据外泄把~/.ssh发到陌生端点敏感资产识别恶意 AI 技能/配置MCP 配置投毒配置文件规则规则与解释的完整清单见 crates/tirith-core/src/rules/人类可读说明在 crates/tirith-core/assets/data/rule_explanations.toml。八、质量如何保证Rust 原生 PTY 测试台钩子代码最忌看着对用起来错。tirith 用 Rust 写的PTY 测试驱动 拉起一个一次性真实 shell完全隔离的 HOME/XDG 环境直接发送按键字节断言一致性契约的每一条不变量。判定恰好执行一次的真相来源不是嘈杂的终端回显而是命令往标记文件里追加的行数——文件系统副作用比终端文本可靠得多。完整覆盖矩阵见 docs/shell-hook-conformance.md。九、快速上手如果你想在本地体验完整能力从仓库克隆后即可安装钩子仓库地址https://gitcode.com/gh_mirrors/tir/tirith克隆并构建 tirith运行tirith init把输出 eval 进当前 shell或写进 rc 文件检查$TIRITH_STATUS是否为blocks用tirith doctor自检钩子健康状态日常调参建议想确认 enter 模式自检结论tirith doctor --simulate-enter想临时降级为只告警设置TIRITH_BASH_MODEpreexec提示符集成Starship 等参考 docs/prompt-status.md结语tirith 的 shell 钩子系统展示了终端安全的一个成熟范式用 widget/键绑定把检查嵌入命令生命周期、用一次性回执令牌防篡改、用能力探测代替版本猜测、用可强制执行的预算表守住毫秒级延迟。对新手而言安装只需一行tirith init对工程师而言shell/lib/ 下三个钩子文件 一致性契约文档 性能预算表是一份值得反复研读的钩子工程教材。【免费下载链接】tirithTerminal security for developers and AI agents. Intercepts homograph URLs, pipe-to-shell, ANSI injection, obfuscated payloads, data exfiltration, and malicious AI skills/configs before they execute.项目地址: https://gitcode.com/gh_mirrors/tir/tirith创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考