dsh-stock-quotes
中文 | English
一个 DeepSeek Harness 插件：在侧边栏数据面板里显示自选股实时行情，同时注册 stock_quote 工具，让 Agent 能在对话里直接回答"茅台现在多少钱"这类问题。
- 面板：A 股 / 港股 / 美股自选股一张表 —— 最新价、涨跌额、涨跌幅、今开 / 最高 / 最低、成交额；15 秒自动刷新；右键菜单、拖拽排序、多选批量操作。
- 工具：
stock_quote一次批量取回一只或多只行情（不带参数时用配置里的默认自选股）。 - 外观中性：侧边栏默认叫「数据」、图标是普通表格样式，显示名称可配置 —— 看起来像通用数据视图，而不是行情软件。
> 行情来自公开接口的延时/快照数据，仅供查看，不构成任何投资建议，不用于交易决策。
环境要求
- DeepSeek Harness（0.2.x，需要
plugin_manager工具） - 无需 API key，无需安装额外依赖；Host 半不 import 包外任何模块
安装
git clone https://github.com/AhaCrazy/dsh-stock-quotes.git
然后在 DSH 会话里按绝对路径安装这个 bundle：
plugin_manager action: install_bundle target: /dsh-stock-quotes
客户端模块加载后侧边栏会出现图标；没出现就刷新一次页面。stock_quote 会在下一次请求的工具清单里出现。
卸载：
plugin_manager action: remove_bundle target: dsh-stock-quotes
面板操作
| 操作 | 怎么做 |
|---|---|
| 添加 | 顶部输入代码或板块名 → 回车 / 点「添加」 |
| 删除 | 在任意一行上右键 → 菜单里选「删除」（没有每行右侧的 ✕ 按钮） |
| 排序 | 拖行首的 ⠿ 手柄上下拖拽，落点会显示品牌色指示线；也可以用右键菜单的「上移 / 下移 / 置顶 / 置底」 |
| 多选 | 勾选每行最左侧复选框；表头复选框是全选 / 清空 |
| 批量操作 | 选中 ≥1 项后表格上方出现操作条：删除所选 / 置顶 / 置底 / 取消选择 |
| 右键菜单其余项 | 复制代码（多选时按行拼接）、全选、清除选择 |
| 曲线 | 工具栏「曲线」按钮开关每行的分时走势 |
右键菜单是感知选择范围的：右键的那一行若已在多选里，删除 / 移动 / 复制会作用于整个选中集合，菜单标题会带数量；否则只作用于该行。
自选股顺序与成员保存在浏览器 localStorage（键 dsh-stock-quotes/watchlist）。表格始终按自选股顺序渲染、行情按代码映射进对应行，所以拖动排序不会让"代码 ↔ 报价"错位。
曲线图
工具栏的「曲线」按钮控制每行是否显示当天的分时走势（迷你折线），状态存在 localStorage（dsh-stock-quotes/prefs 的 chart 字段），默认开启。
- 数据来自东财分时接口，A 股 / 港股 / 美股 / 板块都支持；美股显示最近一个交易时段
- 横轴是整个交易时段，不是把已有数据拉伸铺满：A 股 / 北交所 / 板块 240 分钟（09:30–11:30、13:00–15:00），港股 330 分钟（09:30–12:00、13:00–16:00），美股 390 分钟（北京时间 21:30–04:00）。所以 11:30 看盘时折线只画到一半，右边空白正是还没交易的部分；收盘后才会铺满整条
- 每 60 秒刷新一次（不跟 15 秒的报价刷新同步，避免请求风暴）
- 颜色跟随当日涨跌：红涨绿跌，平盘用中性色，和数值列一致
- 关掉后不发起任何分时请求，只保留数值
- 走势还没取到时该格留空，行内列不会错位
- 悬停小图即可读数：鼠标移到某行的迷你线上会出现十字线，同时该行的「最新价 / 涨跌额 / 涨跌幅」临时变成指针所指那一分钟的值，第二行代码处显示该时刻（如
sh600519 · 11:30），移开即恢复
大图（点击行展开）
迷你线只够看趋势。点任意一行，表格上方会展开这个标的的大图；再点该行或点右上角 × 收起。
- 左右两侧 Y 轴刻度 + 网格线 + 昨收虚线
- 时间轴按各自的交易时段：A 股
09:30 / 10:30 / 11:30·13:00 / 14:00 / 15:00；港股、美股同理会标注自己的时段 - 悬停十字线：竖线 + 圆点定位到最近的一分钟，图下方一行读出「时间 · 价格 · 相对昨收 ±% · 均价 · 成交量」
- 顶部显示名称、当前价、当日最高 / 最低
- 1日 / 5日 切换：5 日模式按交易日分段、横轴标日期，不画均价线
- 1 日模式额外画一条均价线（灰色虚线）
设置
全部在 设置 → 插件 → 「数据面板」 这一张卡片里，改完立即生效：
| 设置 | 说明 |
|---|---|
| 显示名称 | 侧边栏文案、面板标题、提示信息共用一个名称，默认「数据」。自动去首尾空白、忽略多余空格、限 24 字 |
| 刷新间隔 | 5 / 10 / 15 / 30 / 60 秒；连续失败时自动退避（最长 2 分钟），成功后恢复 |
| 涨跌配色 | 红涨绿跌（A 股习惯）或绿涨红跌（国际习惯），数值与曲线一起切换 |
| 显示的列 | 开盘 / 最高 / 最低 / 成交额可关掉；名称、最新价、涨跌额、涨跌幅、走势列常驻 |
| 异动提醒阈值 | 当日涨跌幅绝对值超过该百分比时，面板顶部提示；0 = 关闭 |
| 自选股导入 / 导出 | 文本框里的 JSON（{"version":1,"symbols":[...]} 或纯字符串数组），可跨机器搬运 |
设置存在 localStorage（键 dsh-stock-quotes/prefs）。
排序：点「名称 / 最新价 / 涨跌额 / 涨跌幅 / 成交额」表头可排序（降序 → 升序 → 取消）。排序是只读视图，拖动排序前需先取消排序（会提示）。
键盘：Tab 聚焦到某行，Enter / 空格 展开大图，Esc 收起。
支持的代码写法
| 市场 | 写法 | 例子 |
|---|---|---|
| 上交所 | 6 位代码、sh 前缀、.SH/.SS 后缀 |
600519、sh600519、600519.SH、688981、900901 |
| 深交所 | 6 位代码、sz 前缀、.SZ 后缀 |
000001、sz000001、000001.SZ、300750 |
| 北交所 | 6 位代码、bj 前缀、.BJ 后缀 |
430047、830799、920001 |
| 港股 | 1–5 位数字、hk 前缀、.HK 后缀 |
00700、700、hk00700、00700.HK |
| 美股 | 字母代码、us 前缀、.US/.O/.N 后缀 |
AAPL、usAAPL、AAPL.US、BRK.B（自动在 NASDAQ / NYSE / AMEX 之间匹配） |
| 原始 secid | 市场.代码 |
1.600519、116.00700 |
裸 6 位代码有歧义时：两个市场都会试，先命中的胜出。所以 000300（沪深300，只有沪市有）会自动落到 1.000300；而 000001 两个市场都有，默认按深市（平安银行）解析 —— 想要上证指数就写 sh000001 或 000001.SH。显式写了前缀/后缀就不再回退，写错市场会如实报「未找到」。
板块（行业 / 概念）
东财板块走同一个行情接口，面板里可以直接加：
| 写法 | 例子 |
|---|---|
| 东财板块码 | BK1036（半导体）、BK0891（国产芯片） |
| 板块名称（仅面板） | 直接输入 半导体、白酒、存储芯片，按东财板块名精确匹配，否则唯一包含匹配 |
| 原始 secid | 90.BK1036 |
三点须知：
- 同花顺的板块代码（
88xxxx，例如881121）是同花顺私有编码，公开接口没有映射，加不进去 —— 把它换成名称或东财代码即可：881121就是「半导体」，输入半导体或BK1036。 - 两家的板块成分股与权重不同，点位和涨跌幅会有差异（同一时刻实测：东财半导体
+3.47%，同花顺+3.25%）。要跟同花顺完全一致是做不到的。 - 名称解析只在面板里做；
stock_quote工具请直接传BK1036。
搜索（按名称添加）
不确定代码也没关系——在输入框里打字就会弹出建议（名称 + 规范代码），点一下即可加入自选：
| 输入 | 建议 |
|---|---|
茅台 |
贵州茅台 sh600519 |
半导体 |
半导体 BK1036（另有 半导体材料 BK1325 等） |
BK13 |
半导体材料 BK1325 |
600519 |
直接添加（精确代码优先，不需要点选） |
排序规则：完全同名 → 名称前缀 → 名称包含 → 代码前缀。
建议数据来自仓库里的 data/securities.json（约 1.1 万条：A 股、指数、港股、行业/概念板块），面板从 jsDelivr / raw.githubusercontent 拉取一次并缓存一天。索引由脚本生成：
node scripts/build-index.mjs # 需要能访问 push2.eastmoney.com
新股上市后重跑一次并提交即可。索引拉不到（离线、被墙）时，代码和板块名的添加方式仍然可用。
覆盖范围
数据源是东方财富的公开行情接口，能加什么取决于它的覆盖：
- ✅ A 股、北交所、港股、美股、指数、ETF / LOF、可转债、B 股、板块（
BKxxxx） - ❌ 已退市 / 已摘牌的代码（例如
110043）、场外基金净值、期货、期权、外汇 - ❌ 中文个股名称搜索：暂时不支持（公开搜索接口没有 CORS 头，浏览器端拿不到），请用代码；板块名称是例外，见上
如果某个代码你在同花顺能看到却加不进去，可以带完整后缀试一次（600519.SH）；还不行就是数据源没有这只票。
配置
cordis.patch.yml 里的 config.defaultSymbols 是 stock_quote 不带参数时使用的默认自选股：
- insert:
- id: stock-quotes
name: 'dsh-stock-quotes'
config:
defaultSymbols:
- sh000001
- sh600519
- sz300750
- hk00700
- usAAPL
注意：面板自己的自选股存在浏览器里，与这份配置相互独立 —— 配置是给 Agent 查的，面板是给自己看的。
实现说明
| 文件 | 作用 |
|---|---|
package.json |
bundle 清单：dsh.bundle.patch 插入 Host 行，dsh.client 让 Web 端加载浏览器半 |
cordis.patch.yml |
Loader 补丁：插入 stock-quotes 行并给出默认自选股 |
index.js |
Host 半：以原生 ToolDefinition 注册 stock_quote（包外零依赖） |
quotes.js |
纯数据层：代码解析、批量取数、格式化 |
client.js |
浏览器半：main 面板、plugins.bundle.config 设置卡、sidebar.panellist 图标 |
locale/{zh,en}.json |
插件管理器卡片的标题与描述 |
改代码前值得知道的两条设计约束：
- Host 半不能写裸
@deepseek-ai/...import。 工作区里的 bundle 是 link 进 profile 的，这些裸模块名解析不到，整行会failed to import。所以它直接用原生ToolDefinition。 - 浏览器半不 import 任何 Harness 客户端包。 控件全部自己写、只用主题 token（
--dsw-alias-*），这样跨 Harness 版本更稳。
测试
npm test
tests/quotes.test.mjs：代码解析、批量取数、格式化、取消；确定性的部分不联网，联网段不可达时自动跳过。tests/render.test.mjs：工具定义与它渲染的文本——两位小数、正负号、缺失字段显示为「—」、退化输入不抛错。tests/client.test.mjs：模拟模块加载器 / 语言服务 / slot 注册表 / React，断言注册了什么、组件渲染出什么，以及排序、移动和搜索打分的纯函数；另外逐条比对浏览器端与 Host 端的代码解析器，防止两份实现漂移。
Host 半的完整契约校验需要 DSH 安装目录里的包，因此没有放进本仓库。
tests/meta.test.mjs：发布一致性——版本号与代码里锁定的索引版本一致、CHANGELOG有对应条目、files覆盖必需产物、无运行时依赖、索引结构完整。
稳定性、数据来源与免责声明
- 行情来自东方财富对外的公开接口（
push2/push2his），非官方、未授权、无 SLA：接口可能限流、改字段或停止服务。插件对 HTTP 错误做了退避与降级，但不能保证一直可用。 - 搜索索引是仓库里生成的快照（
data/securities.json），通过 CDN 按版本标签固定获取；新股上市后需要重新运行node scripts/build-index.mjs并发布。 - 数据可能延迟、可能不准确。本插件仅供查看，不构成任何投资建议，不得用于交易决策。因使用本插件产生的任何损失由使用者自行承担。
- 插件不收集、不上报任何数据；自选股与设置只存在浏览器
localStorage。
许可证
MIT —— 见 LICENSE。
