# v1.0.0-user 个人用户版 · 发行说明

**Tag**：`v1.0.0-user`  
**分支**：`release/v1.0-user`  
**完整版开发线**：`main`（功能更多，勿与客户环境混用）

---

## 版本定位

面向 **个人购买者** 的首次交付版本：聚焦 **CTP 下单纪律、关键位、记录复盘与统计**，去掉易引发误解或依赖新浪 K 线展示的功能模块。

本软件为 **交易纪律与记录辅助工具**，不构成投资建议。

---

## 包含功能

| 模块 | 路径 |
|------|------|
| 下单监控 | `/positions` |
| 关键位监控 | `/keys` |
| 交易记录与复盘 | `/records` |
| 统计分析 | `/stats` |
| 系统设置 / 备份 | `/settings` |
| 策略交易、开单计划、AI、手续费等 | 可在导航中开关（默认以交付时配置为准） |

### 小账户品种限制（保留）

- 权益 **≤20 万元** 或 **CTP 未连接** 时，仅可浏览、搜索、报单：**玉米、豆粕、甲醇、螺纹钢**
- 品种下拉与开仓 API 校验一致
- **不含**「可开仓品种」筛选大表（走势、成交量、行业排序等）

---

## 不含功能

| 功能 | 说明 |
|------|------|
| 行情 K 线 | 无 `/market` 页面；无 K 线 SSE |
| 可开仓品种表 | 无下单页下方大表；无 recommend SSE |
| 复盘自动 K 线 | 复盘请 **手动上传截图** |

---

## 部署（SSH 代部署）

```bash
git clone https://gitee.com/dekun/qihuo.git /opt/qihuo
cd /opt/qihuo
git fetch --tags
git checkout v1.0.0-user
bash deploy.sh
nano /opt/qihuo/.env   # ADMIN_*、SIMNOW_* 等
pm2 restart qihuo
```

验收：

- 顶栏无「行情 K 线」
- `/positions` 无「可开仓品种」大表
- `/records` 无「自动 K 线」选项
- 小账户四品种限制生效

详见 [DEPLOY.md](./DEPLOY.md)。

---

## 与完整版（main）的关系

| | 个人用户版 | 完整版 main |
|--|-----------|-------------|
| 代码线 | `release/v1.0-user` | `main` |
| 行情 K 线 | 无 | 有 |
| 可开仓品种表 | 无 | 有 |
| 复盘自动 K 线 | 无 | 有 |
| 小账户四品种 | 有 | 有 |

- 用户版 bug 修复：在 `release/v1.0-user` 发 `v1.0.1-user` 等 patch tag  
- 完整版新功能：**不会**自动进入用户版；客户升级需另议  

---

## 协议与交付

- 协议附件填写：**版本 tag `v1.0.0-user`**
- 交付：SSH 部署 + 管理员账号 + 本文档与 [FEATURES.md](./FEATURES.md)
- 不提供 `main` 分支写权限

---

## 技术说明

- 发行标识：`edition.py` 中 `USER_EDITION = True`
- 现价报价（新浪 `hq.sinajs.cn`）仍用于计划、关键位等内部逻辑；**不对用户提供 K 线浏览服务**
- 关键位监控后台可能使用 K 线数据计算箱体（用户不可见）

---

## 联系

著作权人：马建军 · 手机 18364911125 · 微信 dekun03