📈 DSH 行情看板（DSH Quote Panel）
English | 简体中文
DeepSeek Harness（dsh web）会话内的实时行情看板：可拖拽、永远置顶的悬浮面板，A股 + 美股，无需任何 API Key、无账号、免费。
截图
✨ 功能特性
- A股：默认页展示三大股指——上证指数（
sh000001）、深证成指（sz399001）、创业板指（sz399006）；可添加任意 A 股代码（600519、sh600519…）
- 美股：默认页展示三大指数——道琼斯（
DJI）、纳斯达克综合（IXIC）、标普500（INX）；可添加任意美股代码（AAPL、TSLA…）
- K线：A股分时 / 60分 / 日K / 周K / 月K；美股日K / 周K / 月K
- 自选管理：各市场独立自选，增删实时生效，存于浏览器
localStorage
- 自动刷新：行情服务端轮询，A股 5 秒 / 美股 10 秒
- 置顶 + 可拖动：z-index 压过所有皮肤/主题浮层；按住标题栏可拖到任意位置，位置自动记忆
- 🐂 牛来桌宠（v1.1 新增 · v2.2 多皮肤）：看板上点 "🐂 牛来" 即可召唤一头会撒欢奔跑的牛，盯 A股 / 美股自选；任一标的
changePct > 0 就跑两步 + 文字喊两声 \牛来/。直接浮在 DSH 会话页面，跟着页面滚动，自选自动同步。每次打开都会循环切换形象（经典牛 / 毛绒牛，皮肤持久化不丢失）
- 零配置：数据全部来自免费公开接口（腾讯财经），无需申请密钥
🚀 安装
bundle 插件：无需审批弹窗，重启不丢失。
一键安装脚本（推荐）
仓库根目录自带两个一键安装脚本（幂等，可重复执行）：
# Linux / macOS
bash install.sh
# Windows（PowerShell 5.1+）
powershell -NoProfile -ExecutionPolicy Bypass -File install.ps1
脚本会自动：复制插件源码 → 在 web profile 的 package.json 写入 dependencies["dsh-quote-panel"]="link:<绝对路径>" 与 dsh.profile.bundles 条目（先备份，幂等）→ 执行 pnpm install → 提示重启。可用环境变量 DSH_PROFILE_DIR / DSH_PLUGIN_DIR 覆盖默认路径。
手动安装（各平台通用）
- 克隆/复制本仓库到你的
dsh-plugin-download 目录（或任意位置）。
- 编辑 web profile 的
package.json（默认 ~/.dsh/profiles/web/package.json）：
dependencies 增加："dsh-quote-panel": "link:<本仓库绝对路径>"dsh.profile.bundles 增加："dsh-quote-panel"
- 在 profile 目录执行
pnpm install。
- 重启
dsh web，在会话页顶栏点击 📈 行情 按钮。
从 npm / GitHub Releases 安装（v2.0 已发布）
# npm
npm i -g dsh-quote-panel
# 或像其他 dsh bundle 插件一样加进 profile 依赖
GitHub Releases 页面会附带 dsh-quote-panel-install.tar.gz 安装包（含插件本体 + install.sh，适合全新环境直接解压进 profile 的 node_modules）。
🛠 使用
- 打开 dsh 会话页面，点击会话顶栏右侧的 📈 行情。
- 用 A股 / 美股 页签切换市场。
- 在输入框输入代码，点 添加 扩展自选；悬停列表行点 ✕ 移除。
- 点击任意行查看 K线，用按钮切换周期（分时 / 60分 / 日K / 周K / 月K）。
- 面板挡住内容时，按住标题栏拖动即可，位置会被记住。
🐂 牛来桌宠（🐮 Desk Pet）
桌宠演示
看板头部点击 🐂 牛来，打开后一头牛会浮在页面底部左右徘徊。每当自选列表里任一标的实时上涨（changePct > 0），牛立刻：
- 跑两步（在 1.6 秒里走完横向 78px + 两跳）
- 停下
- 弹出黄色对话泡，大字
\牛来/，下方一行小字列出当前在涨的几只标的（如 贵州茅台 +1.32% · 上证指数 +0.21%）
- 同一波上涨节流约 1.8 秒，避免连刷
- 标的回落时（不再有上涨）牛恢复安静漫步，对话泡消失
数据源与上面看板一致——复用 /dshq/quotes，所以完全零额外接口。
关闭桌宠
看板标题里的高亮按钮变回 🐂 关掉牛 即可关闭。
🗂 数据来源与免责声明
| 市场 | 行情 | K线 |
|---|
| A股 | 腾讯 qt.gtimg.cn | 腾讯 ifzq.gtimg.cn（分时 / 60分 / 日 / 周 / 月） |
| 美股 | 腾讯 qt.gtimg.cn | 腾讯 ifzq.gtimg.cn（日 / 周 / 月） |
- 所有接口均为免费公开 Web 接口，可能随时变动、限流或失效；面板会优雅降级并显示错误信息。
- 不构成投资建议。 数据仅供学习研究，任何交易决策请以券商数据为准。
- 美股没有分时（腾讯免费接口不提供美股盘中），K线为日级及以上。
💬 常见问题（FAQ）
Q: 需要申请 API Key 吗？
A: 完全不需要。所有行情数据来自腾讯财经免费公开接口，零配置零成本。
Q: 为什么美股没有分时图？
A: 腾讯免费接口不提供美股盘中分时数据，K线为日级及以上。这是数据源限制，非插件缺陷。
Q: 行情不更新了/显示错误怎么办？
A: 免费接口可能被限流或临时失效，面板会显示错误信息并自动重试。可点击面板底部「刷新」手动触发；若长时间异常，多为接口方限制，稍后再试。
Q: 牛来桌宠为什么有时候不喊？
A: 牛来只在你自选列表里**有标的上涨（changePct > 0）**时触发，且同一波上涨有节流（网页版 1.8s，桌面版 8s + 70% 概率）。全绿/休市时它安静散步是正常行为。
Q: 自选列表存在哪里？会不会丢？
A: 存在浏览器 localStorage（dshq.lists.cn/us），刷新页面、重启浏览器都会保留。清除浏览器站点数据才会清空。
Q: 气泡/牛挡住界面了怎么办？
A: 面板可按住标题栏拖走（位置记忆）；牛来在网页版里浮于页面底部，看板内点「🐂 关掉牛」即可关闭。
Q: 支持哪些浏览器？
A: 任意现代浏览器（Chrome / Edge / 夸克 / Firefox / Safari）及 Android WebView；面板支持触摸拖动。
🤝 贡献
欢迎 PR 与 Issue！小贴士：
- 代码风格：ESLint 默认 + 2 空格缩进；
lib/ 为宿主与客户端源码，desktop-pet/ 为独立 Electron 应用
- 提交前跑一遍检查：
pnpm check（或 npm run check）
- 数据源、兼容性、免责声明相关改动请在 PR 描述里注明验证环境
- 中文交流友好：Issue 可以用中文写
🗺 路线图（Roadmap）
⚙️ 兼容性
- dsh web（服务端：Node ≥ 20，依赖 dsh 核心自带的
webServer 服务）
- 浏览器端：任意现代浏览器 / Android WebView（面板支持触摸拖动）
- 已在 Linux、Windows 部署上实测
🛠 开发
pnpm check # 对 host 与 client 源码做语法检查
📄 许可证
MIT © 2026 dsh-quote-panel contributors
