npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@mzzsfy/dsh-stock-assistant

v0.7.1

Published

股票单页面工具:独立于会话的自选、多平台数据路由与行情查看

Readme

@mzzsfy/dsh-stock-assistant

DSH 全局股票工具。左侧“股票”入口打开独立主页面,无会话也可使用。切换、关闭 DSH 会话或临时打开其他工具,不会清除股票工具的搜索、详情、排序、滚动位置和设置草稿。

支持八个市场(沪/深 A 股、港股、美股 NYSE/NASDAQ、日经、韩证、伦敦):自选(多标签分组;市场自动分组:解散某市场分组后新增同市场票不再自动归组,该市场自选清空后仍按默认归组,手动加回市场标签即恢复;分组 tab 与 tab 内涨跌/持仓统计、置顶、拖拽排序、别名、删除撤销)、名称/代码/拼音首字母搜索(多市场候选带币种徽标)、行情与 K 线图表(分时/日K/周K/月K,MA/EMA/BOLL/BBI 可分别开关、成交量副图、昨收/价格标记/区间高低参考线,lightweight-charts 渲染)、价格标记(成本/卖价,单只最多 12 条,多笔成本取最低价计浮盈、卖价按成本计潜在收益)、悬浮盯盘(列表与图形双模式、只盯勾选的标的、设了成本的标的直接以小字给出持仓盈亏、刷新间隔五档 3/5/10/15/30 秒、默认 10 秒、可拖动、常驻在所有面板之上)、基础详情、涨跌排序、手动刷新、暂停采集,以及数据源与能力路由设置(含"应用推荐配置"与按市场配置 K 线)。不做交易、持仓管理或资讯;价格提醒仅限自选标记价穿越,经页内/系统通知或已安装的通知插件呈现。

数据结构与持久化

不使用 DSH 默认设置系统。 本插件不声明 Config,不调用 settings 或 configEditor。配置界面位于股票工具自己的“设置”视图中。

通过宿主 storageDomain 只持久化一条记录(2026-10-30 前为 stock_sidebar 数据域,随包改名一并更名):

| 表 / 记录 | 内容 | 默认 json backend 的介质 | | --- | --- | --- | | control/root | 自选证券、手动顺序、置顶、别名、标记、分组标签、显示偏好、Provider 实例、能力路由、控制版本、近期幂等操作结果 | ~/.dsh/storages/stock_assistant.json(version=1、layout=single,约十几 KB) |

K 线、标准证券目录、交易日历都是可重建的派生数据,只放内存:目录/日历 64 条、K 线 512 条两个独立池,各自最久未写先淘汰,重启宿主后按需重拉。旧版本把这个缓存写进了同一个文件,把它撑到 3.3 MB:打开时 cache 表被忽略,下一次控制写入后文件自然缩回十几 KB,不需要手动清理。打开时对整文件做严格校验:JSON 不可解析、版本号不认、控制记录不合 schema 都直接拒绝打开、原字节不动;只有文件不存在、或文件里没有 control/root 时才初始化为空自选。

开发过程中曾短暂改成过 <域>/<表>/<记录>.json 目录布局(未发布,生产从未以该布局运行)。如果某个数据目录被那个中间版本写过,stock_assistant/ 里的自选不会被读取,需要按 CHANGELOG 里的步骤手工搬回。

密钥不在这个文件里:数据源密钥写进宿主的凭据存储(或留在启动宿主进程的环境变量里),文件里只有引用名。备份时需另行备份凭据或环境变量。报价只保留在 Host 内存;搜索、详情、设置草稿等浏览状态由每个浏览器页面持有,刷新会重建。

浏览器本地另存两组窗口级状态,不进 control/root:悬浮盯盘的开关/位置/勾选目标/暂停开关/列表或图形模式(ssb-floating)与 K 线辅助线开关(ssb-guides)。这些状态跟着当前窗口与这块屏幕走,多设备之间没有同步价值;放进宿主 preferences 的话,每加一个开关都要改协议 schema 并重启宿主才能生效,收益不成比例。代价是不随账号同步、清空站点数据会丢。跨页面共享且影响全局语义的配置留在宿主侧:列表刷新间隔(15/30/60)、悬浮盯盘刷新间隔(3/5/10/15/30 秒,默认 10)与涨跌配色;暂停开关虽然决定是否发请求,但它只属于当前窗口、无需跨设备同步,因此留在本地。业务数据(自选、成本、别名、分组标签、数据源与路由)一律只走宿主存储。

写操作在单一队列中执行,并携带版本及操作 ID。持久化成功后才发布;版本冲突保留用户输入并要求重新确认,写盘失败保留原数据。删除撤销有效期为8秒,恢复到当前列表原邻居附近,不回滚别页修改。控制文件不可解析时拒绝打开、原文件不动,不会用空自选覆盖。

初次使用

全新安装即内置默认数据源:东财、新浪、腾讯、雪球四个免凭据公开源(东财主源,新浪/腾讯/雪球按市场做报价或 K 线备用;保守预算 60 次/分起步),八个市场的目录、搜索、报价、K 线共 32 条能力路由全部配好,无需任何注册。悬浮盯盘选 3 秒档时,交易时段内每拍一次批量刷新;盯超过 20 只会拆成多批,并与列表刷新共用这 60 次/分;全部标的休市或午休时降到一分钟一拍,触限时来源退避、界面提示失败,把档位调慢或减少勾选即可。打开后即可「检查所有来源能力」→ 保存 → 同步目录 → 用「浏览市场」翻页浏览全市场证券并直接加自选,或按代码/中文名/拼音首字母搜索。日经、韩证、伦敦三个市场由东财全球搜索与目录页覆盖,其成交额字段来源恒给 0,界面按缺失呈现而不是显示「0」。

  • 顶栏「浏览市场」提供无目的浏览:按市场分页查看全部 A 股,行内一键加自选;目录未同步时页内有同步引导。
  • 搜索在目录未就绪时不再死路:错误提示带「前往浏览市场」直达入口。
  • 设置页在配置被清空时提供「启用默认数据源」一键恢复(与初始安装同一配置来源)。

需要目录/日历(搜索、日历休市调度)或更正式的数据合同(权限表、配额文档、服务协议)时走 Tushare:

  1. 当前 main 的凭据优先由宿主凭据服务托管:在“股票 → 设置 → 数据源”实例卡的密钥输入框直接录入(写入宿主凭据存储,不回显、不落插件配置);服务接口不全时回退 启动 DSH 的 Host 进程环境变量 DSH_STOCK_TUSHARE_TOKEN(或同层 .env)。0.4.0 发布版没有凭据服务,只读该环境变量。插件只保存引用名/变量名与数据路由;修改引用名不会迁移已有密钥。
  2. 打开“股票 → 设置”,添加数据源实例,填写账号实际允许的请求预算。同一账号的实例使用同一“共享额度组”。新实例额度默认为未知;未填写时只允许每组最多每10秒一次主动探针,实际目录同步与报价采集均禁用,不假设任何免费套餐额度。
  3. 为上海/深圳分别选择证券目录、报价、交易日历来源。可以只启用自己需要的市场和能力。
  4. 点击“检查所有来源能力”。所有被引用能力检查就绪后保存。检查消耗该来源请求额度,检查通过不代表任何第三方展示许可。
  5. 同步需要的市场目录和日历,搜索证券、选择候选并确认添加。
  6. 列表或详情可见时自动采集;进入设置、搜索、隐藏页面或暂停时停止自动采集。暂停期间手动刷新可更新当前静态快照。

设置页按「① 数据源 → ② 市场与能力 → ③ 显示偏好」递进组织;每个数据源实例卡内可见适配器一句话说明、「接口反代」端点覆盖(自建反向代理/镜像时替换地址,留空用官方默认;东财五个端点、腾讯两个端点)、高级预算折叠组与「运行状态」最近请求轨迹(环形 20 条:时间/能力/状态/耗时,用于确认上游是否可达)。实例还支持可选 HTTP 代理出口(http(s)://[user:pass@]host:port,经 undici ProxyAgent;一般无需配置)。列表页顶部常驻数据源概览横幅:启用数/最近请求失败实例一目了然,「管理」直达设置。

Tushare 的 rt_k、stock_basic、trade_cal 权限分别由账号决定。目录与日历权限不足不等于“市场为空”。rt_k 使用 HTTPS;本插件不使用 HTTP 降级,也不通过浏览器直接访问来源。具体能力检查以实际账号结果为准。

数据源适配器

生产内置六个适配器,各自独立文件(src/providers/),互不依赖:

| 适配器 | 能力 | 凭据 | 边界 | | --- | --- | --- | --- | | tushare | quotes / catalog / calendar | 宿主凭据服务或环境变量(默认引用 DSH_STOCK_TUSHARE_TOKEN) | 唯一有正式权限表、配额文档与服务协议的渠道;三种能力可分开路由 | | finnhub | quotes | 宿主凭据服务或环境变量(默认引用 DSH_STOCK_FINNHUB_TOKEN) | 美股 XNAS/XNYS 实时报价;免费档不含 K 线,单只一请求,不适合持续轮询 | | tencent | quotes / kline | 免凭据 | 公开网页接口;非官方、无 SLA,协议随时可能变化 | | sina | quotes / catalog | 免凭据 | 同上;价格恒三位小数,适配器裁剪到分;目录仅沪深 | | eastmoney | quotes / catalog / search / kline | 免凭据 | 同上;目录分页抓全量(单市场约2500只,页频受限流退避约束),联想搜索支持中文/代码/首字母拼音;K 线含分时与日/周/月,分时时间戳统一按北京时间解析 | | xueqiu | quotes | 免凭据(匿名 token) | 同上;可混装多市场,额外提供换手率与市值 |

零注册全流程:只添加 eastmoney 实例(设置页选适配器即标"免凭据",默认保守预算 60 次/分),八个市场各配 catalog/search/quotes/kline 四条路由,检查→保存→同步目录→搜索添加→看行情,全程不需要任何账户。日历能力仅 Tushare 提供;缺日历时插件按"未知交易状态"保守采集,功能不受阻。

混合路由:可把沪深行情分别路由到不同来源(沪市腾讯、深市东财、新浪备用等),目录/搜索用东财、日历用 Tushare——全部在设置页按市场/能力勾选。同一报价的现价、昨收、涨跌和时间始终来自同一适配器,不混拼字段。

免凭据机制:实例 credentialRef=null 时跳过凭据解析(宿主凭据服务或进程环境变量),但 schema 强制其声明保守预算(防无界请求);凭据型适配器切换回档时自动恢复引用名输入框。

新增平台步骤:在 src/providers/ 实现标准合同(descriptor.credential 声明 'none' 或默认引用名 + 能力方法 + probe),在 application.mjs 的 registry 登记,测试放 test/public-providers.test.mjs 或 test/<adapter>.test.mjs。UI、存储、自选模型零改动。

报价路由可选一个备用源,自动切换默认关闭。开启后,连续三轮完全由 NETWORK/TIMEOUT 失败才整条路由切换;权限错误、额度限制与逐证券缺失不触发。切换增加运行代次并丢弃旧请求,最短驻留10分钟,回主源必须手动检查。设置视图显示当前备用选择与回主源操作。

调度与接口

同额度组顺序执行,上游启动间隔至少1秒;最多两个额度组并发。总账号、能力子额度、每日额度和证券计费额度共同约束请求。网络错误指数退避;429遵守 Retry-After;AUTH/PERMISSION/BAD_PAYLOAD暂停该能力,检查或修改后恢复。已知休市/午休不持续采集,日历缺失按未知状态保守采集。

HTTP 路径前缀 /api/stock-assistant:snapshot/search/watchlist/preferences/provider-check/configuration/catalog-sync/route-selection/refresh。写接口均为POST,读接口GET。普通请求上限10秒、单次上游8秒;目录同步30秒,多能力检查最多60秒。刷新直接等待批次并回快照,同价也有获取时间回执。周期启动下界同时考虑用户周期与来源额度。

通知复用 @mzzsfy/dsh-common-tools 的页面共享 WS,不创建股票专用 socket。失效通知与快照拉取分别合并;快照单飞、至少1秒启动间隔,失败不自循环重试。页面需求通过同一总线续租,不以 HTTP 心跳维持。

安装与开发

已发布 npm(当前 0.5.0),安装与升级走正式包:

dsh plugin --profile web add @mzzsfy/dsh-stock-assistant

随后重启该 profile 的宿主。仓库 README 对应 main(可能含尚未发版的改动),npm 页面上的说明是发版时的快照。仓库开发挂载遵循根目录 scripts/dev-link.mjs dsh-stock-assistant(工作副本 junction),装载层变更不走热重载,同样需要重启宿主。

要求 Node>=22,宿主已有 webServer(包括upgrade)、storageDomain 与有效 backend。本包 0.4.0 及更早的发布版只读 Host 进程环境变量;本包 0.5.0 起把 credentials 列入注入服务,由宿主凭据服务托管,接口不全时回退环境变量。client 需要 slots/locale/layout。缺必需服务干净禁用。公共 client 依赖 @mzzsfy/dsh-common-tools 由本包 cordis.patch.yml 自带的装载行 stock-assistant-dsh-common-tools 引入,装本包即可独立运行;宿主按包名把各消费插件的装载行合并成一份 client 模块。本包声明公共依赖范围 ^0.5.0(与库同 minor,当前 0.5.x)与 dsh.client.external,该依赖是普通 npm 包,不进 profile 依赖清单、不单独成插件卡(只在所属插件详情页作为只读部件行出现)。Host/client 使用同代 common-tools 0.5.x,装载与兼容窗口规则见 DEVELOPMENT/client-dependency.md。

npm install --omit=peer
npm test

生产 client 是原生 ModuleLoader 单入口,没有生产打包步骤、独立状态库或 React 副本。devDependencies 的 React/ReactDOM/esbuild 仅用于实际组件测试和隔离验收夹具,不进入生产运行路径。

有头浏览器夹具可运行 node test/browser-fixture.mjs,输出随机本地端口。它使用固定行情、内存存储、真实client组件和真实公共快照调度器,测试传输替为夹具事件桥;不能将其作为真实Tushare账户或宿主WS验收证据。使用后终止该进程。

DSH 版本兼容

| 版本 | 状态 | 证据边界 | | --- | --- | --- | | 0.2.2-rc.1 | compatible | 2026-11-09 隔离真宿主:导航入口、自选/搜索/浏览市场/详情/K线/悬浮盯盘/设置、真实东财行情与八市场路由;截图资产同源采集 | | 0.2.1-rc.5 | compatible | manifest 登记;仅有 .compat/0.2.1-rc.5 的 crash-only 装载记录(page true),未做功能复测 | | 0.2.1-rc.2 / 0.2.1-rc.3 | compatible | 早期隔离验证:导航入口、main 页面、样式、快照路由、WS ready→invalidate、重载后偏好保留;rc.3 另验证无凭据 AUTH 检查拒绝与保存守卫 | | 其余版本 | unknown | 未实测不声明 |

逐项证据和局限见兼容性测试,变更记录见CHANGELOG。界面截图(2026-11-09 隔离宿主实采)见assets/screenshots/dsh-stock-assistant。实现规格与研究分别见开发文档、调研文档。