Add personal license agreement and rename product section to tradable symbols.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-26 02:52:45 +08:00
parent 7b60f0dce5
commit ab9987e4c7
85 changed files with 18772 additions and 18235 deletions
@@ -199,7 +199,7 @@ pm2 restart qihuo

 1. 浏览器登录 → **系统设置** 确认 **模拟盘 · SimNow**
 2. 打开 **下单监控** 页 → 点击 **连接 CTP**
-3. 连接成功后：权益来自柜台、显示 CTP 持仓、可报单与品种推荐
+3. 连接成功后：权益来自柜台、显示 CTP 持仓、可报单与可开仓品种筛选

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

@@ -399,8 +399,8 @@ pm2 restart qihuo
 /opt/qihuo/
 ├── app.py
 ├── vnpy_bridge.py          # CTP 执行层
-├── recommend_store.py      # 品种推荐缓存
-├── recommend_stream.py     # 品种推荐 SSE 推送
+├── recommend_store.py      # 可开仓品种缓存
+├── recommend_stream.py     # 可开仓品种 SSE 推送
 ├── venv/
 ├── futures.db
 ├── .env
@@ -46,7 +46,7 @@

 ### 期货下单

- 品种联想（仅推荐可开品种或全部主力，取决于计仓模式）
+- 品种联想（仅列出可开仓品种或全部主力，取决于计仓模式）
 - 方向、手数（固定手数 / 固定金额计仓）
 - 限价 / 市价（FAK）、止盈、止损
 - 非交易时段禁止报单
@@ -58,9 +58,9 @@
 - 持仓卡片：浮盈亏、保证金、止盈止损、平仓等
 - 数据经 SSE 推送，无需整页刷新

-### 品种推荐
+### 可开仓品种

- 按当前权益与保证金上限筛选可开品种
+- 按当前权益与保证金上限筛选可开品种，养成开仓纪律、限制仓位
 - **行业分类**、走势（多头/空头/震荡/转多/转空）、跳空、昨日成交量（手）、成交额
 - 支持行业筛选与多字段排序
 - 每日后台刷新缓存
@@ -184,7 +184,7 @@
 | 计仓模式 | 固定手数、固定金额 |
 | 保证金上限、移动保本、挂单超时 | 见表单说明 |
 | CTP 连接 | SimNow / 实盘前置与账号（可覆盖 `.env`） |
-| 参考资金 | CTP 未连接时用于推荐与估算 |
+| 参考资金 | CTP 未连接时用于可开仓筛选与估算 |
 | 企业微信 Webhook | 计划/关键位推送 |
 | 修改密码 | 管理员密码 |
 | 深色/浅色主题 | 页头切换 |
@@ -224,7 +224,7 @@
 | `review_records` | 复盘 |
 | `trade_records` | 计划自动止盈止损记录 |
 | `fee_rates` | 手续费缓存 |
-| `product_recommend_cache` | 品种推荐缓存 |
+| `product_recommend_cache` | 可开仓品种缓存 |
 | `stats_cache` | 统计缓存 |

 数据库文件：项目根目录 `futures.db`。
@@ -236,7 +236,7 @@
 | 任务 | 说明 |
 |------|------|
 | 计划/关键位轮询 | 约 3 秒，触发判断与微信推送 |
-| 品种推荐刷新 | 每日 + 按需 |
+| 可开仓品种刷新 | 每日 + 按需 |
 | 持仓 SSE | 前端订阅 `/api/trading/stream` |
 | CTP 开盘前连接 | 默认开盘前 30 分钟 |
 | 挂单超时撤单 | 可配置分钟数 |
@@ -249,10 +249,10 @@
 ```
 qihuo/
 ├── app.py                 # 主路由、计划/关键位/记录/统计
-├── install_trading.py     # 下单、推荐、策略路由
+├── install_trading.py     # 下单、可开仓品种、策略路由
 ├── vnpy_bridge.py         # CTP 连接、报单、持仓
 ├── ctp_trade_sync.py      # 柜台成交同步到 trade_logs
-├── product_recommend.py   # 品种推荐计算
+├── product_recommend.py   # 可开仓品种计算
 ├── stats_engine.py        # 统计分析
 ├── fee_specs.py / ctp_fee_sync.py
 ├── market.py / kline_chart.py
@@ -156,7 +156,7 @@ pm2 restart qihuo
 4. 点击 **连接 CTP**
 5. 顶栏显示 **CTP 已连接**，权益变为 SimNow 账户资金即成功

-连接成功后：下单、持仓、浮盈均来自 SimNow 柜台；**系统设置里的「参考资金」不再用于交易**，仅 CTP 未连接时用于品种推荐与以损定仓估算。
+连接成功后：下单、持仓、浮盈均来自 SimNow 柜台；**系统设置里的「参考资金」不再用于交易**，仅 CTP 未连接时用于可开仓品种筛选与以损定仓估算。

 ---

@@ -9,9 +9,9 @@
 | 顶栏 | 交易模式、CTP 状态、权益/可用、连接 CTP |
 | 期货下单 | 限价/市价报单、止盈止损、以损定仓/固定手数 |
 | 当前持仓 | CTP 持仓卡片、挂单中、撤单、平仓 |
-| 品种推荐 | 按权益筛选、行业分类、走势/跳空/成交量排序 |
+| 可开仓品种 | 按权益与保证金上限筛选、行业分类、走势/跳空/成交量排序 |

-`/trade`、`/recommend` 均重定向到 `/positions`（推荐锚点 `#recommend`）。
+`/trade`、`/recommend` 均重定向到 `/positions`（可开仓品种锚点 `#recommend`）。

 ## 两种交易通道

@@ -29,9 +29,10 @@
 - **平仓**：程序平仓写入 `trade_logs`（来源「本地」）
 - **持仓数据**：SSE `/api/trading/stream` 推送，约 1 秒刷新

-## 品种推荐
+## 可开仓品种

- 每日后台刷新可开品种列表（`/api/recommend/stream`）
+- 用于开仓纪律与仓位限制：按保证金上限计算最大手数，仅展示当前权益下可开的品种
+- 每日后台刷新列表（`/api/recommend/stream`）
 - 最大手数 = floor(权益 × 保证金上限 ÷ 1 手保证金)
 - 展示近一周日线走势、跳空、昨日成交量（手）、成交额
 - 可按 **行业** 筛选，支持多字段排序
@@ -47,7 +48,7 @@

 ## 参考资金

-系统设置中的「参考资金」仅在 **CTP 未连接** 时用于品种推荐与以损定仓估算；连接后自动改用柜台权益。
+系统设置中的「参考资金」仅在 **CTP 未连接** 时用于可开仓品种筛选与以损定仓估算；连接后自动改用柜台权益。

 ## 首次使用 SimNow

@@ -65,8 +66,8 @@
 | `POST /api/trading/order/cancel` | 撤单（交易时段） |
 | `POST /api/trading/close` | 平仓 |
 | `GET /api/trading/stream` | 持仓 SSE |
-| `GET /api/recommend/list` | 品种推荐 JSON |
-| `GET /api/recommend/stream` | 品种推荐 SSE |
+| `GET /api/recommend/list` | 可开仓品种 JSON |
+| `GET /api/recommend/stream` | 可开仓品种 SSE |
 | `POST /api/strategy/trend/execute` | 执行趋势策略 |

 详见 [DEPLOY.md](./DEPLOY.md) 中 CTP 故障排查。
@@ -0,0 +1,185 @@
+# 软件购买与使用协议（个人版）
+
+> **说明**：本协议为个人购买者使用模板。正式交付时可打印或转为 PDF，由双方签字/确认。
+> 本模板不构成法律意见；金额较大或机构/共享交易室合作，建议由执业律师审阅后使用。
+
+---
+
+**协议编号**：_______________  
+**签订日期**：_______________
+
+---
+
+## 甲方（著作权人 / 许可方）
+
+- **姓名**：马建军  
+- **联系电话**：18364911125  
+- **微信**：dekun03  
+
+## 乙方（被许可方 / 购买方）
+
+- **姓名**：_______________  
+- **联系电话**：_______________  
+- **微信/邮箱**：_______________  
+
+---
+
+## 第一条  软件与交付内容
+
+1.1 甲方向乙方提供的软件名称为 **「国内期货交易监控复盘系统」**（以下简称「本软件」），包括甲方交付时约定版本的源代码、部署说明及必要配置指导。
+
+1.2 **交付方式**（勾选适用项）：
+
+- [ ] 部署服务：甲方协助乙方在乙方指定服务器完成安装与基础配置  
+- [ ] 源代码：甲方提供约定版本源代码（Git 归档 / 压缩包 / 私有仓库只读权限，择一填写：_______________）  
+- [ ] 其他：_______________  
+
+1.3 **交付版本标识**（建议填写 Git 提交号或日期）：_______________  
+
+---
+
+## 第二条  授权范围
+
+2.1 甲方授予乙方 **非独占、不可转让、不可再许可** 的个人使用许可。
+
+2.2 乙方仅可将本软件部署在 **乙方本人名下单一实例**（一台 VPS 或一台个人电脑服务器，二选一或填写：_______________），供 **乙方本人** 用于个人期货交易的纪律管理、记录与复盘。
+
+2.3 本授权 **不包括** 以下权利（须另行书面协议并支付费用）：
+
+- 共享交易室、培训室、跟单室等多人共用或对外经营  
+- 白标、OEM、二次分发、转售源码  
+- 将本软件作为带单、荐品种、配资等业务的工具或平台  
+
+---
+
+## 第三条  严禁用途（乙方承诺）
+
+乙方承诺 **不得** 利用本软件从事以下行为：
+
+1. **带单、代客理财、代客下单、信号群喊单、跟单服务** 等可能违反期货监管及咨询资质要求的行为；  
+2. **向他人推荐、介绍特定期货品种、合约或具体买卖方向**，并以此向他人收费或获利；  
+3. **融资、配资、分仓、对赌、非法吸收资金** 等资金融通或变相配资行为；  
+4. **复制、传播、转售、出租、出借** 源代码或部署包给任何第三方；  
+5. **删除、篡改** 软件内或文档中的版权声明与许可说明；  
+6. 其他违反中国法律法规及期货监管规定的行为。  
+
+乙方违反本条，甲方有权 **立即终止许可**；乙方已付费用 **不予退还**（法律另有强制性规定的除外）。因乙方违规导致甲方损失的，乙方应依法赔偿。
+
+---
+
+## 第四条  费用与支付
+
+4.1 乙方应向甲方支付：
+
+| 项目 | 金额（元） | 备注 |
+|------|------------|------|
+| 部署服务费 | | |
+| 源代码许可费 | | |
+| 其他 | | |
+| **合计** | | |
+
+4.2 支付方式：_______________  
+4.3 甲方收到约定款项后 ___ 个工作日内完成交付（或双方另行约定）。
+
+---
+
+## 第五条  更新、维护与支持
+
+5.1 **版本更新**（勾选）：
+
+- [ ] 本次交付为固定版本，后续大版本更新需 **另行付费**  
+- [ ] 含 ___ 个月内的缺陷修复与小版本更新（不含新功能模块）  
+- [ ] 其他：_______________  
+
+5.2 支持方式与范围：_______________（如：微信答疑、远程协助次数等）。  
+5.3 超出约定范围的支持，双方可 **另行协商费用**。
+
+---
+
+## 第六条  知识产权
+
+6.1 本软件之著作权及其他知识产权 **均归甲方所有**。乙方仅获得本协议第二条约定之 **有限使用权**，不取得著作权转让或共有。
+
+6.2 乙方可在本协议授权范围内备份源代码供 **自用**，不得用于再分发。
+
+---
+
+## 第七条  免责声明与风险提示
+
+7.1 本软件为 **交易纪律与记录辅助工具**，不提供投资咨询，不构成任何 **投资建议、收益承诺或交易信号**。
+
+7.2 **期货交易风险极大**，乙方须具备相应风险承受能力，独立作出交易决策，盈亏由乙方 **自行承担**。
+
+7.3 因 CTP/SimNow/网络/服务器/第三方接口故障、断线、延迟等导致的数据偏差、下单失败或损失，甲方在已尽合理交付与说明义务的前提下， **不承担** 由此产生的交易损失（法律强制性规定除外）。
+
+7.4 甲方不保证软件持续符合某一交易所或期货公司的全部最新规则；监管或接口变化时，乙方应配合升级或调整配置。
+
+---
+
+## 第八条  责任限制
+
+8.1 除因甲方 **故意或重大过失** 直接导致乙方人身或财产损害的情形外，甲方对乙方因使用或无法使用本软件产生的 **间接损失、交易亏损、数据丢失、业务中断** 等不承担责任。
+
+8.2 在任何情况下，甲方对乙方的 **累计赔偿责任** 不超过乙方就本协议 **实际已支付给甲方的费用总额**（法律强制性规定除外）。
+
+---
+
+## 第九条  保密
+
+9.1 乙方对交付的 **未公开源代码、部署文档、配置信息** 负有保密义务，不得向无关第三方披露，法律法规或监管要求除外。
+
+9.2 保密期限：许可终止后 **三（3）年** 内仍有效（源代码本身仍不得非法传播）。
+
+---
+
+## 第十条  协议期限与终止
+
+10.1 本协议自双方签字/确认之日起生效。个人使用许可为 **长期有效**，直至依本条终止。
+
+10.2 有下列情形之一的，甲方有权终止许可，乙方应停止使用并销毁多余副本（保留一份备份法律允许的范围内自用备份除外）：
+
+- 乙方违反第三条严禁用途或第二条授权范围；  
+- 乙方非法转售、传播源码；  
+- 乙方从事违法经营活动并使用本软件。  
+
+10.3 终止后，乙方 **不得** 继续使用本软件开展新业务；已产生的法律责任不因终止而免除。
+
+---
+
+## 第十一条  争议解决
+
+11.1 本协议之订立、效力、解释、履行及争议解决均适用 **中华人民共和国法律**。
+
+11.2 双方因本协议发生争议，应先友好协商；协商不成的，任一方可向 **甲方住所地有管辖权的人民法院** 提起诉讼。
+
+---
+
+## 第十二条  其他
+
+12.1 本协议与仓库根目录 `LICENSE.zh-CN.txt` 内容不一致的， **以本协议为准**（仅针对甲乙双方之间）。
+
+12.2 本协议一式两份，甲乙双方各执一份，具有同等效力（电子确认、微信确认截图与纸质同等有效，双方认可时）。
+
+12.3 未尽事宜，双方可签订 **补充协议**；补充协议与本协议具有同等效力。
+
+---
+
+## 签署栏
+
+**甲方（许可方）**  
+
+签名：_______________  
+日期：_______________  
+
+**乙方（被许可方）**  
+
+签名：_______________  
+日期：_______________  
+
+---
+
+## 附件（可选）
+
+- [ ] 交付清单（版本号、文件列表、服务器信息）  
+- [ ] 部署完成确认单  
+- [ ] 乙方身份证复印件（线下签约时）