前言¶
在 DeepSeek Harness（DSH）里做智能体或日常开发时，经常需要扫一眼 A 股、港股、美股或外汇、期货的现价，又不想单独开交易软件或网页图表。常见做法是浏览器书签或第三方 App，和 Harness 窗口是割裂的。dsh-marketboard 是 stitchmaps 维护的 DSH Client 原生插件：把多市场标的收进一块自选看板，只展示列表与实时价，不带 K 线图表，并跟随 DSH 明暗主题与语言设置。
这是什么¶
dsh-marketboard（DeepSeek Harness 行情看板）面向 DSH Web GUI 桌面端，分类属于联网工具。Host 侧拉取公开行情接口，Browser 侧通过本地 API 渲染 React 界面；自选、设置与自定义分组写在宿主机 <DSH_HOME>/dsh-marketboard/data.json，不使用 localStorage。插件只读行情，不提供下单能力。
维护者与仓库：GitHub stitchmaps/dsh-marketboard，当前 package 版本为 0.2.1，许可证 MIT。
核心功能¶
七类市场，一块看板¶
默认分组覆盖 A 股（cn）、港股（hk）、美股（us）、外汇（fx）、国内商品期货（futcn）、国际商品期货（futgl）与全球指数（index）。首次运行内置 49 个 curated 标的示例；可按分组筛选、在自选内搜索、按涨跌幅排序。
自动刷新与 stale 标记¶
默认支持 3 / 5 / 10 / 30 / 60 秒自动刷新，可暂停/恢复、手动刷新。上游异常时会对陈旧报价做标记；成功拉到的报价缓存 15 分钟，缺数据时再走备用源。
自选与自定义分组¶
星标置顶，一键移除；通过搜索或手动代码表单添加。除不可删的默认市场分组外，可新建、重命名、删除自定义分组，并勾选成员；不同市场的标的可以放进同一个命名集合。
看板信息密度¶
除现价外，界面提供涨跌家数、平均涨跌、领涨/领跌、最后更新时间、日内区间位置、开盘价与昨收等汇总信息，而不是简单表格堆叠。
数据来源（无需 API Key）¶
Host 使用公开接口批量拉价，每轮刷新主源最多两次批量请求，仍缺失的标的再 fallback：
| 资产 | 主源 | 备用 |
|---|---|---|
| A 股 / 港股 / 美股 / A 股指数 | 腾讯 qt.gtimg.cn |
新浪 hq.sinajs.cn |
| 外汇 | 新浪 fx_s* |
Yahoo Finance chart |
| 国内商品期货 | 新浪 nf_* |
— |
| 国际商品期货 | 新浪 hf_* |
Yahoo Finance chart |
| 全球指数 | 新浪 int_* |
Yahoo Finance chart |
行情可能延迟、不完整或暂时不可用；仅供个人参考，不构成投资建议。
与 Harness 的集成方式¶
UI 仅使用主题 token 配色，支持 zh/en 本地化，响应式布局；Client 用本地 React 控件实现，不依赖 Harness Client 包 import。Browser 通过相对路径访问 api/dsh-marketboard/...，适配 DSH 桌面 Web GUI 的 IPC fetch。
安装与启用¶
仓库是 DSH bundle（dsh.bundle.patch + dsh.client）。官方 README 给出两种方式，不要凭插件名拼接 dsh plugin add github:...。
方式 A — DSH CLI（将路径换成本机 clone 或解压后的绝对路径）：
dsh plugin --profile desktop add file:/absolute/path/to/dsh-marketboard
方式 B — Plugin Manager
在 DSH Plugin Manager 中将仓库目录添加为本地 bundle，再启用。
安装后刷新 DSH Web GUI（Ctrl+R）。若 Host 半部已在运行，需重新加载 profile patch（移除并重新添加 dsh-marketboard 的 insert 行），或重启桌面应用一次。
环境要求（README 已验证项）：
- DSH：
>= 0.2.0-rc.2 || >= 0.2.1-rc.2 - Node：
^22.19.0 || >= 24.0.0 - 平台：Web GUI
典型用法¶
经过上面的安装步骤后，可按 README 顺序操作：
- 在左侧导航打开 Marketboard。
- 用分组 chip 切换市场或自定义分组；默认市场分组自动生成且不可删除。
- 点 New group 创建自定义集合并勾选成员；用 Manage 重命名或删除自定义分组。
- 点 Add symbol 按名称/代码搜索，或手动输入代码。当前若选中自定义分组，新标的也会加入该组。
- 悬停行：星标置顶，
×移除。 - 工具栏可暂停自动刷新，也可随时手动刷新。
- 打开 Settings 调整刷新间隔、涨跌配色（红涨绿跌或相反）与界面密度。
手动添加代码时，README 给出的格式示例包括：A 股 600519 或 sh600519；港股 00700；美股 AAPL、BRK.B；外汇 EURUSD、EUR/USD；国内期货 RB0 / RB；国际期货 CL、CL=F；指数 sh000001、^GSPC 等。
Host 侧主要 API 均为 POST JSON，例如 /api/dsh-marketboard/state（读写自选与设置）、/api/dsh-marketboard/quotes（拉当前报价）、/api/dsh-marketboard/search（内置目录与腾讯股票搜索）。写入由 Host 校验与规范化 ID，浏览器不自行生成标识。
适用场景与注意¶
适合谁：在 DSH 桌面环境里工作、需要同时盯多市场列表价、又不需要图表的交易员式参考或开发者。
隐私：无账号、Cookie、API Key，无遥测；Browser 只访问本地 DSH API，Host 才访问公开行情/搜索端点；自选与设置不离开本机。
安全与合规：插件以当前 DSH 进程权限运行，安装前应阅读源码与 MIT 许可证，并自行遵守上游数据提供方条款。社区目录页 skillhub.cn 插件条目 与 DeepSeek / 幻方无官方从属关系，DSH 生态理念是「一切皆插件」，本文介绍的是社区维护的联网工具，而非官方应用商店内置应用。
结尾¶
dsh-marketboard 把 A 股、港股、美股、外汇、国内外期货与指数收进一块 Harness 原生看板：自选持久化、自定义分组、可配置刷新，Host 批量拉价且无需 API Key。需要详情、Issue 或本地 bundle 结构时，见目录页与仓库：
- 目录页：https://www.skillhub.cn/plugins/stitchmaps/dsh-marketboard
- GitHub：https://github.com/stitchmaps/dsh-marketboard
