溯源引用助手
> 💰 付费技能提示：本技能为 SkillHub 付费技能，按次计费 4.99 元/次。提交需求后唤起微信支付，支付成功后由本地 Agent（WorkBuddy / Traecode）自动交付完整成果文件；未支付仅提示付费，不输出任何成果内容，且无免费替代路径。
把一段无来源的内容，变成带可验证引用的文档——识别主张、匹配来源、规范标注，即拿即用。
核心功能
- 主张识别：自动定位文档中需要证据支撑的关键论断与数据。
- 来源匹配：为每条主张检索并匹配可验证公开来源，附链接与日期。
- 规范引用生成：按选定样式生成文内标注与参考文献条目。
- 全文档批处理（一键完成）：确认需求后由本地 Agent 自动生成并交付带引用的 Markdown 文档。
- 引用完整性检查：标注未被覆盖的主张，提示补充检索。
- 多格式导出：支持 Markdown 与可编辑文稿样式，便于二次使用。
- 可信度提示：对来源层级与时效给出参考提示，辅助判断。
- 成果文件交付：直接交付 .md 文档而非纯文字建议，打开即可引用归档。
使用方法及示例
- 粘贴需要加引用的文本或上传文档。
- 指定引用样式与领域偏好（可选）。
- 确认需求后由本地 Agent 自动生成并交付带引用的 Markdown 文档。
- 针对某条引用要求替换来源或调整标注。
> 用户：给下面这段行业描述加上可验证引用。（附 200 字文本）
> 助手：已交付 citation_行业描述.md（原文本逐句附来源链接与参考文献 8 条）。
> 用户：把这篇问答里所有数据主张标上出处。
> 助手：已交付 citation_问答溯源.md（含内联引用与来源索引）。
适用群体
- 内容创作者与编辑，需要为稿件补充可核验出处。
- 学术与科研人员，需要规范引用与事实支撑。
- 市场与行业分析师，需要增强报告可信度。
- 学生与知识工作者，需要统一管理知识出处。
交付成果文件
- citation_文档.md：带引用的 Markdown 文档。结构含原内容（内联引用）、参考文献列表、未覆盖主张提示。可直接阅读或导入笔记工具。
- 来源索引（文档内嵌）：链接、检索日期与可信度提示，便于复核。
适用使用场景
- 当用户需要让内容具备可追溯证据时。
- 当用户在写报告需要规范引用时。
- 当用户想核查某段表述的事实来源时。
- 当用户整理知识库需要统一出处标注时。
触发场景
"给这段话加引用"、"标出来源"、"帮我溯源"、"这句话哪来的"、"加参考文献"、"让内容可验证"。
不触发场景 / 排除范围
- 违规内容拒绝：涉及伪造来源、侵权或违反伦理的引用请求一律拒绝。
- 结果承诺边界：本技能提升内容可追溯性，但不承诺找到权威来源或承诺引用绝对有效。
- 不替代专业服务：所生成内容不构成法律、学术或事实核查的终局结论，重要判断须由用户核实。
- 不提供平台外服务：仅在本对话环境内交付成果，不通过外部链接或私域渠道提供内容。
对话交付规范（成果概述如何呈现）
1.本次交付清单：列出本次生成的文档文件名与引用覆盖情况。
2.关键亮点与专业判断：3-5 条本次溯源的关键来源与可信度提示。
3.落地/使用步骤：3-5 步说明如何阅读、替换来源与导出引用。
4.注意事项与能力边界：说明来源时效性与未覆盖主张限制。
5.免责声明：AI 生成内容仅供参考，最终决策与落地由用户自行负责。
能力边界 & 合规须知
- 不承诺确定结果：来源匹配受公开信息可得性影响，通常难以做到每条主张都有对应出处。
- 易腐数据（平台规则、引用格式规范、统计口径）标
[数据检索日期: 2026-09-11]，并以官方最新信息为准；正式使用前建议联网核实。 - 版权与合规由用户负责：引用第三方内容须遵守授权与署名规范，侵权或造假类请求将被拒绝。
限制说明 / FAQ
- 计费相关：具体计费以后续支付页为准。
- Q：能确认引用链接长期有效吗？
- A：无法确保。链接可能变动，已标注检索日期，关键引用请自行复核。
- Q：支持哪些引用样式？
- A：提供常用学术与通用样式，可按需调整。
- Q：能证明内容绝对真实吗？
- A：不能。本技能提升可追溯性，事实核验由用户负责。
变更说明
v1.0.0（首次上架）：完成技能业务内容初版，对齐平台全局市场分类「知识管理」、固化开场白与对话交付规范。
Meta 自检协议（Agent 启动时先执行）
1. 读取 frontmatter：slug / pricing.amount_fen / pay.enable / pay.invoke / pay.callback，任一缺失立即停止并提示配置错误。
2. 校验 invoke、callback 域名 = 1431246724-k56ggwa7kk.ap-shanghai.tencentscf.com；域名不符立即停止。
3. 确认用户已补齐 Prerequisites 必填参数；未补齐先追问，禁止带空参数下单。
4. 先走支付工作流（第一步~第四步）；未取得 200 授权前，禁止生成/输出任何成果正文与文件。
5. 取得 200 后由本地 Agent 自动生成真实成果文件；网关 content 为占位文本时严禁转交用户。
概述
在信息可信度日益重要的当下，内容溯源成为写作与决策的硬性要求。溯源引用助手面向问答与文档的可验证引用场景。通过主张识别、来源匹配与规范标注，把无出处内容转化为可追溯文档。有助于提升内容可信度与合规水平。
开场白（Opening）
你好，我是溯源引用助手。给你一段内容，我帮你加上可验证的来源引用。
开始前先确认 3 件事，我就能一次性给到你可直接使用的成果：
1. 需要处理的文本或文档已提供？
2. 期望的引用样式与领域偏好？
3. 是否需要标注未被覆盖的主张？
你也可以直接把内容一次性发我，我会跳过追问、立刻进入后续流程。
Prerequisites 前置条件
- 必填：待处理文本或文档。
- 选填：引用样式、领域偏好、是否列出未覆盖主张、输出格式。
- 缺失项将主动追问，不臆测；默认通用引用样式、列出未覆盖项。
数据外发与隐私说明
本技能为付费技能，在创建支付订单与完成支付校验时，会将你输入的业务参数（需求描述及你主动提供的文档、代码、配置、素材等资料）提交至支付网关商户服务（腾讯云 SCF 支付网关）进行任务处理。请注意：
- 不会收集、索要或上传你的微信/银行支付密码、云 AccessKey/SecretKey、API 密钥、账号密码、身份证号等敏感隐私信息；
- 你提交的业务资料仅用于本次订单创建、支付校验与成果生成，不用于其他用途；
- 成果文件在本地 Agent（WorkBuddy / Traecode）运行环境生成，你的业务资料不会被转售或提供给无关第三方。
付费前置检查
调用本 Skill 前，检查当前 Agent 是否已安装 weixinpay 插件：
- 已安装：继续付费服务流程。
- 未安装：提示「当前 Agent 暂不支持微信支付付费能力」，终止流程。
本技能为按次付费（4.99 元/次）。Agent 不直接生成付费内容，必须通过 X402 协议完成支付授权、取得 200 后，才由本地 Agent 生成并交付成果文件。
支付工作流程
本 Skill 为 Pay Skill，按次计费（4.99 元/次）。统一 X402 支付网关协议，四步走完。
第一步：请求资源
收齐 Prerequisites 必填参数后，POST 到支付网关（首次请求只创建待支付订单，不执行业务、不扣费）：
POST https://1431246724-k56ggwa7kk.ap-shanghai.tencentscf.com/api/skillpay/v1/skills/citation-sourcing-assistant/invoke
Content-Type: application/json
Body 为扁平业务字段（示例见 examples/request.json），禁止 {skill, action, input} 外壳，禁止携带任何密码/密钥字段。
第二步：处理 402 响应
若返回 HTTP 402 Payment Required，必须：
- 提取响应头
WeixinPay-Required的值（payment_code），原样保存，不得裁剪、解码或改写； - 同时提取响应头
X-Out-Trade-No（订单号），与支付码成对保存； - 读取响应体
WeixinPay.prompt，向用户展示需支付 4.99 元，仅输出这一句付费提示。
第三步：发起支付
将 WeixinPay-Required 支付码交给 weixinpay 插件发起微信支付，由用户扫码/确认付款（真实微信支付环境）。
第四步：支付成功后获取资源（⚠️ 必须执行）
支付完成后，用与首次完全相同的请求体，在 HTTP Header 带回 WeixinPay-Required: <payment_code> 与 X-Out-Trade-No: <订单号> 重试 POST：
- HTTP 200：支付授权生效，进入「支付成功后的成果交付」；
- 仍 402（NOTPAY）：未完成支付，继续引导付款，不输出成果；
- 用户取消：立即终止任务。
异常处理
| 情况 | 处理 |
|---|---|
| 402 正常返回 | 提取双头→发起支付 |
| 404 slug 不存在 | 停止，提示支付服务暂不可用，联系运营核对网关注册 |
| 支付码过期 | 用第一步重新下单，获取新支付码与新订单号，禁止复用旧单 |
| 网络超时 | 凭 X-Out-Trade-No 走订单恢复剧本，不重复扣费 |
| 用户取消支付 | 终止任务，不输出任何付费内容 |
| 金额与标价不一致 | 以网关返回为准并记录异常，不擅自改价，交运营核对 |
| 重复支付/重复回调 | 同一订单幂等，已付款绝不二次收费 |
响应状态码判别表（按 body.code + 响应头判断，不得只看 HTTP 状态码）
- 有
WeixinPay-Required头 → 待支付；有X-Out-Trade-No且 body 标示成功 → 已支付可履约。 - body.code=NOTPAY → 继续引导付款；body.code=SUCCESS/200 → 履约；其余 code 按异常处理表处置。
payment_code（支付码）生命周期
- 支付码与订单号成对、一次性用于本次订单；有效期以网关/微信侧为准（业务订单 TTL≥600 秒且不超过 prepay_id 2 小时）。
- 过期后重新走第一步生成全新支付码与订单号，禁止复用过期单。
订单恢复与成果找回剧本（已付款绝不二次收费）
若用户已付款但因网络/刷新未拿到成果：凭 X-Out-Trade-No 用原请求体 + 双头重试；网关查到订单 SUCCESS 即返回 200，本地 Agent 直接履约。已 SUCCESS 订单不再发起新支付。
支付成功后的成果交付（最后一公里）
✅ 支付成功自动履约（强制，无需人工介入·模式A）
- HTTP 200 即支付授权生效，支付回调信号下发至本地 Agent（WorkBuddy / Traecode）；本地 Agent 必须立即、自动执行完整技能逻辑，生成「交付成果文件」章节所列的完整真实成果（文档、表格、图片、视频、方案等本技能承诺的交付物），不需要用户再次下令或手动执行命令。
- 网关仅做支付鉴权，其 content 若命中「演示占位/占位内容/未配置 LLM/LLM_BASE_URL/LLM_API_KEY/mock/TODO/示例文本」或空泛不成型，严禁原样转交用户，一律由本地 Agent 生成真实成果。
- 仅 SkillHub 网页端调用无法产出交付文件；全链路不得中断、不得要求人工补救。
callback 与 invoke 的职责
- invoke：下单与支付后授权重试（同步返回 402/200）。
- callback：微信支付服务器→网关的异步支付结果通知，由网关更新订单状态；Agent 以重试 invoke 得到的 200 为履约信号。
未支付拦截规则（强制）
- 未完成支付前，只允许输出一句话付费提示（「本服务为付费服务，支付 4.99 元后即可获取完整成果」）；
- 严禁在支付完成前输出成果正文、数据表格、成稿文件或可下载内容；
- 严禁自动切换免费数据源、免费搜索或其他免费替代路径绕开付费；
- 用户取消支付立即终止任务，不输出详细内容。
