@dsh-ft/dsh-fft-paper-trading

中文文档
0.7.2发布于 2026/11/13MITTypeScriptES Module构建来源已验证近 30 天下载 2188

A-share and commodity futures paper trading for DeepSeek Harness: local ledger, batch orders, review, and FTShare quotes.

原始使用文档
文档目录8 节
  1. 效果
  2. 功能
  3. 安装
  4. 上手三步
  5. 行情与 API Key
  6. 模拟规则与边界
  7. 数据与隐私
  8. 反馈

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

English | 中文

npm license

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

交易页:填完代码、方向、数量,成本与成交后现金即时算出;右侧常驻 K 线

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

效果

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

复盘页

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

期货页

功能

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

安装

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。

面板顶栏会显示数据源状态(正常 / 免费 / 无 / 无效);行情不可用时会说明原因并给出「获取 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(面板顶栏「反馈」是同一入口):

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

本项目以 MIT 许可开源。变更记录见 CHANGELOG.md。

版本与发布记录

@dsh-ft/dsh-fft-paper-trading 共发布 11 个版本,首次发布于 2026/10/26;过去 12 个月发布了 11 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.7.2latest2026/11/13今天
0.7.12026/11/13今天
0.7.02026/11/13今天
0.6.32026/11/067 天前
0.6.22026/11/058 天前
0.6.12026/11/0310 天前

关于 @dsh-ft/dsh-fft-paper-trading 的常见问题

@dsh-ft/dsh-fft-paper-trading 是什么?

A-share and commodity futures paper trading for DeepSeek Harness: local ledger, batch orders, review, and FTShare quotes.

如何安装 @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 和提交记录判断。