前言¶
在 DeepSeek Harness (DSH) 中進行智能體開發或日常對話時，往往需要獲取實時的金融數據來輔助決策。現有的做法通常是打開瀏覽器切換頁面，這會打斷對話流。dsh-xueqiu 插件旨在解決這一割裂問題，它通過嵌入式設計將雪球的數據面板集成到 DSH 的對話界面中，提供免登錄的 A股/港美股行情服務。
插件介紹¶
dsh-xueqiu 是一個運行在 DeepSeek Harness Web 端的聯網工具插件，由開發者 wanderer-yk 維護。它通過調用雪球公開接口，爲用戶提供實時行情、K線圖、分時圖、熱榜、快訊和熱議用戶等數據。該插件採用 MIT 開源許可證，支持本地持久化存儲自選股，並提供 Cookie 登錄選項以同步雲端數據。
核心功能¶
插件的核心能力集中在數據可視化與交互體驗上：
- 實時行情與圖表：支持大盤指數（上證、深證、創業板、科創50）及自選股列表展示，支持漲跌顏色標識與排序。K線圖基於 KLineChart v10 引擎，支持 MA 均線、7 檔週期（5分至月K）、縮放與平移；分時圖包含面積價格線、均價線及昨收基準虛線。
- 社區數據集成：提供雪球熱門榜（支持 A股/美股/港股/全球切換）、7×24 實時快訊（含重要新聞高亮）以及個股熱議 KOL（含粉絲數與認證標識）。
- 嵌入式面板：主面板停靠在輸入框上方，不遮擋對話記錄。右下角設有常駐行情區域，顯示四大指數與自選股前 12 只，支持拖拽調整位置與寬度（120-480px）。
- 自適應與防護：面板高度可調（160px–85% 視口），支持跟隨 DSH 明暗主題。內置請求防護機制，包含併發閘門、看門狗（30s 超時釋放）、TTL 緩存以及 Cookie 自愈功能。
- Agent 工具集成：提供
xueqiu_quote、xueqiu_kline、xueqiu_search、xueqiu_hot、xueqiu_news、xueqiu_kol六個 Agent 工具，可在對話中直接調用並返回卡片化結果。
安裝與啓用¶
通過 DSH 的命令行工具安裝該插件：
dsh plugin --profile web add dsh-xueqiu
安裝完成後，需要重啓 dsh web 進程以加載插件。刷新頁面後，面板會自動出現在對話輸入框上方。
典型用法¶
安裝並啓用插件後，可以通過以下步驟進行操作：
- 面板控制：面板默認停靠在輸入框上方。點擊面板上的收起按鈕或按
Esc鍵可以收起面板，點擊右下角行情區域或底部指數條可重新展開。 - 調整佈局：拖動右下角行情區域的邊緣手柄可以調整寬度（120-480px），雙擊可復位。拖動面板底部的手柄可以調整面板高度（160px–85% 視口）。
- 查看詳情：點擊自選股、指數卡片或熱榜行，會彈出詳情面板，展示 16 項行情數據、K線/分時圖表、財務指標及熱議用戶。
- 登錄雲端：點擊面板右上角的“登錄”按鈕，從瀏覽器複製 Cookie 並粘貼。Cookie 僅保存在本機
~/.dsh工作區，不上傳。登錄後可選擇使用雪球雲端自選股（10 分鐘自動同步）。 - Agent 調用：在對話中直接提問，如“查詢貴州茅臺的實時行情”或“獲取寧德時代的 K 線圖”，Agent 會調用對應工具並渲染結果。
注意事項¶
- 本項目非雪球官方產品，僅供學習與研究，不構成投資建議。
- 雪球接口可能變更，導致功能失效，建議關注 GitHub 倉庫的更新日誌。
- Cookie 僅保存在本地，退出登錄即清除。
- 交易時段提示基於本地時區推算，不含節假日調休，僅供參考。
資源鏈接¶
- GitHub 倉庫：https://github.com/wanderer-yk/dsh-xueqiu
- 插件目錄頁：https://www.skillhub.cn/plugins/wanderer-yk/dsh-xueqiu
