MurasakiIzumi/dsh-ticker-jp

English · 简体中文 · 日本語

右上角的悬浮行情小窗，展示 TOPIX 联动 ETF 与日经225，并支持全球股市：可自选任意 Yahoo 代码，日股（.T）、美股、港股（.HK）、A 股（.SS/.SZ）等全球主要市场均可实时报价。由 dsh-stock-ticker 改版而来，浮窗交互保留自上游，数据源换成 Yahoo Finance 以覆盖全球市场。

📸 预览

✨ 功能

• 浮窗可拖拽、可收起，背景跟随 DSH 主题色
• 每行显示名称、价格、涨跌幅，红涨绿跌
• 自选全球股市代码（日股 .T、美股、港股 .HK、A 股 .SS/.SZ…），支持 4 位简码与 代码:显示名 别名
• 休市自动降频：全部自选市场休市时改为每分钟检查，开盘恢复 5 秒刷新
• 涨跌配色可在日式/美式间切换
• 16 种界面语言，首次按浏览器语言匹配，随时可换
• 窗口位置、收起状态、自选列表、配色、语言均保存在本地
• 一键恢复默认

默认标的

显示名	代码	说明
TOPIX ETF	1306.T	Yahoo 的 TOPIX 指数接口已停更，以其联动 ETF 代替
日経225	^N225	日经225 指数本体

📋 环境要求

项目	要求
DSH	>=0.1.0-rc.7 <0.2.0（已在 0.1.7-rc.2 实测）
Node.js	^22.19.0 或 >=24.0.0

通过 engines.dsh 与 @deepseek-ai/dsh-client-ui-slots 这条 peer 依赖声明，不依赖其他 DSH 侧官方包。

🚀 安装

从 npm 安装（预构建、免构建授权），或直接从 GitHub 源码安装：

# npm（推荐）
dsh plugin --profile web add dsh-ticker-jp

# GitHub 源码
dsh plugin --profile web add github:MurasakiIzumi/dsh-ticker-jp

装完重启 DSH（或选「立即重启」），窗口出现在页面右上角。

⚙️ 使用

1. 点标题栏 ⚙ 进入设置。
2. 每行是代码 + 显示名 + 移除按钮。直接改显示名即生效；留空则按默认简称 → Yahoo 名 → 代码回退。
3. 底部输入框添加标的，可填 9984.T、AAPL、9984（4 位纯数字只对日股补 .T）或带别名的 9984.T:软银。
4. 配色与语言在面板中部切换，即时生效。
5. 「恢复默认」回到 TOPIX ETF 与日経225，「完成」退出。

🗂️ 代码结构

dsh-ticker-jp/
├── lib/index.js       # Host：注册 /dsh-ticker-jp/quotes 路由
├── lib/client.js      # Client：悬浮窗 UI、轮询、自选/别名
├── lib/index.d.ts     # Host 类型声明
├── lib/client.d.ts    # Client 类型声明
├── host.js            # 动态插件 Host 半区（可选）
├── client.js          # 动态插件 Client 半区（可选）
├── package.json       # 包清单
├── cordis.patch.yml   # bundle patch
├── CHANGELOG.md       # 变更记录
├── assets/            # 预览截图
├── LICENSE
├── README.md          # English（主文档）
├── README.zh-CN.md    # 简体中文
└── README.ja.md       # 日本語

同一份代码有两种形态：lib/ 是随 DSH 常驻的 bundle 入口；host.js / client.js 是动态插件形态，临时体验用，功能等价。

🔌 数据源

• Yahoo Finance chart API：https://query1.finance.yahoo.com/v8/finance/chart/{代码}?interval=1d&range=1d
• 免费、无需鉴权。价格取 meta.regularMarketPrice，涨跌幅取 meta.regularMarketChangePercent，名称取 longName/shortName
• 覆盖全球主要市场：日股 .T、美股、港股 .HK、A 股 .SS/.SZ 均可
• 抓取时回传交易所时区与交易所名，客户端据此判断当地交易时段
• 名称不内置，以 Yahoo 返回为准；默认两只的简称只在展示层覆盖

🧪 动态插件（可选）

不落盘、临时载入，适合快速体验：

1. 用 cordis_define 创建插件：code.host 填 host.js 全文，code.client 填 client.js 全文。
2. cordis_run 激活，客户端首次运行在审批卡片点「允许」。
3. 刷新页面即出现悬浮窗。

动态形态与 bundle 功能一致，差别只在 Host 抓取方式：动态形态运行在受限沙箱，经 ctx.web 抓取；bundle 用原生 fetch。两者的 RPC 契约相同。

📄 License

MIT

悬浮窗实现与结构源自 FeiZhuNiU-INFJA 的 dsh-stock-ticker（Copyright (c) 2026 Yulin），本改版修改数据源、扩展自选功能并将覆盖范围扩展至全球市场（Copyright (c) 2026 XuZhichao）。