前言¶
在 DeepSeek Harness（下稱 DSH）的插件場景裏，常見的一類需求並不是直接交易，而是圍繞單個標的做規則研究：查看當前規則狀態、回測歷史表現、生成可交互的報告，再把已驗證的規則保存下來複用。如果把這些能力拆成數據拉取、Python 回測、HTML 圖表和策略管理，開發者往往需要自行維護一套外部工具鏈。
dsh-quant-workspace 提供的是另一條路徑：作爲一個自包含的 DSH 量化研究插件，它內置 Python 引擎，支持 Yahoo Finance 日線數據、規則策略回測和交互式可視化報告。下面介紹它的定位、核心能力、安裝方式和典型用法。
這是什麼¶
AllenCX/dsh-quant-workspace 是一個面向 DSH 的自包含量化研究工作區。它把數據獲取、規則回測和報告生成放進同一個插件裏，並圍繞單標的研究提供 single_ticker 工具。
項目倉庫爲 AllenCX/dsh-quant-workspace，許可證爲 MIT。它需要 DSH 的 web profile 與 pnpm；內置 Python 引擎需要 uv 運行，首次使用時會同步 python/.venv；獲取 Yahoo Finance 數據需要互聯網訪問。Node 引擎要求爲 >=22.19。
核心功能¶
數據獲取¶
插件支持獲取 Yahoo Finance 日線數據，默認獲取 2 年數據。可導出 OHLCV 數據和指標數據。
規則回測¶
回測針對規則策略執行，輸出內容包括：
- 逐筆交易表
- 總收益
- 最大回撤
- 勝率
- 平均持倉
- 買入持有基線
交互式報告¶
插件可生成自包含的交互式 HTML 報告。報告內容包括：
- K 線帶
- 成交量
%B- 權益曲線
報告支持縮放、平移、十字光標，以及紅漲綠跌切換。HTML 文件爲自包含格式，可在瀏覽器中打開。
策略註冊表¶
插件提供策略註冊表，用於保存已經研究過的策略，並按 id 複用。這樣在後續會話中不必每次重新描述規則參數。
只讀邊界¶
該插件按只讀設計：不下單，不改變持倉，不需要市場數據密鑰。它展示規則狀態和證據，但決策由用戶負責，不構成投資建議。
安裝與啓用¶
依賴¶
使用前需要滿足以下條件：
- 已安裝 DSH，並使用
webprofile - 已安裝
pnpm - 已安裝
uv，用於運行內置 Python 引擎 - 能訪問互聯網以獲取 Yahoo Finance 數據
安裝¶
README 標明該插件尚未發佈到 npm。未發佈前，可使用下面的 GitHub 安裝命令：
dsh plugin --profile web add github:AllenCX/dsh-quant-workspace
README 中也出現另一條安裝命令：
dsh plugin --profile web add dsh-quant-workspace
這兩條命令在 README 中同時出現，官方推薦命令需根據具體文檔和使用環境確認。
配置¶
所有配置項均爲可選。示例用戶補丁路徑如下：
$DSH_HOME/profiles/web/cordis.patch.yml
示例內容：
- id: quant-workspace
config:
ledgerPath: 'C:\path\to\trade_log.csv' # optional: track your real positions
reportsDir: 'C:\path\to\reports' # optional: where visual reports go
主要配置項如下：
| 配置項 | 默認值 | 含義 |
|---|---|---|
ledgerPath |
無 | 持倉臺賬 CSV，格式爲 date,ticker,action,price，按 FIFO 處理；持倉僅從該文件跟蹤 |
reportsDir |
$DSH_HOME/dsh-quant-workspace/reports |
可視化報告產物和狀態導出目錄 |
registryPath |
$DSH_HOME/dsh-quant-workspace/strategies.json |
策略註冊表 JSON 文件 |
defaultRule |
無 | 調用中未指定規則時使用的默認規則族 |
timeoutMs |
180000 |
每次工具調用的前臺超時時間 |
pythonCommand |
uv run --project <package>/python dsh-quant |
覆蓋內置引擎 CLI 的運行命令，例如使用預構建 venv |
典型用法¶
在 DSH 會話中使用¶
在 Harness 會話中，可以直接用自然語言觸發 single_ticker 工具。
查看某隻標的的當日信號卡：
Give me today's signal card for TSLA
這對應 single_ticker，mode 爲 daily。
回測某隻標的並生成圖表：
Backtest META and generate a chart
這對應 single_ticker，mode 爲 backtest，並啓用 chart: true。
做 review 健康檢查：
Compare the review health check for TSLA
這對應 single_ticker，mode 爲 review。
一次調用只運行一個規則。規則可以來自示例 rule family，也可以來自注冊表中的 strategy id；如果兩者都沒有，則使用配置中的 defaultRule。如果這些都沒有提供，工作區會報告沒有選擇策略。
single_ticker 參數¶
single_ticker 的主要參數如下：
ticker：必填，標的代碼，例如TSLA；會自動轉爲大寫，只允許字母、數字、點和連字符mode：默認daily，可選daily、backtest、reviewrule：示例規則族，當前包括bollinger_mean_reversionstrategy：策略註冊表中的策略idchart：默認false；設爲true時同時生成交互式 HTML 報告，並在reportsDir下寫入狀態 CSV，輸出中包含產物路徑
CLI 用法¶
插件提供 dsh-quant CLI。單標的命令格式如下：
dsh-quant single-ticker --ticker <T> --mode <daily|backtest|review> (--rule <family> | --strategy <id>) [--ledger <path>] [--chart <dir>] [--export-state <dir>] [--registry <path>] [--data-file <csv>]
策略註冊表命令示例：
dsh-quant strategy register --id tsla_dip --family bollinger_mean_reversion --bollinger-window 30 --note 'dip strategy after Aug-2026 research'
查看已註冊策略：
dsh-quant strategy list
刪除某個策略：
dsh-quant strategy remove --id tsla_dip
CLI 退出碼如下：
0：成功，輸出純文本報告1：數據無法加載2：無效調用
--data-file 可用於讀取本地 OHLCV CSV，而不是從網絡獲取數據；該參數主要用於測試。
示例規則¶
內置引擎提供一個示例規則：Bollinger 均值迴歸。規則爲日線級別，%B <= 0 時入場，%B >= 1 時出場。
適用場景與注意¶
這個插件適合以下場景：
- 使用 DSH
webprofile，希望從聊天或 CLI 做單標的研究 - 需要查看某個規則在指定標的上的信號狀態
- 需要對規則策略做日線級別回測
- 需要生成可交互、自包含的 HTML 報告
- 希望把已研究過的策略保存到註冊表，之後按
id複用
它不適合用於實際下單、持倉變更或需要完整交易系統支持的場景。
使用注意：
- 插件不構成投資建議；它只展示規則狀態和證據，決策由用戶負責
- 插件不下單，也不改變持倉
- 插件會以當前 DSH 進程權限運行；安裝前應檢查源碼和許可證
- 獲取 Yahoo Finance 數據需要互聯網訪問
- 首次運行內置 Python 引擎時，
uv會同步python/.venv --data-file讀取本地 CSV 時，主要用於測試或離線驗證
結尾¶
dsh-quant-workspace 的價值在於把單標的量化研究中的幾個常見步驟放在同一個 DSH 插件裏：日線數據、規則回測、交互式報告和策略複用。它保持只讀邊界，不觸及下單和持倉變更，因此更適合研究和複覈場景。
GitHub 倉庫：
https://github.com/AllenCX/dsh-quant-workspace
插件目錄頁線索：
https://www.skillhub.cn/plugins/AllenCX/dsh-quant-workspace
