核心用法
a-stock-paper-trade 是一套完整的 A 股纸面交易系统，专为需要零成本练习股票交易的投资者设计。系统通过调用 akshare 库实时获取东方财富行情数据，在本地构建完整的模拟交易环境。
功能模块
- 账户管理：初始化 100 万虚拟资金，支持一键重置
- 行情查询：大盘指数、个股实时报价、K 线数据（60 日历史）
- 交易执行：支持市价/限价买入卖出，自动计算 1 手=100 股规则
- 持仓管理：实时盈亏计算、历史交易记录查询
- 市场洞察：涨跌幅 TOP10 排行、股票搜索功能
费用模拟真实性
系统精确还原 A 股交易成本结构：买入佣金万三（最低 5 元），卖出额外收取千一印花税，让用户在模拟环境中建立真实的成本意识。
显著优点
1. 零门槛使用：无需券商开户、无需实名认证、不涉及真实资金，完全消除心理压力
2. 数据真实可靠：直连东方财富行情，与实盘数据同步，非交易时间自动提示数据时效性
3. 命令行高效操作：支持批量查询、JSON 输出格式，便于自动化脚本集成和数据分析
4. 本地化存储：交易记录保存在本地 JSON 文件，数据隐私完全自主可控
潜在局限与风险
- 时效性限制：非 A 股交易时间（9:30-11:30, 13:00-15:00）行情数据可能不准确或缺失
- 网络依赖：需稳定连接东方财富服务器，虽无需代理但存在数据源单点风险
- 规则简化：过户费已忽略，涨跌停价格未强制校验，极端行情下的成交逻辑与实盘存在差异
- 无滑点模拟：市价单按当前报价成交，未模拟流动性不足时的滑点成本
适合人群
- 股票投资初学者，需要熟悉交易流程和费用结构
- 量化策略开发者，需要快速验证算法思路
- 希望测试新策略而不愿承担实盘风险的成熟投资者
常规风险提示
⚠️ 模拟交易盈利不代表实盘能力，请勿因模拟成绩盲目入市。股市有风险，投资需谨慎。