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