SuperAPI AI 工具集

tirith-config

测试与质量

查看项目

更新于 10-16 02:34

技能介绍

Tirith 是一个终端防护工具,拦截 shell 命令与粘贴内容,识别同形异义 URL(西里尔字母相似字符、混合书写系统)、ANSI 转义注入以及 curl | bash 式管道执行。该技能提供操作流程与决策逻辑,实时配置以文件为准。

结构:Shell 钩子通过 eval "$(tirith init --shell zsh)" 接入;策略文件在 ~/.config/tirith/policy.yaml 与项目级 .tirith/policy.yaml;审计日志在 ~/.local/share/tirith/log.jsonl,仅存脱敏预览;tirith run <url> 生成回执,可用 tirith receipt verify <sha256> 验证。tirith doctor 是标准健康检查。

命令被拦截时的四种应对:先运行 tirith why 看规则;对可信来源用 tirith trust last 或 tirith trust from-last-trigger;仅对反复使用的官方安装域名写入白名单 allowlist;或采用下载—阅读—执行的 curl -fsSL <url> -o /tmp/install.sh 再 sh。TIRITH=0 前缀对整条输入的命令有效,但粘贴扫描器不读取粘贴内容中的赋值,因此粘贴 TIRITH=0 curl … | sh 仍会被拦截。

降噪可用 severity_overrides 将某规则降为 LOW,而非直接关闭或加白名单。白名单仅支持精确主机名,不支持通配符与路径匹配。不要为共享 CDN 或子域预先加白名单,也不要用它压制噪音。

配置变更后应依次运行 tirith policy validate、tirith doctor、tirith policy test 验证拦截与放行两端。tirith policy validate 是唯一能发现字段拼写错误的检查,未知键会被忽略。

注意:修改 shell 配置仅对新终端生效;tirith check -- <cmd> 的 -- 必填;fail_mode 默认 open。白名单内容、当前版本、钩子状态均需运行时查询。