dsh-fx-marquee

Readme

# dsh-fx-marquee · 汇率跑马灯

一个 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（dsh）Web 插件：在输入框上方常驻一条行情跑马灯，点开任一标的看走势图，另有汇率计算器与设置页。

**English** — A [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) web plugin: a live FX/market ticker strip above the composer, with click-through trend charts, a frozen-rate currency calculator, and a settings page. All data sources are keyless. Runs on Windows, macOS and Linux.

完整版本变更见 [`CHANGELOG.md`](./CHANGELOG.md)。

> 非官方插件，与 DeepSeek 官方无关。数据仅供个人参考，不构成投资建议。
> Unofficial plugin, not affiliated with DeepSeek. Market data is for personal reference only, not investment advice.

## 功能

**跑马灯**（会话输入框上方）

- 可自选标的：货币对、A 股/指数、加密货币混排
- 每个标的显示名称、数值、涨跌幅，可选迷你走势图
- 内容放得下时静态居中、放不下才滚动
- 点击任一标的弹出明细浮层
- 新会话未开始聊天前不显示（Hero 阶段）

**走势图**（点击标的后）

- Y 轴数值刻度（最高/中间/最低）+ 虚线网格，X 轴时间两端点
- **X 轴单位可选**：自动 / 小时 / 天 / 月
- **数据组数可选**：天 / 月 / 自动档为 **7 的倍数**（14 / 21 / 28 / 35 / 42 / 49 / 56）；小时档为 12 的倍数、上限 60（12 / 24 / 36 / 48 / 60）
- 切换单位时若原组数对新单位无效（例如 28 换到小时档），自动收敛到该单位默认值（小时 24，其余 28）
- 鼠标悬停吸附到最近取样点：十字线、圆点、读数（值 + 时间）
- 显示该标的所属市场的**交易时段**：市场时钟（北京/纽约/UTC）、开市状态、距开盘/收盘倒计时
- **休市时曲线转灰**

> ⚠️ **小时档当前暂停提供**（选项保留可见但置灰，并标注「（无数据源）」）。
> 原因：唯一免密钥的外汇日内源是东方财富 K 线，它只覆盖 `USD/CNH` 与 `EUR/USD` 两个品种，且该接口目前对所有主机都拒绝请求（`UND_ERR_SOCKET`）；普通货币对本身只有 ECB 每日参考价。与其提供一个几乎处处不可用的档位，不如先撤回。恢复只需把 `lib/quotes.js` 里的 `HOUR_UNIT_ENABLED` 改为 `true`——取数逻辑、12 步进的组数规则及其测试都完整保留。

两个选择会记住（存本地，下次打开保持）。**各档位的实际可得性取决于数据源**，界面上区分得很清楚：

- 取得到的档位：**深色加粗**
- 取不到的档位：**灰色**并标注「（无数据源）」，不可选；悬停给出原因
- 控件右侧标注**当前实际画的是哪一档**：外汇选「自动」时显示「当前：自动（天）」，因为 ECB 只有日线——「自动」与「天」对外汇本就是同一组数据，不标出来会让人以为控件失效

| 类别 | 小时 | 天 | 月 |
|---|---|---|---|
| 加密货币 | ⏸ 暂停 | ✅ Binance 1d | ✅ Binance 1M |
| 指数 / A股 | ⏸ 暂停 | ✅ 腾讯日线 | ✅ 腾讯月线 |
| 货币对（含 `USD/CNH`、`EUR/USD`） | ⏸ 暂停（ECB 只有日线） | ✅ ECB | ✅ ECB 聚合 |

> 「自动」档位下：外汇与加密货币按各自自然粒度取 N 个点；**指数**显示全天分时线，此时组数控件置灰（分时线的长度由交易日决定，指定组数没有意义）。

**汇率计算器**（正文区上方 Tab）

- 货币对可选 **24 个**（跑马灯里的 + 内置清单），带分组
- 汇率取**打开计算器时**的值，之后不自动变化，只有点「刷新汇率」才更新
- 结果保留两位小数；支持 `⇅` 调换方向
- 换算使用「每 1 单位」汇率，`日元/人民币` 这类按 100 单位报价的会正确换算

**设置页**（设置 → 汇率跑马灯）

- 一键开/关跑马灯（关闭即停止后台轮询）
- 19 个常用货币对 + 6 个指数/加密标的勾选，支持自定义添加
- **汇率信源可选**：自动 / 新浪财经 / ECB / ER-API
- 自动更新间隔：关闭 / 5 秒 / 10 秒 / 20 秒 / 30 秒 / 1 分钟 / 5 分钟
- 走势图开关、涨跌配色（红涨绿跌 / 绿涨红跌）、实时预览

## 数据源

全部免密钥。

| 类别 | 主源 | 更新频率 | 兜底 |
|---|---|---|---|
| 货币对 | 新浪财经 `hq.sinajs.cn` 盘中即期 | 秒级（交易时段内） | ECB 每日参考价 → open.er-api.com |
| 指数 / A 股 | 东方财富 `push2.eastmoney.com` | 交易时段内实时 | 无 |
| 加密货币 | Binance `data-api.binance.vision` | 7×24 实时 | 无 |

**各源的实际新鲜度**（实测）：

- 新浪外汇：盘中秒级推进；在岸人民币在境内交易时段（09:30–23:30）结束后会冻结
- ECB / ER-API：**每日一次**，不是实时；ECB 约 30 个币种，ER-API 覆盖 166 个
- 东方财富指数：交易日 09:30–11:30、13:00–15:00 实时，收盘后为收盘价
- Binance：7×24 实时

客户端默认每 20 秒轮询一次，宿主侧另有 25 秒缓存，所以**最坏情况下屏幕上的数字比上游旧约 45 秒**。明细浮层里会显示上游报价时间与信源，可据此判断。

## 安装

```
dsh plugin --profile web add github:0rangeSoda1506/dsh-fx-marquee
```

然后**重启 dsh 进程**（新装的插件包必须真正重启：`recompose` 不会重算已启动进程的 boot manifest，客户端 UI 不会出现）。

## 兼容性

- 在 **dsh 0.1.5-rc.1** 上开发与实测
- 客户端 half 只用浏览器标准 API，宿主 half 只用 Node 标准 API，**无平台专有代码**
- Windows / macOS / Linux 通用

## 已知限制

- **新浪外汇需要 `Referer` 头**：宿主端带上，浏览器端无法直连，因此数据统一由宿主代理
- **境外访问**：新浪、东方财富在海外可能变慢或失败；外汇会自动回退到 ECB/ER-API，**指数与加密目前没有备源**
- **Binance 在部分地区受限**（如美国），受限时该标的显示 `—`
- 指数与加密**没有兜底源**，主源不可用时该格显示 `—`
- 交易时段按市场本地时区（`Asia/Beijing` / `America/New_York`）判定，与你的机器所在时区无关

## 测试

`test/` 下是本地验证脚本，需要 Node 18+：

```bash
cd test && npm install     # jsdom + react + react-dom
node test-host.mjs         # 宿主端到端（真实上游）
node test-client2.mjs      # 客户端集成（jsdom + 真实 React）
node test-sources.mjs      # 信源选择与缓存分区
node test-series.mjs       # 走势图数据与标签对齐
node test-granularity.mjs  # 三档粒度 × 七档组数（真实上游）
node test-trend-route.mjs  # 趋势路由与降级回报
```

## 许可

MIT