前言¶
在 DSH Desktop 里写代码、跑 Harness 时，若还要切到浏览器或行情 App 看自选，上下文会被频繁打断。常见做法是另开标签页刷第三方站点，或自己接行情 API 再写一个小面板——前者占注意力，后者要维护 Key、代理和图表组件。
下面介绍社区插件 dsh-stock-ticker（维护者 lengyeyu123）：把 A 股、港股、美股的实时快照、分时与 K 线收进 DSH 侧栏与浮层面板，数据走腾讯公开行情接口，无需 API Key。插件分类为客户端，当前 npm 版本 0.2.1，依赖 DSH >=0.2.1-rc.3、DSH Desktop >=2.0.0（MIT 许可证）。
这是什么¶
dsh-stock-ticker 是 DeepSeek Harness / DSH Desktop 的自选股行情插件：侧栏底部常驻「自选行情」入口，轮播自选涨跌幅；点开浮层可管理自选列表，进入单只标的的分时图、日 K / 周 K / 月 K 与柱状视图。宿主半区提供 /api/dsh-stock/* 代理（GBK 解码、单位统一、TTL 缓存）；浏览器半区负责 UI，宿主不可用时可直连腾讯端点兜底。
- 目录页：https://www.skillhub.cn/plugins/lengyeyu123/dsh-stock-ticker
- 源码：https://github.com/lengyeyu123/dsh-stock-ticker
- npm：https://www.npmjs.com/package/dsh-stock-ticker
核心功能¶
行情与图表¶
| 能力 | 说明 |
|---|---|
| 实时报价 | 默认约 5 秒一轮；可选 3s / 5s / 10s / 30s / 60s，或 1～600 秒自定义；窗口不可见时停轮询，回到前台立即补一次 |
| 分时图 | 价格折线、均价虚线、昨收零轴、十字光标读数 |
| K 线 | 日 K / 周 K / 月 K，带 MA5 / MA10 / MA20 与成交量；A 股前复权，港美股原始价 |
| 柱状图 | 分时视图可切「柱状」：每分钟相对昨收的涨跌柱，下方按分钟涨跌上色的成交量柱 |
| 交易时段 | 详情页按市场本地时间显示「交易中 / 午间休市 / 盘前 / 已收盘」等标签（节假日仍可能取数，标签仅供参考） |
自选与交互¶
- 代码识别：
600519、sh600519、600519.SH、700、AAPL、AAPL.OQ等；支持空格或逗号批量粘贴；行内置顶、移出。 - 侧栏入口：挂在
sidebar.footer.action槽位；悬停暂停轮播，可整体关闭。 - 一级页面：同时注册
settings.section，作为大屏看板，或在侧栏槽位缺失时的兜底。
配置方案¶
偏好保存在浏览器 localStorage（键 dsh.stock-ticker.prefs.v2，旧版 v1 首次读取时自动迁移）。当前参数包括刷新频率、图表形态、涨跌配色、列表密度、侧栏轮播；配置方案是命名快照。内置只读「标准 / 盯盘 / 省流」三套，可新建、重命名、删除自定义方案，改参后可「保存」回方案或「另存为」新方案。宿主半区不落盘、不鉴权、不保存用户数据。
涨跌配色默认 红涨绿跌（A 股习惯），可切绿涨红跌；列表密度有标准 / 紧凑两档。
数据与架构¶
- 数据源：腾讯行情（
qt.gtimg.cn、web.ifzq.gtimg.cn），免费、无需 API Key。 - 双半区：宿主代理 + 浏览器 UI；快照缓存 TTL 约 2.5s，分时约 8s。
- 图表：分时与 K 线为纯 SVG 手绘，未引入第三方图表库。
宿主 HTTP 接口（节选）：
| 路由 | 说明 |
|---|---|
GET /api/dsh-stock/quotes?codes=sh600519,hk00700,usAAPL |
批量实时快照，单次最多 40 个代码 |
GET /api/dsh-stock/minute?code=sh600519 |
当日分时序列 |
GET /api/dsh-stock/kline?code=sh600519&period=day&count=60 |
K 线，period 为 day / week / month，count 20～240 |
安装与启用¶
安装前请确认当前 profile 对应的 DSH Desktop 与 runtime 版本满足插件声明（web-client、host-route 能力）。插件以当前 DSH 进程权限运行，安装前应自行查看源码与 MIT 许可证，评估网络出站与合规需求。
从 npm 安装（推荐）¶
dsh plugin --profile <profile-name> add dsh-stock-ticker
装完后重启 DSH Desktop，或重新加载当前工作配置。侧栏底部应出现「自选行情」按钮。
从 GitHub 安装¶
dsh plugin --profile <profile-name> add github:lengyeyu123/dsh-stock-ticker
从 git 依赖安装时会自动执行 prepare（类型检查 + 构建）。离线环境可使用 Releases 中的 tarball 本地安装。
卸载¶
dsh plugin --profile <profile-name> remove dsh-stock-ticker
典型用法¶
- 点击侧栏「自选行情」，在列表中输入或粘贴股票代码，添加自选。
- 点击某只标的，在详情中切换分时 / 柱状 / 日 K / 周 K / 月 K，并查看 MA 与成交量。
- 在设置页选择内置「盯盘 / 省流」方案，或新建方案保存自己的刷新频率与配色；需要欧美配色时切换绿涨红跌。
未安装 DSH 时，仓库提供免构建预览页 preview/stock-panel-preview.html，可直连真实行情。若浏览器拦截跨域，可在仓库目录执行：
python -m http.server
再在浏览器访问对应 URL。预览页支持查询参数，例如 ?mock=1 离线演示、?theme=dark 深色、?tone=us 绿涨红跌、#code=sh600519 直接打开指定标的（完整参数见 README）。
适用场景与注意¶
适合：在 DSH Desktop 内长时间开发或对话、需要轻量盯自选又不想单独开行情站的用户；接受腾讯公开接口、无 SLA 的场景。
限制（README 已说明）：
- 高频轮询可能被限流，默认 5s 已偏保守。
- 自选与配置方案仅在本机
localStorage，换设备或清缓存会丢失，无云端同步。 - 不支持分笔、五档盘口与分钟级 K 线（m5 / m15 等）。
- 腾讯接口变更或限流时，功能可能不稳定。
DSH 生态强调「一切皆插件」；SkillHub 目录 为社区站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-stock-ticker 把自选股快照、分时与 K 线嵌进 DSH 侧栏与浮层，数据源免费、双半区可兜底，并可用配置方案在盯盘与省流之间切换。需要试用或贡献代码时，可从目录页与 GitHub 仓库入手：
