前言¶

在 DSH 里做智能体或日常开发时，常会需要快速扫一眼持仓或指数，又不想切到券商客户端或单独开行情站。专业看盘与交易仍应交给券商与专业软件；若在 Harness 同一套 Web 界面里挂一块延迟公开行情、只读、不接交易的股票看板，摸鱼盯盘会省不少上下文切换。下面介绍社区插件 寰镜股票看板 MarketLens（@suifei/dsh-market-lens），由维护者 suifei 发布，分类为联网工具，源码与包见 GitHub 与 SkillHub 目录页。

这是什么¶

一句话定位：给散户在 DSH Web 面板里看自己股票情况的只读看盘·盯盘看板——极致简单，行情分析与交易请用专业软件。

• 覆盖 A 股（沪/深/北）、港股、美股 的指数与个股；板块视图在后续版本。
• 数据来自公开免费接口的延迟行情（非 Level-2），UI 会常驻标注；不做下单、撤单、持仓盈亏、量化执行或任何写操作（连配置写回都没有）。
• 当前包版本以 npm 为准（资料中 package.json 为 0.34.8）；README 写明 0.27.1 起依赖 schemastery/dsh-tools 可正常解析，0.29.0 起证券大厅为 WebGL2 灯墙管线。

架构与数据流¶

行情抓取只发生在 DSH 宿主侧；浏览器里的 React 面板通过同源 HTTP 访问 /market-lens/*，不直连外部行情源。

浏览器（DSH Web GUI）                      Node（DSH Host）
┌─────────────────────────┐   同源 HTTP   ┌──────────────────────────┐
│ client.js  React 面板     │ ───────────→ │ index.js                  │
│ · 侧栏入口与主面板         │  /market-lens│  · 只读路由与工具          │
│ · Canvas 自绘 K 线        │   /*        │  lib/service.js 缓存/降级  │
│ · localStorage 自选/偏好  │             │  sources: 东方财富/腾讯/Yahoo │
└─────────────────────────┘             └──────────────────────────┘

智能体侧还提供三个只读模型工具：market_search、market_quotes、market_kline，与面板共用同一套 createMarketService；描述中写明只读、不涉及交易，且没有下单类写工具。

多源按市场降级（单源失败自动切换；全链失败时 quotes 返回 failed[]，有缓存时可能带 stale: true）：

核心功能¶

三列看盘首页¶

指数条、自选列表（代码主视觉 + 微型趋势线 + 涨跌胶囊 + 市场状态条）、K 线（MA、量副图、框选放大），以及详情卡、提醒、财报（A 股）、资讯等右栏能力。轮询在上一请求完成后再排下一次；标签页隐藏时暂停，回前台立即刷新。

证券大厅¶

顶部工具栏可进入 800×450 灯墙大屏（桌面版安装后左侧栏有「寰镜股票看板」，点「证券大厅」进入）。大厅为固定灯格矩阵，离屏原生渲染后等比缩放居中显示，与窗口分辨率解耦。

符号与搜索¶

内部符号与腾讯公开接口词表一致（如 sh600519、hk00700、usAAPL）；输入支持多种常见写法，裸 6 位 A 股代码可按规则推断市场。搜索支持代码、中文名、拼音全拼与拼音首字母（如 gzmt → 贵州茅台）。

宿主 HTTP 接口（摘录）¶

同源护栏下提供只读路由，例如：

• GET /market-lens/quotes?symbols=...（≤200 个符号）
• GET /market-lens/kline?symbol=...&period=day|week|month&count=20-320
• GET /market-lens/search?q=...
• GET /market-lens/meta（轮询间隔、默认自选、免责声明等）

QuoteRow 中缺失字段为 null，UI 显示 —，不补零。K 线前复权在宿主侧固定，UI 与工具不暴露复权参数。

安装与启用¶

安装走 DSH 自带的 dsh plugin：会加依赖并把 bundle 写入 dsh.profile.bundles，一般无需手改 patch。

桌面版（DSH Desktop）¶

dsh plugin --profile desktop add @suifei/dsh-market-lens

装完后重启 DSH Desktop；左侧栏出现「寰镜股票看板」，可从顶部进入证券大厅。

Web 版（dsh web）¶

dsh plugin --profile web add @suifei/dsh-market-lens
dsh web

换端口可用 dsh web --port 8080。浏览器从左侧栏进入；升级或改配置后刷新页面即可。

钉版本、快照与卸载¶

dsh plugin --profile desktop add @suifei/dsh-market-lens@0.34.3
dsh plugin --profile desktop add github:suifei/dsh-market-lens#<40 位 commit>
dsh plugin --profile desktop remove @suifei/dsh-market-lens

也可在 DSH「插件管理」界面按包名安装，效果等价。

不使用 dsh plugin 时，可在 profile 的 cordis.patch.yml 中手动 insert 挂载（id: market-lens，name: '@suifei/dsh-market-lens'）；可选 config 含 diagLevel、pollIntervalMs、scrollVpx 等，详见 README 配置节。

典型用法¶

1. 日常盯盘：安装并启动对应 profile 后，在侧栏打开寰镜股票看板，维护自选列表（存于浏览器 localStorage），观察延迟报价与 K 线；需要总览时进入证券大厅。
2. 智能体问价：在对话中让模型调用 market_quotes / market_kline / market_search，参数上限与路由一致（例如 symbols ≤200，kline count 20–320）。
3. 调参与排障：在 cordis.patch.yml 行内 config 可改 pollIntervalMs（默认 5000）、scrollVpx（大厅滚动速度，0 为冻结）等；diagLevel 为日志总开关（发布默认 errors），诊断日志默认落在 ~/.dsh/market-lens/marketlens-diag-<日期>.jsonl，可通过 GET /market-lens/diag?tail=50 回读。

适用场景与注意¶

适合：已在用 DSH Desktop 或 dsh web 的开发者，希望同源面板里轻量看延迟行情、搜代码、拉 K 线或让模型只读查价，且明确不需要交易能力。

不适合：需要 Level-2、极低延迟、实盘下单或持仓同步的场景——插件 deliberately 不接任何交易端。

安全与权限：插件以当前 dsh 进程权限运行，会向东方财富、腾讯、Yahoo 等公网源发起只读 GET；安装前请查看 源码仓库 与 MIT 许可证，自行评估网络与合规要求。SkillHub 为社区目录站点，与 DeepSeek / 幻方无官方从属关系；Harness 生态理念是「一切皆插件」，本包是社区维护的联网工具之一（目录页标注星标等信息以站点为准）。

结尾¶

寰镜 MarketLens 把 A 股、港股、美股的延迟公开行情收进 DSH Web 面板与只读模型工具，强调简单与不交易。若要在本机试用，从目录页或 README 核对最新版本后，用上面的 dsh plugin 命令装入对应 profile 即可。

• 目录页：https://www.skillhub.cn/plugins/suifei/dsh-market-lens
• GitHub：https://github.com/suifei/dsh-market-lens