前言¶
在 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。
