单只个股最大持仓占比上限校验与调仓建议工具（教学级量化风控原型）
内容包含免责声明和风险提示，不荐股、不对接券商、不自动交易、无任何引流。
一、实际应用场景描述
在智能证券投资课程中，仓位管理（Position Sizing）与集中度风险控制是核心教学内容。
本程序适用于：
- 高校量化投资、证券实务课程实验
- 个人投资者风控纪律训练
- 投资组合管理（Portfolio Management）教学
- 交易规则自动化演示
核心目标：
- 设置单只个股最大持仓占比上限
- 自动校验当前仓位是否超标
- 若超标，给出可执行的调仓建议
- 强调人工决策，不自动下单
✅ 不连接券商系统
✅ 不执行真实交易
✅ 仅作为风控规则演示工具
二、痛点引入（真实可感知）
痛点 表现
持股过于集中 单只个股占比过高
风险敞口失控 黑天鹅事件损失巨大
调仓无依据 “该卖多少？”全凭感觉
规则只停留在纸面 知道但不执行
工具过重 专业风控系统复杂
👉 需要一个轻量、本地、可解释、可复现的仓位校验工具
三、核心逻辑讲解（工程视角）
1️⃣ 数据模型设计
Position
├── symbol 股票代码
├── market_value 持仓市值
└── total_assets 总资产
2️⃣ 核心风控规则（教学用）
单只个股持仓占比
持仓占比 = 个股市值 / 总资产
超标判定
if 持仓占比 > 最大持仓上限:
触发风控警告
3️⃣ 调仓建议逻辑
场景 建议
超标 ≤ 5% 小幅减仓
超标 > 5% 显著降低仓位
接近上限 暂停加仓
4️⃣ 设计原则
- 只校验，不交易
- 规则透明
- 建议可人工覆盖
四、Python 模块化代码（可直接运行）
📁 项目结构
position_limit_checker/
│
├── main.py
├── models.py
├── checker.py
├── advisor.py
├── storage.py
├── README.md
└── DISCLAIMER.md
✅ models.py（数据建模）
"""
models.py
持仓数据模型
"""
class Position:
def __init__(self, symbol, market_value, total_assets):
self.symbol = symbol
self.market_value = market_value
self.total_assets = total_assets
self.weight = market_value / total_assets
✅ checker.py（仓位校验）
"""
checker.py
单只个股持仓上限校验
"""
def check_position(position, max_weight):
if position.weight > max_weight:
return {
"symbol": position.symbol,
"current_weight": round(position.weight * 100, 2),
"exceeded": round((position.weight - max_weight) * 100, 2),
"status": "超标"
}
else:
return {
"symbol": position.symbol,
"current_weight": round(position.weight * 100, 2),
"status": "正常"
}
✅ advisor.py（调仓建议）
"""
advisor.py
超标仓位调仓建议
"""
def advise(check_result, max_weight):
if check_result["status"] == "正常":
return "仓位健康，无需调整"
exceed = check_result["exceeded"]
if exceed <= 5:
return f"建议小幅减仓 {exceed}%，回归上限以内"
else:
target_reduce = exceed + 2
return f"建议显著降低仓位 {target_reduce}%，控制集中度风险"
✅ storage.py（本地存储）
"""
storage.py
JSON 本地存储
"""
import json
FILE_PATH = "position_check_log.json"
def save_log(data):
with open(FILE_PATH, "w", encoding="utf-8") as f:
json.dump(data, f, ensure_ascii=False, indent=2)
✅ main.py（交互入口）
"""
main.py
单只个股最大持仓占比校验工具
"""
from models import Position
from checker import check_position
from advisor import advise
from storage import save_log
def main():
print("=== 单只个股持仓上限校验工具（教学版） ===")
positions = []
total_assets = float(input("请输入总资产："))
while True:
symbol = input("股票代码（空结束）：")
if not symbol:
break
mv = float(input("该股市值："))
positions.append(Position(symbol, mv, total_assets))
max_weight = float(input("最大持仓占比上限（如 0.2 表示 20%）："))
results = []
for p in positions:
check = check_position(p, max_weight)
check["advice"] = advise(check, max_weight)
results.append(check)
print("\n【仓位校验结果】")
for r in results:
print(r)
save_log(results)
print("✅ 校验结果已保存")
if __name__ == "__main__":
main()
五、README 与使用说明
# 单只个股最大持仓占比校验工具（教学版）
## 项目说明
用于设置单只个股最大持仓占比上限，并自动校验是否超标及给出调仓建议。
## 使用方式
```bash
python main.py
```
## 适用范围
- 量化投资课程
- 风控与仓位管理教学
- 个人投资者纪律训练
## 注意事项
- 不执行真实交易
- 不连接券商系统
- 使用前请阅读 DISCLAIMER.md
六、DISCLAIMER.md（免责声明与风险提示）
# 免责声明与风险提示
## 免责声明
本程序仅供**教学与科研用途**，用于演示仓位管理与风控规则。
作者不提供任何投资建议，不推荐任何股票，不承诺任何收益。
## 风险提示
1. 仓位上限 ≠ 风险控制全部
2. 调仓建议仅为数学计算结果
3. 实盘需结合市场环境与流动性
4. 使用本工具产生的任何后果，作者概不负责。
七、核心知识点卡片（教学向）
分类 内容
Python 类、条件判断、数据建模
量化金融 仓位管理、集中度风险
风控理念 规则化、可执行
工程思想 模块化、可复现
风险教育 工具 ≠ 决策
可扩展性 可接入组合管理系统
八、总结（工程师视角）
这是一个完全中立、去营销化、可教学的原型系统：
✅ 不鼓吹集中持股
✅ 不神化分散投资
✅ 不伪装成智能风控系统
它真正展示的是：
如何用 Python 把“模糊的风控意识”固化为可校验、可审计、可反思的技术规则
本文代码仅供学习与技术交流，不构成任何投资建议，股市有风险，入市需谨慎！
利用AI解决实际问题，如果你觉得这个工具好用，欢迎关注长安牧笛！
