前言¶
在 DSH（DeepSeek Harness）里做宏观或指数相关分析时，常见做法是自己在对话里贴行情、手算比值，或在浏览器里开第三方图表站对照。铜油比（沪铜连续 ÷ 原油连续）常被当作 A 股领先指标，但「固定滞后 3 个月」的画法很难反映滞后本身在漂移。社区插件 dsh-copper-oil（仓库 xinyuzi/copper-oil-plugin）把这条指标做成 DSH 侧边栏一页看板，并在 Host 侧注册 Agent 工具，便于在会话里直接读数。下面介绍它是什么、怎么装、怎么用。
这是什么¶
dsh-copper-oil（npm 包名 dsh-copper-oil，当前版本 1.7.5）由维护者 xinyuzi 发布，GitHub 仓库归属同一账号；package.json 中作者署名为「零点风研」。SkillHub 目录分类为 联网工具，简介为「铜油比&上证指数 harness 插件」。
插件在 DSH 桌面端内完成：从行情源抓取沪铜连续、原油连续与上证指数，计算铜油比；在 60~130 个交易日的滞后候选上按最近 250 日相关性加权，得到有效滞后并对齐上证；再外推与未来有效滞后等长的交易日，并在 Web 面板展示读数、主图与预测区间。数据需访问外网行情接口，插件以当前 DSH 进程权限运行；安装前建议浏览源码与 MIT 许可证，文档注明仅供研究参考、不构成投资建议。
核心功能¶
看板面板¶
安装成功后，左侧边栏增加 铜油比 入口，点开为整页看板。面板自上而下包括：读数卡、主图、沪铜/原油、走势预估与滞后分布、逐日预测列表、口径说明。
主图含义（与 README 一致）：
| 图上的元素 | 含义 |
|---|---|
| 深色实线 | 上证指数（右轴） |
| 红色实线 | 铜油比，按有效滞后向前平移（左轴） |
| 三条浅色线 | 5 / 10 / 20 日均线各自的预测路径 |
| 灰蓝色阴影 | 各路径的 P10–P90 区间 |
| 竖向虚线 | 预测起点（最后真实交易日），右侧为预测段 |
与常见固定「滞后 3 个月」、单条预测线不同，本插件对 60~130 日各算路径、按相关性加权（近一年实测有效滞后在约 85~105 日之间漂移），预测长度等于有效滞后，并用「错位 L 日后的 20 日变化」相关性定权，减轻趋势线伪相关。
首次打开约 1 秒抓取与计算，默认 5 分钟缓存；右上角「立即刷新」可强制更新。绘图区支持滚轮缩放、拖动平移、底部滑块调窗、双击复位；「高低点对齐」可开关双轴刻度策略。
Agent 工具¶
在 cordis.patch.yml 中默认 enableTool: true 时，注册工具 copper_oil_snapshot。无需打开面板，在会话中提问例如「现在铜油比多少、上证后面怎么走」，Agent 可调用该工具返回 JSON 快照。
返回字段示例（README 摘录，日期为文档示例值）：
{
"asOf": "2026-10-30",
"source": "eastmoney",
"current": { "ratio": 145.54, "cu": 108050, "sc": 742.4, "sh": 3599.02 },
"leadTd": 88,
"forecastEnd": "2027-03-03",
"trend": "混沌",
"predEnd": { "5": 3520, "10": 3539, "20": 3565 },
"lag": { "eff": 88, "p10": 75, "p90": 100, "best": 85 }
}
Host 侧还提供 /copper-oil/api 路由供面板使用；实现为纯 JS（index.js Host、client.js Client），无额外 npm 依赖、无构建步骤。
安装与启用¶
需要 DSH 桌面端，引擎要求 engines.dsh >= 0.2.1-rc.3。无需在本机单独安装 Python，也不要在插件目录对助手执行 npm install（包无第三方依赖）。
方式一：从 npm 安装（推荐）
在 DSH 任意会话中对助手说明要安装插件 dsh-copper-oil。助手会调用 plugin_manager（action: install_bundle，target: dsh-copper-oil），从 npm 拉取包。
方式二：从源码安装
下载仓库 ZIP 解压到本地目录（例如 D:\dsh-plugins\copper-oil-plugin），然后说：
安装本地插件，路径
D:\dsh-plugins\copper-oil-plugin
target 须指向包含 package.json 的目录。安装成功返回 application: applied，刷新页面后侧边栏出现图标。
注意：不要将插件放在 DSH 安装目录或 app.asar 内。
可选配置在 cordis.patch.yml 中覆盖，例如延长缓存：
- insert:
- id: copper-oil
name: 'dsh-copper-oil'
config:
cacheMinutes: 10
完整可选字段：cacheMinutes（默认 5）、lagMin / lagMax / lagStep（默认 60 / 130 / 5）、lagWindow（250）、lagTau（0.15）、enableTool（true）。
典型用法¶
- 点侧边栏铜油比图标打开看板，查看当前比值、对齐后的走势与预测段 P10–P90。
- 在对话中直接问：「现在铜油比多少？上证后面 3 个月大概怎么走？」由 Agent 调用
copper_oil_snapshot获取读数与预测端点。 - 若首次空白或报错，确认本机可访问外网行情；数据源失败时面板会提示，可点「立即刷新」重试。
数据口径（README）：新浪财经沪铜连续 CU0、原油连续 SC0；东方财富上证指数 000001；铜油比为沪铜收盘 ÷ 原油收盘（元/吨 ÷ 元/桶）。原油自 2018-03-26 上市起有样本；未来交易日按工作日推算，未剔除法定节假日。
适用场景与注意¶
适合在 DSH 内做铜油比与上证联动的研究型查看、或在 Agent 工作流里需要结构化快照的场景。不适合当作唯一交易依据；预测为文档所述公式的统计外推，历史规律可能失效。
有效滞后每日重算属设计行为，不是配置错误。若预测线与历史段在视觉上「对不上」，是因为铜油比横轴已按有效滞后前移，与上证对齐的是领先之后的日期。
DSH 生态强调「一切皆插件」；SkillHub 目录页 为社区收录站点，与 DeepSeek / 幻方无官方从属关系。仓库开发自测可执行 node --test（6 项冒烟测试）。
结尾¶
dsh-copper-oil 把铜油比领先指标和上证指数放在同一 DSH 看板里，并用可配置的滞后网格与 Agent 工具 copper_oil_snapshot 补全会话查数。进一步了解可访问目录页 xinyuzi/copper-oil-plugin 与源码 GitHub。
