📦 dsh-trading 详细部署教程

dsh-trading 是一个构建在 DeepSeek Harness (DSH) 之上的原生 AI 交易终端。它将专业的交易界面（包含图表、订单簿、多市场看板）与一个了解市场数据的 AI 代理深度集成，支持加密货币、美股、A股和港股。所有交易默认模拟运行 (Dry-Run)，任何真实订单都需要你手动点击确认，确保你的资金安全。

⚙️ 部署前准备

1. 基础环境要求

Node.js：版本 18 或更高。你可以通过 node --version 检查。
包管理器：npm（随 Node.js 一起安装）或 pnpm。
DeepSeek Harness (DSH)：需要先安装 DSH 核心 CLI 工具。如果尚未安装，运行 npm install -g @deepseek-ai/dsh。

2. 数据源与 API 密钥 (BYOK, 自带密钥)

本工具不会捆绑或转发任何 API 密钥。你需要根据要交易的市场，自行注册并获取相应数据/交易服务的密钥。密钥仅保存在你的本地环境变量或配置文件中。

市场	推荐数据源	获取方式	是否需要 API Key
加密货币	Binance, OKX, Bybit	交易所官网注册	是（用于交易/数据）
美股	Yahoo Finance (公开), Alpaca	Alpaca 官网注册	是（Alpaca 用于交易）
A股	腾讯财经 (公开), Tushare Pro	Tushare 官网注册	是（Tushare Pro 需积分）
港股	腾讯港股 (公开), 长桥 OpenAPI	长桥证券等官网	是（用于交易）

重要：对于不需要 API Key 的公开数据源（如 Yahoo Finance、腾讯财经），工具可以直接获取行情数据，但交易功能仍需对应券商的 API。

🚀 安装与启动

整个部署过程通过 DSH 的插件系统完成，无需克隆此 GitHub 仓库。

步骤 1: 安装 dsh-trading 插件

打开终端，根据你需要交易的市场，安装对应的插件包。base 是必须的。

安装所有市场（推荐）：

1	dsh plugin --profile trading-web add @dshtrading/base @dshtrading/crypto @dshtrading/us @dshtrading/cn @dshtrading/hk

或仅安装特定市场（例如，仅加密货币和美股）：

1	dsh plugin --profile trading-web add @dshtrading/base @dshtrading/crypto @dshtrading/us

步骤 2: 配置 Web 界面层 (仅需一次)

为了让终端界面在浏览器中显示，需要在刚才创建的 trading-web 配置文件中注入 Web 应用层。

一键配置命令 (复制整段运行)：

node -e "const f=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')"

步骤 3: 启动终端

1	dsh --profile trading-web

命令执行后，终端会输出一个本地访问地址（通常是 http://localhost:3000）。在浏览器中打开该地址即可看到 dsh-trading 界面。

提示：你也可以将 trading-web 设置为默认配置文件，之后直接使用 dsh 命令启动。

⚙️ 首次配置与使用

1. 配置数据源 (Connectors)

进入界面后，点击 设置 (Settings) 或 交易路由 (Trading Routes) 面板。

在对应市场（如 Crypto）下，选择你要使用的数据源（如 Binance）。
在弹出的配置项中，填写你从交易所或数据服务商获取的 API Key 和 Secret Key。
保存配置。界面上的行情数据会立即切换到你所选的数据源。

2. 了解界面布局

dsh-trading 采用经典的三栏布局，专为专业交易设计：

左侧栏 (Watchlist)：你的自选股/币列表，可跨市场（如 BTC 和 AAPL 并列）。
中央区域 (Chart)：核心图表区，基于 Lightweight Charts v5，支持多时间周期切换和 MA、MACD、RSI 等技术指标。
右侧栏 (Agent)：与 AI 代理对话的区域。你可以将当前关注的标的通过“发送给代理 (Send to Agent)”按钮直接分享给 AI。

3. 开始你的第一次 AI 分析

在中央图表区选择一个你关注的标的（如 BTCUSDT）。
点击图表工具栏上的 “发送给代理” 按钮。
右侧的 AI 代理会收到包含该标的最新行情、K线数据、资金流向等信息的上下文。
你可以直接提问，例如：“分析一下 BTC 当前的走势和技术指标”、“检查一下这只股票的基本面” 或 “根据当前情况，给出一个交易计划”。

🤖 理解 AI 代理的工作模式

dsh-trading 内置了一个多角色 AI 团队，由一位 “大师 (Master)” 领导：

大师 (Master)：总协调者，负责任务分解、整合结论，并最终掌握交易执行权。
研究员 (Researcher)：负责基本面分析、财报解读、新闻和公告查询。
交易员 (Trader)：负责制定详细的交易计划（包括入场点、止损、仓位）。
风险审查员 (Risk Reviewer)：负责评估交易计划的风险，检查是否符合预设的风险规则。

关键安全机制：

默认模拟：代理的所有交易操作（买入/卖出）都处于 模拟运行 (Dry-Run) 模式，不会实际下单。
人工确认：只有当你在指令中明确加入 liveTrading: true 参数，并要求代理执行真实交易时，它才会生成一个需要你手动点击批准的订单。在无图形界面的环境下，此功能会直接拒绝执行。

📂 部署位置与数据管理

安装位置：所有插件包默认安装在用户目录下的 ~/.dsh/profiles/trading-web/ 文件夹中。
配置文件：数据源 API 密钥等信息保存在本地的环境变量或配置文件中，不会被上传到任何云端。
更新插件：当有新版本发布时，可以重新运行 dsh plugin --profile trading-web add @dshtrading/... 命令来更新到最新版本。

❓ 常见问题 (FAQ)

Q: 启动后界面空白或显示连接错误？
- A: 确保步骤 2 的 Web 界面层配置命令已正确执行。检查终端输出的服务地址（通常是 localhost:3000），并确认防火墙没有阻止 Node.js 进程。
Q: 数据源配置后无法获取行情？
- A: 检查 API Key 是否正确，以及该数据源是否允许你所在的地区访问。部分数据源（如 Alpaca）有区域限制。可以临时切换回公共数据源（如 Yahoo Finance）进行测试。
Q: 如何添加一个新的市场或数据源？
- A: 项目支持通过插件热拔插。你可以在 GitHub 仓库的 packages/ 目录下查找是否有对应的市场插件，然后使用 dsh plugin add 命令安装。如果新数据源不在列表中，可能需要等待官方更新或参考“新连接器开发指南”自行编写。
Q: 这个工具是免费的吗？
- A: 项目代码采用 PolyForm Noncommercial 1.0.0 许可证，个人学习、研究和非商业用途免费。商业使用需获得作者书面授权。