feat: personal user edition v1.0.0-user on release branch

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
dekun
2026-06-30 20:22:42 +08:00
parent e5f264b774
commit ec1c9873b7
20 changed files with 324 additions and 294 deletions
+102
View File
@@ -0,0 +1,102 @@
# 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