前言¶
在 DSH 裏做個股研究，常見做法是臨時拉行情、讓模型自由發揮，結論往往缺少固定輸入、可追溯的計算和可復盤的研究記錄。MegaPandas 維護的 dsh-stock-research（npm 包名 @megapandas/dsh-stock-research）是掛在 DeepSeek Harness 上的工作流類插件：以固定數據快照爲起點，由主 Agent 協調多個研究角色完成問答、快速研究、深度研究與復盤，並保留快照、證據、估值計算與研究產物。插件不執行交易。
這是什麼¶
插件面向 A 股與美股單標的，解決「研究過程可留痕、可驗收、可重跑」的問題。研究思路參考 TradingAgents，許可證爲 MIT。社區目錄頁：skillhub.cn/plugins/MegaPandas/dsh-stock-research；源碼：github.com/MegaPandas/dsh-stock-research。
程序側負責採集、估值計算、數字與引用校驗，並保存來源、輸入和結果；主 Agent 組織角色分析、討論、風險評估與階段驗收，最終交付報告。研究判斷、假設及材料缺口隨報告保存，供復盤查閱。
核心功能¶
下面介紹插件 README 中已說明的能力，按使用方式劃分。
個股問答：基於採集到的數據快照回答具體問題。
快速與深度研究：主 Agent 組織分析、多空討論和風險評估，分階段驗收並彙總報告。
| 研究方式 | 分析範圍 | 後續流程 |
|---|---|---|
| 快速研究 | 市場、基本面、宏觀、公開信息 | 一輪多空討論，綜合風險分析 |
| 深度研究 | 在上述基礎上增加經營、地緣政治和交易行爲與參與度 | 兩輪多空討論，制定研究計劃，分別評估財務、估值和事件風險 |
快速研究適合形成初步判斷；深度研究適合進一步檢驗判斷，通常需要更多時間和模型調用。
復盤與重跑：基於既有研究記錄復盤，或使用固定輸入創建派生運行。
保留研究依據：保存數據快照、證據、產物和採集診斷，方便後續查閱。採集結果和診斷保存在數據目錄的 collections/<UUID>.json 中；財務快照含派生指標及計算口徑，研究使用估值引擎，計算輸入、步驟、算法版本和結果隨研究保存，報告通過計算編號引用結果。
公開信息搜索由研究角色按需執行；額度耗盡後需要審批，搜索多次被拒時暫停，由用戶或主 Agent 判斷是否恢復。
安裝與啓用¶
安裝前需要 Node.js 24.16.0、DSH 0.2.1 系列（從 0.2.1-rc.1 起） 和 pnpm，並在 DSH 中配置模型與憑證。插件以當前 DSH 進程權限運行，安裝前應自行查看源碼與 MIT 許可證，確認數據來源與網絡行爲符合你的環境要求。
將插件安裝到使用的 profile（以 web 爲例）：
dsh plugin --profile web add @megapandas/dsh-stock-research@next
安裝後啓動對應的 DSH profile；已運行的實例若未自動加載插件，需重啓後再使用。自定義 profile 需提供 Agent、工具、模型、命令、會話查詢及本地子 Agent 等基礎服務。
package.json 中當前版本爲 0.2.0-rc.1，通過 npm next 標籤發佈。
典型用法¶
在聊天中發起研究¶
在 DSH 聊天中直接提出研究需求，例如：
請對 002594.SZ 比亞迪做一次快速個股調研。
請對 NASDAQ:NVDA 做一次深度調研，研究日期爲 2026-10-23。
標的需明確交易所：A 股可使用 002594.SZ 或 CN:002594.SZ 等形式，美股使用 NASDAQ:NVDA 或 NYSE:IBM 等形式。研究日期使用 YYYY-MM-DD 格式。默認使用 DSH 數據目錄，研究子 Agent 繼承當前會話的模型設置。
常用斜槓命令¶
日常可直接與主 Agent 對話；需要明確指定操作時，可使用以下命令（涉及既有研究的操作使用對應的 runId）：
| 命令 | 用途 |
|---|---|
/stock-ask |
基於採集快照回答問題 |
/stock-quick / /stock-deep |
發起快速或深度研究 |
/stock-status |
查看研究狀態、任務和阻塞原因 |
/stock-resume |
解決阻塞原因後繼續研究 |
/stock-redo |
重做指定任務，並使受影響的下游結果失效 |
/stock-cancel |
取消研究 |
/stock-recover |
確認宿主中斷遺留的運行中嘗試已經停止 |
/stock-review |
基於既有研究保存獨立復盤記憶 |
/stock-replay |
使用固定輸入創建派生運行 |
/stock-gc all 會清除緩存、研究運行、草稿和復盤數據，保留 collections/ 中的獨立採集快照與診斷；任務運行時不可執行清理，清除後的研究記錄無法再用於復盤或重跑。
研究過程概覽¶
- 採集數據：問答和研究先執行固定採集流程，取得必需日線後採集其餘數據，保存快照和診斷。
- 分析與交接：研究子 Agent 使用固定輸入分章節撰寫報告，提交正文及結構化交接。
- 驗收與彙總：主 Agent 可以追問、要求修改，驗收後推進討論、風險評估和決策，最終交付報告。
配置與數據來源¶
在 DSH Web 界面打開 設置 → 股票研究，可按需調整研究模型與思考強度、免審批搜索次數（公開信息角色默認 8 次免審批搜索）、數據來源、數據目錄（通常爲 ~/.dsh/stock-research）、網絡與緩存、數據新鮮度等。修改後需保存；模型與搜索額度對新任務生效，在途研究保留啓動時的設置。
默認啓用的來源包括東方財富、Yahoo Finance、騰訊行情、新浪財經、商務部數據中心、FRED 等；雪球和 SEC 默認關閉。啓用雪球須填寫 Cookie 相關字段；啓用 SEC 須提供請求身份、有效聯繫方式以及已確認的股票 ID 與十位 CIK 映射。公開信息搜索還需在 DSH 中配置搜索後端。
美股固定採集目前以日線、有限的 SEC 財務字段和美國宏觀序列爲主；未啓用 SEC 時不會採集其財務數據。
適用場景與注意¶
適合需要在 DSH 內做 A 股或美股單股調研、並希望保留固定輸入與結構化報告的研發者或分析流程搭建者。不適合當作實盤或自動交易工具。
中斷與版本方面：重新啓動 DSH 不會自動恢復中斷的研究，可先 /stock-status，再通過 /stock-recover 與 /stock-resume 處理。遇到 VERSION_UNAVAILABLE 時應新建研究；已保存的歷史報告和計算記錄仍可讀取。若出現 Cannot acquire data-root writer lock，檢查是否有其他 DSH 實例使用同一數據目錄。
從源碼安裝時，可在項目目錄 npm pack 後安裝到 profile：
npm pack
dsh plugin --profile web add "/絕對路徑/megapandas-dsh-stock-research-<版本>.tgz"
將路徑替換爲 npm pack 實際輸出的歸檔路徑。
結尾¶
dsh-stock-research 把「固定快照 + 多角色工作流 + 可復盤記錄」接到 DSH 聊天與工作流裏，便於在可控數據基礎上完成快速或深度單股研究。進一步瞭解可訪問 插件目錄頁 與 GitHub 倉庫 及倉庫內 docs/README.md 技術文檔。
