谓词快照引擎

用谓词的机器学习排序DOM元素替换默认浏览器快照。
将提示令牌使用量减少95%，同时保留可操作元素。

为何使用此工具？

结果： 更快的LLM推理、更低的成本、更少的重试次数。

系统要求

• - Node.js 18+
• PREDICATEAPIKEY 环境变量（可选）

无API密钥： 本地基于启发式的剪枝（约减少80%令牌）
有API密钥： 基于机器学习的排序以获得更干净的输出（约减少95%令牌，更少噪声）

在 predicate.systems/keys 获取免费API密钥

安装

bash
npx clawdhub@latest install predicate-snapshot

或手动安装：

bash
git clone https://github.com/predicate-systems/predicate-snapshot-skill ~/.openclaw/skills/predicate-snapshot
cd ~/.openclaw/skills/predicate-snapshot && npm install && npm run build

配置

如需增强的机器学习排序功能，请设置您的API密钥：

bash
export PREDICATEAPIKEY=sk-...

或在 ~/.openclaw/config.yaml 中配置：

yaml
skills:
predicate-snapshot:
api_key: sk-...
# 可选：设置使用限制
maxcreditsper_session: 100

使用方法

/predicate-snapshot

捕获经过剪枝的DOM快照，优化用于LLM消费。

/predicate-snapshot [--limit=50] [--include-ordinal]

选项：

• - --limit=N - 返回的最大元素数（默认：50）
• --include-ordinal - 为列表项包含序数排名

输出格式：

ID|role|text|imp|is_primary|docYq|ord|DG|href
42|button|Add to Cart|0.95|true|320|1|cart-actions|
15|button|Buy Now|0.92|true|340|2|cart-actions|
23|link|Product Details|0.78|false|400|0||/dp/...

/predicate-act

通过谓词ID对元素执行操作。

/predicate-act [value]

示例：

bash

点击元素42

在元素15中输入

滚动到元素23

/predicate-snapshot-local

仅限本地的快照，无需机器学习重排序（免费，精度较低）。

/predicate-snapshot-local [--limit=50]

在开发时或不需要机器学习排序功能时使用此命令。

示例工作流程

1. 1. 导航到页面
2. /predicate-snapshot # 获取排序后的元素
3. /predicate-act click 42 # 点击Add to Cart（元素42）
4. /predicate-snapshot # 刷新快照
5. 验证购物车已更新

定价方案

每次快照消耗1积分。本地快照免费。

对比：使用前后

使用前（无障碍树）：

@e1 navigation Skip to main content
@e2 link Amazon
@e3 search Search Amazon
...（800+个元素）
@e742 button Add to Cart <-- 埋没在噪声中
...（更多元素）

使用后（谓词快照）：

ID|role|text|imp|is_primary|docYq|ord|DG|href
42|button|Add to Cart|0.98|true|520|1|cart-actions| <-- 排名第1
15|button|Buy Now|0.95|true|540|2|cart-actions|
23|link|See All Buying...|0.72|false|560|3|cart-actions|

支持

• - 文档：predicatesystems.ai/docs
• 问题反馈：GitHub Issues
• Discord：Predicate Community