AI 交易终端 zhu1090093659/dsh-trading

dsh-trading — 开源 AI 交易终端与多智能体量化平台

当前状态与交接：见 docs/current-state.md（已验收里程碑、fail-closed 不变量、文档地图）。

dsh-trading 是开源、agent-native 的 AI 交易终端与量化投资研究平台，构建在 DeepSeek Harness (DSH) 与 Cordis 微内核之上。它把加密货币（Binance、OKX、Bybit、CCXT）、美股（Alpaca、Interactive Brokers、Yahoo Finance）、中国 A 股（MiniQMT、Eastmoney、AkShare、Tushare）、港股（Longbridge、Futu、Tiger）与中国商品期货统一到同一个模块化工作区。

dsh-trading 结合 TradingView Lightweight Charts v5、按角色划分的多智能体团队（Master、Researcher、Trader、Risk Reviewer）、内置策略回测，以及零信任双轨人工审批闸门，在深度 AI 推理与有纪律的交易执行之间搭起桥梁。

快速开始 · 核心功能 · 为什么选 dsh-trading · 支持的市场 · 智能体架构 · 常见问题 · 文档

dsh-trading — Your next trading terminal, and your AI Agent

你的下一台交易终端，也可以是你的 AI 智能体。
No chumps for the slaughter, just everyday traders.

核心功能

- 一体化多市场工作区： 在统一自选列表里跟踪加密货币（现货与永续合约）、美股、中国 A 股、港股与商品期货，实时行情、订单簿与公司披露一应俱全。
- TradingView 图表与市场深度引擎： 舞台中央是 Lightweight Charts v5，支持多周期切换（5m 到周线）、15+ 技术指标（MA、EMA、MACD、RSI、Bollinger Bands、KDJ、SuperTrend、TD9）、逐笔成交，以及加密衍生品指标（未平仓量、资金费率、多空比）。
- 智能体原生的多智能体编排： 一支协作 AI 团队（master 领队，instrument-researcher、trader、risk-reviewer），自主查询行情数据工具、做财务报表分析、起草交易计划、压测风险场景。
- 机构级研究手册与风险清单： 每个市场都附带盘前风险清单，一套 5 步加密标的分析框架，机构级公司估值手册，以及只追加、双轨并行的交易日志。
- 量化策略回测： 用 strategy_backtest 构建并回测系统化交易信号，编写自定义技术指标，跨市场周期评估历史表现。
- 零信任安全与双轨审批闸门： 默认空跑模拟；实盘券商下单需要显式开启、人工交互确认，外加 Ed25519 授权平面。无头环境下失败即关闭。
- 100% 本地隐私（BYOK）： 自带密钥。API 密钥和个人交易记录严格只存在你的本机。零厂商锁定，零云端遥测，零行情数据再分发。

先问你一个问题：

你交易亏掉的钱里，有多少是在你真正想清楚之前就亏掉的？

追一波涨，结果成了别人的退出流动性。抄底，它接着跌。止损，你一出来它就反弹；扛单，它把你磨进深红。（老手也未必次次躲得过。）

问题出在哪？不在运气，在纪律。

市场每天都开门，多空每天都厮杀。散户手里最靠得住的武器，从来不是更好的消息——是纪律。老猎手十次里有九次在等，剩下那一次才出手；多数交易者正好相反——九次在动，一次在悔。

这就是 dsh-trading 存在的理由：一个智能体原生的交易终端，构建在 DeepSeek Harness (DSH) 之上。专业交易工作流，配一个与市场同步的 AI 智能体：行情、新闻、资金流都在它视野里；研究按机构级手册走；真实订单发出之前，每一单都要过一道只有你的手能点的审批闸门。

加密、美股、中国 A 股、港股。一个终端。一个智能体。十九个以上连接器。零厂商锁定——每一把密钥都留在你的机器上。

dsh-trading 终端——自选列表、带指标的图表舞台、订单簿与衍生品面板

为什么选 dsh-trading，而不是其他方案？

| 维度 | 传统交易终端（TradingView / 券商 App） | 通用 AI 聊天机器人（ChatGPT / Copilot 侧边栏） | dsh-trading（智能体原生终端） |
| 多市场覆盖 | 账户分散在不同 App 里 | 只有文字对话，没有实时行情 | 统一自选列表与 Dock：加密货币、美股、A 股、港股、期货 |
| 实时市场深度 | 订阅费用高，数据封闭 | 幻觉频出，零逐笔数据、零订单簿 | 实时 L2 订单簿、逐笔成交、加密货币资金费率与未平仓合约 |
| 终端集成 | 没有，或只有简单的外部提醒 | 聊天框贴在图表旁边，靠手动复制粘贴 | 终端一等公民：AI 直接驱动原生行情工具与代码分析 |
| 多智能体架构 | 没有 | 单一提示词 / 单一模型 | 分层团队：主控（Lead）+ 研究员 + 量化交易员 + 风控审核员 |
| 投资研究 | 在多个网站之间手动翻阅 | 泛泛的网页搜索摘要 | 内置机构级技能：市场风险清单、加密货币五步框架、估值手册 |
| 策略与回测 | 各自封闭的专有脚本（Pine Script） | 无法在真实行情上跑代码 | 原生 strategy_backtest 引擎，可在工作区内编写指标 |
| 执行安全 | 手动点击，或黑箱算法不透明 | 无人监控的执行，危险；或者干脆不能执行 | 双轨闸门：默认模拟运行，实盘下单需人工批准，Ed25519 授权 |
| 隐私与凭据 | 密钥存在第三方云服务器上 | 提示词与数据发往外部云端 AI | 100% BYOK，存在你本机，零数据外传 |

智能体原生是什么意思？

大多数「AI 交易工具」长什么样？一个聊天框，贴在图表旁边。

是贴上去的，不是长出来的。

dsh-trading 把这种关系彻底翻过来：智能体是终端的一等公民，终端是智能体的身体。 它和你用过的任何聊天机器人有四点不同：

1. 行情、新闻、资金流——智能体全都有。 实时报价、当前 K 线、图表序列的时间范围连同取数定位符（智能体据此自己拉取同一份路由数据，并用代码分析）、你当前启用指标的算值、衍生品快照，再加上公告、新闻和一份有边界的基本面摘要——这些都是原生工具，智能体为你正在看的标的直接驱动。缺失的数据源会明确标出；系统会引导智能体核对原始披露，并用原生研究工具补齐。不用再截图复制粘贴了。
2. 智能体可以交易，但闸门握在你手里。 行情数据、订单簿、衍生品持仓、新闻、下单，全是原生工具。但每笔订单默认走 dry-run 模拟；实盘路由必须显式开启 liveTrading: true，开启后每笔订单仍要经过人工交互审批。无头环境下直接失败关闭。一条规则：没有闸门，不动手。任何操作都不会背着你执行。

3. 智能体为此受过训练。 领域知识以捆绑技能的形式提供，不靠模型临场发挥：每个市场的盘前风险清单（crypto · US · CN · HK）、五步加密标的分析框架、完整的公司分析手册，以及交易日志纪律——双轨记录「智能体做了什么」与「你做了什么」，只追加、可审计。

风险清单在每次入场前运行——这种纪律，多数老手十年都坚持不下来（通常败给「就这一次」）。

4. 一位大师带领角色化团队。 master（大师）是全能的多智能体团队负责人：每个交易问题都先落到统一持仓账本（holdings_list / holdings_stage）和各市场余额工具上，先拉取用户知识库，再拆解任务，把专项工作分派给固定人设的子代理——标的分析交给研究员（researcher_subagent），交易计划起草交给交易员（trader_subagent），计划审查交给风险审查员（risk_reviewer_subagent）——按任务类型调度项目技能（分析框架、市场风险清单、配合 strategy_backtest 的策略范式、用于一次性跨标的聚合的动态包），最后交叉核对、整合出单一结论。跨市场概览和订单执行它可以自己做，仍然默认 dry-run、位于审批闸门之后；子代理只交付分析文本——执行始终留在闸门后的大师手里。其下：trader（交易员）负责交易计划与受闸门管控的执行，instrument-researcher（标的分析研究员）负责披露、基本面与估值，risk-reviewer（风险审查员）负责敞口、压力情景与拒绝条件。每个角色都优先使用项目知识、新闻/公告和基本面工具。研究与风险角色保留只读的行情/ K 线，但不挂载下单/撤单连接器；子代理继承会话工具集，用人设固定职责——共享的宿主工具仍然可见，所以角色划分不是独立的安全沙箱。
基础安装器根据已启用的市场包生成这四个角色，部分市场安装也包含在内；新会话的部署默认角色是大师（master），用户可在设置中按人覆盖。未改动过的托管旧版市场预设会迁移到同级的 .legacy-backup 根目录；自定义、未打标记或扩展过的目录保持原样。不会删除任何用户预设数据。

终端本身得先是真正的软件

终端做得糙，再聪明的智能体也只能纸上谈兵。

- C 位图表： Lightweight Charts v5，支持多周期切换（5m 到周线）；MA / EMA / BOLL / MACD / RSI / KDJ / SuperTrend，全部可视化编辑；策略信号标记、知识事件图钉、拖拽测距区间统计。
- 真实市场深度： 实时订单簿带买卖压力条，逐笔成交，还有衍生品驾驶舱——持仓量、资金费率与结算倒计时、多空比、主动成交流向。行情与资金流数据是原生工具，智能体按需查询。
- 跨市场自选： 加密永续合约挨着 AAPL，再挨着牧原股份，带迷你走势图和实时报价。整个风险宇宙收进一个停靠栏。

操作界面内置

- 用量统计： DSH 内置的性能与用量设置界面展示每个会话的实时 token 流与花费，在宿主侧解析，凭据不会进入浏览器。
- 插件管理器： 插件区新增管理标签页：从 npm 规格或 git URL 安装，切换下次启动时的启用状态，检查并应用已验证的更新（以每个包声明的最低 DSH 版本为门槛），回滚冲突的安装，把失败交给修复会话处理。写入仅限回环地址，并走官方命令行；桌面版自带 dsh shim，无需全局安装也能用。
- 按模型声明能力： 每张自定义 llm-pi-ai 服务商卡片都带能力区：按模型声明图像输入与推理强度（包括每个档位实际发送的线上值），或归档服务商，下线其路由而不动已存的密钥。

支持的市场与券商连接器

dsh-trading 连接 19+ 行情服务商、加密货币交易所和持牌股票券商：

| 市场 | 支持的服务商与券商连接器 | 覆盖范围与数据面能力 | 执行与认证方式 |
| 加密货币 | Binance、OKX（模拟盘/实盘）、Bybit、CCXT（聚合九家交易所，仅现货） | Binance / OKX / Bybit：现货与永续合约报价、深度、历史 K 线、未平仓合约量、资金费率、多空比。CCXT：九条直连路由（binance、okx、bybit、gateio、kucoin、kraken、coinbase、bitfinex、htx）上的现货报价与 K 线，按各交易所映射 K 线周期——不提供深度，不提供衍生品，不读取账户，永续 -SWAP 符号一律拒绝 | REST 轮询（没有连接器自带 WebSocket 传输），BYOK API 密钥；OKX 合约交易自动换算 ctVal 单位 |
| 美股 | Alpaca（模拟盘/实盘）、Interactive Brokers (IBKR)、Yahoo Finance、FMP、Finnhub、Polygon.io | 实时报价、历史 K 线、资产负债表与现金流基本面、SEC 文件、分析师情绪 | 券商官方 REST/WS API，BYOK 凭据；Yahoo Finance 免费公开接口 |
| 中国 A 股 | MiniQMT (QMT / XtQuant)、腾讯财经、东方财富、同花顺/富遥、Tushare Pro、AkShare | 实时 L1 报价、集合竞价价格、日 K 线、板块资金流、估值指标 | 本地 MiniQMT 券商客户端网关负责实盘执行；公开 REST 与 token 鉴权 |
| 港股 | 长桥 OpenAPI、富途 OpenD、老虎证券 OpenAPI、腾讯港股 | 实时报价、Level 2 行情、窝轮与牛熊证 | 持牌券商 OpenAPI / 网关执行；腾讯港股公开报价 |
| 商品期货 | 同花顺/富遥期货 | 日 K 线、盘中 tick 点、商品与股指期货数据面 | 机构 REST API（仅数据面） |

数据面可热插拔： 对数据源不满意？换掉它。设置 → 交易 可以把任意市场路由到任意已安装的服务商：保存后报价面板立即改走新路由，智能体会话在下一轮对话时生效——不用重启，不用翻配置。

服务商路由——按市场选择交易所，并配置 BYOK 凭据槽位

零信任安全与执行纪律

交易的公式从来都是：研究 + 等待 + 果断 + 耐心 = 活下来。

工具没法替你等待，也没法替你耐心。但它能守住中间那道闸门：

1. 默认模拟运行： 所有下单与撤单工具都在模拟模式下执行，除非你显式打开 liveTrading: true。
2. 实盘订单需人工交互审批： DSH 的审批层会拦截实盘路由；无人值守的执行会话一律按失败关闭处理。
3. 100% BYOK（自带密钥）： API 密钥与券商凭据只存在你本地的环境变量或本地配置里。不打包、不中转、不上传到任何第三方服务器。
4. 零数据再分发： 行情数据严格按各服务商的《服务条款》获取，仅供你个人使用。不抓取、不缓存，绝不转售或分享。

没有你的签名，一分钱都不会动。

快速开始

1. 安装

交易功能运行在独立的 DSH 主目录（~/.dsh-trading）里，不会和你主用的 dsh web 主目录（~/.dsh）混在一起。dsh-trading 的所有包都通过 $DSH_HOME 解析路径。

Install into a dedicated DSH profile (pick your markets)
export DSH_HOME=~/.dsh-trading
dsh plugin --profile trading-web add @dshtrading/base @dshtrading/crypto @dshtrading/us

Or install all markets at once
dsh plugin --profile trading-web add @dshtrading/base @dshtrading/crypto @dshtrading/us @dshtrading/cn @dshtrading/hk

Serve the browser UI in this profile (run once): insert the in-box web host layer
node -e "const f=(process.env.DSH_HOME||require('os').homedir()+'/.dsh')+'/profiles/trading-web/package.json',fs=require('fs'),m=JSON.parse(fs.readFileSync(f,'utf8'));m.dsh.profile.bundles.includes('@deepseek-ai/dsh-web-app')||m.dsh.profile.bundles.splice(1,0,'@deepseek-ai/dsh-web-app');fs.writeFileSync(f,JSON.stringify(m,null,2)+'\n')"

2. 启动

From a repository checkout: install the wrapper once, then launch
cp scripts/home/dsh-trading ~/.local/bin/ && chmod +x ~/.local/bin/dsh-trading
dsh-trading --profile trading-web # serves on port 8888 by default

Installed from npm only? The wrapper sets DSH_HOME and the 8888 default:
DSH_HOME=~/.dsh-trading dsh --profile trading-web --port 8888

不同配置档对应不同的使用场景：

| 配置档 | 界面形态 | 包含的包 |
| trading-web | 浏览器 GUI（推荐） | dsh-base + dsh-web-app + base + gui + bot-api + crypto + us + cn + hk + futures + global |
| trading-dev | 无头模式，单一市场 | dsh-base + dsh-headless + base + crypto |
| trading-all | 无头模式，全部市场 | dsh-base + dsh-headless + base + all + cn + crypto + hk + us |
| trading-bot | 机器人形态：智能体宿主 + /dshtrading/api，仅限回环地址 | dsh-base + base + bot + bot-api + crypto —— 源码在私有仓库 dsh-trading-bot |

在浏览器里打开终端打印出的 URL：左侧是自选列表，中间是图表，右侧是你的 AI 交易智能体。新建会话 → 选一个市场预设 → 问智能体：「今天市场怎么样？」

3. 从源码构建

pnpm install && pnpm build && pnpm test # Node per engines (^22.19.0 || >=24.0.0), pnpm 11
./scripts/refresh-profile.sh # Rebuild profile file: copies (default trading-web)

完整的运行、配置档与刷新约定见 docs/ops/running.md。

架构概览

模块化、分层 Cordis 微内核架构，各市场组合起来互不干扰：

@dshtrading/base ← Core: account/order/quote contracts, approval gate, GUI shell
├── @dshtrading/crypto ← Binance / OKX / Bybit / CCXT + skills + presets
├── @dshtrading/us ← Yahoo / Alpaca / FMP / Finnhub / Polygon / IBKR + skills + presets
├── @dshtrading/cn ← Tencent / Eastmoney / Tushare / AkShare / MiniQMT + skills + presets
└── @dshtrading/hk ← Tencent HK / Longbridge / Futu / Tiger + skills + presets

六条架构不变量为系统保驾护航：
1. Bundle 补丁严格 只增不改。
2. 领域知识放在可复用技能里，不靠硬编码提示词 hack。
3. 双轨订单闸门守护每一笔交易。
4. 共享代码必须服务 ≥2 个市场，才能进入 base。
5. 遵守服务商服务条款，零数据再分发。
6. GUI 外壳可替换；数据契约不可变。

实盘交易授权平面（已发布，默认关闭）

- 实盘交易授权平面： 实盘执行开关不在智能体可写的路径上。人类签名的密码学授权（Ed25519）是解锁实盘订单路由的唯一机制，智能体一侧永远接触不到签名材料。这部分随公开的 GUI 行情数据桥（packages/bot-api）一起，发布在 packages/authority 中。
- 自主机器人平面边界： 自主交易平面（后台机器人守护进程、自动化授权执行、Web 驾驶舱、原生 iOS 观察客户端、systemd 单元）位于私有卫星仓库 dsh-trading-bot。本公开仓库只保留独立构建所需的干净接缝。

数据源与服务条款

| 市场 | 默认数据源 | 边界与合规 |
| 美股 | Yahoo Finance / Alpaca | Yahoo 公开端点（个人非商业用途）；Alpaca 官方 Paper/Live API |
| 中国 A 股 | 腾讯财经 / 东方财富 / 同花顺（Fuyao） | 公开端点；同花顺 REST API 提供日 K、基本面与集合竞价数据；实盘执行走本地 MiniQMT 券商网关 |
| 期货（中国） | 同花顺（Fuyao） | 同花顺 REST API 提供日 K、盘中分时、商品与股指期货数据；仅数据平面 |
| 香港 | 腾讯港股 / Longbridge | 公开端点；持牌券商 OpenAPI/Gateway 用于执行 |
| 加密货币 | Binance / OKX | 交易所官方 API；OKX 模拟盘支持 BYOK 凭证 |
| 加密货币基本面 | CoinCap | 公开 REST，仅限个人使用 —— 不得再分发，不得批量抓取 |

常见问题（FAQ）

dsh-trading 是自主交易机器人吗？

这是 AI 辅助交易终端，不是无人值守的实盘交易机器人。下单工具默认走 dry-run 模拟。实盘执行需要显式开启 liveTrading: true，并由真人交互确认；无头会话一律 fail closed。dry-run 模拟与交易所或券商的模拟盘是两回事。

可以连接哪些交易所、券商和行情 API？

dsh-trading 支持 19+ 个连接器：加密货币方面有 Binance、OKX、Bybit、CCXT（现货报价与 K 线，九条直连路由：binance / okx / bybit / gateio / kucoin / kraken / coinbase / bitfinex / htx）；美股方面有 Alpaca、Interactive Brokers（IBKR）、Yahoo Finance、FMP、Finnhub、Polygon.io；中国 A 股方面有 MiniQMT、腾讯财经、东方财富、同花顺、Tushare Pro、AkShare；港股方面有 Longbridge、Futu OpenD、Tiger OpenAPI；商品期货方面有 同花顺。详见连接器配置指南。

dsh-trading 可以用哪些 AI 模型？

dsh-trading 运行在 DeepSeek Harness（DSH）上，支持 DeepSeek（V3 / R1）、Anthropic Claude、OpenAI GPT-4o，以及自定义的 OpenAI 兼容端点或本地模型（通过 Ollama / vLLM）。你可以在设置里按模型配置推理强度、图像能力和 token 预算。

使用终端需要 API 密钥吗？

部分公开行情源（如腾讯财经、东方财富、Yahoo Finance）开箱即用，不需要密钥。需要鉴权的数据服务、持牌券商、加密货币交易所和你选定的 AI 服务商，都要单独配置凭据。密钥由你自己提供（BYOK），凭据严格保存在本地机器上。

可以回测交易策略、编写自定义指标吗？

可以。终端内置原生 strategy_backtest 引擎，同时支持经典量化范式（Donchian 突破、RSI 均值回归、EMA 交叉、布林带回归、200 日趋势跟踪、动量）。你也可以编写自定义指标（SuperTrend、TD9、OBV+MA），直接渲染到图表上。

dsh-trading 可以免费商用吗？

不可以。PolyForm Noncommercial 1.0.0 许可证允许个人、教育、研究用途免费使用。商用需事先获得书面授权。本软件不提供投资建议，也不保证交易收益。

文档

- 文档索引
- 运行、配置档与开发
- 连接器接入与配置
- 新连接器开发手册
- 技能架构指南
- 标的代码规范
- 交易所路由与数据面
- 分析与量化路线图
- 架构决策日志（Spikes）
- 简体中文说明

友情链接

- dsh-web
- LINUX DO

社区

QQ 群：DSH Trading 交流群（群号 319737695） —— 提问、反馈，以及一切和 dsh-trading 相关的事。用 QQ 扫码加入：

最后一句

工具是死物，纪律才是活的。再好的终端也没法替你按下买入键，也不该这么做——但它能保证，每次你的手真的动了，思考都已经先一步完成。

去体验吧。去犯错吧。去复盘你的交易吧。路还长——一起走。

本项目是软件，不是投资建议。市场有风险——交易需谨慎。

许可

PolyForm Noncommercial 1.0.0 —— 个人学习、研究与非商业用途免费。商业用途须事先取得书面授权：开 GitHub issue 或联系 <chunlinzhu666@gmail.com>。

本项目采用 PolyForm Noncommercial 1.0.0 许可：非商业用途免费；商业用途须事先取得书面授权（chunlinzhu666@gmail.com 或 GitHub Issue）。

主题与搜索标签

ai-trading · algorithmic-trading · quantitative-finance · deepseek · deepseek-harness · trading-terminal · lightweight-charts · technical-analysis · crypto-trading · binance · okx · bybit · ccxt · stock-trading · alpaca · interactive-brokers · miniqmt · futu · longbridge · multi-agent-systems · backtesting · risk-management