前言¶

在用 DeepSeek Harness（DSH）写代码或查资料时，如果想顺便看一眼行情，通常要么打开另一个网页，要么在对话里粘贴数据。这会打断思路，也分散注意力。DSH 生态采用「一切皆插件」的设计，插件可以挂载在官方槽位上，既不侵入本体，又能按需加载。

dsh-market-dock 就是一个挂载在 DSH 官方槽位上的行情面板插件。它把 A股、港股、美股的实时行情、K线、热榜、快讯嵌入到对话框上方和输入框旁，并自带本地持仓与盈亏现算、价格提醒，以及一个「行情隐身」开关。这个插件由 xxxSnack 维护，分类为联网工具，非雪球官方产品，数据来自雪球公开 Web 接口。

核心功能¶

行情面板¶

面板挂载在 conversation.input.dock，按 Esc 可收起。面板包含 6 个 tab：

• 行情：顶部是四大指数（上证、深证、创业板、沪深300），下方是自选股。点击任意一行可打开详情页。
• 热榜：实时热榜列表。
• 搜索：支持中文名、拼音、ticker 与纯代码（如「茅台」/「maotai」/「600519」/「00700」）。
• 快讯：7×24 快讯。
• 盈亏：当日盈亏 chip，以及盈亏与持仓的统计。
• 持仓：本地持仓列表，可增删改。

详情页展示大号现价、涨跌额/涨跌幅、16 格指标卡、K线（蜡烛 + 成交量 + MA）、分时图，以及 7 个时间周期（5/15/30/60 分、日/周/月）。

迷你行情徽标¶

徽标挂载在 shell.overlay，是一个独立悬浮组件。它可拖拽，可折叠成一行，位置与尺寸会落盘。徽标会轮播自选股与指数涨跌。右上角的 ⊘ 按钮是「行情隐身」开关，− 按钮用于折叠。

指数条¶

在输入框上方常驻一行四大指数，单独占行，不挤占输入区。

本地持仓与盈亏¶

「持仓」tab 里维护持仓数据：代码、股数、成本价，可随时增删改。当日盈亏、持仓盈亏、市值按实时行情现算，不依赖任何账本接口。

今日盈亏¶

面板头部常驻一枚盈亏 chip。可选接同花顺投资账本做一次性导入/校对：在「持仓」tab 里点击「从账本同步」，粘贴 Cookie 即可。账本只在你点击时请求，不点就一个请求都不发。账本失效不影响实时盈亏计算。

价格提醒¶

给任意标的设上限/下限，到价会弹系统通知。提醒判定跑在宿主侧 watcher 里，所以面板关着、页面刷新、徽标折叠都不影响提醒。浏览器未给通知权限时，第一次触发会提示授权。

行情隐身¶

「行情隐身」一键让面板、徽标、指数条一起卸载（不是 CSS 隐藏），行情轮询随之停止——真的一个行情请求都不发；价格提醒仍然生效。恢复有三条路径：

• 左下角恢复胶囊：屏幕左下角一枚 ● 行情 小胶囊，单击即可恢复。
• 快捷键：Ctrl + Alt + Shift + X（macOS 为 ⌘ + Alt + Shift + X），可在「设置 → 通用 → 快捷键」里修改。
• Agent 工具：让 AI 调 xueqiu_display（hidden: false），或直接说「把行情打开」。

隐身状态是宿主级的：存储在 $DSH_HOME/dsh-xueqiu/.xueqiu-ui-state.json，刷新、重启、换工作区、换浏览器都保持一致。

Agent 工具¶

插件提供 7 个工具，并在对话里渲染成 4 张工具卡片：

• xueqiu_quote：实时行情快照（A股/港股/美股/指数/ETF）。
• xueqiu_kline：历史 K 线（OHLCV + 涨跌幅）。
• xueqiu_search：按名称/拼音/代码搜标的。
• xueqiu_hot：热榜。
• xueqiu_news：7×24 快讯。
• xueqiu_kol：某只股票的热议大V。
• xueqiu_display：读/写「行情隐身」状态（{hidden: true｜false}；不传参即只读）。

安装与启用¶

环境要求¶

面向 DSH 0.2+（宿主 shell 服务改名后的版本），已在该版本验证；更早版本未做兼容。

安装命令¶

方式一：作为 bundle 插件（推荐）

# GitHub 源
dsh plugin --profile web add github:xxxSnack/dsh-market-dock

# 或本地目录（开发 / 自用最省事）
dsh plugin --profile web add /abs/path/to/dsh-market-dock

装完后重启一次 dsh web（插件行发现按启动缓存），再刷新页面即可看到面板。

手动接入等价于在 profile 的 package.json 里写两处（~/.dsh/profiles/web/package.json）：

{
  "dependencies": { "dsh-market-dock": "link:/abs/path/to/dsh-market-dock" },
  "dsh": { "profile": { "bundles": ["…", "dsh-market-dock"] } }
}

并让 node_modules/dsh-market-dock 指向插件目录（link: 依赖或 symlink，二选一即可）。

方式二：动态插件

仓库里的 dynamic/host.js 与 dynamic/client.js 是同一份源码构建出的动态形态，可在任意 DSH 会话里用 cordis_define（kind: new）+ cordis_run 加载，不必进 profile。两个形态能力一致，区别只在安装方式。

典型用法¶

行情与自选¶

在面板「行情」tab 里添加自选股，支持搜索。点击任意一行可查看详情。右上「刷新」按钮可手动触发一次刷新；其余时候按交易时段自适应刷新，并带 TTL 缓存与请求节流。

本地持仓与盈亏¶

在「持仓」tab 里手工添加持仓（代码 + 股数 + 成本价）。当日盈亏与持仓盈亏会根据实时行情自动计算。如需校对，点击「从账本同步」，粘贴同花顺投资账本的 Cookie，完成一次性导入/校对。

价格提醒¶

在详情页或列表里为某个标的设置上限/下限，到价会弹系统通知。提醒在宿主侧 watcher 里运行，面板关闭或刷新不影响。

行情隐身与恢复¶

• 隐身：面板头部「隐身」按钮、徽标上的 ⊘ 按钮，或对 AI 说「把行情隐身」。
• 恢复：左下角恢复胶囊、快捷键 Ctrl + Alt + Shift + X，或让 AI 调 xueqiu_display（hidden: false）。

适用场景与注意¶

适合在 DSH 中一边对话一边查看行情、分析 K线、管理自选与本地持仓，或用 Agent 工具让模型自己查行情与快讯。插件以当前 dsh 进程权限运行，安装前建议检查源码与许可证（MIT + Apache-2.0 嵌入组件）。

短结尾¶

dsh-market-dock 在官方槽位上提供了完整的行情查看、自选管理、本地持仓与盈亏现算、价格提醒与「行情隐身」功能，与上游 dsh-xueqiu 是替代关系，装之前建议先卸掉上游同名插件。更多细节见目录页与 GitHub 仓库。

目录页¶

https://www.skillhub.cn/plugins/xxxSnack/dsh-market-dock

GitHub¶

https://github.com/xxxSnack/dsh-market-dock