- Home
- Plugin
- Strumenti e capacità
- dsh-hitrading
dsh-hitrading
atorber/dsh-hitrading
A-share research assistant with 13 agent tools and a 15-tab console covering quotes, market turnover and breadth, strong stocks, limit-up ladders, watchlists with sectors and T-n returns, a paper portfolio with cash account and trade log, screening, backtesting, news, Weibo and alerts. Analysis only - never places real orders.
Installazione
dsh plugin --profile web add github:atorber/dsh-hitradingREADME
HiTrading — A股投资助手插件
运行在当前 DeepSeek Harness 内的 Cordis 插件。为 Agent 提供 14 个 A股工具,并在 Web GUI 左侧栏挂出 HiTrading 交互控制台(16 个 Tab,所有模块都有 UI)。
纯分析与跟踪,不连接券商、不真实下单;所有结论附投资风险提示,数据来自公开免费接口。
仓库:github.com/atorber/dsh-hitrading · 官网文档:atorber.github.io/dsh-hitrading · 包名 @atorber/hitrading · 当前版本 v1.1.0(更新日志) · MIT
交互控制台(UI)
左侧栏点 HiTrading 图标打开,含 16 个 Tab,全部通过 /api/hitrading 实时读写 Host 数据:
| Tab | 能做什么 |
|---|---|
| 自选 | 加自选(可批量、带关注度+领域+多标签)、实时行情表、关注度/领域/标签筛选、点击个股看 K线图 + 指标 详情 |
| 量能 | 沪深京成交额趋势、情绪仪表(三档操作参考:谨慎区/过渡区/参与区)、涨跌家数对比、涨停跌停统计、指数涨跌与明细表 |
| 强势股 | 按交易日看当日涨幅 > 7% 的股票:左侧日期导航(最近 10 日)、涨停/连板、首封时间、行业、最新涨跌、一键加自选 |
| 涨停板 | 按连板梯队(首板/二板/三板…)列出当日涨停股:左侧日期导航与涨停家数、封单/炸板/封板时间/行业、梯队筛选、一键加自选 |
| 盘前竞价 | 9:15–9:25 集合竞价实时异动(抢筹/砸盘/竞价涨停跌停)、四大指数竞价、11 档涨跌家数分布、竞价量/委比、自选竞价提示;9:25 自动定格快照落库,最近 10 个交易日可复盘 |
| 龙虎榜 | 独立 Tab:资金摘要、多空分歧榜、上榜原因、净买额排序、只看自选 |
| 快讯 | A股 7×24 快讯:监管/宏观/行情分类标记、监管动态提醒卡、只看自选 |
| 公告 | 个股公告:类型分类(业绩/激励/并购/增减持/分红/融资/治理)、按代码查询、一键加自选 |
| 微博 | 微博监控:博主筛选、互动数、已提取标记、提取股票(模型解析写入自选) |
| 模拟仓 | 带 171 万现金账户的模拟交易:买入/卖出按实时现价成交(可指定价格),持仓行可加仓/卖出 + 当日盈亏(较昨收)/累计盈亏 + 成交流水 |
| 选股 | 排序字段 + 区间过滤(市盈率/市值/涨跌幅/换手)+ 结果表 |
| 回测 | 策略选择 + 参数 + 权益曲线图 + 收益/回撤/夏普/胜率 |
| 预警 | 价格/涨跌幅规则增删 + 触发状态 |
| Agent 技能 | 14 个工具的提示词示例(可复制 / 一键试用:新开一个会话并把提示词填进输入框,确认后回车发送)+ 给其他 Agent 安装 SKILL.md 的说明与全文 |
| API | 独立 HTTP 服务接口文档(参数表 + 请求/响应示例) |
| 使用说明 | 整体上手引导、Tab 速览、数据与存储说明 |
Agent 工具
| 工具 | 说明 |
|---|---|
hitrading_quote | 批量实时行情(腾讯/新浪) |
hitrading_kline | 历史 K线(日/周/月/分钟,新浪) |
hitrading_analysis | 个股技术面(MA/MACD/RSI/KDJ)+ 基本面概览 |
hitrading_screen | 全市场排序 + 区间过滤选股(新浪) |
hitrading_market_energy | 沪深京三市日成交额 + 量能状态(东财) |
hitrading_powerful | 强势股:按交易日查当日涨幅>7%(涨停/连板/行业,东财) |
hitrading_limitup | 涨停板:按连板梯队(首板/二板/三板…)查当日涨停股(封单/炸板/封板时间/行业,东财涨停看板) |
hitrading_auction | 盘前竞价:竞价异动(大幅高开/低开、竞价涨停/跌停)、四大指数竞价、涨跌家数分布、竞价量与委比(9:15–9:25 实时,9:25 定格快照,可查最近 10 个交易日) |
hitrading_watchlist | 自选股管理(持久化)+ 关注度分级 + 领域分类(大金融/消费/周期/科技)+ 多标签 |
hitrading_portfolio | 模拟仓买卖与持仓(本地记账、不接券商):现金账户 + 成交流水 + 当日盈亏/累计盈亏 |
hitrading_weibo | 微博监控(本地 Weibo Crawler)+ 提取股票(模型解析写入自选) |
hitrading_news | 快讯 / 个股公告 / 龙虎榜(东方财富) |
hitrading_backtest | 内置策略回测(双均线/MACD/RSI) |
hitrading_alert | 价格/涨跌幅预警(定时器轮询,GUI 内看触发状态) |
数据持久化
自选股 / 模拟仓 / 预警规则存在 SQLite(node:sqlite 内置,WAL 模式),文件:
~/.dsh/storages/hitrading.db
同一份 db 被 Harness 插件与独立 HTTP 服务共用,因此 GUI、Agent 工具、外部程序三方的增删改实时互通(多进程并发由 SQLite WAL 保证)。可用 HITRADING_DB 环境变量覆盖路径。
数据保护:
- 旧数据自动迁移:早期版本存在同目录的
hitrading.json,首次启动时会自动导入当前库(不覆盖已有记录),导入后把旧文件改名为hitrading.json.migrated。 - 每小时自动快照:
hitrading.db.bak(VACUUM INTO生成的一致性副本,含 WAL 中未 checkpoint 的写入)。误删可把.bak复制回.db恢复。 - 面板里的「移除自选 / 重置模拟仓 / 删除预警」均有二次确认。
外部程序通过 HTTP 访问(量化脚本)
插件加载时会自动拉起独立服务(server.js),默认监听 127.0.0.1:8099,无需手动启动;插件停用/卸载时子进程随之关闭。
面板头部右侧常驻服务状态(绿点=运行中 / 红点=已停止)与 启动 / 停止 / 重启 三个按钮;状态每 5 秒自动刷新。
也可在 Harness 未运行时手动启动:
node server.js(或npm run start:api)。端口已被占用时新进程会自行退出,不会冲突。
配置:HITRADING_PORT(默认 8099)、HITRADING_HOST(默认 127.0.0.1)、HITRADING_TOKEN(可选,设置后需带 Authorization: Bearer <token>)、HITRADING_DB(默认 ~/.dsh/storages/hitrading.db)。
接口统一返回 { ok, value } 或 { ok: false, error }:
GET /health— 返回{ service, name, version, repo, docs, time },可用于版本自检GET /api?op=<op>&...POST /api,body{ "op": "<op>", "args": {...} }
op 与 Agent 工具同名:quote / kline / analysis / screen / market_energy / powerful / limitup / auction / watchlist.list|add|remove / portfolio.buy|sell|list|trades|reset / news / backtest / alerts.list|create|delete / weibo(列表),另有 version(包名/版本/仓库/文档地址)。
import requests
B = "http://127.0.0.1:8099"
# 实时行情
print(requests.get(f"{B}/api", params={"op": "quote", "symbols": "600519,000001"}).json()["value"]["quotes"])
# K线
print(requests.get(f"{B}/api", params={"op": "kline", "symbol": "600519", "period": "day", "limit": 60}).json())
# 选股
print(requests.get(f"{B}/api", params={"op": "screen", "sort": "changepercent", "pctMin": 5, "limit": 30}).json())
# 自选(与 GUI 共享同一份数据)
requests.post(f"{B}/api", json={"op": "watchlist.add", "args": {"symbols": ["600519"]}})
该服务与 Harness 插件共享同一 SQLite,写入实时互相可见。预警定时检查只由 Harness 插件(GUI 运行时)执行;独立服务提供规则的增删查。
给其他 Agent 使用(SKILL.md)
本仓库提供一份可直接安装的 skill:skills/hitrading/SKILL.md,内含启动方式、全部接口、示例与任务配方。
做法:把这份文件放进目标 Agent 的技能目录即可,安装交给 Agent 自己完成。
# 通用:把 <技能目录> 换成你的(如 ~/.agents/skills、~/.claude/skills、~/.cursor/skills)
curl -o <技能目录>/hitrading/SKILL.md http://127.0.0.1:8099/skill.md
或者直接把这句话发给目标 Agent:
请把 http://127.0.0.1:8099/skill.md 安装到你的 skills 目录(例如 ~/.agents/skills/hitrading/SKILL.md),然后按其中的说明使用 A股能力。
前提是 HiTrading 的本地服务已启动(node server.js)。
目录结构
index.js # Host 入口:工具 + /api/hitrading 路由 + 定时器 + 免责声明
client.js # Client 入口:sidebar 图标 + 16-Tab 交互控制台
server.js # 独立本地 HTTP 服务(供外部程序/量化脚本)
lib/ops.js # 单一真相源:A股操作(工具/路由/独立服务共用)
lib/auction.js # 盘前竞价三态引擎(实时 / 定格快照 / 开盘价重建)
lib/db.js # 跨进程共享的 SQLite 存储
lib/*.js # 数据适配(http/quotes/kline/market/news/backtest/indicators/symbol)
cordis.patch.yml # Loader 插入行
locale/*.json # 中英双语标题/描述
icon.svg # 图标
版本号与发布
版本号的唯一真相源是 package.json 的 version,CHANGELOG.md 记录每个版本的变化。面板头部右侧、GET /health、GET /api?op=version 与独立服务启动日志都从同一处读取,不会出现手写漂移。
# 升级版本(会把 CHANGELOG 的 [Unreleased] 定版为带日期的版本段落)
npm run bump -- patch # 或 minor / major / 1.2.3
# 只校验不修改(CI 与发布流水线都跑这个)
npm run check:version # version 格式、CHANGELOG 段落、是否低于已发布最高版本、tag 一致性
发布流程:把变更写进 CHANGELOG.md 的 [Unreleased] → npm run bump -- minor → 提交 → git tag -a v1.2.0 -m "v1.2.0" → 推送 tag。.github/workflows/release.yml 会校验 tag 与 package.json 版本一致,再打包并创建 GitHub Release。
其他自查脚本:
| 命令 | 作用 |
|---|---|
npm run check:version | 版本号与 CHANGELOG 一致性 |
npm run check:manifest | 插件清单自检(含 dshmarket 收录要求:dsh.bundle.patch、cordis.patch.yml、locale、icon、screenshots.json) |
npm run test:smoke | 起临时端口的独立服务,核对 /health、version、energy 与未知 op 报错 |
npm run start:api | 手动启动独立 HTTP 服务 |
发布到 dshmarket 市场
dshmarket(dshmarket.com)的目录数据来自 awesome-dsh-plugin,每日 CI 刷新,所以「上架」= 让仓库被该目录收录。本仓库已备齐材料,按 发布指南 执行即可:
- 给仓库加 GitHub topic
dsh-plugin:gh api -X PUT repos/atorber/dsh-hitrading/topics -f names[]=dsh-plugin - (推荐)发布到 npm:已自动化且免 token——在 npmjs.com 包设置里一次性登记 Trusted Publisher(GitHub Actions /
atorber/dsh-hitrading/npm-publish.yml,Allowed actions 勾选npm publish),此后打v*.*.*标签即由.github/workflows/npm-publish.yml通过 OIDC 自动npm publish;也可在 Actions 页手动触发补发。详见发布指南 - 向 awesome-dsh-plugin/awesome-dsh-plugin 提 PR,只加一个文件
data/plugins/atorber__dsh-hitrading.yml,内容用本仓库的market/atorber__dsh-hitrading.yml - 目录合并后次日生效,用户在 Harness 内即可搜到并一键安装
仓库内已包含的市场材料:assets/icon-180.png(180×180 栅格图)、screenshots.json(6 张截图)、market/atorber__dsh-hitrading.yml(条目文件)。
安装市场客户端并在本地验证:
dsh plugin --profile web add dshmarket # 需 dsh 0.2.1+
# 重启 dsh web → Plugins → Plugin Market Tab
安装
从 GitHub 安装(推荐)
对 Harness 的对话说:
帮我安装 GitHub 上的插件:https://github.com/atorber/dsh-hitrading
或直接在 Harness 内通过 plugin_manager 安装(install_bundle,target 填 https://github.com/atorber/dsh-hitrading)。安装程序会自动拉取仓库、解析 @deepseek-ai/dsh-tools peer 依赖并应用插件补丁。
要求:DeepSeek Harness ≥ 0.2.2-rc.1(peer 依赖 @deepseek-ai/dsh-tools@>=0.2.2-rc.1 <1.0.0-0,显式覆盖预发布版本,避免 rc 被静默排除)。
从本地目录安装(开发)
git clone https://github.com/atorber/dsh-hitrading.git
# 在 Harness 内:plugin_manager install_bundle target=<仓库绝对路径>
安装后 hitrading 插件激活,在左侧栏出现 HiTrading 图标与面板,对话中可用上述 14 个工具。
本地开发注意
本插件在 Host 侧 import 了 @deepseek-ai/dsh-tools(工具定义)。从 GitHub/registry 安装时该包由 pnpm 按 peerDependencies 自动装进 profile,开箱即用;本地 link: 开发时 pnpm 不会为 link 依赖装 peer,Node ESM 又从插件真实路径向上解析 node_modules(插件目录不在 DSH 安装树内),因此需在插件目录建立指向 DSH 安装树的软链:
cd /path/to/dsh-hitrading
mkdir -p node_modules
DSH_NPM_ROOT=$(dirname "$(dirname "$(readlink -f "$(which dsh)")")")/node_modules
ln -sfn "$DSH_NPM_ROOT/@deepseek-ai" node_modules/@deepseek-ai
该软链指向当前 DSH 安装(npx 缓存)路径,已列入
.gitignore;若 DSH 从新的 npx 缓存启动,需重建软链。
Plugin correlati
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