编写定期调仓计时器，每季度首个交易日自动输出持仓再平衡清单。

定期调仓计时器 —— 每季度首个交易日自动输出持仓再平衡清单（教学级投资组合管理原型）

内容包含免责声明和风险提示，不荐股、不对接券商、不自动化交易、无任何引流。

一、实际应用场景描述

在智能证券投资课程中，再平衡（Rebalancing）是投资组合管理的核心教学内容。

本程序适用于：

- 高校量化投资、投资组合管理课程实验

- 个人投资者调仓纪律训练

- 多资产配置（股票 / 债券 / 现金）教学

- 规则化投资流程演示

核心目标：

- 设定每季度首个交易日为调仓日

- 自动检测当前是否为调仓日

- 若到达调仓日，输出持仓再平衡清单

- 强调人工执行，不自动下单

✅ 不连接券商系统

✅ 不执行真实交易

✅ 仅作为调仓规则演示工具

二、痛点引入（真实可感知）

痛点 表现

忘记调仓 “又过了一个季度，忘了再平衡”

调仓无规律 想起来才调，没有固定节奏

比例漂移 股票涨多了，风险敞口悄悄变大

缺乏清单 调仓时手忙脚乱，漏调或错调

工具过重 专业组合管理系统复杂

👉 需要一个轻量、本地、可解释、可复现的调仓计时工具

三、核心逻辑讲解（工程视角）

1️⃣ 数据模型设计

TargetPortfolio

├── name 标的名称（如 沪深300ETF）

├── ticker 代码

├── target_weight 目标权重（如 0.4 = 40%）

└── current_weight 当前权重（由外部更新）

2️⃣ 调仓日判定规则（A 股教学用）

规则 说明

每季度 1 月、4 月、7 月、10 月

首个交易日 该月第一个周一（教学简化：第一个工作日）

非交易日 跳过，顺延至下一交易日（高级版实现）

简化逻辑：

if 当前月份 in [1, 4, 7, 10]:

if 当前日 == 该月首个交易日:

触发调仓

3️⃣ 再平衡清单生成逻辑

步骤 操作

① 读取各标的当前权重

② 对比目标权重

③ 计算偏离度

④ 生成调仓方向（增持 / 减持 / 不变）

⑤ 输出调仓清单

4️⃣ 核心公式

权重偏离度：

偏离度 = 当前权重 − 目标权重

调仓方向：

偏离度 动作

> +5% 减持

< −5% 增持

其他 维持不变

5️⃣ 设计原则

- 只提醒，不下单

- 规则透明

- 可人工覆盖

四、Python 模块化代码（可直接运行）

📁 项目结构

rebalancing_timer/

│

├── main.py

├── models.py

├── scheduler.py

├── rebalancer.py

├── reporter.py

├── storage.py

├── README.md

└── DISCLAIMER.md

✅ models.py（数据建模）

"""

models.py

投资组合持仓数据模型

"""

class PortfolioAsset:

"""单个持仓标的"""

def __init__(self, name, ticker, target_weight, current_weight=0.0):

"""

name: 标的名称

ticker: 代码

target_weight: 目标权重（0–1）

current_weight: 当前权重（0–1）

"""

self.name = name

self.ticker = ticker

self.target_weight = target_weight

self.current_weight = current_weight

def deviation(self):

"""权重偏离度"""

return self.current_weight - self.target_weight

class Portfolio:

"""投资组合"""

def __init__(self, name, assets):

self.name = name

self.assets = assets

✅ scheduler.py（调仓日判定）

"""

scheduler.py

每季度首个交易日判定

"""

from datetime import datetime

import calendar

def is_rebalance_day(date=None):

"""

判断今天是否为调仓日

规则：每季度的第一个交易日

简化实现：取每月第一个工作日

"""

if date is None:

date = datetime.today()

# 调仓月份：1、4、7、10

rebalance_months = {1, 4, 7, 10}

if date.month not in rebalance_months:

return False, "非调仓月份"

# 找到本月第一个工作日

first_day = _find_first_workday(date.year, date.month)

if date.day == first_day:

return True, "✅ 今日为调仓日"

else:

return False, f"本月调仓日为 {date.month} 月 {first_day} 日"

def _find_first_workday(year, month):

"""找到指定月份第一个工作日"""

for day in range(1, 8):

try:

d = datetime(year, month, day)

# 0–4 代表周一到周五

if d.weekday() < 5:

return day

except ValueError:

break

return 1 # 兜底

✅ rebalancer.py（再平衡清单生成）

"""

rebalancer.py

持仓再平衡清单生成

"""

THRESHOLD = 0.05 # 5% 偏离阈值

def generate_rebalance_list(portfolio):

"""

对比当前权重与目标权重，生成调仓清单

"""

rebalance_list = []

total_deviation = 0.0

for asset in portfolio.assets:

deviation = asset.deviation()

total_deviation += abs(deviation)

if deviation > THRESHOLD:

action = "减持"

elif deviation < -THRESHOLD:

action = "增持"

else:

action = "维持不变"

rebalance_list.append({

"name": asset.name,

"ticker": asset.ticker,

"target_weight": round(asset.target_weight * 100, 1),

"current_weight": round(asset.current_weight * 100, 1),

"deviation_pct": round(deviation * 100, 1),

"action": action

})

return {

"portfolio": portfolio.name,

"total_deviation": round(total_deviation * 100, 2),

"assets": rebalance_list,

"needs_rebalance": total_deviation > THRESHOLD

}

✅ reporter.py（调仓报告输出）

"""

reporter.py

调仓清单与再平衡报告

"""

def report(rebalance_result):

print("\n" + "=" * 60)

print(f"【持仓再平衡清单】")

print("=" * 60)

print(f"组合：{rebalance_result['portfolio']}")

print(f"总偏离度：{rebalance_result['total_deviation']}%")

if not rebalance_result["needs_rebalance"]:

print("\n✅ 当前权重偏离较小，无需调仓")

print("=" * 60)

return

print(f"\n📋 调仓明细：")

print("-" * 60)

print(f"{'标的':<12} {'目标':>6} {'当前':>6} {'偏离':>7} {'动作'}")

print("-" * 60)

for a in rebalance_result["assets"]:

marker = "⚠️" if a["action"] != "维持不变" else " "

print(

f"{marker} {a['name']:<10} "

f"{a['target_weight']:>5.1f}% "

f"{a['current_weight']:>5.1f}% "

f"{a['deviation_pct']:>+6.1f}% "

f"{a['action']}"

)

print("-" * 60)

# 统计

actions = [a for a in rebalance_result["assets"] if a["action"] != "维持不变"]

print(f"\n📊 需调整标的：{len(actions)} / {len(rebalance_result['assets'])}")

# 教学提示

print(f"\n💡 教学提示：")

print("-" * 60)

print(f" ① 偏离阈值设定为 ±5%，可根据课程需要调整")

print(f" ② 实际调仓需考虑交易成本与税费")

print(f" ③ 调仓频率越高 ≠ 效果越好，需权衡")

print(f" ④ 本清单仅供参考，请人工确认后执行")

print("=" * 60)

✅ storage.py（本地存储）

"""

storage.py

JSON 本地存储

"""

import json

FILE_PATH = "rebalance_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 datetime import datetime

from models import PortfolioAsset, Portfolio

from scheduler import is_rebalance_day

from rebalancer import generate_rebalance_list

from reporter import report

from storage import save_log

def main():

print("=== 定期调仓计时器（教学版）===")

print("每季度首个交易日自动输出持仓再平衡清单\n")

# 调仓日检测

is_rb, msg = is_rebalance_day()

today = datetime.today().strftime("%Y-%m-%d")

print(f"📅 今日日期：{today}")

print(f"📅 调仓检测：{msg}")

if not is_rb:

print(f"\n⏭️ 今日非调仓日，无需输出清单")

return

# 组合配置

print(f"\n📌 配置投资组合：")

portfolio_name = input("组合名称（如 核心-卫星组合）：")

assets = []

while True:

ticker = input("标的代码（空结束）：")

if not ticker:

break

name = input("标的名称：")

target_w = float(input("目标权重（如 0.4 表示 40%）："))

current_w = float(input("当前权重（如 0.5 表示 50%）："))

assets.append(PortfolioAsset(name, ticker, target_w, current_w))

if not assets:

print("⚠️ 未配置持仓，退出")

return

# 校验权重

total_target = sum(a.target_weight for a in assets)

total_current = sum(a.current_weight for a in assets)

if abs(total_target - 1.0) > 0.01:

print(f"⚠️ 目标权重之和 = {round(total_target * 100, 1)}%，不等于 100%")

if abs(total_current - 1.0) > 0.01:

print(f"⚠️ 当前权重之和 = {round(total_current * 100, 1)}%，不等于 100%")

portfolio = Portfolio(portfolio_name, assets)

# 生成再平衡清单

result = generate_rebalance_list(portfolio)

# 输出报告

report(result)

# 保存日志

log_data = {

"date": today,

"portfolio": portfolio_name,

"is_rebalance_day": True,

"result": result

}

save_log(log_data)

print("\n✅ 调仓日志已保存")

if __name__ == "__main__":

main()

五、README 与使用说明

# 定期调仓计时器（教学版）

## 项目说明

每季度首个交易日自动检测并输出持仓再平衡清单。

## 使用方式

bash

python main.py

## 调仓规则

| 季度 | 调仓月 | 调仓日 |

|---|---|---|

| Q1 | 1 月 | 第一个工作日 |

| Q2 | 4 月 | 第一个工作日 |

| Q3 | 7 月 | 第一个工作日 |

| Q4 | 10 月 | 第一个工作日 |

## 输入示例

组合名称：核心-卫星组合

标的代码：510300

标的名称：沪深300ETF

目标权重：0.4

当前权重：0.5

## 适用范围

- 量化投资课程

- 投资组合管理教学

- 调仓纪律训练

## 注意事项

- 不执行真实交易

- 不连接券商系统

- 使用前请阅读 DISCLAIMER.md

六、DISCLAIMER.md（免责声明与风险提示）

# 免责声明与风险提示

## 免责声明

本程序仅供**教学与科研用途**，用于演示再平衡规则与调仓流程。

作者不提供任何投资建议，不推荐任何证券，不承诺任何收益。

## 风险提示

1. 调仓日判定为简化实现，未考虑法定节假日调休

2. 偏离阈值 5% 为教学假设，非"唯一正确答案"

3. 实际调仓需考虑交易手续费、印花税、滑点等成本

4. 高频调仓可能侵蚀收益（"再平衡摩擦"）

5. 静态权重再平衡 ≠ 最优动态配置策略

使用本工具产生的任何后果，作者概不负责。

七、核心知识点卡片（教学向）

分类 内容

Python 类、日期处理、条件分支

量化金融 再平衡（Rebalancing）、权重偏离

投资组合 资产配置、目标权重、漂移管理

交易纪律 规则化调仓、克服情绪干扰

工程思想 调度器与执行器解耦

可扩展性 可接入真实交易日历 API

八、总结（工程师视角）

这是一个完全中立、去营销化、可教学的原型系统：

✅ 不鼓吹频繁调仓

✅ 不妖魔化偏离

✅ 不伪装成智能投顾

它真正展示的是：

如何用 Python 把"调仓纪律"从模糊的意图，变成可定时、可检测、可执行的规则系统

核心教学价值：

场景 数据事实

"差不多就调吧" 无规则的调仓往往过度交易

"一直不调也行" 权重漂移可能让风险悄然失控

"调仓好麻烦" 规则化后，调仓只需几分钟

本文代码仅供学习与技术交流，不构成任何投资建议，股市有风险，入市需谨慎！

利用AI解决实际问题，如果你觉得这个工具好用，欢迎关注长安牧笛！