前言¶
在 DeepSeek Harness（DSH）里做量化或加密方向的智能体，常见痛点不是「找不到数据网站」，而是引用时混用二手说法、把修订后序列当 PIT、把同域名的深层链接归因错源。口头经验与官方文档往往差一线，而 agent 循环里又很难边写边逐条核实。
下面介绍维护者 hanwang-ai 在 SkillHub「联网工具」分类下的插件 quantitativeTrading-source-reliable：把 119 条人工核定的信源打成可本地查询的注册表，并暴露两个面向模型的工具，用于查源与审计草稿中的 URL 引用。注册表与工具调用均不发起外网请求，查询快且无写副作用。
这是什么¶
quantitativeTrading-source-reliable 是面向 DSH 的独立插件（与 cs-source-reliable 无依赖关系，可单独安装）。它以数据包形式内置信源元数据：权威分级、验证状态、PIT 五态、修订风险、数据集标签等；模型通过 qt_source_find、qt_source_audit 在本地查表，而不是把「可靠性」交给一次性的网页搜索。
插件当前版本为 0.1.6（MIT），要求 Node.js 20+，DSH 版本 >=0.2.1-rc.1 <0.3.0-0。
核心功能¶
注册表规模与字段¶
插件内置 119 个 agent 可采集信源：
- 73 条
quant：监管申报、宏观、基本面、A 股/港股、执行接口、全球官方统计等。 - 46 条
crypto：交易所、衍生品、链上、归档、SDK、新闻、ETF 资金流等。
每条源记录包括但不限于：域与类别、权威级（A 监管/交易所/官方文档，B 机构/同行评审，C 可靠二手，D 仅线索）、verification 五档（从 discovered 到 production_approved）、pit 五态、revision_risk、data_types（87 个受控标签，定义于 data/datasets.yaml）、redistribution、刷新建议与探测日期等。构建脚本 tools/build-data.cjs 会校验未知 tag、错误枚举与悬空 fallback_id。
另有 22 条 api_hosts 映射：把真实 API 主机（例如 fapi.binance.com）归到文档所在的源 ID，避免「文档站与 API 不同域」时引用无法对齐。
人工核验层 data/enrichment.yaml（version 2）记录探测之后确认的 PIT 修正、验证状态与数据集标签；产物 data/sources.json 带 meta.data_version: 2 与构建元信息。
两个本地工具¶
qt_source_find：按 URL、关键词、domain（quant/crypto）、layer（breadth/depth）检索信源，默认最多 5 条、上限 20 条。输出含权威级、验证状态、PIT、修订风险、数据集标签与源 URL 等一行摘要。qt_source_audit：从草稿文本抽取 URL，逐条给出匹配置信度（exact_url/canonical_page/api_host/same_host_ambiguous/unknown），统计 known/unknown，并对疑似凭据参数做脱敏。
插件还通过 order 241 的短 system prompt 说明何时调用上述工具、如何书写 [source-id] URL 式引用；它不拦截请求，由模型按引导自选调用。
与「常见说法」的差异¶
注册表在 2026-11-06 对官方页面或 API 做过探测，并在矩阵中保留 verified_on。README 用对照表说明若干易错点，例如：宏观 PIT 应用 ALFRED 而非仅用修订后的 FRED；Alpha Vantage 免费层为 25 请求/天；Binance 合约公开行情 WebSocket 路径为 wss://fstream.binance.com/ws/<stream>，不存在 /public 或 /market；单连接最长 24 小时 等。未核实定价会标 free_tier: unverified，不硬抄数字。
安装与启用¶
安装前请自行审阅 GitHub 仓库 源码与 MIT 许可证。插件随当前 dsh 进程权限运行，与社区目录 SkillHub 插件页 一样，并非 DeepSeek / 幻方官方应用商店。
官方 README 给出的安装方式如下（以资料原文为准）。
从 Release tarball 安装（推荐，无需构建）：
dsh plugin --profile web add https://github.com/uhygyuf/quantitativeTrading-source-reliable/releases/latest/download/quantitativeTrading-source-reliable.tgz
从源码仓库安装：
dsh plugin --profile web add github:uhygyuf/quantitativeTrading-source-reliable
本地开发目录安装：
dsh plugin --profile web add /absolute/path/to/quantitativeTrading-source-reliable
安装后重启或重载 profile。在「设置 → 插件」中可见名称为 量化交易信源可靠性 的条目。
典型用法¶
查交易所或监管文档源¶
在陈述端点、费率、限流或 PIT 事实之前，可先调用 qt_source_find。示例参数与 README 中展示的形态一致：
query:"binance funding rate"或"sec xbrl"domain:crypto或quanturl: 已知文档页 URL 时优先用 URL 匹配
返回示例形态（节选）：
- [binance-ws-futures] Binance USD-M Futures WebSocket Streams — crypto/exchange; A/spec; verify=semantic_verified; ...
note: 公开行情 wss://fstream.binance.com/ws/<stream>（或 /stream?streams=）；私有用户流 /private/ws/<listenKey>。不存在 /public 或 /market 路径。
审计草稿引用¶
草稿含 URL 时调用 qt_source_audit。工具会汇总 known/unknown、权威级分布，并对 same_host_ambiguous 明确提示「需固定到具体页面」。README 中的输出示例包括：Binance 文档与带 api_key 参数的 API URL（脱敏后）被标为 canonical_page；同 host 无路径关系的 PDF 链接触发 ambiguous；未注册域名为 unknown。
触发规则要点（与资料一致）：
- 优先 A/B 源；C 作二手；D 仅线索，不能单独支撑结论。
verification=discovered须重新确认；reachable仅表示探测时 HTTP 200。- 新闻与事件类事实引用首次发布时间。
- 话题超出量化金融与加密时，两工具均可跳过。
实测开销（README 记录 2026-11-07）：注册表加载约 2.3 ms；qt_source_find 平均延迟约 0.136 ms（5000 次）；每请求 schema 与引导合计约 712 tokens（按 4 字符/token 估算）。
适用场景与注意¶
适合：在 DSH 中编写研报草稿、策略说明、数据管线设计文档的智能体或开发者，需要统一信源 ID、权威级与引用审计，又不想在每次对话里重复爬定价页或交易所文档。
不适合当作：数据网关、行情抓取器或交易系统。工具只读注册表，不抓页面、不调 API、不验证句子语义是否与源一致；不存储 API key，不提供合规法律意见。交易风控须在模型与交易所之间另建确定性层。
维护边界：qt_source_audit 对 same_host_ambiguous 一律不算 known；api_host 只归因主机，不证明路径与参数正确。未入库 URL 一律 unknown。费用、限额与端点会变更，依赖数字前应结合 refresh_days、last_checked 与重新探测。
结尾¶
经过上面的步骤可知，quantitativeTrading-source-reliable 把量化与加密场景下「去哪取数、怎么引用、常见误区是什么」收敛成 119 条带日期的结构化元数据，并用两个毫秒级本地工具辅助查源与 citation 审计，适合作为 DSH 智能体写结论前的信源层，而不是替代各数据商 API 本身。
