前言¶
在 DeepSeek Harness（DSH）里做策略讨论或下单演练时，常见做法是接外部行情 API、自建账本，或在对话里「口头模拟」——数据和成交状态往往和面板脱节。若希望不开户券商、不把账本放到云端，又能在侧边栏和对话里共用同一套持仓与流水，gigaflw/dsh-fft-paper-trading 把模拟账户、FTShare 行情、交易日历和 K 线收进一个插件，账本落在本机。
下面介绍它是什么、能做什么，以及如何安装与使用。
这是什么¶
@dsh-ft/dsh-fft-paper-trading 是维护者 gigaflw 发布的 DSH 插件（npm 包名 @dsh-ft/dsh-fft-paper-trading，当前资料中版本为 0.6.0，MIT 许可证）。定位是：在 DSH 中打开 A 股与商品期货的模拟账户，内置 FTShare 数据源与 K 线视图，无需单独再装行情类数据插件；未配置 API Key 时也可使用免费档（以最近日 K 收盘价为报价）进行练习。
插件以当前 DSH 进程权限运行，安装前建议自行查看 GitHub 仓库 源码与许可证。社区目录页：https://www.skillhub.cn/plugins/gigaflw/dsh-fft-paper-trading（独立站点，与 DeepSeek / 幻方无官方从属关系）。
核心功能¶
下单前即算清成本¶
在交易页输入代码、方向与数量后，预估成交价、佣金、印花税、过户费、成交后现金与可买上限会一并刷新，无需单独查价或再点预览。
股票与期货两套独立账户¶
首次打开「Paper Trading」面板会自动建账：A 股模拟资金 100,000 CNY，商品期货 1,000,000 CNY。期货按手交易、预留保证金、支持当日平仓（T+0），日终按规则结算。账户头里的「Funds」可随时入金或出金。
面板与对话共用同一账本¶
在对话中可直接说「市价买入 000001 两百股」或「回顾本周股票成交」，模型会调用下单与复盘工具；侧边栏与对话操作的是同一账户。
K 线与自选¶
面板右侧保留完整 K 线；在图上选标的会把代码带到交易页。行情页可按板块翻页，把关注标的加入短名单。
按权重批量建仓¶
可导入 code,weight 格式的 CSV，设定预算后一次最多买入 20 个标的，提交前可核对股数、费用与剩余现金。
复盘与本地账本¶
复盘页提供权益曲线、最大回撤、成交统计、日终报告与现金流；收益口径已排除出入金。事件账本保存在本机 DSH 数据目录（默认 ~/.dsh 下的 paper-trading/，股票与期货各一份），重启 DSH 后自动恢复；重置账户前会先备份到同目录的 backups/。
行情档与 API Key¶
- 未配置 Key：免费档，报价为最近收盘价（盘中为上一交易日收盘）；分钟线与实时接口不可用；匿名额度用尽后报价暂停，约 24 小时滚动恢复，期间仍可用手工参考价下单。
- 已配置 Key：实时报价。在 DSH「Settings → Financial Terminal」配置，Key 可在 https://ftai.chat/ftshare 申请。
面板头会显示数据源状态（live / free / unavailable / invalid）。
安装与启用¶
要求 DSH 版本 >= 0.2.0-rc.2。官方安装命令如下：
dsh plugin add @dsh-ft/dsh-fft-paper-trading
插件自带 FTShare 行情、交易日历与 K 线，一般不必再装单独的数据插件。
注意：
- 完整 K 线视图需要本机 Python 3.10+，首次启动会通过网络准备运行时；准备失败不影响下单、持仓与复盘。
- 不要与
@dsh-ft/dsh-fft-bundle或其他自带 FTShare 数据服务的入口包同时安装，否则会重复注册数据服务，插件管理里相关项无法单独开关。
典型用法¶
三步上手¶
- 在侧边栏打开「Paper Trading」，账户自动创建；需要时用「Funds」调整资金。
- 在交易页输入代码（如
000001），选择方向、数量与市价或限价，确认预览后提交。未成交的限价单可在「Orders」中撤单。 - 在「Review」看权益与回撤，在「Positions」看可卖数量与浮动盈亏；可随时重置账户（会先备份）。
对话示例¶
- 「600519 现在什么价？」
- 「市价买入 000001 两百股，备注：测试 T+1」
- 「回顾我本周的股票交易」
模拟规则与范围¶
A 股：市价单按最新价一次性成交；限价单未穿越则挂单当日有效。涨跌停、停牌、T+1 可卖数量及佣金 / 印花税 / 过户费按 A 股规则模拟；缺行情时可用参考价下单。
商品期货：仅商品期货（SHFE / INE / DCE / CZCE / GFEX），仅接受日盘（09:00–11:30、13:30–15:00）报单；15:30 按收盘价结算并做风险检查。夜盘、股指与国债期货、交割与移仓不在本版本范围内。
明确不包含：实盘、融资融券、期权、港美股、策略回测。仅供模拟与研究，不构成投资建议。
适用场景与注意¶
适合需要在 DSH 内练手 A 股 T+1 与商品期货日盘规则、希望 AI 与面板共用账本、且倾向本地存储流水的开发者或研究者。
安装与运行前请确认：插件与 DSH 同源信任边界；账本与 API Key 均在本机配置，反馈 Issue 前勿粘贴 Key、账户数据与账本路径（面板「Feedback」指向 GitHub Issues）。
结尾¶
dsh-fft-paper-trading 把模拟交易、内置行情与 K 线、对话工具调用和本地账本放在同一 DSH 插件里，无 Key 也能用日 K 收盘价练习，有 Key 可切实时档。更多信息见 SkillHub 目录页 与 GitHub 仓库。
