Zum Hauptinhalt springen
A

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.

Installation

dsh plugin --profile web add github:atorber/dsh-hitrading

README

HiTrading — A股投资助手插件

npm CI Release Docs

运行在当前 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 刷新,所以「上架」= 让仓库被该目录收录。本仓库已备齐材料,按 发布指南 执行即可:

  1. 给仓库加 GitHub topic dsh-plugin:gh api -X PUT repos/atorber/dsh-hitrading/topics -f names[]=dsh-plugin
  2. (推荐)发布到 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 页手动触发补发。详见发布指南
  3. 向 awesome-dsh-plugin/awesome-dsh-plugin 提 PR,只加一个文件 data/plugins/atorber__dsh-hitrading.yml,内容用本仓库的 market/atorber__dsh-hitrading.yml
  4. 目录合并后次日生效,用户在 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 缓存启动,需重建软链。

Ähnliche Plugins