SuCriss/dsh-leekbox

English | 简体中文

A-share 看盘助手 —— DeepSeek Harness (DSH) Web 客户端插件。

在 DSH Web 界面的左侧边栏出现 🥬 入口，点击打开行情面板：

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 秒自动刷新，可点相关股票直达详情

行情页顶部保留连板梯队（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 分钟时间窗内相似度合并为一条，保留信息最全的副本

所有数据由插件服务端（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），进一步压低节假日与盘后的无效请求。

上游请求治理

榜单 / 行情 / 板块 / 快讯这些最热的路由此前每次请求都直打上游，而客户端是 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/* 之间 14 个模块的导入/导出配对——漏掉一个 export 会让构建失败，而那条断言会带着文件名和符号名报错。

环境要求

• DeepSeek Harness (DSH) ≥ 0.1.1-rc.1（声明于 package.json 的 dsh.engines.dsh）
• 仅运行于 web profile（dsh.client.platform: "web"）：服务端路由随宿主进程运行，浏览器端经同源 /api/leekbox/* 访问（仅限本机 loopback）

安装

# 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/* 路由 + 自选股持久化
• lib/calendar.js — 交易日历与交易时段（指数日 K 反推交易日，东八区时段判定）
• lib/route-cache.js — 路由级 TTL 缓存 + 单飞 + stale-if-error + 观测统计
• lib/search-index.js — 本地全市场搜索索引（代码/名称/拼音首字母毫秒匹配）
• lib/client.js — 浏览器端 bundle：侧边栏入口 + 行情面板（React）。构建产物，勿手改——源码在 src/client/（14 个职责文件），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 下发信号/策略元数据，前端据此渲染勾选面板，服务端加信号时界面自动跟随（客户端仅保留离线兜底副本）。

免责声明

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