行情盯盘 Justin-Mai/dsh-stock-view

dsh-stock-view

DeepSeek Harness 右上角行情盯盘插件：A 股 / ETF / 港股 / 美股 自选股 + 加密货币实时行情。

本插件 fork 自 dsh-stock-watch v1.1.0（MIT，作者 Awu12277），在其基础上做了下面这些改造。原作者的行情解析逻辑（腾讯财经接口、K 线列序、分时昨收反推）完整保留。

仓库：

相对上游的改动

| # | 改动 | 说明 |
| 1 | 移除悬浮扇形菜单 | 鼠标移到胶囊上不再弹出「行情分析 / 每日复盘 / 涨停分析」三项，host 端对应的三份提示词注入也一并删除（FAN_PROMPTS 与 .fan-prompts systemPrompt section）。其余交互不变。 |
| 2 | 新增加密货币监控 | 自选股里可以直接添加加密货币，列表 / 分时 / K 线三种视图与股票完全一致。 |
| 3 | 顺带修复 | 上游 web.ifzq.gtimg.cn/appstock/app/minute/query 已被腾讯 WAF 路径级拦截（HTTP 501），改用同一套 API 的 proxy.finance.qq.com 镜像并保留原 host 作为回退。 |
| 4 | 新增美股 | usAAPL / usNVDA 等，快照 / 分时 / K 线三视图与 A 股一致（走东方财富，见下）。 |
| 5 | 表头常驻前两个分组 | 固定钉住分组列表的第 1、2 个（不随切换变化），两行表头布局，切换时表头不跳动。 |
| 6 | 分组管理器 | 表头不再铺一行 tab；右侧 切换 下拉含全部分组，支持切换 / 拖动排序 / 删除 / 重命名。 |

| 7 | 不再随包分发技能 | 上游会把 skills/（Anthropic 的 frontend-design + investment-research）注入 ~/.agents/skills/，本 fork 移除了该文件与该行为，只再分发自己的代码。代价：「一键分析」需要用户自备这两个技能。 |

保留的原有能力：分组管理、代码/名称搜索、分时图、日/周/月 K 线（含 MA 均线）、买卖目标价与触发提示、暗/亮主题、胶囊拖拽吸附、面板缩放、展开态迷你走势、一键分析。

美股数据源

代码约定 us，例如 usAAPL、usNVDA、usBABA。搜索直接复用腾讯 smartbox（支持 AAPL、苹果、特斯拉 等），结果里带交易所后缀（aapl.oq），用它直接定出东方财富 secid，省掉逐交易所探测。

为什么不用腾讯（实测，见 tools/probe-us-stocks.mjs）：腾讯对美股三个接口都不完整 ——

- minute/query 的 data.data 只有 1 个点、date 为空 → 拿不到分时
- fqkline/get 的 day 只回「最早一根 + 最新一根」 → 拿不到 K 线序列
- 行情字段首项为 "delay" → 延时数据

改用东方财富（与 stock-sdk 同一选择）：

| 视图 | 接口 | 口径 |
| 快照 | /api/qt/stock/get | 现价/涨跌额/涨跌幅/开高低/量额（fltt=2 已是十进制） |
| 分时 | /api/qt/stock/trends2/get?ndays=1 | 当日，实测 391 个点；时间为北京时间 |
| K 线 | /api/qt/stock/kline/get | klt=101/102/103，fqt=1 前复权，160/120/60 根 |

secid 前缀：105=NASDAQ、106=NYSE、107=AMEX。手工输入 usXYZ（无后缀）时会按这三个交易所依次探测，结果进程内缓存。

分组：表头常驻前两个

表头保持单行，分组区不再单独占一行：

📈 行情盯盘 [分组1] [分组2] [切换] ⏱10s ◐ ⟳ — [折叠] └── 标题 ──┘ └─ 常驻钉住 ─┘ └切换┘ └── 动作图标 ──┘

宽度紧张时可压缩的只有「钉住标签 → 留白」这一段（标签自动省略号截断），右侧的动作图标固定不被挤。

- 常驻的前两个：固定钉住分组列表的第 1、2 个，不随当前分组变化 —— 所以表头永远稳定、切换时不跳动。
点一下即切换，当前所在的那个高亮（[分组1] 高亮 = 正在看分组1）。
如果当前分组不在这两个里（从下拉切到了第 5 个），两个标签都不高亮 —— 表头只负责"快速回到常用的两个"，当前在哪一组由列表内容和下拉里的高亮表示。
- 切换（表头右侧那个按钮）：其余分组全部在这个下拉里。弹窗按「相对面板」的坐标定位，高度自适应到面板底边，所以面板拖到屏幕下方也不会跑出面板或被裁掉。

下拉本身是个分组管理器：

| 操作 | 怎么做 |
| 切换 | 点下拉里的任意一行。下拉不自动收起，方便连续切几个；鼠标移开才收。 |
| 调顺序 | 按住行首 ⠿（或整行）上下拖动，目标位置显示青色横线 |
| 删除 | 点该行右侧 ✕（二次确认；至少保留一个分组） |
| 重命名 | 双击分组名，就地改名 |

行的右侧显示该分组的股票数，当前分组高亮。拖动重排后当前选中的分组不会跑掉（按对象身份重算下标）。

钉住的顺序 = 分组列表顺序。想让别的分组常驻，就在下拉里把它拖到前两位。

加密货币数据源

代码约定为 cr:，例如 cr:BTC-USDT。cr: 前缀用于在 /quotes 等路由里与 A 股（sh/sz）、港股（hk）、美股（us）无歧义分流。

数据来自 OKX 现货公开 REST（https://www.okx.com/api/v5，无需 API Key）：

| 视图 | 接口 | 口径 |
| 列表快照 / 迷你走势 | /market/ticker、/market/candles?bar=5m&limit=48 | 现价、24h 涨跌幅/涨跌额/最高/最低、24h 成交量额 |
| 分时 | /market/candles?bar=5m&limit=288 | 最近 24 小时（≈23.9h），基准线取区间首根开盘价 |
| K 线 | /market/candles?bar=1D\|1W\|1M | 160 / 120 / 60 根；OKX 日线按 UTC+8 0 点切分 |
| 搜索 | /public/instruments?instType=SPOT | 407 个可交易 USDT 现货对，保证结果都能取到行情 |

选型实测（tools/probe-crypto.mjs）：

- Binance api.binance.com → HTTP 451（地域限制）
- CoinGecko api.coingecko.com/simple/price → HTTP 403（风控，仅 /search 可用）
- OKX www.okx.com/api/v5 → 全部 200，国内可直连

使用

1. 面板顶部 🗂 添加分组 建一个分组（首次运行会自动补一个「加密货币」分组，只加一次）。
2. ＋ 添加股票 → 输入 btc、eth、比特币、狗狗币 等搜索，选中即加入。
3. 点击列表行进入详情，可切 分时 / 日K / 周K / 月K，与股票一致。
4. 详情里的「一键分析」会新开一个会话，提示模型依次使用 investment-research 与 frontend-design 两个技能。本包不随包分发技能（上游会在首次启动时把 skills/ 注入 ~/.agents/skills/，这里已移除该行为），请自行安装这两个技能，否则该按钮发出的请求会缺少技能指引。插件本身不依赖它们运行。

自选股配置存在浏览器 localStorage（键 stocking.config.v1，与上游一致，因此从 dsh-stock-watch 迁移过来时自选股会自动延续），首次打开会从 ~/.stocking/settings.json
一次性迁移，失败则用默认分组。重置：localStorage.removeItem('stocking.config.v1') 后刷新。

买卖目标价同样支持加密货币（按 USDT 计价）——价格触达时胶囊会给出提示。

HTTP 路由

| 路由 | 说明 |
| /dsh-stock-view/config | 读取 ~/.stocking/settings.json（客户端首次迁移用） |
| /dsh-stock-view/stocks?q= | 搜索：A 股池 + ETF 池 + 港股池 + 腾讯 smartbox（含美股 GP/ETF）+ OKX 加密货币 |
| /dsh-stock-view/quotes?group=&minutes=&groups= | 按分组拉取快照（cr:→OKX，us→东方财富，其余→腾讯），minutes=1 附带迷你走势 |
| /dsh-stock-view/kline?code=&period= | 日/周/月 K 线（A股/港股走腾讯前复权，美股走东方财富，加密货币走 OKX） |
| /dsh-stock-view/minute?code= | 分时详情（A股/港股=当日分钟线，美股=当日 391 点，加密货币=最近 24h） |

安装

作为本地插件安装到 profile：

// /package.json
"dependencies": { "dsh-stock-view": "link:../../../Desktop/dsh/dsh-stock-view" },
"dsh": { "profile": { "bundles": ["dsh-stock-view"] } }

装好后重启 DSH Desktop（bundle 在启动时组合；客户端代码也只在启动时从磁盘快照）。

数据目录

- data/a_stocks.json、data/etf_stocks.json、data/hk_stocks.json：股票/ETF/港股代码池（随包）
- 本包不含 skills/：不随包分发任何第三方技能或素材
- 加密货币不需要本地池：搜索直接查 OKX 交易对清单（30 分钟内存缓存）
- 常见币种中文名内置在 crypto.js 的 COMMON_COINS

开发工具（tools/）

| 文件 | 用途 |
| strip-fan.mjs | 从上游 client.js 移除扇形菜单（带锚点与残留守卫） |
| apply-edits.mjs | 更名 / 移除迁移补丁 / 插入 crypto helper（带断言） |
| integrate-crypto.mjs | 把加密货币接入三个路由 + 搜索 + 默认分组 |
| round2-us-and-groups.mjs | 接入美股分流 + 分组拖拽 / 下拉切换 |
| round3-group-manager.mjs | 表头改单分组 + 下拉升级为分组管理器（删除 / 排序 / 重命名） |
| round4-pinned-two.mjs | 表头常驻前两个分组 + 两行布局 |
| test-plugin.mjs / test-us.mjs | 导入真实模块并调用各 handler 的端到端测试 |
| probe-*.mjs | 各数据源连通性与字段探测（腾讯 / OKX / 东方财富） |

License

MIT。上游 dsh-stock-watch 版权归 Awu12277 所有，见 LICENSE。