韭菜盒子 LeekBox · A股看盘助手（DeepSeek Harness 插件）

English | 简体中文

韭菜盒子 LeekBox — A股看盘助手 · DeepSeek Harness (DSH) 插件：实时行情、分时与K线、自选股盈亏与预警、技术信号选股、涨停情绪、龙虎榜、AI 分析

韭菜盒子（LeekBox）是一个 A 股实时行情看板，形态是 DeepSeek Harness（DSH）的 Web 客户端插件：装好后 DSH 左侧边栏多出一个 🥬 入口，点开就是行情面板——实时行情与大盘指数、分时图与前复权 K 线、自选股（持仓成本 / 实时盈亏 / 价格预警）、技术信号选股、涨停情绪温度计与龙虎榜、7×24 三源聚合快讯、以及可自带模型的 AI 个股分析。全部请求由插件服务端在本机代理，浏览器同源访问 /api/leekbox/*，只监听 loopback。

如果你在找「DeepSeek Harness / DSH 的 A 股插件」「开源 A 股看盘面板」「自选股 + 价格预警 + 选股器」「涨停 / 龙虎榜 / 情绪温度计」，这个仓库就是它。数据来自腾讯财经、东方财富、新浪财经、金十数据的公开接口，开箱即用、不需要任何 API key（AI 分析除外，模型密钥由你自己配置）。

这是什么

一个开源、可自托管、嵌在你自己的 AI 工作台里的 A 股看盘工具。和同花顺 / 东方财富客户端的区别不是行情深度，而是形态：它不是一个独立 App，而是 DSH 面板里的一个标签页集群——看盘、选股、快讯、AI 分析在同一个窗口里，代码全部开放，数据链路可审计（每个上游都能在 lib/ 里找到对应的适配器）。

面向 A 股：沪深京 A 股、ETF / 场内基金、可转债、LOF；不含港股、美股、期货。
行情实时：交易时段内 30~60 秒自动刷新，非交易时段不发请求（见交易时段与交易日历）。
零配置起步：免费公开行情接口，装完就能用；只有 AI 分析需要你自己填模型密钥。
纯本机：服务端路由随 DSH 进程运行，只监听 127.0.0.1，密钥只落盘在服务端、界面只显示脱敏值。

功能亮点

📈 实时行情与大盘指数 — 上证 / 深成 / 创业板 / 科创50，15 项实时指标；个股详情弹窗带当日分时图、日/周/月/5分/30分前复权 K 线（MA5/10/20 + 成交量 + 十字光标）、主力资金流向柱状图、F10 财务摘要。
⭐ 自选股 + 持仓盈亏 + 价格预警 — 分组管理，按持仓成本实时计算浮动盈亏与收益率；行内设置「涨到 / 跌破 / 涨跌幅达到」阈值，交易时段自动盯盘，触发后 toast + 浏览器通知 + 蜂鸣。
🔍 选股器 — 两种模式：13 项技术信号加权评分排序，以及 7 个预设策略的并行交集（交叉选股）；信号定义集中在服务端，界面按元数据自动渲染。
🌡️ 涨停情绪温度计 — 市场宽度 / 涨停强度 / 封板率 / 连板高度加权成 0~100 分，配连板梯队、炸板率、涨跌家数、涨停池明细。
🐉 龙虎榜 — 按日期回溯到最近一个已发布的交易日，不把"当天还没发布"伪装成"没有数据"。
📰 7×24 快讯 — 新浪 / 东财 / 金十三源聚合，跨源去重（同一事件措辞不同也合并），重要资讯高亮，可点相关股票直达详情。
🤖 AI 个股分析 — 服务端汇总实时行情 + 近 60 日 K 线 + F10 财务后送模型，输出结构化中文分析（含风险提示）；支持 DeepSeek / OpenAI / Anthropic Claude / Moonshot Kimi / 智谱 / 通义等服务商。
🔎 毫秒级全市场搜索 — 约 8 千只标的的本地索引，代码 / 名称 / 拼音首字母匹配，结果卡带实时价格。

快速开始

# 1) 拿代码
git clone https://github.com/SuCriss/dsh-leekbox.git

# 2) 链进 web profile 的 node_modules
#    Windows
mklink /J "%DSH_HOME%\profiles\web\node_modules\dsh-leekbox" "<仓库路径>"
#    macOS / Linux
ln -s "<仓库路径>" "$DSH_HOME/profiles/web/node_modules/dsh-leekbox"

# 3) 在 $DSH_HOME/profiles/web/cordis.patch.yml 追加一行注册：
#    - insert:
#        - id: leekbox
#          name: 'dsh-leekbox'

# 4) profile watcher 约 1 秒内热重组合；刷新浏览器，侧边栏出现 🥬

细节与常见坑见安装。要求 DSH ≥ 0.1.1-rc.1、web profile。

六个标签页

Tab	功能
📊 大盘	上证 / 深成 / 创业板 / 科创50 实时指数，30 秒自动刷新；顶部市场情绪温度计——半圆分段仪表盘呈现综合情绪温度 0~100°（市场宽度 40% + 涨停强度 25% + 封板率 20% + 连板高度 15%，数据缺失自动按剩余权重归一），冰点→沸腾五档弧段当前档位高亮、游标点平滑转动，右侧无框数据行：涨跌家数（红绿占比微条）/ 涨跌停 / 炸板 / 封板率 / 最高板
💹 行情	股票/ETF/转债/LOF 搜索（代码/名称/拼音首字母，本地索引毫秒级返回，带实时价格涨幅的下拉结果卡）+ 多池榜单（沪深A股/主板/非主板/ETF·场内基金/可转债/LOF，按涨幅/成交额/换手/主力净流入）+ 板块榜 + 龙虎榜
⭐ 自选	自选股实时行情（持久化在 `$DSH_HOME/.leekbox-watchlist.json`），支持分组、持仓成本与实时盈亏（点击持仓/成本单元格内联编辑，按现价实时计算浮动盈亏额 + 收益率 + 汇总条）、价格预警（🔔 行内按钮设置价格涨到/跌破、涨跌幅达到；交易时段自动盯盘，触发后 toast + 浏览器通知 + 蜂鸣并自动移除，持久化在 `$DSH_HOME/.leekbox-alerts.json`）、一键 JSON 备份 / CSV 导出（含持仓字段）、从 JSON/CSV/文本导入（合并或覆盖）
🔍 选股	两种模式：评分选股（按价格/涨跌幅/换手率筛选 + 13 项技术信号勾选 + 加权评分排序）和多策略交叉选股（7 个预设策略的并行交集，个股需同时命中多个策略，按命中数排序）
📰 快讯	新浪 / 东财 / 金十三源聚合 7×24 快讯，来源可筛选，重要资讯红色高亮，60 秒自动刷新，可点相关股票直达详情
🤖 分析	AI 个股分析：搜索选股后由服务端汇总实时行情 + 近 60 日 K 线概览 + F10 财务摘要，调模型生成结构化中文分析（含风险提示与免责声明，支持复制 / 重新生成）。模型在面板头部 ⚙️ 全局设置里配置：多服务商下拉（DeepSeek / OpenAI / Anthropic Claude / Moonshot Kimi / 智谱 / 通义 / b.ai 等；OpenAI 兼容 + Anthropic 原生两种协议）+ 模型下拉（可一键「获取模型」拉取真实列表，也可手填），持久化在 `$DSH_HOME/.leekbox-analysis.json`，密钥仅服务端保存、界面只显示脱敏值

行情页顶部保留连板梯队（2板/3板/…及最高板数），可展开涨停池列表（点击直达个股详情）。

点击任意股票（自选里点股票名称即可）会弹出独立的个股详情窗口（类似同花顺）：大字现价 + 涨跌、15 项实时指标、当日分时图（价格线 + 成交量加权均价线 + 成交量 + 昨收基准 + 相对涨跌幅纵轴，悬停浮窗）、日/周/月/5分/30分 K 线（前复权，蜡烛图 + MA5/10/20 均线 + 成交量 + 十字光标）、主力资金流向柱状图（最近 15 日，流入红/流出绿，悬停显示当日净流入额）+ 资金流分明细表、F10 财务摘要（最近 8 个报告期：营收/归母净利+同比、ROE、毛利率、负债率、EPS，东财 F10 数据源），一键加自选。详情窗口可拖动、可同时打开多个，ESC 或点击遮罩逐层关闭。

数据源

实时行情 / 指数 / 分时 / K线：腾讯财经（qt.gtimg.cn / web.ifzq.gtimg.cn / ifzq.gtimg.cn）
F10 财务摘要：东方财富 F10 报表（datacenter.eastmoney.com，双主机回退）
榜单 / 选股：东方财富（push2.eastmoney.com，多镜像自动回退）
搜索：本地全市场索引（东方财富 push2 clist 快照，约 8 千只标的，缓存 6 小时）+ 腾讯 smartbox 全拼兜底 + 批量实时行情（qt.gtimg.cn）；索引未就绪时自动回退东方财富 searchadapter
7×24 快讯：新浪财经直播流（zhibo.sina.com.cn）+ 东方财富快讯（np-listapi.eastmoney.com）+ 金十数据（jin10.com）；重要资讯 = 各源官方标记（金十星标 / 新浪焦点）+ 关键词兜底（突发/重磅/重大/紧急/超预期）；跨源自动去重——同一事件多家源措辞不同（截断/扩写/换措辞）也按归一化文本 + 10 分钟时间窗内相似度合并为一条，保留信息最全的副本
AI 个股分析：模型由用户自行配置（OpenAI 兼容接口，如 OpenAI / DeepSeek 等），个股数据复用上面的行情 / K线 / F10 源汇总后送入模型；调用走服务端 /chat/completions 代理，密钥明文只在服务端落盘、绝不下发浏览器

所有数据由插件服务端（web profile 内的 cordis 插件）代理抓取并标准化，浏览器端同源调用 /api/leekbox/*，仅限本机 loopback 访问。数据仅供研究参考，不构成投资建议。

交易时段与交易日历

交易日不是"周一到周五"——国庆/春节这类工作日假期要靠真实日历才判得对。插件不从零维护节假日表，而是用指数日 K 的日期序列反推交易日（节假日没有 K 线），缓存 12 小时：

服务端 lib/calendar.js 提供 sessionState()：preOpen / auction（9:15–9:25）/ open / lunch / closed / weekend / holiday，时刻一律按东八区判定（宿主机时区不参与）。GET /api/leekbox/calendar 下发交易日列表，/health、/sentiment 顺带回带时段摘要。首次请求不阻塞：先用"工作日"启发式回答并标注 source: weekday-fallback，后台把真日历建好后再切换，拿不到就永远如实标注是兜底。
客户端据此判定两件事：面板顶部标签（盘前 / 集合竞价 / 交易中 / 午间休市 / 已收盘 / 休市）与要不要轮询——非交易时段与页面不可见时都不再发请求，回到前台立刻补一次。此前国庆假期会显示"交易中"并整天重复打上游。
非交易时段上游数据不再变化，服务端缓存 TTL 自动放宽（sessionTtl，默认 ×20），进一步压低节假日与盘后的无效请求。
日 K 的右边界：日线只包含"已经出现过"的交易日，今天那根要到集合竞价前后才出现——所以"今天不在交易日集合里"绝不能被当成"今天休市"（否则任何交易日的白天都会显示休市）。现在的判定顺序是：今天有日线 → 交易日；日期落在日线覆盖窗口 [from, to] 内却没有那根 → 确定休市；今天在窗口右侧 → 再用 5 分钟线探测"今天有没有分时"，探到 → 交易日，探不到且已过 09:35 → 休市，其余（盘前 / 探测失败）→ 标 provisional 并退回工作日启发式。日历跨到新的一天会无条件重建，早盘窗口内 90 秒重探一次，拿到当天日线后立刻回到 12 小时长 TTL。

上游请求治理

榜单 / 行情 / 板块 / 快讯这些最热的路由此前每次请求都直打上游，而客户端是 15~60s 轮询、多开详情窗还会并发同码请求——重复请求不只是浪费，它会主动触发东财按出口 IP 的限流。现在统一走 lib/route-cache.js：

TTL 缓存 + 单飞（in-flight 去重）：同一 key 的并发请求共享一个上游调用，缓存挡不住的正是这一层。
stale-if-error：上游抖动时返回上次成功的数据（有的路由保留 10 分钟、历史 K 线 30 分钟、F10 24 小时），而不是把整页 502 糊到用户脸上。前提语义不变——只在拿到真实数据后写入，绝不缓存"空快照"。
时段感知 TTL：配合上面的交易日历，盘后/节假日自动放宽。
观测出口：GET /api/leekbox/metrics（版本 / uptime / 时段 / 索引状态 / 各缓存命中率、淘汰数、stale 服务次数），/health 也带上同一份缓存统计。
涨停池与涨跌家数任一不可用时，/sentiment 按缺失渲染而不是整卡失败（响应带 partial: true）。

写接口的跨站防护

回环栅栏只看 socket 地址与 Host 头，挡不住浏览器发起的跨站请求：恶意页面用 fetch(..., {mode:"no-cors"}) 打本机端口时 Host 照样是 127.0.0.1，响应虽然读不到，但写操作已经生效。所以所有写路由额外要求：

Origin 缺失或指向本机才放行（Origin: null、其他站点一律 403）；
Content-Type 必须是 application/json（否则 415）——跨站 no-cors 的字符串 body 默认是 text/plain，这一条把它彻底堵死。

龙虎榜的日期语义

GET /api/leekbox/longhu?date=YYYY-MM-DD 里的 date 是回溯起点，不是"必须是这一天"：

当天的龙虎榜要等收盘后晚间才发布，所以盘中、周末、节假日请求当天必然为空。服务端从 date 起往前找最近一个有榜的交易日（周末直接跳过——周末不可能有榜），响应同时回带 requestedDate（你要的）和 date（实际显示的）。界面上两者不同时会写明"该日尚未发布，已回溯到最近交易日"。
只往过去回溯：起点之后即使有数据也不取用。往前找会把未来日期的榜单当成用户请求的那天。
日期格式非法（如 2026-02-30、2026-13-01、20261009）直接 400，不会悄悄换成今天——静默返回另一天的数据比报错更糟。
整个回溯有 15s 总预算，避免"多天 × 多轮 × 多 host"把一次请求拖到几分钟。

出错了要说得出来

这个项目里最隐蔽的一类缺陷是静默失败：不抛异常、不报错，只是悄悄给出错误结果或悄悄什么都不做。约定如下：

用户主动点击的操作（加/移自选、改分组、删预警等）失败必须提示，统一走 notifyFailure(what)（和价格预警同一条 toast 通道），文案形如 加入自选失败：网络连接失败，请检查网络后重试。
后台轮询 / 预热 / 可选增强信息（F10、资金流首次加载、情绪温度计等）保持安静：这类失败不该骚扰用户，页面上另有显式失败态——保留标题、显示原因、给一个"重试"按钮，而不是让整块消失。
请求失败时清掉上一次的数据，不要让旧数据留在屏幕上冒充本次结果（龙虎榜、快讯都遵循这条）。

构建产物与源码必须一致

lib/client.js 是提交进仓库的产物（宿主直接加载它，不跑构建）。CI 用"重新构建后 git diff 是否为空"判断产物是否过期。

注意一个反直觉的点：esbuild 构建失败时不会覆盖产物，所以"重建后产物哈希不变"听起来像"构建成功且幂等"，实际上也可能是"构建一直在报错，产物还是上一次的旧文件"。因此除了产物新鲜度，client-bundle-test.mjs 还会直接检查 src/client/* 之间 15 个模块的导入/导出配对——漏掉一个 export 会让构建失败，而那条断言会带着文件名和符号名报错。

环境要求

DeepSeek Harness (DSH) ≥ 0.1.1-rc.1（声明于 package.json 的 dsh.engines.dsh）
仅运行于 web profile（dsh.client.platform: "web"）：服务端路由随宿主进程运行，浏览器端经同源 /api/leekbox/* 访问（仅限本机 loopback）
Node.js ≥ 20（仅构建产物 / 跑测试需要，宿主运行不需要单独装 node）

安装

# 1. 把包链接进 web profile 的 node_modules（或 pnpm add file:...）
mklink /J "$DSH_HOME\profiles\web\node_modules\dsh-leekbox" "<本包路径>"

# 2. 在 $DSH_HOME/profiles/web/cordis.patch.yml 追加：
# - insert:
#     - id: leekbox
#       name: 'dsh-leekbox'

# 3. profile 配置文件 watcher 会在 ~1s 内热重组合，无需重启（服务端立即生效）；
#    浏览器刷新页面后侧边栏出现 🥬 入口。
#    若修改了 lib/index.js（服务端代码），需要重启 DeepSeek Harness 进程生效。

结构

lib/index.js — 服务端 cordis 插件：/api/leekbox/* 路由 + 自选股持久化 + AI 分析（模型配置持久化与 /chat/completions 代理）
lib/calendar.js — 交易日历与交易时段（指数日 K 反推交易日，东八区时段判定）
lib/route-cache.js — 路由级 TTL 缓存 + 单飞 + stale-if-error + 观测统计
lib/search-index.js — 本地全市场搜索索引（代码/名称/拼音首字母毫秒匹配）
lib/client.js — 浏览器端 bundle：侧边栏入口 + 行情面板（React）。构建产物，勿手改——源码在 src/client/（15 个职责文件），npm run build 用 esbuild 打包生成（npm run dev 为 watch 模式）；react 由宿主注入，不进 bundle
cordis.patch.yml — 插件行注册（dsh.bundle.patch）

选股模块

选股按职责拆成 5 个文件，lib/screener.js 是对外门面（runScreener / screenerProgress / screenerMeta）：

lib/screener.js — 编排层：股票池快照、逐只拉日K、基础条件过滤、排序与进度快照
lib/indicators.js — 纯指标数学（EMA/MACD/RSI/KDJ/SMA/BOLL/上穿判定），无 I/O
lib/signals.js — 信号与策略的唯一定义处（权重、分组、文案、策略组成）+ 打分
lib/screener-cache.js — 结果缓存（LRU + 15 分钟 TTL）与日K缓存（自适应 TTL）
lib/screener-validate.js — 参数归一化 + 带 error.code 的校验异常

GET /api/leekbox/screener/meta 下发信号/策略元数据，前端据此渲染勾选面板，服务端加信号时界面自动跟随（客户端仅保留离线兜底副本）。

常见问题

这是网页版还是客户端？要单独装软件吗？ 都不是——它是 DSH（DeepSeek Harness）的插件，跑在 DSH 的 web profile 里：服务端路由在 DSH 进程内，界面是浏览器里的一个面板。所以"安装"= 把包放进 $DSH_HOME/profiles/web/node_modules + 在 cordis.patch.yml 注册一行。

需要付费行情 API 或注册账号吗？ 不需要。行情、指数、K 线、榜单、龙虎榜、快讯全部来自公开免费接口（腾讯财经 / 东方财富 / 新浪财经 / 金十数据）。唯一需要你自备凭据的是 AI 个股分析里的模型密钥。

行情有多实时？ 交易时段内按 30~60 秒轮询（各标签页不同），盘中开着的详情窗口跟着刷新；非交易时段、页面在后台时不发请求，回到前台立刻补一次。

支持港股、美股、期货吗？ 不支持，只做 A 股：沪深京股票、ETF / 场内基金、可转债、LOF。

我的自选股和密钥会上传到你的服务器吗？ 不会。所有路由只监听 127.0.0.1，浏览器同源访问；自选股 / 持仓 / 预警 / 模型配置都落盘在 $DSH_HOME/.leekbox-*.json，模型密钥只存在服务端、界面只显示脱敏值。

为什么有时右上角显示「休市」？ 那是交易日历在说"今天不开市"——可能是周末、法定假期（含调休），也可能是当天还没开盘。日历用指数日 K 反推，配合分时探测区分"今天休市"和"今天的日线还没出"，细节见交易时段与交易日历。

选股是怎么算的？会不会是随机推荐？ 不是。13 项技术信号（均线、MACD、RSI、KDJ、BOLL、放量、上穿等）由日 K 现算并加权评分；多策略模式是 7 个预设策略的并行交集，个股需同时命中多个策略才入选，按命中数排序。所有信号与权重的唯一定义在 lib/signals.js，可审计、可改。

和同花顺 / 东方财富客户端比，差在哪？ 差在数据深度（没有 Level-2、逐笔、财报全库）与交易下单；强在形态与开放性——嵌在你的 AI 工作台里、代码全开源、数据链路可查、可以自己改信号和权重。

免责声明

本插件仅聚合公开免费行情接口，数据可能有延迟或缺失；所有内容仅供学习研究，不构成任何投资建议。股市有风险，入市需谨慎。

dsh-leekbox

Instalar

README