dsh-plugin-stock-x

Readme

# 📈 dsh-plugin-stock-x (DeepSeek Harness 股票盯盘与量化投研插件)

<p align="center">
  <img src="https://img.shields.io/badge/DeepSeek%20Harness-Plugin-blue?style=flat-square&logo=github" alt="DSH Plugin" />
  <img src="https://img.shields.io/badge/Node.js-%3E%3D18.0.0-green?style=flat-square&logo=node.js" alt="Node.js" />
  <img src="https://img.shields.io/badge/License-MIT-amber?style=flat-square" alt="License" />
  <img src="https://img.shields.io/badge/Platform-Web%20%7C%20Standalone-purple?style=flat-square" alt="Platform" />
</p>

这是一个**纯 JavaScript / Node.js 实现、零外部运行依赖**的 **DeepSeek Harness (`dsh`) Web 宿主专属股票行情盯盘与量化投研插件**。

一键为你的 DeepSeek Harness 注入**摸鱼半透明悬浮球**、**自选股抽屉面板**、**全球 8 大核心指数实时看板**、**专业多周期 K 线/分时多窗口看板**，并深度打通 **“一键将股票投研诊断发送至 DSH 对话框进行深度分析”**，内置 **AI 文字型选股策略库**，支持自定义策略让 DeepSeek 全市场深度选股。全面采用 **可调毛玻璃主题**（模糊度/透明度滑块实时调节，深色/浅色双色调玻璃）。

---

## 📸 界面预览 (Screenshots)

<div align="center">
  <p><b>🌙 深色主题多窗口看盘工作台</b></p>
  <img src="images/dark.png" alt="深色主题看盘工作台" width="95%" />
  <br/><br/>
  <p><b>☀️ 亮色主题多窗口看盘工作台</b></p>
  <img src="images/light.png" alt="亮色主题看盘工作台" width="95%" />
</div>

---

## 🌟 核心特性

- ⚡ **纯 JS / 零外部运行依赖**：基于 Node.js 原生 API 与前端 Canvas/ECharts，无需配置 Python 环境或本地数据库。
- 🌏 **全市场实时行情**：全覆盖 **A股 (沪/深/北交所)、港股、美股与全球 8 大核心指数**。
- 🔍 **智能拼音与全市场检索**：支持拼音首字母（如 `gzmt` -> 贵州茅台）、全拼（`tengxun` -> 腾讯控股）、股票代码（`600519`, `00700`, `NVDA`）秒级搜索。
- 🔮 **摸鱼浅色磨砂悬浮球**：平时收缩为屏幕角落的精致小圆球（支持随意拖拽移动），点击瞬间平滑展开自选盯盘面板。
- ⚙️ **全局偏好与设置中心**：
  - 🌓 **视觉主题风格**：支持 `极客深色暗黑` 与 `清爽高雅亮白` 随心切换；
  - 🎨 **红绿/绿红国际化配色习惯**：支持 `🇨🇳 红涨绿跌 (A股/港股标准)` 与 `🌐 绿涨红跌 (美股/加密货币国际标准)`，图表/走势/盘口指标全量无缝换色；
  - ⏱️ **行情自动刷新频率**：支持 `2秒 (极速)` / `3秒 (标准)` / `5秒 (省流)` / `10秒` 自定义轮询；
  - 📦 **自选股数据备份与批量导入**：支持一键复制 JSON 结构化数据或纯代码列表，支持批量粘贴代码/名称一键全市场检索导入。
- 🏷️ **自选股市场分类与多维排序**：
  - 支持按 `全部` | `A股` | `港股` | `美股` | `指数` 药丸标签快速过滤；
  - 支持在 `默认排序` ➡️ `涨幅 ⬇` ➡️ `跌幅 ⬆` ➡️ `成交额 💰` 之间一键多维动态排序。
- 🧲 **AI 文字型选股策略库**：
  - 抽屉面板第四选项卡 `🧲 选股`（顺序为 `🌐 全球` ➡️ `📈 自选` ➡️ `🔥 领涨热点` ➡️ `🧲 选股`）；
  - 内置放量突破、超跌反弹、热门龙头、低位价值等文字型选股策略，全部支持编辑，亦可自定义新建策略（本地持久化）；
  - 执行时股票池范围可切换：`自选股`（附自选清单）/ `板块`（声明板块，由 AI 调用插件接口获取成分股）/ `全A`（仅发策略文本）；
  - 策略指令发送至 DSH 对话框后，由 DeepSeek 自主调用插件数据接口（K线/F10/资金流向等）深度研究并输出选股清单与理由。
- 🖥️ **股票详情窗口（左右分栏工作台）**：
  - 左侧：K线/分时多周期图表 + 主副图技术指标（MA/BOLL/EMA、VOL/MACD/RSI/KDJ），始终显示；
  - 右侧：深度投研面板堆叠区，`📊 五档盘口` / `🌊 资金流向` / `📑 F10档案` / `📰 资讯公告` / `📝 交易笔记` / `📐 AI量化诊断` 点哪个开哪个、**可多开同屏对照**，每块可单独关闭，全部关闭则右栏收起回到纯 K 线模式；
  - 打开右侧面板时窗口自动加宽，关闭后自动恢复。
- 🔥 **全市场领涨行业与概念题材热点榜**：
  - 实时抓取全市场领涨行业与热门概念题材排行（如半导体、低空经济、人形机器人等），支持板块名称本地快速过滤，支持展开查看板块内排名前 10 的领涨龙头成分股，支持一键快速加自选或开图分析；
  - 板块行内嵌 `🧲选股` 按钮，一键将该板块设为 AI 选股股票池，与「选股」选项卡无缝联动。
- 🌊 **主力资金流向与大单买卖博弈卡片**：
  - 深度解析超大单、大单、中单与小单的净流入金额与多空成交占比；
  - 提供近 5 日主力资金连续流向历史趋势表，精准洞察主力吸筹建仓与散户博弈动态。
- 📅 **5日连续分时走势图**：
  - 在分时与日K之间引入 `5日分时` 连续走势，自动绘制近 5 个交易日的连续分时价格与 VWAP 均价曲线，把握跨交易日关键趋势转折。
- 📝 **个股交易复盘笔记与分类标签体系**：
  - 为自选股自由贴上个性化彩色标签（`🔴 核心重仓`、`🟡 突破观察`、`🟢 短线打板`、`🟣 逢低低吸`、`⚪ 长期定投`），列表直观分类识别；
  - 内置个股独立复盘笔记备忘录，支持随时记录买入逻辑、止盈止损计划与复盘心得，内容本地加密存储，纯粹安全。
- 🤖 **AI 提示词多策略模板选择**：
  - AI 投研看板提供 4 大针对性策略模式（`🎯 全景投研` / `⚡ 短线攻防` / `💎 价值长线` / `🔄 做T解套`）；
  - 自动根据选定策略模式动态生成量化提示词，一键复制或直接与 DeepSeek 大模型对话。
- 📊 **五档买卖深度挂单盘口**：
  - 实时高频提取并呈现买一~买五与卖一~卖五挂单价格与手数（支持万手智能换算）；
  - 挂单价格对比昨收价动态跟随红/绿配色，支持在窗口内一键折叠/展开。
- 📈 **K线十字光标联动实时 HUD 数据栏**：
  - 图表顶部常驻量化指标状态栏，光标在历史 K 线或分时走势上移动时，实时高频跳动展示该时刻的 `开/高/低/收/涨跌幅/量/MA/BOLL/MACD/RSI/KDJ` 数值，还原 TradingView 级别的读盘手感。
- 💼 **个人模拟持仓与浮动盈亏资产看板**：
  - 支持自选股录入买入成本均价（¥）与持有股数（股）；
  - 自动实时计算单股持仓市值、浮盈金额（¥）与收益率（%）；
  - 抽屉面板顶部自动汇总呈现个人投资组合的 `总资产市值`、`今日总盈亏` 与 `累计总浮盈`。
- 🔔 **目标价格突破与异动预警通知**：
  - 支持为关注标的设置 `突破上限目标价`、`跌破止损警戒价` 或 `单日异动涨跌幅阈值`；
  - 盘中触及阈值即刻在右下角弹出高亮 Toast 预警通知，防止踩雷或错过突破买卖点。
- 💬 **深度联动 DSH 对话窗口**：
  - **走势窗口顶栏一键发送**：点击「💬 发送到聊天」，自动将当前股票行情盘口、关键点位、最新资讯/公告超链接与提问提示词填入 DSH 对话框；
  - **AI 量化诊断一键提问**：点击「⚡ 一键提问AI」，直接向 DeepSeek 发起超深度投研诊断与仓位风控咨询；
  - **自选列表快捷咨询**：自选股列表右侧内置 `💬` 按钮，一键快速向 AI 咨询该股。
- 📊 **专业多窗口时序看图**：
  - 支持分时均价线 (VWAP)、5日分时、日K、周K、月K及 5m/15m/30m/60m 分钟K线；
  - 智能周K/月K聚合引擎，确保冷门指数与跨国标的亦能顺畅看图；
  - 内置经典主图指标（MA 均线、BOLL 布林通道、EMA 指数均线）与副图指标（VOL 成交量、MACD 异同均线、RSI 相对强弱、KDJ 随机指标）；
  - 支持平铺、双屏、四分屏、层叠等多窗口智能布局与独立拖拽缩放。
- 📑 **企业 F10 档案与即时资讯**：秒级获取公司主营业务、关键财务中枢、最新公告与行业新闻（包含源链接）。

---

## 🚀 快速安装与使用指南

### 前置准备
- 安装 [Node.js](https://nodejs.org/) (`v18.0.0` 或更高版本)
- 安装 [DeepSeek Harness (`dsh`)](https://github.com/deepseek-ai)

---

### 第一步：克隆仓库并进入目录

```bash
git clone https://github.com/xuexiaolei1997/dsh-plugin-stock-x.git
cd dsh-plugin-stock-x
```

### 第二步：安装项目依赖

```bash
npm install
```

### 第三步：安装插件到 DSH Web Profile

在 `dsh-plugin-stock-x` 根目录下执行：

```bash
dsh plugin --profile web add file:.
```

> 💡 **提示**：如果使用完整绝对路径，也可以执行：
> ```bash
> dsh plugin --profile web add file:D:\你的插件目录路径\dsh-plugin-stock-x
> ```

### 第四步：启动 DeepSeek Harness Web 宿主

```bash
dsh web
```
*(或在 DSH 项目开发目录下执行 `pnpm dsh web`)*

启动后，打开浏览器访问 DSH Web 页面，右下角将出现**股票悬浮球**，点击即可开始实时盯盘！

---

## 🖥️ 独立运行模式（无需 DSH 亦可单独运行）

如果你只想作为独立的本地股票看盘工作台使用，直接在项目目录下执行：

```bash
npm start
```

启动后在浏览器打开：
- **独立看板工作台**：`http://127.0.0.1:3000`
- **网页嵌入测试 Demo**：`http://127.0.0.1:3000/demo`

---

## 🗑️ 卸载插件

如需从 DSH Web 环境卸载该插件，在终端执行：

```bash
dsh plugin --profile web remove dsh-plugin-stock-x
```

---

## 📂 项目结构

```text
dsh-plugin-stock-x/
├── index.js             # DSH/Cordis 插件服务端入口 (路由注册、提示词注入)
├── client.js            # DSH 浏览器端插件运行时 (由 build_client.js 生成，勿手改)
├── cordis.patch.yml     # DSH Bundle 插件配置 Patch
├── stock-api.js         # 全市场实时行情、时序K线聚合、F10与智能搜索核心 SDK
├── server.js            # 独立本地 Web 服务器 (npm start)
├── package.json         # 模块声明与 DSH 插件配置
├── build_client.js      # 前端构建脚本 (将 public/ 打包为 DSH 插件 client.js)
├── build_index.js       # index 构建辅助脚本
├── download_data.js     # 股票基础数据下载脚本
├── widget.js            # 独立悬浮球小组件 (网页嵌入用)
├── demo_embed.html      # 第三方网页嵌入测试 Demo
├── cmd.sh               # 常用命令快捷脚本
├── watchlist.json       # 自选股持久化数据
├── PRD.md               # 产品需求文档
├── data/                # 本地股票基础数据 (A股/港股/ETF)
├── public/              # 前端源码 (app.js, indicators.js, index.html)
├── images/              # README 界面截图
└── skills/              # 内置投研技能 (investment-research)
```

> 💡 **开发提示**：修改前端功能请编辑 `public/` 下的源文件，然后执行 `npm run build:client` 重新生成 `client.js`（同时会同步到本机 DSH Web Profile）。

---

## 📄 开源协议

本项目采用 [MIT License](LICENSE) 协议开源，欢迎 Star 与贡献代码！