行情终端 linhut/dsh-stock-terminal

📈 dsh-stock-terminal · 股市行情皮肤 + 功能插件

DSH Web GUI（DeepSeek Harness）行情皮肤与功能插件：全局交易终端视觉 + 实时行情面板。
自选跑马灯、首字母模糊搜索、持仓盈亏管理，A股 / 港股 / 美股 / 指数 / 加密 / 外汇一站式盯盘。

License
Platform
Version
CI
awesome-dsh-plugin

✨ 功能亮点

| 能力 | 说明 |
| 🎨 交易终端皮肤 | 顶栏 K 线品牌图标 + 标题 + 持仓摘要芯片 + 设置齿轮 + 仿终端窗口按钮；红涨绿跌（亮/暗双主题完整 CSS 变量切换）；自定义 K 线 favicon 和页面标题 |
| 📢 实时行情跑马灯 | 自选列表无缝循环滚动，hover 暂停；点击任一品种弹出个股 K 线图（日K/周K/月K 可切换） |
| 📈 个股 K 线弹窗 | 日K / 周K / 月K 一键切换；鼠标滚轮缩放（锚点缩放，20~200 根）+ 拖拽平移查看历史/近期；十字光标（hover 竖线+横线 + OHLC 浮层 + 价格轴/日期轴联动标注）；蜡烛图 + MA5/MA10 均线 + 成交量幅图 + 价格/日期轴 + 网格 + 区间涨跌统计；Esc/遮罩/✕ 关闭；窗口 resize 自适应重绘；A股/港股/指数走腾讯前复权，美股腾讯不足时回退 Yahoo，加密货币走 Binance；服务端 60s 缓存 + 在途去重 |
| 🧭 自选列表 | 增删 / ↑↓ 排序 / 移除；拼音首字母 + 代码 + 名称模糊搜索联想（如 gzmt → 贵州茅台、600519、茅台），内置 130+ 品种词典 + 在线 API 兜底，键盘 ↑↓ Enter Esc 操作 |
| 💼 持仓管理 | 模糊搜索添加持仓（与自选同款联想体验）；代码 + 数量 + 成本价 → 现价 / 市值 / 浮动盈亏 / 盈亏率，底部汇总总市值 / 总盈亏 / 总盈亏率；编辑 / 删除持仓 |
| 🔔 持仓盯盘提醒 | 每个持仓可设「盯盘高价 / 盯盘低价」（≥高价触发涨提醒、≤低价触发跌提醒），一次预警后标记已触发可手动重置重新武装；持仓行🔔快捷设置 + 表单字段双入口；状态栏实时显示激活盯盘数；触发时页面 Toast + 浏览器桌面通知（Notification API）双重提醒，首次设置时自动请求授权 |
| 🏷 标题栏持仓摘要 | 持仓个股名称 + 涨跌幅按标题栏宽度自适应显示，超宽时自动收起为「等 N 只」+ 总盈亏芯片；窗口 resize 重新适配 |
| 📏 伸缩条 | 拖动面板顶部伸缩条调整面板高度（替代 CSS resize 右下角把手），高度持久化到 localStorage |
| ⏱ 交易时段 | 状态栏实时显示 A股 / 港股 / 美股 盘中·午休·盘前·休市，每分钟自动刷新（Intl.DateTimeFormat 按 Asia/Shanghai、Asia/Hong_Kong、America/New_York 判定） |
| 📊 指数快照 | 状态栏中部实时快照：上证 / 深成 / 创业板 / 恒指 / 道指 / 纳指 |
| 🔔 状态栏总盈亏 | 状态栏右侧显示持仓总盈亏 / 总盈亏率，随行情实时更新 |
| ⚙ 三入口设置 | 状态栏「行情」按钮 + 标题栏齿轮 + 面板内「设置」页签；DSH 系统设置侧边栏出现独立「股市行情」分区（可管理刷新间隔 / 跑马灯开关 / 自选 / 持仓） |
| 🔄 刷新间隔可调 | 15 / 30 / 60 秒可调（系统设置卡与面板内设置同步），页面隐藏时暂停轮询、回到前台立即刷新 |
| 🗃 数据持久化 | 自选 / 持仓 / 面板高度 / 刷新间隔 / 跑马灯开关 全部存浏览器 localStorage，重开不丢 |
| 🌙 亮暗双主题 | 完整跟随 DSH 深色/浅色主题，全套 CSS 变量切换，跑马灯 / K 线 / 面板 / 状态栏所有元素适配 |
| 🛡 故障容错 | 全部数据源失败 toast 一次性提示并自动重试；代理失败自动降级浏览器直连；宿主 apply 全部 try/catch 容错，模块零第三方依赖，坏也只影响自身功能，不影响 DSH 本体 |

📦 安装

本插件为 DSH Web GUI 外部插件，支持以下三种安装方式。

方式一：CLI 一键安装（推荐 ⭐）

DSH 自带 dsh plugin 命令（对 pnpm 的封装），会自动完成依赖安装 + bundle 注册：

dsh plugin --profile web add github:linhut/dsh-stock-terminal

执行后你会看到类似输出：

dependencies:
+ @linxin666/dsh-client-ui-skin-stock github:linhut/dsh-stock-terminal
使用 pnpm v11.22.0 在 8.3 秒内完成

它自动做了三件事：

1. 安装依赖 → 写入 ~/.dsh/profiles/web/package.json 的 dependencies
2. 注册 bundle → 把 @linxin666/dsh-client-ui-skin-stock 追加进 dsh.profile.bundles（与 dsh-web-ui-all、modlens 同队列）
3. 文件就位 → node_modules/@linxin666/dsh-client-ui-skin-stock/ 下 lib/skin.json/patch 齐全

然后重启 dsh web 使 bundle 加载生效：

找到当前 dsh web 进程 PID 杀掉后重新启动重启：dsh web（或 node /lib/bin.js web）

常见问题
- 提示 allowBuilds / Ignored build scripts → 把 @linxin666/dsh-client-ui-skin-stock 加入 ~/.dsh/profiles/web/pnpm-workspace.yaml 的 allowBuilds 列表后重跑该命令
- dsh plugin 命令不存在 → DSH 版本过旧，升级至 0.1.0-rc.6 或更新
- 已安装过旧版本想更新 → dsh plugin --profile web update @linxin666/dsh-client-ui-skin-stock

方式二：手动安装

适合离线环境 / 二次开发调试：

① 编辑 ~/.dsh/cordis.patch.yml（home 层补丁，只写这一处，勿在多层重复写同一 id）：

- insert:
- id: ui-skin-stock
name: '@linxin666/dsh-client-ui-skin-stock'

② 把仓库复制到 profile 的 node_modules：

git clone https://github.com/linhut/dsh-stock-terminal.git \
~/.dsh/profiles/web/node_modules/@linxin666/dsh-client-ui-skin-stock

③ 重启 dsh web（见方式一的重启说明），刷新浏览器即可。

方式三：插件市场安装

DSH 官方插件市场（dsh-market）的插件目录来自 awesome-dsh-plugin 精选列表（线上 https://awesome-dsh-plugin.com/plugins.json 实时生成）。

本插件已提交收录 PR #1766，合并后（通常 1 天内）即可在 设置 → 插件市场 搜索 stock 一键安装。

⚠️ 注意（2026-08-19）：@linxin666/dsh-client-ui-skin-stock 已从 npm registry 下架（E404）。
方式一 / 方式三 不再可用（install 会失败并可能损坏依赖树）；请改用方式四 本地安装，或使用方式二手动安装。

方式四：本地一键安装（推荐 ⭐ 2026-08-19 起）

包已下架后，推荐使用仓库内置的本地安装脚本——完全绕过 npm registry，直接文件拷贝 + 写入 patch，绝不触发 install（避免上次事故的依赖树残缺问题）：

node tools/install-local.mjs

脚本自动完成：

1. 校验源目录完整性（lib/client.js / lib/index.js / skin.json / package.json / screenshots.json / assets/screenshot.png 必须齐全）
2. 拷贝文件（lib / skin.json / package.json / cordis.patch.yml / screenshots.json / assets）到 ~/.dsh/profiles/web/node_modules/@linxin666/dsh-client-ui-skin-stock/
3. 写入 patch到 ~/.dsh/cordis.patch.yml（幂等，重复运行不产生重复条目）
4. 校验安装副本：逐文件对比源目录与目标目录的文件名 + 字节数

参数：

指定 profile
node tools/install-local.mjs --profile C:\Users\xxx\.dsh\profiles\web

卸载（删除文件与 patch 条目，保留浏览器本地数据）
node tools/install-local.mjs --dispose

首次接线后需重启 dsh web 生效；之后更新文件无需重启（刷新浏览器即可）。

安装后

1. 重启 dsh web（杀进程重新启动，或 Ctrl+C 后重跑启动命令）
2. 刷新浏览器（Ctrl+F5 硬刷新清除缓存）
3. 应看到股市主题的标题栏，底部状态栏出现「行情」按钮
4. 点击「行情」打开面板 → 添加自选股开始使用

卸载

CLI 方式安装的
dsh plugin --profile web remove @linxin666/dsh-client-ui-skin-stock

手动方式安装的，删除 home 补丁行编辑 ~/.dsh/cordis.patch.yml，删掉 ui-skin-stock 那一块 insert，保存

重启 dsh web 生效

卸载不影响 DSH 本体运行。宿主 apply 全部 try/catch 容错，模块零第三方依赖，坏也只影响自身功能。
回退到旧版本：dsh plugin --profile web install @linxin666/dsh-client-ui-skin-stock@ 或手动切换 git tag。

🎯 数据源与符号语法

| 语法 | 示例 | 含义 | 数据源 |
| sh + 6 位 | sh600519 贵州茅台 | 沪市 A 股 / 上证指数 | 腾讯行情 |
| sz + 6 位 | sz000001 平安银行 · sz399001 深证成指 | 深市 | 腾讯行情 |
| hk + 5 位 | hk00700 腾讯控股 · hkHSI 恒生指数 | 港股 / 恒指 | 腾讯行情 |
| us + 代码 | usAAPL 苹果 · usDJI 道指 · usIXIC 纳指 | 美股 / 美指 | 腾讯行情 |
| 大写组合 | BTCUSDT ETHUSDT… | 加密货币（24h） | Binance |
| AAA/BBB | USD/CNY | 外汇（美元等基准） | Frankfurter |

数据由宿主端聚合代理统一拉取（/plugins/dsh-stock/api/quotes，GBK 解码、超时降级），浏览器零 CORS；代理不可用时自动降级为浏览器直连。

🔍 搜索联想

支持以下方式模糊匹配（取前 8 条）：

- 拼音首字母：gzmt → 贵州茅台、csbm → 常山北明、zsyh → 招商银行
- 代码：600519、000158、AAPL、BTC…
- 名称：茅台、苹果、比亚迪…（中英文子串）

内置 130+ 常用品种词典秒出结果；词典未收录的品种自动走在线兜底——宿主代理新浪股票建议 API（/plugins/dsh-stock/api/suggest，GBK 解码、300ms 防抖），任意 A股 / 港股 / 美股 / 指数输入代码、简称或拼音首字母即可联想。

键盘 ↑↓ 选择、Enter 添加、Esc 关闭。

📁 项目结构

dsh-stock-terminal/
├── lib/
│ ├── index.js # 宿主端：行情聚合代理 /plugins/dsh-stock/api/quotes + /suggest + /kline │ └── client.js # 浏览器端：皮肤 chrome + 行情面板（自选/持仓/设置）+ K 线弹窗 + 系统设置卡 ├── skin.json # 皮肤注册元数据（id: stock，wiring: ui-skin-stock） ├── package.json # DSH 插件包清单（dsh.client / dsh.bundle 元数据） ├── cordis.patch.yml # 插件接线 ├── assets/ │ └── screenshot.png ├── screenshots.json # dsh-market 截图声明（指向 assets/screenshot.png） ├── tools/ │ ├── install-local.mjs # 本地一键安装（绕过 npm registry） │ ├── check-dsh-compliance.mjs # DSH 规范合规检查（见下方「合规检查」） │ └── verify-pack.mjs # prepare/verify 产物自检（语法 + 白名单） ├── .github/workflows/ci.yml # CI：合规 + 自检 + 单测 + pack dry-run ├── CHANGELOG.md # 版本变更记录（Keep a Changelog 格式） └── README.md

仓库只同步必要性源代码与发布文件；tests/ 与依赖锁文件仅留在本地开发环境（.gitignore 排除），不纳入版本库。

⚙️ 集成方式

两种接线机制

| 方式 | 注册位置 | 适用场景 |
| profile bundle（CLI 安装自动） | ~/.dsh/profiles/web/package.json → dsh.profile.bundles | 推荐；与 dsh-web-ui-all、modlens 同队列 |
| home patch（手动安装） | ~/.dsh/cordis.patch.yml → insert | 离线 / 二次开发 |

⚠️ 重要注意事项

- 切勿把同一 insert 同时写进 profile patch 与 home patch —— 两层叠加会产生重复 loader entry id，触发 DSH fail-loud 启动保护（曾因此导致 web 无法启动）
- 皮肤中心（dsh-client-ui-skin-center）可识别本皮肤（skin.json 位于 node_modules/@linxin666/ 下）；其切换皮肤时可能将本行视为 legacy 皮肤行移除，重加该行即可（CLI 方式装的 bundle 不受此影响）
- DSH 系统设置侧边栏出现独立「股市行情」分区 —— 可管理刷新间隔、自选列表、持仓信息，与面板内数据双向同步（同一份 localStorage 读写）

🛠 技术要点

- 红涨绿跌配色：up #e02e3d / dark #f23645，down #089981，平灰；深色主题整套 CSS 变量切换
- Intl.DateTimeFormat 按 Asia/Shanghai、Asia/Hong_Kong、America/New_York 实时判定交易时段
- 数据轮询 30s（可调 15/30/60s），ctx.effect 一次性收回所有 DOM / 定时器
- 客户端形态：window.__ModuleLoader__.load({ id, factory })，exports.apply + exports.inject（slots / settingsScope），设置卡走 slots.inject("settings.section")
- Canvas 蜡烛图绘制：日K/周K/月K 自适应、MA5/MA10 均线、成交量幅图、网格+价格+日期轴

🛡 可靠性设计
- 宿主端短 TTL 缓存 + 在途请求去重：quotes 5s / suggest 30s / kline 60s 缓存，并发同参数请求共享同一次上游拉取（上限 128 条防无界增长）
- 符号规范化：SH600519 等大写市场前缀自动转小写（外汇对 USD/CNY 保持原样）
- 轮询调度：setTimeout 链式调度（上一次完成再排下一次）+ 在途请求守卫；页面隐藏时暂停轮询，回到前台立即刷新
- 跑马灯不闪跳：行情刷新只原地更新数字，不重建 DOM，动画位置不被重置
- 联想防竞态：搜索建议加序号计数器，慢的旧请求不会覆盖新输入的结果
- 故障降级提示：全部数据源失败时 toast 一次性提示并自动重试；代理失败自动降级浏览器直连
- 设置双向即时生效：系统设置卡修改刷新间隔/跑马灯后，面板轮询与跑马灯立即重排（自定义事件同步）
- K 线周期自适应：服务端原生支持 day/week/month（腾讯 fqkline / Binance / Yahoo）；客户端聚合 fallback 确保不重启也能用
- 最新 DSH API 兼容：服务器设置接入采用 ctx.inject(["settings"]) + ctx.settings.installSection（dsh-settings ≥ 0.1.0-rc.x 官方新 API，已移除的 installSettingsSection/settingsNamespace 不再使用）；客户端设置卡走 slots + settingsScope 服务，两侧均为当前官方接线
- DSH 规范合规：官方 harness 运行时包按规则声明（@deepseek-ai/schemastery 进 dependencies、客户端 react 进 peerDependencies），皮肤元数据与 bundle 接线一致（skin.json bundleWired: true），文本文件一律 UTF-8 无 BOM（显式 readFileSync(path, "utf8")，规避 Windows 默认 GBK 解码乱码）
- 防御式边界：quotes 最多 200 个符号、kline count 20–320、suggest key 1–50、分时点数上限 480；全部路由同源护栏（跨站 403）+ 8s 超时 + 失败独立降级

✅ 合规检查

按最新 DSH 要求与规则（awesome-dsh-plugin 收录审核 Checklist + DeepSeek Harness 官方文档 + skin-center 接线规则）自动校验插件元数据与内部逻辑：

npm run check:compliance # 等价 node tools/check-dsh-compliance.mjs
node tools/check-dsh-compliance.mjs --fix # 自动修复可修复项
node tools/check-dsh-compliance.mjs --quiet # 只输出 FAIL

检查项（21 项，逐项独立上报，失败退出码 1）：

| 检查项 | 依据 |
| pkg.manifest / pkg.bundle-patch-exists | dsh.bundle.patch 必须声明且指向存在的文件（只声明 dsh.client 不可安装） |
| pkg.client | 带 UI 时 platform 应为 web |
| pkg.imports | 静态扫描 lib/.js 的 import/require（react 子路径归并），未声明依赖会被报出 |
| pkg.peer-deps:harness | 官方 harness 运行时包（@deepseek-ai/dsh-）必须 peerDependencies 且范围带显式预发布分支 |
| pkg.peer-deps:react | 客户端 bundle require("react") → peerDependencies 须声明 react（skin-center 约定） |
| pkg.client-inject | 客户端 exports.inject 服务（slots/settingsScope）与 dsh.client.inject 提供方 bundle 两侧一致 |
| pkg.prepare | prepare 脚本存在（git 源安装不构建 → 必须有自检；本仓库为 verify-pack.mjs） |
| pkg.files-cover-screenshots | files 白名单覆盖 screenshots.json 引用（发布包自洽） |
| pkg.settings-api-current | 服务器 settings 必须用 ctx.inject(["settings"]) + installSection（旧 API 已移除） |
| pkg.config-schema | 服务器导出 export const Config（cordis.yml 组合配置入口） |
| patch.format / patch.unique-id | cordis.patch.yml 结构与 id 规范（ui-skin-）、无重复 id |
| skin.json.meta / skin.bundleWired | id/package/wiring.id 正则（skin-center 规则）与 bundle 接线一致性 |
| screenshots.json | 市场截图声明：1-8 张、相对路径不出目录 |
| encoding.utf8-no-bom | 文本文件（含 SKILL.md 若存在）必须 UTF-8 无 BOM |
| sync.symbol-rules | 前后端符号分类/规范化规则一致（公共约定两侧同源） |
| input.key-trim | suggest key 校验 min/max 基于同一 trim 后的值 |
| input.minute-symbol | minute 路由与 kline 一致校验 classifySymbol（防御式公共约定） |
| ci.present | .github/workflows CI 存在（收录 Checklist：CI 证明真实可调用） |

自检与测试

npm run verify # 产物自检（prepare 等价）：必备文件 + JSON 可解析 + node --check 语法 + 白名单自洽
npm test # 开发期本地单测（tests/ 不纳入版本库，见「项目结构」说明）

各脚本读取文件一律显式 utf8，不依赖 Windows 默认编码；检查工具用 fatal 模式 TextDecoder 校验 UTF-8 合法性，防止 GBK 解码乱码导致误判。

🧩 标签 / Topics

dsh-plugin · deepseek-harness · web-ui · skin · stock · 行情 · 跑马灯 ·自选股 · 持仓 · K线 · trading-terminal · ticker

📄 License

Apache-2.0

由 linhut 维护，已提交 awesome-dsh-plugin 收录。*