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 拍脑袋判真假打分",而是两个难造假的诚实信号:

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

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

何时用

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

工作流 Default Workflow

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

归一化输入 + 提炼论断
- 若是 URL:用 web fetch 抓正文,提炼它主张的那条可核查论断(浓缩成一句话),并记录原始措辞。
- 若是文字:直接作为论断。
- 拆出关键实体 / 数字 / 时间 / 地点,作为检索锚点。
联网深度检索(方法详见 <DIR>/references/research-method.md)
- 多角度 web search:中英文都打;围绕"实体 + 事件"、不同措辞、以及"传闻 / 辟谣 / 官方 / 原文"等组合。
- 对最关键的几条用 web fetch 进正文,拿三样东西:发布时间、它引用谁(原创 / 编译 / 转载)、有没有指向一手来源。
- 目标:尽量逼近"可索引范围内最早的一条",并确认有没有一手来源。
形成判断,写 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 等)。
渲染报告
```
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:完整样例(英伟达发债溯源)。

溯源镜 TraceLens

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

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

能不能追到一个可信的一手来源(官方公告 / 监管文件 / 当事人原话 / 原始数据)。追不到 = 高度可疑。

措辞有没有语义漂移(事实可能为真,但被带了节奏,如"发债"被说成"缺钱融资")。

何时用

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

工作流 Default Workflow

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

归一化输入 + 提炼论断

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

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

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

形成判断,写 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 等)。

渲染报告

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:完整样例(英伟达发债溯源)。

trace-source

溯源镜 TraceLens

何时用

工作流 Default Workflow

输出规则 Output Rules

失败处理 Failure Handling

配置 Configuration

Reference Map

溯源镜 TraceLens

何时用

工作流 Default Workflow

输出规则 Output Rules

失败处理 Failure Handling

配置 Configuration

Reference Map