dsh-fun-ticker

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）

Symbol 语法

设置

命名空间 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<symbol, {data, ts}>，刷新间隔内只打一次上游；sparkline 每刷新间隔 append 一点并按设置裁点。
• 断流整条变灰 + 末格「更新于 HH:MM」；单源失败只灰对应格。
• prefers-reduced-motion 时跑马灯退化为静态列表。

Model Experience

The ticker is a read-only surface: every user-editable fact (symbol list order,
palette, speed, cadence, sparkline window) persists through the plugin's own
proxy route into the durable settings document, and the poller honors edits on
its next tick without a reload.