yangfei222666-9/dsh-paper-trade

dsh-paper-trade

痛点：想练交易的人直接上真钱，亏掉的是学费。
解法：10 万美元虚拟盘 + 哈希链防篡改账本 + 机器强制纪律（无报价拒单、现金不足拒单），只练一条——下单前写理由、成交后留证据。
证据：14 个测试全绿，CI 绿，awesome-dsh 已收录，零第三方依赖。

一个面向 DeepSeek Harness 生态的零依赖模拟交易 CLI：一个虚拟的 10 万美元账户、真实的每日股票报价，以及每一笔交易都记录在哈希链式、可防篡改的账本中。它的存在只为训练一条纪律——下单前写下理由，成交后留下证据——而无需触碰任何真钱。

MIT · 纯 Python 标准库 · 作者：太极鲸（Taiji Whale）

为什么存在

DSH 生态几乎没有任何金融工具。大多数人直接跳到真实券商，烧掉真金白银。这个工具把“基于证据的交易纪律”变成最小的可运行系统：

- 仅模拟盘——无券商集成，无真实资金。这条红线已内置于设计中。
- 哈希链式账本——每条交易记录都携带上一条记录的哈希；一条命令即可验证没有任何内容被篡改。
- 机器强制纪律——现金不足拒单、持仓不足拒单、无报价时拒单，每笔交易 1 美元虚拟佣金，最低名义金额 20 美元。
- 零依赖——免费的 Yahoo 每日 K 线，并带有本地 CSV 缓存回退。无第三方库。

安装

git clone https://github.com/yangfei222666-9/dsh-paper-trade.git
cd dsh-paper-trade
python3 paper_trade.py status

需要 Python 3.9+。无需 pip install 步骤：整个代码库只使用标准库。

用法

python3 paper_trade.py quote AAPL            # 最新收盘价（Yahoo；缓存回退）
python3 paper_trade.py buy AAPL 10 "reason"  # 买入：现金检查 + 佣金
python3 paper_trade.py sell AAPL 5 "reason"  # 卖出：持仓检查
python3 paper_trade.py status                # 持仓 + 未实现盈亏
python3 paper_trade.py report                # JSON 快照（每周复盘）
python3 paper_trade.py chain-check           # 验证账本完整性

| 命令 | 用途 |
|---|---|
| quote SYM | 某只股票代码的最新收盘价 |
| buy SYM   | 买入（现金校验 + 1 美元手续费） |
| sell SYM   | 卖出（持仓校验 + 1 美元手续费） |
| status | 现金、持仓、未实现盈亏、总资产 |
| report | 在 snapshots/ 下生成带时间戳的 JSON 快照 |
| chain-check | 哈希链完整性验证 |

reason 参数不是可选的装饰——账本会将其与交易一同记录。如果你说不出理由，这笔交易就不该发生。

哈希链式账本

每笔交易都会向 trades.jsonl 追加一行：

{"ts": "2026-08-20 09:15:00", "action": "buy", "ticker": "AAPL", "shares": 10,
"price": 100.0, "px_date": "2026-08-19", "fee": 1.0, "reason": "…",
"prev": "", "hash": ""}

- 每条记录的 hash 是对其自身规范主体（键排序，排除 hash）计算的 sha1。
- 每条记录的 prev 链接到上一条记录的哈希；头部哈希存储在 portfolio.json 中，作为 chain。
- chain-check 会从文件中重新计算每个哈希，并报告第一个断点。

账本规则： 仅追加；永不重写；篡改可被检测，但无法被阻止——目标是证据，而证据必须能够经受住随意编辑。

设计红线（永不更改）

1. 仅限模拟。 绝不连接真实券商，绝不下达真实订单。
2. 不承诺收益。这是纪律训练器，不是顾问。
3. 没有数据，就没有交易。 缺少报价时拒绝订单，而不是猜测价格。
4. 账本仅追加。已建立的记录永不重写。

测试

仅使用标准库的单元测试（哈希链完整性、篡改检测、交易记账）：

python3 -m unittest discover -s tests -v

CI 在 Python 3.9–3.13 上运行同一套测试（见 .github/workflows/ci.yml）。

文件

- prices.py — 报价引擎（Yahoo 日线数据 + CSV 缓存）
- paper_trade.py — 交易 CLI + 哈希链式账本
- paper_data.py — 仪表盘数据生成器
- watchlist.json — 示例自选列表
- tests/ — 标准库单元测试

与 DeepSeek Harness 的关系

该工具独立于 DSH 运行（任何 Python 3.9+ 环境均可）。它起源于 DSH 生态系统中“太极鲸”管家系统的投资模块，后被拆分出来以填补金融工具方面的空白。路线图：DSH 插件面板和策略回测层。

许可证

MIT © Taiji Whale（太极鲸）