踪迹

人工智能 社区

技能解读

当前原文的自动摘译,尚未人工审校。

何时使用

映射从用户输入到敏感功能的调用路径 查找审计优先级的复杂性热点 识别攻击面和入口点 了解不熟悉的代码库中的调用关系 跨多语言项目的安全审查或审计准备

何时不使用

调用图不添加任何值的单文件脚本(直接读取文件) 不是从代码派生的架构图(使用diagramming-code技能或手工绘制) 突变测试分类(使用基因毒性技能,在内部调用 Trailmark) 运行时行为分析(Trailmark 是静态的,而不是动态的)

拒绝的理由

合理化 · 错误的原因 · 所需的操作 “我将手动读取源文件” · 手动读取会错过调用路径、爆炸半径和污点数据 · 安装跟踪标记并使用 API “快速查询不需要预分析” · 爆炸半径、污点和权限数据仅在 preanalysis() 之后才可用 · 在移交给其他技能之前始终运行 engine.preanalysis() “图表太大,我将采样” · 采样遗漏了跨模块攻击路径 · 构建完整的图;使用子图查询来聚焦

安装

强制:如果未找到 trailmark,请在执行其他操作之前安装 CLI:工具安装仅提供 CLI — 它不会使 import trailmark 可解析。使用uv run --with trailmark python -运行本技能中的Python片段;这是对代码片段中导入错误或 ModuleNotFoundError 的修复,而不是安装。不要退回到“手动验证”、“手动分析”或阅读

版本门

Trailmark 0.4.0 扩展了图形模型和查询面,0.5.0 添加了 SQL 解析器、存储库链接配置和更丰富的入口点元数据。在使用 v0.4+ 或 v0.5+ 列出的功能之前,请检查已安装的版本:按数字(而非词汇)比较报告的版本。 0.4.0或更新版本

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
人工智能
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@trailofbits · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
macOS · Linux · Windows
运行环境要求
Node.js · Python
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
网络行为
允许外网请求
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

输出预览 trailmark.preview
# Auto-detect and merge every supported language under the tree
uv run trailmark analyze --language auto --summary {targetDir}

# Explicit languages (single language or comma-separated list)
uv run trailmark analyze --language rust {targetDir}
uv run trailmark analyze --language python,rust {targetDir}

# Complexity hotspots
uv run trailmark analyze --language auto --complexity 10 {targetDir}

# Entrypoint inventory and structural diff (v0.2-safe)
uv run trailmark entrypoints --language auto {targetDir}
uv run trailmark diff --language auto --repo {repoDir} main HEAD --json

# Version report (0.2.2+)
uv run trailmark --version

# v0.4+: native diagram command
uv run trailmark diagram -t {targetDir} -T call-graph -f main --depth 2

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。