- Home
- Plugins
- Tools & Capabilities
- dsh-stock-quote
dsh-stock-quote
mengmenghao/dsh-stock-quote
Real-time quotes for A-share, Hong Kong and US listings: the stock_quote and stock_search tools, a watchlist page, and a per-stock page with daily candles and an AI analysis prompt.
Install
dsh plugin --profile web add github:mengmenghao/dsh-stock-quoteREADME
@liaomenghao/dsh-stock-quote
股票行情插件,三部分:
- 「股票行情」页面:侧边栏入口 + 主区面板,维护自选列表(添加、删除、手动/自动刷新),A 股、港股、美股同屏。
- 个股详情:点列表里的名称进入,日 K 线(蜡烛图 + 成交量 + MA5/MA20,60/120/240 日可切换)。
- AI 分析:详情页写下分析要求,用当前 profile 的默认模型生成结论。
- Agent 工具:
stock_quote与stock_search,会话里直接问「茅台现在多少」。
安装
npx @deepseek-ai/dsh plugin --profile <profile> add @liaomenghao/dsh-stock-quote
装完重启 Harness,侧边栏出现「股票行情」入口。
要求:DSH ≥ 0.2.0、Node.js ≥ 20。插件零运行时依赖,行情与 K 线都走公开接口,不需要 API key。
页面
侧边栏「股票行情」进入。自选列表存在浏览器 localStorage(键 dsh-stock-quote.watchlist),默认 sh000001、600519、00700.HK、AAPL。
- 顶部输入框接受代码或名称:回车添加首个搜索结果,或点选下拉里的候选;像
sz002594这样的完整代码可直接回车。 - 每 30 秒自动刷新一次,可关闭;右上角「刷新」立即取一次。
- 表格展示名称/代码、现价、涨跌、涨跌幅、成交量、换手率、行情时间。涨红跌绿。
个股详情
点表格里的名称进入:
- 分时(今日):默认视图。今日逐分钟价格线、均价线、昨收虚线基线、成交量柱,涨红跌绿;左上角标注该数据所属交易日。
- 日 K 线:蜡烛图(涨红跌绿)、上下影线、MA5 / MA20 折线、成交量柱、右侧价格刻度、最新价虚线。数据为前复权日线,周期可切 60 / 120 / 240 日。
- AI 分析:写下要求(有「趋势走向 / 支撑压力 / 风险点」三个快捷填充),点「开始分析」。答案就显示在输入框下方,不跳转。
面板内的多轮对话
同一只股票里可以连续追问:
- 每轮问答依次排在下方的对话线程里,最新的在最下面,每条带时间;
- 追问时会把之前的问答一并带上,所以「那压力位呢?」这种指代能接上;
- 最多带最近 6 轮给模型;页面上最多保留 20 轮,最多记住 30 只股票;
- 记录按股票存在 localStorage(键
dsh-stock-quote.analyses),退出详情、切换股票、刷新页面都还在; - 「清空对话」只清掉当前这只股票的记录。
实现上是把历史折进一条 user 消息(【之前的对话】…【最新行情】…【我的新要求】…),而不是拼成多轮 messages——后者需要手造带 source 的 assistant 消息,容易踩到适配器的假设。每轮都会重新取一次最新行情,所以历史里的旧价格不会污染当前判断。
分析用的是当前 profile 的默认模型,费用按普通模型调用计费(实测一次约 2.2k 输入,追问多 0.25k 左右)。
工具
| 工具 | 参数 | 返回 |
|---|---|---|
stock_quote | symbols:代码数组,单次最多 20 个 | 现价、涨跌额、涨跌幅、昨收、开盘、最高、最低、成交量、成交额、换手率、市盈率、总市值,以及该笔行情的交易所时间戳 |
stock_kline | symbol;days:20–250,默认 60 | 前复权日线(日期/开/高/低/收/量,由旧到新)+ 当前报价 |
stock_search | keyword:名称 / 代码 / 拼音首字母;limit:1–20,默认 8 | 候选列表,每项带 symbol,可直接传给 stock_quote |
支持的代码写法:600519、sh600519、600519.SH、430047(北交所)、00700、0700.HK、AAPL、BRK.B、usBRK.B。只给公司名时先用 stock_search。
数据来源
- 实时行情:腾讯
qt.gtimg.cn,GBK 编码,单次请求可批量取多只。 - 日 K 线:东方财富
push2his.eastmoney.com,前复权日线;美股按 105/106/107 市场段探测后缓存。 - 代码搜索:东方财富 suggest 接口。
插件不写缓存、不落盘(美股市场段除外,仅进程内缓存),每次调用都实时请求上游。
内部路由
页面通过同源接口取数,与工具共用同一套解析,避免页面和工具各说一套:
| 路由 | 用途 |
|---|---|
GET /stock-quote/quotes?symbols=a,b | 批量报价 |
GET /stock-quote/search?q=... | 代码搜索 |
GET /stock-quote/kline?symbol=...&days=120 | 日 K + 当前报价 |
GET /stock-quote/intraday?symbol=... | 今日分时序列(含昨收)+ 当前报价 |
「在会话中分析」不经过 HTTP:客户端用 ctx.sessions.create 建会话、prompt 投递首条消息,再 uiWorkspace.openSession 切过去。
验收
npm test
跑的是 test/accept-analyze.mjs:用一个最小 React 实现(支持 state、effect、useCallback 记忆化和元素 key 重挂载)把 client.js 真正挂载起来,然后用桩数据驱动界面,逐条断言「分析」按钮的行为:
| 覆盖 | 断言 |
|---|---|
| 列表 → 详情 | 点股票名能进入详情,历史记录被恢复 |
| 按钮状态 | 输入为空时禁用,有输入时可用 |
| 点击行为 | 只发一次请求,body 里带上了新问题和历史 |
| 结果呈现 | 就地多出一条问答、输入框清空、用量显示 |
| 持久化 | 结果写入 localStorage,清空只删当前股票 |
| 跨股票隔离 | 切到另一只股票不会带上上一只的问答 |
npm test 通过 18 项。
它不覆盖:真实浏览器渲染、CSS 效果、皮肤/宠物等第三方浮层对点击的遮挡。这些只能在实际界面里看。
注意
- 行情时间戳是交易所当地时间(A 股
Asia/Shanghai、港股Asia/Hong_Kong、美股America/New_York)。非交易时段返回的是最近一个交易时段的快照,判断「是否实时」要看这个时间戳,而不是页面上的「更新于」。 - 分时图在非交易日展示的是上一个交易日的完整走势,左上角标注的日期会告诉你数据属于哪一天。
- A 股成交量的上游单位是「手」、成交额是「万元」,插件已换算为股和元;港股与美股上游本身就是股与当地货币。
- 只有一个实时行情上游。上游不可达时,工具会把失败原因放进结果的
unresolved,页面会显示错误条,都不会返回旧值或猜测值。 - 若界面顶部的皮肤装饰层盖住了页面标题,那是所启用皮肤(如 maid-atelier)在非会话页的固定装饰,宿主的「任务看板」同样如此;页头已按该装饰的高度留白。
- AI 分析消耗模型额度,按次调用;10 分钟内同一问题的重复点击会命中页面内缓存。
配置
cordis.patch.yml 里该行的 config 支持:
| 键 | 默认 | 含义 |
|---|---|---|
timeoutMs | 8000 | 单次上游行情/K 线请求超时,范围 1000–20000 毫秒 |
文件
| 文件 | 作用 |
|---|---|
index.js | Host 半:两个工具、四个面板路由、分析请求组装 |
quote.js | 代码归一化、行情/K 线/搜索解析、格式化 |
client.js | Client 半:侧边栏图标、自选面板、详情页与 K 线图 |
cordis.patch.yml | bundle patch,插入 stock-quote 行 |
Related plugins
archify (deepseek-harness)
tt-a1i/archify
WeKnora (dsh-weknora)
tencent/weknora
next-ai-draw-io (dsh-plugin)
dayuanjiang/next-ai-draw-io
weknora
tencent/weknora