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

[](LICENSE) [](#安装) [](./package.json) [](https://github.com/linhut/dsh-stock-terminal/actions/workflows/ci.yml) [](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/1766) --- ## ✨ 功能亮点 | 能力 | 说明 | | --- | --- | | 🎨 **交易终端皮肤** | 顶栏 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 注册： ```sh dsh plugin --profile web add github:linhut/dsh-stock-terminal ``` 执行后你会看到类似输出： ``` dependencies: + @linxin666/dsh-client-ui-skin-stock github:linhut/dsh-stock-terminal Done in 8.3s using pnpm v11.22.0 ``` 它自动做了三件事： 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 加载生效： ```sh # 找到当前 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）： ```yaml - insert: - id: ui-skin-stock name: '@linxin666/dsh-client-ui-skin-stock' ``` **② 把仓库复制到 profile 的 node_modules**： ```sh 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://github.com/awesome-dsh-plugin/awesome-dsh-plugin) 精选列表（线上 https://awesome-dsh-plugin.com/plugins.json 实时生成）。 本插件已提交收录 [PR #1766](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/1766)，合并后（通常 1 天内）即可在 **设置 → 插件市场** 搜索 `stock` 一键安装。 > ⚠️ **注意（2026-08-19）**：`@linxin666/dsh-client-ui-skin-stock` 已从 npm registry 下架（E404）。 > **方式一 / 方式三 不再可用**（install 会失败并可能损坏依赖树）；请改用**方式四 本地安装**，或使用方式二手动安装。 ### 方式四：本地一键安装（推荐 ⭐ 2026-08-19 起） 包已下架后，推荐使用仓库内置的本地安装脚本——**完全绕过 npm registry**，直接文件拷贝 + 写入 patch，绝不触发 install（避免上次事故的依赖树残缺问题）： ```sh 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. **校验安装副本**：逐文件对比源目录与目标目录的文件名 + 字节数 参数： ```sh # 指定 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. 点击「行情」打开面板 → 添加自选股开始使用 ### 卸载 ```sh # 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） │ ├── repair-profile.mjs # 校验并修复 profile node_modules 残缺 │ ├── check-dsh-compliance.mjs # DSH 规范合规检查（见下方「合规检查」） │ └── verify-pack.mjs # prepare/verify 产物自检（语法 + 白名单） ├── tests/ │ ├── plugin.test.js # 宿主端：真实 apply → 注册路由 → 执行 handler → 断言 │ └── client.test.js # 浏览器端：ModuleLoader 形态 + 防 XSS 基线 ├── .github/workflows/ci.yml # CI：合规 + 自检 + 单测 + pack dry-run ├── CHANGELOG.md # 版本变更记录（Keep a Changelog 格式） └── README.md ``` --- ## ⚙️ 集成方式 ### 两种接线机制 | 方式 | 注册位置 | 适用场景 | |------|----------|----------| | **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 接线规则）自动校验插件元数据与内部逻辑： ```sh 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 证明真实可调用） | ### 自检与测试 ```sh npm run verify # 产物自检（prepare 等价）：必备文件 + JSON 可解析 + node --check 语法 + 白名单自洽 npm test # node --test：宿主端 apply→路由→handler 断言 + 客户端形态/防 XSS 基线 ``` > 各脚本读取文件一律显式 `utf8`，不依赖 Windows 默认编码；检查工具用 fatal 模式 `TextDecoder` 校验 UTF-8 合法性，防止 GBK 解码乱码导致误判。 --- ## 🧩 标签 / Topics `dsh-plugin` · `deepseek-harness` · `web-ui` · `skin` · `stock` · `行情` · `跑马灯` · `自选股` · `持仓` · `K线` · `trading-terminal` · `ticker` --- ## 📄 License [Apache-2.0](LICENSE) --- *由 [linhut](https://github.com/linhut) 维护，已提交 [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) 收录。*