dsh-stock-dashboard

English | 中文

面向 DeepSeek Harness Web GUI 的 A 股看板插件：侧边栏底部按钮切换一个浮动行情面板（shell.overlay 层）。面板打开时每 10 秒轮询 /stock/quotes，支持添加和删除自选代码。

行情数据来自公共腾讯 qt.gtimg.cn 端点（无需 key、无需认证）。与东方财富 push2 API 不同，它不封锁海外出口，因此挂国外代理也能正常使用。

安装

需要已安装带 Web GUI 的 DeepSeek Harness（dsh web）。本包发布到 npm 后：

dsh plugin --profile web add dsh-stock-dashboard

这会安装一个 bundle：包内的 cordis.patch.yml 向 web profile 插入股票缝（seam）、腾讯行情 provider、/stock/quotes 路由和浏览器看板。浏览器半通过 dsh.client 声明自动被发现；重启 dsh web 并刷新页面后，侧边栏底部设置旁边就会出现看板入口。

不用 npm 仓库的替代方式：

# 直接从 GitHub 安装（会运行 prepare 构建；首次需在 profile 的 pnpm-workspace.yaml 中放行构建）
dsh plugin --profile web add github:you/dsh-stock-dashboard
# 或从本地 tarball 安装
dsh plugin --profile web add ./dsh-stock-dashboard-0.1.0.tgz

使用

• 点击侧边栏底部的 股市看板 打开/关闭浮动面板。
• 点击刷新图标立即拉取行情（请求进行中图标会旋转）；面板打开时自动轮询——底部有自动刷新开关和间隔选择（5/10/30/60 秒）。
• 用添加行添加代码（shXXXXXX / szXXXXXX，如 sh600519）；点行上的 × 删除。
• 刷新失败时，旧数据上方会显示「刷新失败，展示上一次行情」，而不是静默失败。
• 自选列表、面板状态和轮询设置会在刷新页面后保留。

默认自选列表是三大指数加两只蓝筹：sh000001、sz399001、sz399006、sh600519、sz000001。

开发

pnpm install && pnpm run build && pnpm test。

本包是 TypeScript 写的；它导入的 harness 包（@deepseek-ai/cordis、@deepseek-ai/dsh-client-* 等）是运行时由 dsh 安装提供的 peer 依赖。这些包尚未全部发布到 npm，因此构建期类型解析依赖旁边的一份 deepseek-harness checkout——请把本仓库放在它旁边（../deepseek-harness），并保持其 lib/types 为最新。发布产物中不包含这些路径。

发布

pnpm run build   # prepack 会再跑一次，本地先跑一次更稳妥
npm publish      # 发布 lib/、cordis.patch.yml 和本 README

已知限制与暂缓事项

• 仅限 A 股：代码为 sh/sz 形式；港股和美股暂缓。
• 整态持久化：自选列表、面板状态和轮询设置会持久化；瞬态的 failed/addError 标志也会随之保存，并在下一次拉取或添加时自愈。
• 公共 API 波动：qt.gtimg.cn 是匿名公共端点，可用性和字段布局可能变化。
• GBK 传输：provider 用 TextDecoder('gbk') 解码响应，需要完整 ICU 的 Node 运行时。