Skip to content

dsh-stock-workbench

Verified

dsh-stock-workbench · v0.2.0 · MIT · Web UI

看股工作台:全 A 股今日快照、多指标排序与条件选股。A-share market workbench: today's full-market snapshot with multi-metric ranking and screening.

Install

dsh plugin add dsh-stock-workbench

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Creators

Readme

看股工作台(DSH 插件)

左侧栏一个「看股」图标 → 点击进入整页工作台:全 A 股当日快照、多指标排序、条件选股。

  • 数据源:东方财富公开行情接口(Host 侧 Node 抓取,浏览器不直连行情站)
  • 股票池:全 A 5927 个代码,其中约 5572 只可交易(355 条退市/停牌占位自动过滤)
  • 刷新:手动(点一次拉一次),Host 侧 3 秒内缓存复用;收盘后缓存放宽到 5 分钟

页面有什么

区块 内容
顶栏 数据日期、快照时间、全 A 只数、上游耗时、刷新按钮
指数卡 上证 / 深证成指 / 创业板指 / 科创50 / 北证50
市场宽度 涨/平/跌家数 + 比例条 + 涨停/跌停家数(官方口径)+ 两市成交额 + 主力净流入合计
快捷选股 涨停、放量异动、主力抢筹、高换手、大盘走强、低 PE 六个预设
技术信号扫描 右上 tab 切到「信号扫描」:先选预设组合(双金叉共振 / 突破放量 / 趋势启动),或自己勾信号(均线金叉 / MACD 金叉 / 20 日新高 / 放量上攻 / 多头排列 / 站上 60 日线)→ 选周期(日线 / 60 分 / 15 分 / 5 分)与窗口(今日 / 近 3 日 / 近 5 日)→ 设候选池(成交额门槛 + 上限)→ 扫描。命中行可双击进详情
板块资金流 第五个 tab:概念板块 / 行业板块的资金流表(主力净流入、净占比、涨跌家数),点表头排序;点击任意板块 → 拉该板块成分股(新接口 /board-members)→ 回榜单按成员代码筛选(顶部显示「板块筛选:xxx ×」可一键清除)
资金流榜 第四个 tab:全市场主力净流入/净流出 TOP 30 并排,含净占比、涨跌幅、合计与流入/流出家数(数据来自快照 f62,零额外请求)
公式选股 第五个 tab:写 量比 > 2 且 涨跌幅 between 3 and 7;也有可视化构造器(点选字段/运算符/数值 → 生成公式并执行)。字段白名单 + 手写词法/语法分析,不用 eval,解析错误返回中文提示与光标位置
公式收藏夹 「☆ 收藏当前」命名保存;点「☆ 收藏夹 (N)」右侧抽屉列出全部收藏(名称 + 公式 + 备注),点击一键套用并执行,▲▼ 排序、× 删除;抽屉底部「导入 / 导出 JSON(逐条校验)/ 恢复预置」。存在 localStorage
预置策略 15 条公开经典方法的「快照可表达」近似版:欧奈尔量价齐升、格雷厄姆低估值、海龟突破近似、超跌反抽、放量滞涨预警,以及 5 条红利策略(高股息核心 / 破净高股息 / 银行保险红利 / 现金牛 / 低波红利)。每条都带依据与数据限制说明,不是裸公式
批量导入自选 分组条右侧「⤓ 导入」弹窗:上方标签区 + 代码/名称模糊搜索(回车/点击添加)+ 一大串文本粘贴识别(空格/换行/逗号/斜杠分隔,代码或中文名均可,歧义名称不硬匹配),确认后合并进当前分组
自选股池(多分组) 榜单最左列 ☆ 单击收藏,收藏进当前分组;表格上方工具行左侧是分组条:默认/红利组/短线组…(每组显示数量),点名字切换、点 + 新建分组、多组时每组可 × 删除;快捷筛选区「只看自选 (N)」按当前分组过滤;详情页也有加入/取消自选。旧版纯数组自选自动迁移成「默认」组
自动刷新 顶栏下拉:手动 / 3 秒 / 5 秒 / 10 秒(只在该 tab 且未打开详情时跑;Host 侧仍有 3 秒缓存兜底)
个股详情 popover 详情页右上角「ⓘ 详情」按钮 → 弹出该股全部指标:交易数据、估值分位(PE/PB 近 5 年百分位,低分位绿/高分位红)、分红(股息率/年数/连续年数/最近除息)、基本面(ROE/负债率/毛利率/营收与净利同比/EPS/BVPS/PS)、所属(行业/地域板块/概念列表)
表格筛选与收起 信号 / 资金流 / 板块 / 公式结果的表格上方均有筛选框(板块按板块名);顶栏「▴ 收起上方 / ▾ 展开上方」可隐藏指数、涨跌家数、筛选区,把空间让给表格(替代原小屏媒体查询方案)
视觉精简 顶部 tab 收进「当前榜单 ▾」下拉菜单;详情页头部指标移入「ⓘ 详情」弹窗;右下角数据来源跟随当前行情源
列配置 每个 tab 的表格上方都有一小行工具行,最右侧是小齿轮「⚙」,点开配置该表的列:每行 ⋮⋮ 拖拽把手 + 复选框(显示/隐藏)+ ☆/★(固定到左侧);「保存」立即生效,「取消」丢弃,「恢复默认」回到初始列。各 tab 配置互相独立,全部持久化到 localStorage(键 column-prefs,按 list/scan/flow/formula 分组),下次进来自动恢复。星标列固定最左且不可隐藏
导出 CSV 顶栏「导出 CSV」导出当前筛选与排序后的全部行(UTF-8 BOM,Excel 直接打开不乱码;含逗号/引号转义)
导出 CSV 顶栏「导出 CSV」导出当前筛选与排序后的全部行(UTF-8 BOM,Excel 直接打开不乱码;含逗号/引号转义)
筛选器 涨跌幅区间、成交额≥、换手率区间、量比≥、振幅≥、流通市值区间、主力净流入≥、代码/名称搜索、排除 ST/科创/北交
榜单 25 列可排序(点表头),含股息率 / 分红年数 / 连续分红 / PB / PE / ROE / 负债率 / 毛利率等防御指标;点「分红年数 / 连续分红」弹出该股分红明细(近 10 年逐笔:报告期 / 除息日 / 每10股派息 / 每股派息 / 方案)。5.5k 行用行高固定的虚拟滚动,不卡;每个表格上方有一小行工具行,最右侧是小齿轮「⚙」(信号/公式的齿轮随结果表出现),点开可配置该表的列:勾选显示、★ 固定到左侧、拖拽排序(保存/取消/恢复默认);每个 tab 独立配置并持久化,下次打开还是上次的设置
个股详情 双击任意一行进入:K 线(日/周/60/30/15/5 分,前复权)+ 当日分时,MA5/10/20 均线、成交量副图、指标副图、十字光标读数;Esc 或「返回榜单」退出。返回后工作台保持原状(筛选条件、排序、滚动位置、信号/公式面板的扫描结果都还在)
指标副图 成交量下方,可切换 MACD(12,26,9)(DIF/DEA 线 + 红绿柱)/ KDJ(9,3,3) / RSI(6,12,24) / BIAS(6,12,24);带参考线(KDJ、RSI 的 20/50/80;MACD、BIAS 的 0 轴)与右侧刻度,tooltip 同步显示指标值
图表交互 滚轮缩放(以光标为锚点)、按住拖动平移、双击复位、右上 + / - / 复位 按钮;底部 dataZoom 滑条(缩略走势 + 拖窗口/拖两侧改宽度);向左拖到边界自动补历史 K 线(每次 +240 根,日线上限 2400 / 分钟 1440);Y 轴自动贴合可见区间;左下角显示可见日期区间与「可见根数 / 总根数」,补历史时显示进度

排序规则:数值列点一次降序、再点升序;无数据的行(停牌、东财未覆盖的主力资金)恒排最后。

数据口径与已知限制

  • f11 是 5 分钟涨跌幅,f109 才是 5 日涨跌幅;本插件只展示 5 日。
  • 主力净流入 f62 东财对全市场约 15% 的股票恒返回 0(北交所居多)→ 显示为 —,排序时按"无数据"排在最后,不参与 ≥ N 万 筛选。
  • 涨跌家数用自建快照统计(与榜单同口径);涨停/跌停家数用东财专题池(ST 5%、创业/科创 20%、北交 30%、新股不限,阈值法会算错)。
  • 退市/停牌占位条目(f2 === "-")在 Host 侧过滤,不进榜单。
  • 涨跌色沿用 A 股习惯:红涨绿跌。
  • 防御指标口径(重要,指标已并入全 A 榜单列,红利策略已并入公式收藏夹):
    • 股息率 = 近 12 个月已实施的税前每股派息 / 现价,数据来自东财数据中心「分红送配」,缓存 6 小时;不是分红率,也不含未实施的分配预案
    • 分红年数 = 近 3 年里有分红的报告年度数(0~4);连续分红 = 从最新报告年度往回逐年连续的年数(上限 10,显示 10+),窗口 10 年,故 10+ 表示"至少 10 年"而非精确值
    • 分红明细来自东财「分红送配」的已实施记录(不含未实施方案);首次抓取约 36k 条 / 5.6s,之后落盘快照 state/dividend-cache.json,重启秒开、过期后台刷新
    • ROE / 负债率 / 毛利率 / EPS 取最近一期报告、未年化;银行负债率天然 90%+,不要用「负债率 < 60」筛银行
    • 一次性特别分红会把股息率顶得很高(例如某些公司 15%+),要结合 分红年数 与盈利稳定性看,别只看股息率排名
  • 自选池与自动刷新间隔存在 localStorage(键:dsh-stock-workbench:watchlist / dsh-stock-workbench:auto-seconds / dsh-stock-workbench:formulas),换浏览器/清缓存会丢,但不影响行情数据。
  • 预置公式是近似,不是原版策略:CANSLIM 的 C/A(季度盈利、营收增速)、I(机构持仓),唐奇安通道的 20 日 K 线序列,RSI 指标序列都不在快照字段里。每条预置的 note 写明了缺什么、怎么替代。K 线类条件(20 日新高 / 均线金叉 / MACD 金叉)请用「信号扫描」tab。

目录

dsh-stock-workbench/
├── package.json          # bundle manifest + dsh.client 声明
├── cordis.patch.yml      # 1 行:把本插件插进 profile 层栈
├── index.js              # Host 半:注册两条 JSON 路由
├── client.js             # 浏览器半:左侧栏入口 + 整页面板
├── icon.svg              # 插件市场/插件页图标
├── lib/market.js         # 数据层:全集/快照/指数/涨跌家数/K线,含缓存与重试
├── lib/signals.js        # 信号库:SMA/EMA/MACD + 6 个信号检测器(纯函数)
├── lib/formula.js        # 公式引擎:tokenizer + 递归下降 parser + 字段白名单(纯函数)
├── lib/query.js          # 筛选/排序/格式化/预设(纯函数)
└── test/                 # 三层自测:数据层冒烟、查询层单测、Host 端到端

接口

方法 路径 说明
GET /dsh-stock/api/v1/dashboard?force=1 全量快照 + 指数 + 涨跌家数(force 跳过缓存)
GET /dsh-stock/api/v1/kline?secid=1.600000&klt=101&lmt=240 K 线(前复权)。klt:5/15/30/60/101/102;其余回落 101。lmt 上限 6000(日线全历史约 6420 根,前端补历史靠放大 lmt)
GET /dsh-stock/api/v1/trends?secid=1.600000 当日分时(分钟 OHLC + 均价 + 量额)
GET /dsh-stock/api/v1/signals 信号元数据(id / label / desc)
GET /dsh-stock/api/v1/formula/fields 公式可用字段目录 + 示例公式 + 收藏预置
GET /dsh-stock/api/v1/formula/validate?expr=... 只校验语法(收藏夹导入时逐条调用),返回 { valid, error?, position? }
GET /dsh-stock/api/v1/formula?expr=量比>2 且 涨跌幅 between 3 and 7&limit=200 执行公式筛选;解析失败返回 400 + error + position
GET /dsh-stock/api/v1/scan?signals=ma_golden,macd_golden&minAmount=1&limit=150&within=0&klt=101 两段式信号扫描,返回命中列表;klt 支持 5/15/30/60/101(分钟 K 上游只留约 31 个交易日);同参数 60s 内走缓存
GET /dsh-stock/api/v1/dividend?code=600036 单只分红详情:股息率 / 近12个月每股派息 / 近3年年数 / 连续年数 / 最近除息日 / 逐笔明细
GET /dsh-stock/api/v1/boards?type=concept 板块资金流(concept / industry / region)
GET /dsh-stock/api/v1/board-members?code=BK0917 板块成分股代码列表(最多 3890 只 / 39 页,5 分钟缓存)
GET /dsh-stock/api/v1/valuation?code=600036 单只估值分位(逐日精确):PE/PB 当前值 + 近 5 年百分位 + 样本天数
GET /dsh-stock/api/v1/valuation-percentiles 全市场批量估值分位(近 5 年每月抽样,供榜单 PE分位/PB分位 列排序;首次构建约 1 分钟,磁盘缓存 12h)
POST /dsh-stock/api/v1/reload 重载:清空全部缓存(快照/代码全集/分红/板块/估值分位)并立刻重新走一遍真实请求;主源限频时自动改用备用源,返回清理项与耗时
GET /dsh-stock/api/v1/data-sources 行情数据源清单(东财 / 腾讯 / 新浪)、当前源、健康状态、各源缺失字段
POST /dsh-stock/api/v1/data-sources 切换行情源(body: {"provider":"tencent"}),持久化到 state/data-source.json
GET /dsh-stock/api/v1/health 存活探针

公式写法(容忍日常书写习惯)

都能写 归一化后等价于
[量比] > 2、`量比` > 2、**量比** > 2 方括号/反引号/星号被忽略
量比>2、涨跌幅≥3、量比≠4 全角符号、全角数字自动转半角;≥ ≤ ≠ 直接支持
涨跌幅 between 0~1、between 0 到 1 ~、到、至 等价于 and
量比>2 && 涨跌幅>0、`量比>2
量比>2,涨跌幅>0 全角/半角逗号、分号都当「且」
(量比 > 2 或 涨跌幅 > 0)且 换手率 > 1 全角括号
名称 contains "银行,保险" 字符串里的内容原样保留,不会被转成半角

报错位置始终指向原文下标(归一化是 1:1 替换,不改变长度)。

为什么信号扫描是「两段式」

全市场 5572 只逐个拉日 K = 5572 个请求,不可行。所以先用已有快照粗筛候选池(成交额门槛、排除 ST、按成交额取前 N),只对候选池拉日 K(默认 150 只 × 180 根,6 并发,实测 ~1s)再算信号。命中率低的时候把成交额门槛调低、候选上限调大即可。

单次刷新 = 1 次全集(仅进程启动后首次,60 页并发 6)+ 8 批 ulist 快照(800 只/批,并发 4)+ 1 次指数 + 1 次家数 + 2 次涨跌停池;实测 700ms–1.4s,响应 1.23MB(14 字段/行)。

自测

$node = "C:\Users\10932\.dsh\dsh-runtimes\dsh-primary-runtime\dependencies\node\bin\node.exe"
& $node test/smoke.mjs          # 数据层:全集/快照/指数/家数,真的打上游
& $node test/query.test.mjs     # 查询层:25 项断言
& $node test/signals.test.mjs   # 信号库:15 项(SMA/EMA/MACD、各检测器命中与不命中、容错)
& $node test/formula.test.mjs   # 公式引擎:34 项(优先级、括号、金额单位、文本字段、错误与位置、防御字段)
& $node test/host.test.mjs      # Host 端到端:假 ctx 注册 10 条路由 + 真实拉数 + K线/分时/扫描/公式/分红详情

浏览器半(React 组件)另有一套 SSR 冒烟,抓 node --check 抓不到的 JSX 结构错位 / hooks 顺序 / 图表几何:

cd D:\h5\stock-workbench\.ssr      # 独立测试环境:pnpm add react react-dom react-test-renderer scheduler
& $node ssr.mjs                   # 69 项:slot 注册、字典扁平化、K线/分时布局数学、图表 SSR、真实数据筛选排序、收藏夹抽屉、分红弹窗、列配置
& $node interaction.mjs           # 28 项:真渲染 + 模拟点击(表头排序、星标自选、tab/收藏夹、分红弹窗开关)

.ssr/__internals 是给这套测试用的导出(Harness 只消费 name/inject/apply,不受影响)。

开发说明

  • Host 侧改动:重启 DSH 或重装 bundle(loader 层变化不走热更)。
  • Client 侧改动:client.js 属于打包后的 client 资源,改完需要重新安装/刷新页面;只有 pnpm run dev:web 在跑时才有 HMR,本机未跑。
  • Client 半端不依赖任何 Harness Client 包(不 require ui-primitives),样式只用 --dsw-alias-* 主题 token,主题切换自动跟随。