← 返回 Skills 市场
z1one0415

Evidence Cleaner

作者 z1one0415 · GitHub ↗ · v2.0.0 · MIT-0
cross-platform ✓ 安全检测通过
143
总下载
0
收藏
0
当前安装
3
版本数
在 OpenClaw 中安装
/install evidence-cleaner
功能描述
LLM通用证据清洗技能。将原始搜索结果、网页片段、OCR残片等原始材料清洗为可用证据,减少脏输入、伪实体、重复片段和错域材料对后续判断的污染。在搜索结果返回后、进入freshness判定或叙事生成前使用。触发条件:搜索结果质量差、证据量大但信噪比低、需要标准化证据格式。
使用说明 (SKILL.md)

Evidence Cleaner — 证据清洗技能

核心职责

将原始材料(搜索结果、网页片段、OCR残片、RSS条目等)清洗为标准化可用证据。

做什么:

  • 剥离 DOM/HTML/JS 噪声残留
  • 检测并过滤伪实体(不存在的人物、机构、事件)
  • 去重与压缩重复片段
  • 降权错域来源(二手转载、匿名来源等)
  • 将 snippet 标准化为统一格式

不做什么:

  • ❌ 不生成主叙事或最终结论
  • ❌ 不做搜索或补充信息
  • ❌ 不做时间新鲜度判定(交给 freshness-judge)
  • ❌ 不改写证据的语义内容(只做格式标准化)

最小输入

字段 类型 必需 说明
raw_evidence_items[] array 原始证据条目,每条含 source_urltitlesnippetraw_text(可选)
primary_subject string 本次任务的主体对象(用于判断相关性)
canonical_time_frame object {start, end, granularity} 时间框架,供下游 freshness-judge 使用
cleaning_goal string 清洗目标,如 "为新闻分析准备证据" / "为技术调研去噪"

输出格式

{
  "cleaned_evidence": [
    {
      "id": "ev_001",
      "source_url": "https://...",
      "title": "...",
      "cleaned_snippet": "标准化后的文本",
      "source_reliability": "A",
      "cleaning_actions": ["dom_stripped", "truncated_restored"],
      "original_index": 0
    }
  ],
  "removed_noise": [
    {
      "id": "noise_001",
      "original_snippet": "被移除的内容摘要",
      "removal_reason": "pure_advertisement",
      "noise_category": "ad"
    }
  ],
  "downranked_items": [
    {
      "id": "ev_002",
      "original_rank": 1,
      "new_rank": 15,
      "downrank_reason": "secondary_repost",
      "warning": "内容可能被篡改,建议交叉验证"
    }
  ],
  "warnings": [
    "3条证据包含疑似AI幻觉引用",
    "2条证据来源为匿名账号,建议谨慎使用"
  ],
  "cleaning_stats": {
    "total_input": 25,
    "kept": 18,
    "removed": 4,
    "downranked": 3,
    "snr_ratio": 0.72
  }
}

清洗 5 步流程

Step 1: DOM 噪声剥离

从网页抓取结果中移除非内容噪声。

  • 识别并剥离:HTML 标签残留、CSS 样式文本、JS 代码片段、Cookie 提示条文本
  • 识别并剥离:导航栏、页脚、面包屑、侧边栏、"相关推荐"、广告文案
  • 识别并剥离:阅读量/点赞数/评论数等元数据噪声
  • 检测方法:正则匹配 HTML 标签名/CSS 属性;特征词检测("推荐阅读""为您推荐""猜你喜欢")
  • 参考references/noise-patterns.md

Step 2: 伪实体检测

检测证据中引用的人物、机构、事件是否真实存在。

  • 检查人名/机构名是否为已知实体(对比上下文一致性)
  • 检查事件引用是否有时间/地点等可验证锚点
  • 标记 AI 幻觉产生的虚假引用(如引用不存在的论文/报告)
  • 标记相似名称混淆(如 "中国银行" vs "中国人民银行")
  • 检测方法:上下文交叉验证;已知实体库比对;逻辑一致性检查
  • 参考references/noise-patterns.md 伪实体模式章节

Step 2.5: 同源矛盾检测

当多条证据来自同一机构/作者/数据源,且结论相互矛盾时,标记为同源矛盾。

检测规则

  • 同一机构(如MIT)在不同时间发布的两篇研究结论方向相反
  • 同一数据源(如Gartner报告)在不同版本中数据点不一致
  • 同一作者/团队在不同媒体上发表的观点矛盾

处理方式

  • 不丢弃任何一方(双方证据均保留)
  • 在两条证据上均添加 same_source_contradiction 标记
  • warnings[] 中记录矛盾描述和来源
  • cleaning_stats 中新增 same_source_contradictions 计数

输出示例

{
  "cleaned_evidence": [
    {
      "id": "ev_003",
      "flags": ["same_source_contradiction"],
      "contradiction_note": "与ev_007同源(MIT),结论方向相反"
    }
  ],
  "warnings": [
    "同源矛盾: MIT的两项研究(ev_003 vs ev_007)结论方向相反,建议交叉验证"
  ],
  "cleaning_stats": {
    "same_source_contradictions": 1
  }
}

Step 3: 去重压缩

识别并合并重复或高度相似的证据条目。

  • 精确去重:标题和 snippet 完全相同的条目
  • 近似去重:snippet 文本相似度 > 85% 的条目(保留信息量最大的版本)
  • 压缩合并:同一事件的多条报道,合并为一条并标注来源数量
  • 转载链识别:A→B→C 转载链,只保留最早一手来源
  • 输出:去重后保留最佳版本,其他记入 removed_noise 并标注 removal_reason: "duplicate"

Step 4: 错域降权

对来源不权威或与主题不完全匹配的证据进行降权。

  • 二手转载(非原始来源):降权 1 级
  • 匿名来源 / 自媒体无认证:降权 2 级
  • 缺乏时间标注:降权 1 级
  • primary_subject 相关度 \x3C 60%:降权 2 级
  • 来源域名信誉度低(农场号/聚合号):降权 3 级或移除
  • 参考references/clean-vs-drop-rules.md

Step 5: Snippet 标准化

将保留的证据条目格式化为统一结构。

  • 去除首尾空白和多余换行
  • 修正编码问题(&&'' 等 HTML 实体)
  • 修正截断文本(检测 "..." 尾部并标注 [TRUNCATED]
  • 统一引号格式、全半角标点
  • 保留原始来源 URL 和标题不变
  • 为每条证据计算 source_reliability 评级(S/A/B/C)

决策快速参考

证据状况 处理方式
微格式错误、截断、编码问题 Clean — 保留但修正
二手转载、匿名来源、缺时间 Downrank — 保留但降权
纯广告、完全无关、纯噪声 Drop — 彻底移除
伪实体引用、AI幻觉 Drop + Warning — 移除并记录警告
高度重复 Merge — 合并保留最佳版本

完整决策树见 references/clean-vs-drop-rules.md

参考文档

安全使用建议
This skill is internally coherent for cleaning and normalizing evidence. Before installing, consider: (1) provenance: the skill author is unknown — prefer reviewing the SKILL.md and reference docs (already included) and test on non-sensitive data first; (2) data handling: any evidence you pass (including file:// paths) will be inspected and transformed — don't supply secrets or highly sensitive files unless you trust where the agent will run and whether it has network access; (3) verification sources: the skill assumes 'entity libraries' and cross-validation but doesn't declare how those are accessed — if you need offline-only processing, confirm the agent will not perform external web queries; (4) review outputs for dropped items/warnings to avoid silent removals. If you need higher assurance, ask the author for provenance of the entity lists and for an explicit policy on network/local-file access.
功能分析
Type: OpenClaw Skill Name: evidence-cleaner Version: 2.0.0 The evidence-cleaner skill is a data-preprocessing utility designed to filter and standardize raw information (search results, OCR, web snippets) for LLM use. It implements logic for removing technical noise (HTML/JS), de-duplicating content, and flagging potential AI hallucinations or "pseudo-entities." The instructions in SKILL.md and the detailed reference files (noise-patterns.md, clean-vs-drop-rules.md) are entirely consistent with its stated purpose of improving information signal-to-noise ratios, with no indicators of malicious intent, data exfiltration, or unauthorized system access.
能力评估
Purpose & Capability
Name/description (evidence cleaning) align with the inputs, outputs, and stepwise rules in SKILL.md and reference files. The required capabilities (DOM stripping, dedupe, pseudo-entity detection, downranking, snippet normalization) are coherent for this purpose and no unrelated credentials or binaries are requested.
Instruction Scope
SKILL.md stays within the stated scope (it only describes processing raw_evidence_items and producing cleaned_evidence, removed_noise, etc.). It specifies cross-validation and entity-library checks — reasonable for the task, but it does not declare where the entity database or verification sources come from (local DB vs web queries). If the agent performs web lookups or accesses local files referenced by file:// URLs, that expands runtime surface and should be made explicit to users.
Install Mechanism
Instruction-only skill with no install spec and no code files — minimal risk from installation. Nothing is downloaded or written to disk by an install step.
Credentials
No required environment variables, credentials, or config paths are declared. The processing described does not appear to require secrets. Note: entity verification and cross-checking may implicitly require network access or external APIs, but these are not requested here.
Persistence & Privilege
always:false and no self-modifying install actions. The skill can be invoked by the agent (normal), but it does not request permanent elevated presence or system-wide config changes.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install evidence-cleaner
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /evidence-cleaner 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v2.0.0
V2.0: 新增Step 2.5同源矛盾检测(same_source_contradiction)
v1.1.0
V1.1: 无代码变更,确认发布
v1.0.0
- Initial release of evidence-cleaner skill for cleaning LLM raw evidence. - Standardizes noisy search results, web snippets, and OCR fragments into usable evidence. - Removes HTML/DOM/JS noise, detects/filters pseudo-entities, deduplicates repeated segments, and downranks off-domain/low-quality sources. - Provides structured output with cleaned evidence, noise removals, downranked items, warnings, and cleaning statistics. - Designed for use before freshness judgment and narrative generation, targeting large, noisy evidence sets.
元数据
Slug evidence-cleaner
版本 2.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 3
常见问题

Evidence Cleaner 是什么?

LLM通用证据清洗技能。将原始搜索结果、网页片段、OCR残片等原始材料清洗为可用证据,减少脏输入、伪实体、重复片段和错域材料对后续判断的污染。在搜索结果返回后、进入freshness判定或叙事生成前使用。触发条件:搜索结果质量差、证据量大但信噪比低、需要标准化证据格式。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 143 次。

如何安装 Evidence Cleaner?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install evidence-cleaner」即可一键安装,无需额外配置。

Evidence Cleaner 是免费的吗?

是的,Evidence Cleaner 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Evidence Cleaner 支持哪些平台?

Evidence Cleaner 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Evidence Cleaner?

由 z1one0415(@z1one0415)开发并维护,当前版本 v2.0.0。

💬 留言讨论