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