omdsh-dev/dsh-fun-ticker

dsh-fun-ticker

作者 / 维护者： @Zacklinkk

DSH（DeepSeek Harness）行情跑马灯插件：会话底部一条常驻横向跑马灯，加密 / 汇率 / A股 / 指数 / 港美股任意组合，用户自主增删标的；点击条目查看明细（含迷你 sparkline）。全部数据免费免 key，客户端不直连上游 —— 宿主侧代理 + 缓存。

本仓库为 DSH monorepo 中 packages/fun/ticker 的单包快照。源码与该目录内容一致，可直接放回 monorepo 的 packages/fun/ticker/ 目录构建。

结构

- src/index.ts — 宿主入口：注册 dsh-ticker 设置命名空间与 /plugins/dsh-ticker/api 前缀路由。
- src/proxy.ts — 按 symbol 内存缓存、按类别批量刷新、sparkline 滚动窗口、HTTP 路由（/quotes、/settings、/suggest）。
- src/sources.ts — 四类上游的抓取与归一化（Binance/CoinGecko、Frankfurter、eastmoney ulist、Sina GBK）。
- src/contract.ts / src/settings.ts — 双端共享的 symbol 语法、设置类型与 schemastery schema。
- src/client/ — 浏览器端：跑马灯条、管理/明细弹层、设置页区块。

上游（免 key，仅四个域，客户端不可指定 URL）

| 类别 | 上游 | 说明 |
|---|---|---|
| 加密 | data-api.binance.vision（CoinGecko 兜底） | 24hr 批量 + 1m kline 播种 sparkline；未知交易对仅标该格 not-found |
| 汇率 | api.frankfurter.dev | ECB 汇率；timeseries 一次请求取现值/昨值/60 日播种 |
| A股/指数 | push2.eastmoney.com / push2his.eastmoney.com | ulist 一次请求带全部标的（×100 缩放修正），kline 播种 sparkline |
| 港美股 | hq.sinajs.cn | GBK 转码解析 |

Symbol 语法

| 类别 | 示例 | 规则 |
|---|---|---|
| 加密 | BTCUSDT | 4–12 位大写字母数字对 |
| 汇率 | USD/CNY | XXX/YYY 三字母币种对 |
| A股 | 600519 | 6 位数字（6/9 开头→沪，其余→深） |
| 指数 | SH000001 / SZ399001 / SZ399006 | 上证/深证成指/创业板指 |
| 港股 | hk00700 | hk + 4–5 位代码 |
| 美股 | gb_aapl | gb_ + 代码 |

设置

命名空间 dsh-ticker：symbols（预置 BTCUSDT / ETHUSDT / 上证指数 / USD/CNY）、colorScheme（红涨绿跌 / 绿涨红跌）、speed（慢/中/快）、refreshInterval（10s/30s/1min）、sparklinePoints（10–120）、showDetailButton。

构建与挂载（DSH monorepo 内）

1. 把本仓库内容放到 monorepo 的 packages/fun/ticker/（workspace glob packages//* 已覆盖），pnpm install。
2. 构建：tsc -b packages/fun/ticker/tsconfig.json && pnpm --filter @deepseek-ai/dsh-fun-ticker bundle。
3. 在 tsconfig.client.json 的 references 中加 { "path": "./packages/fun/ticker" }。
4. 在 packages/host/apiproxy/src/api-proxy.ts 的 WEB_SETTINGS_NAMESPACES 中加入 'dsh-ticker'（供 RPC 设置通道暴露；插件自身的代理路由不依赖此项）。
5. 组合挂载（web 组合的 cordis 补丁层，如 $DSH_HOME/profiles/web/cordis.patch.yml）：

- insert:
- id: fun-ticker
name: '@deepseek-ai/dsh-fun-ticker'

6. 若组合目录不在 monorepo 内，确保包可解析（如 $DSH_HOME/profiles/node_modules/@deepseek-ai/dsh-fun-ticker 指向包目录）。
7. 刷新浏览器页面；客户端 bundle 由 /plugins/@deepseek-ai/dsh-fun-ticker/client.js 提供（no-cache，重建后刷新即生效）。

说明

- 设置读写走插件自己的 /plugins/dsh-ticker/api/settings 路由（宿主 settings 文档持久化），不依赖 apiproxy 的 RPC 暴露。
- 限流与缓存：宿主侧 Map，刷新间隔内只打一次上游；sparkline 每刷新间隔 append 一点并按设置裁点。
- 断流整条变灰 + 末格「更新于 HH:MM」；单源失败只灰对应格。
- prefers-reduced-motion 时跑马灯退化为静态列表。

模型体验

跑马灯是一个只读界面：每一项用户可编辑的事实（标的列表顺序、
配色、速度、节奏、sparkline 窗口）都通过插件自身的
代理路由持久化到持久化设置文档中，轮询器会在
下一次 tick 时遵循编辑，无需重新加载。