# @dsh-ft/dsh-fft-paper-trading 中文文档

规范地址：https://npmcn.com/package/%40dsh-ft/dsh-fft-paper-trading/

版本：0\.7\.2
npm 元数据更新时间：2026-11-13T12:31:07.329Z
中文译文更新时间：2026-11-13T05:44:32.073Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40dsh-ft/dsh-fft-paper-trading
原文对照：https://npmcn.com/package/%40dsh-ft/dsh-fft-paper-trading/?lang=original
项目主页：https://github.com/gigaflw/dsh-fft-paper-trading#readme
源码仓库：https://github.com/gigaflw/dsh-fft-paper-trading

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.9 MB，295 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.19\.0
- 运行依赖：3 个
- peer 依赖：react ^18\.2\.0，@deepseek-ai/cordis ^4\.0\.2，@deepseek-ai/dsh-tools \>=0\.2\.0-rc\.2
- 首次发布：2026-10-26T07:24:25.451Z
- 最新版本发布：2026-11-13T12:31:06.777Z
- 近 30 天下载量：2188（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 11 个）

## 中文简介

A-Share和商品期货纸币交易为DeepSeek Harness:本地分类账,分批订单,审查,和FTShare报价.

## 安装

```sh
npm install @dsh-ft/dsh-fft-paper-trading
```

也可以使用：`pnpm add @dsh-ft/dsh-fft-paper-trading`、`yarn add @dsh-ft/dsh-fft-paper-trading`、`bun add @dsh-ft/dsh-fft-paper-trading`

## README

# 模拟交易: dsh-fft-paper-trading

[English](https://npmcn.com/package/%40dsh-ft/dsh-fft-paper-trading/README.md) | 中文

[![npm](https://img.shields.io/npm/v/@dsh-ft/dsh-fft-paper-trading)](https://www.npmjs.com/package/@dsh-ft/dsh-fft-paper-trading) [![license](https://img.shields.io/npm/l/@dsh-ft/dsh-fft-paper-trading)](https://npmcn.com/package/%40dsh-ft/dsh-fft-paper-trading/LICENSE)

在 DeepSeek Harness 里开一个不用开户的 A 股 / 商品期货账户

![交易页：填完代码、方向、数量，成本与成交后现金即时算出；右侧常驻 K 线](https://npmcn.com/package/%40dsh-ft/dsh-fft-paper-trading/assets/screenshots/trade.jpg)

> DSH ≥ 0.2.0-rc.2 · 自带行情、交易日历与 K 线 · 账本存本地

## 效果

_复盘页：区间统计、权益曲线、成交记录、日终报告与资金流水。_

![复盘页](https://npmcn.com/package/%40dsh-ft/dsh-fft-paper-trading/assets/screenshots/review.jpg)

_期货页：开多 / 开空 / 平多 / 平空，合约要素、保证金与风险度同屏。_

![期货页](https://npmcn.com/package/%40dsh-ft/dsh-fft-paper-trading/assets/screenshots/futures.jpg)

## 功能

-   **下单前，账已经算完**：填代码、方向、数量，预估成交价、佣金、印花税、过户费、成交后现金、最多可买同步刷新，没有「查行情」「预览」两个多余步骤。
-   **股票 + 期货，两个独立账户**：首次打开自动开户，A 股 100 万元、商品期货 100 万元模拟资金；期货按手交易、占用保证金、T+0 平仓、日终结算。
-   **和 AI 共用同一本账**：对话里说「市价买 200 股 000001」「复盘我这周的交易」，模型直接调用下单与复盘工具，面板和模型撮合的是同一个账户。
-   **从 K 线直接开单**：面板里常驻完整 K 线，在图上点选标的，代码自动带进交易页；行情页可翻板块、把常看的标的加入备选。
-   **按权重批量建仓**：导入「代码,权重」CSV，填一个预算，一次买入最多 20 只；先看股数、费用、剩余现金，再整批提交。
-   **复盘能对账**：权益曲线、最大回撤、成交统计、日终报告、资金流水，收益已剔除出入金。
-   **没配 API Key 也能练**：免费档按日 K 收盘价报价，配置 FTShare Key 后切换实时行情。
-   **账本在本地**：事件账本落在本机文件，重启 DSH 自动恢复；重置账户前自动备份。

## 安装

```sh
dsh plugin add @dsh-ft/dsh-fft-paper-trading
```

需要 DSH `>= 0.2.0-rc.2`。安装后自带 FTShare 行情、交易日历与 K 线视图，不需要再单独安装数据插件。

-   完整 K 线视图依赖本机 Python 3.10+，首次启动会联网准备运行环境；准备失败不影响下单、持仓和复盘。
-   **不要**与 `@dsh-ft/dsh-fft-bundle` 或其他自带 FTShare 数据服务的入口包同时安装：数据服务行会重复，插件管理器里相关项将无法单独开关。

## 上手三步

1.  打开侧栏「模拟交易」，自动开户：股票 100 万元、期货 100 万元；账户头的「资金」可随时注资、提款。
2.  交易页输入代码（如 `000001`），选好方向、数量、市价或限价，预览确认后下单。限价单未穿越会挂单等待，可在「订单」撤单。
3.  「复盘」看权益、回撤与成交，「持仓」看可卖与浮盈亏；随时可以重置账户并指定初始资金（重置前自动备份）。

对话里可以直接说：

-   「现在 600519 多少钱？」
-   「用市价买 200 股 000001，备注试试 T+1」
-   「帮我复盘这周的股票交易」

## 行情与 API Key

行情来自 FTShare，分两档：

-   **已配置 API Key**：实时行情。
-   **未配置 API Key**：免费档，报价取最近一个收盘价（盘中等于上一交易日收盘），分钟线与实时接口不可用；匿名额度有限，用尽后行情暂停，可用手填参考价继续交易，额度恢复后自动恢复（滚动约 24 小时）。

API Key 在 DSH「设置 → 金融终端」中配置，申请地址：[https://ftai.chat/ftshare](https://ftai.chat/ftshare)。

面板顶栏会显示数据源状态（正常 / 免费 / 无 / 无效）；行情不可用时会说明原因并给出「获取 API Key」或「重试」入口。交易日历降级为「周一至周五」时面板会标注（此时节假日会被当作交易日，T+1、挂单过期与结算按工作日估算）。

## 模拟规则与边界

-   **股票**：市价单按最新价一次成交，无部分成交；限价单未穿越才挂单，当日有效。涨停/跌停、停牌、T+1 可卖、佣金/印花税/过户费按 A 股规则模拟；行情缺失时可用参考价下单。非连续竞价时段的委托照常受理并排队，在下一交易时段按当时行情成交。
-   **期货**：只做商品期货（SHFE / INE / DCE / CZCE / GFEX），只在日盘时段（09:00–11:30、13:30–15:00）接受委托；15:30 按收盘价结算并做风险检查。夜盘、股指/国债期货、交割与移仓不在本期。
-   **边界**：不接实盘，不做两融、期权、港美股与策略回测。

## 数据与隐私

-   账本保存在本机 DSH 数据目录（默认 `~/.dsh`）下的 `paper-trading/`（股票与期货各一份），不上传任何服务器。
-   重置账户会先备份到同目录的 `backups/`；账户异常锁定时面板会给出账本路径，可导出后排查。
-   仅用于模拟与研究，不接实盘，不构成投资建议。

## 反馈

遇到 bug 或想加功能，走 GitHub Issues（面板顶栏「反馈」是同一入口）：

-   [报告 bug](https://github.com/gigaflw/dsh-fft-paper-trading/issues/new?template=bug_report.yml)
-   [功能建议](https://github.com/gigaflw/dsh-fft-paper-trading/issues/new?template=feature_request.yml)

贴日志前先删掉 API Key、账户数据与账本路径。行情额度、Key 与交易日历这类使用问题，先看上面的「行情与 API Key」。

本项目以 [MIT](https://npmcn.com/package/%40dsh-ft/dsh-fft-paper-trading/LICENSE) 许可开源。变更记录见 [CHANGELOG.md](https://npmcn.com/package/%40dsh-ft/dsh-fft-paper-trading/CHANGELOG.md)。

## 常见问题

### @dsh-ft/dsh-fft-paper-trading 是什么？

A-Share和商品期货纸币交易为DeepSeek Harness:本地分类账,分批订单,审查,和FTShare报价\.

### 如何安装 @dsh-ft/dsh-fft-paper-trading？

在项目目录运行 npm install @dsh-ft/dsh-fft-paper-trading，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^18\.2\.0）、@deepseek-ai/cordis（^4\.0\.2）、@deepseek-ai/dsh-tools（\>=0\.2\.0-rc\.2）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @dsh-ft/dsh-fft-paper-trading 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @dsh-ft/dsh-fft-paper-trading 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @dsh-ft/dsh-fft-paper-trading 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.19\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @dsh-ft/dsh-fft-paper-trading 可以商用吗？

@dsh-ft/dsh-fft-paper-trading 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @dsh-ft/dsh-fft-paper-trading 的下载量有多少？

根据 npm 官方下载统计，@dsh-ft/dsh-fft-paper-trading 在 2026/10/13 – 2026/11/11 这 30 天内被下载 2,188 次，日均约 73 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @dsh-ft/dsh-fft-paper-trading 还在维护吗？

最新版本 0\.7\.2 发布于 2026/11/13（今天）；至今共发布 11 个版本，其中过去 12 个月发布了 11 个；首次发布于 2026/10/26。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。