trace-source

name	trace-source
description	溯源镜 / TraceLens — 给一个消息链接或一段内容,做联网深度溯源:提炼核心论断、全网检索、按时间线还原"谁最早发的、谁在转",判定有没有可信一手来源、检测"语义漂移",最后产出一份可本地保存的精美 HTML 报告(不在终端堆分析)。Use when the user pastes a news/social link or a claim/message/小作文 and asks to 溯源 / 核查 / 验证真伪 / 查出处 / 看是不是假消息 / 看怎么传出来的, or to trace a rumor, fact-check a story, or find its original source.
license	MIT. See LICENSE.
compatibility	Runs inside an agent that has web search + web fetch tools (e.g. Claude Code). Rendering the report needs only python3 (standard library, no extra dependencies).
argument-hint	<消息链接 或 一段内容>

溯源镜 TraceLens

把一个消息链接 / 一段内容,变成一份带传播时间线 + 一手来源判定的 HTML 溯源报告。

核心不是"让 AI 拍脑袋判真假打分",而是两个难造假的诚实信号:

1. 能不能追到一个可信的一手来源(官方公告 / 监管文件 / 当事人原话 / 原始数据)。追不到 = 高度可疑。
2. 措辞有没有语义漂移(事实可能为真,但被带了节奏,如"发债"被说成"缺钱融资")。

本工具仅基于公开、可被搜索引擎索引的网络来源,不覆盖微信公众号 / 抖音 / 微博等封闭平台,不构成投资或法律建议。仅用于对抗假消息与"小作文"的事实核查,不得用于构陷、骚扰或规避平台规则。

何时用

用户给出一个链接(新闻 / 社媒)或一段文字(传闻 / 小作文 / 群聊转发),想知道:这是真的吗?最早从哪来的?谁在转?有没有出处?怎么传开的?

工作流 Default Workflow

定位 skill 目录:优先环境变量 $TRACE_SOURCE_SKILL_DIR,否则用本 SKILL.md 所在目录。下称 <DIR>。

1. 归一化输入 + 提炼论断

   • 若是 URL:用 web fetch 抓正文,提炼它主张的那条可核查论断(浓缩成一句话),并记录原始措辞。
   • 若是文字:直接作为论断。
   • 拆出关键实体 / 数字 / 时间 / 地点,作为检索锚点。

2. 联网深度检索(方法详见 <DIR>/references/research-method.md)

   • 多角度 web search:中英文都打;围绕"实体 + 事件"、不同措辞、以及"传闻 / 辟谣 / 官方 / 原文"等组合。
   • 对最关键的几条用 web fetch 进正文,拿三样东西:发布时间、它引用谁(原创 / 编译 / 转载)、有没有指向一手来源。
   • 目标:尽量逼近"可索引范围内最早的一条",并确认有没有一手来源。

3. 形成判断,写 findings JSON(字段契约见 <DIR>/references/schema.md)

   • 裁决档 verdict.tier:true / mostly_true / mixed / unverified / likely_false / no_source。
   • 一手来源找到与否是真消息与小作文的分水岭,务必如实填 facts。
   • 检测语义漂移:若事实大体为真但措辞误导,填 semantic_drift。
   • 时间线节点分类:primary / first / compile / forward / update / alert。
   • 诚实写 limits:这次没覆盖到什么(社交平台盲区、源头是推断、抓取被 403 等)。

4. 渲染报告

   cd "<工作目录>"            # 报告默认落在 ./reports/ 下
   python3 "<DIR>/scripts/render_report.py" findings.json --out reports/<名字>.html
   

   也可从 stdin 传 JSON:python3 "<DIR>/scripts/render_report.py" - < findings.json。 脚本默认会在浏览器打开报告;不想自动打开就加 --no-open。脚本会打印报告的绝对路径。

输出规则 Output Rules

• 不要在终端 / 对话里堆叠完整分析。 产出 HTML 文件,把路径告诉用户并打开它。
• 在对话里只回一句话结论:裁决档 + 一手来源有无 + 有没有语义漂移。
• 一手来源没找到时,明确说"追不到可信一手源,高度可疑",不要替它圆场。
• 不确定就标不确定;宁可 unverified 也不要假装 true。给假消息盖"已证实"章是危险的。
• 不杜撰来源、时间、链接。findings 里每个时间线节点都必须来自真实检索结果。

失败处理 Failure Handling

• 搜索 / 抓取被墙或返回 403:在 limits 里如实记录,不要把"没搜到"当成"是假的"。
• 内容为中文社交平台(公众号 / 抖音 / 微博)独有:说明这是当前盲区,只能就可索引部分溯源。
• python3 缺失:渲染只需标准库,确认 python3 --version 即可,无需安装依赖。

配置 Configuration

• TRACE_SOURCE_SKILL_DIR:skill 安装目录(可选)。
• 报告输出目录:默认当前工作目录下的 reports/,可用 --out 覆盖。

Reference Map

• references/research-method.md:溯源方法论——检索策略、一手来源判定、语义漂移、节点分类、诚实置信度档。
• references/schema.md:findings JSON 字段契约 + 内联标记(**粗体**、[[+正确框架]]、[[-误导框架]])。
• templates/report.html.tpl:报告 HTML 模板(占位符 + 纯字符串替换,零依赖)。
• scripts/render_report.py:渲染器(JSON → HTML)。
• examples/nvidia-bond.json / examples/nvidia-bond.html:完整样例(英伟达发债溯源)。