akg-factor-bridge/test_plan_rank_axis.py

237 lines
11 KiB
Python
Raw Normal View History

选股计划排序轴换成公司质地,传导降为雷达门与带内次级键(台账 063) 按 docs/选股计划调整方案_2026-09-17.md 落地。三份读数(09-02 §1.8、08-28 周报、09-11 抽查)一致:传导越强超额越负,传导分的公式奖励的正是被证明为负的"未动补涨"。所以把传导从排序主轴换成雷达门加带内次级键,公司质地成为排序主轴。改动全在计划装配层,四个开关全设旧值即逐字回旧。 一、排序轴换质地(plan.py)。新增 _rerank_by_axis 按(质地带、被指向、组内分、原始分、代码)词典序重排、_rerank 按 config.PLAN_RANK_AXIS 分派;组内分从原始分反解、档位不进次序;被指向以候选卡门槛一 gates.pointed 为准。调用点先用 _rerank_by_quality 算旧序拿 rank_old 再算新序。_pick 与 pick_rows 加 uncapped_no_theme:质地轴下无传导行免主题限额、不计数,否则主轴被限额推翻。_row 加 quality_band、rank_axis、pointed、rank_old 四键,score/score_adj/tier 值与含义不变。返回字典质地轴下加 rank_axis、rank_rule、quality_band_counts。encoding 追加一句。 二、候选卡内序与质地门(card.py)。新增 quality_band 函数(好三中二差零,无评析与证据不足与超期一百二十天归一),plan.py 与 card.py 共用它。judge 加 stale_days 参数、返回加 quality_band;质地门"差降关注"改用质地带为零并带上一百二十天守卫(超期报告不再降档)。sort_key 在判决与涨幅之间插入质地带、受 CARD_SORT_BY_QUALITY 控,关掉逐字回旧。三门槛一确认三风险一字未动。 三、入池与评析名单(pool.py、review_targets.py)。pool 把选行抽成纯函数 select_plan_rows:rank 源取主榜新序里被指向的前 POOL_TOP、_pool_source 记 rank_top,备用开关 POOL_RANK_KEEP_OLD 并进旧序强传导前若干、去重、受 POOL_MAX 兜底;tier 与 candidate 逐字保留。strategy_context_entry 加 quality_band、rank_axis、rank_old 三键。review_targets 新增纯函数 pick_main_targets:both 取原始分前一百与新序前五十的并集、去重按新序,score 逐字回旧;评析覆盖与排序轴解耦。 四、周报对照(plan_review.py)。第一节加主榜新序前二十与旧序前二十两份名单(rank_old 缺的旧快照跳过);档位分组外加档位乘质地带交叉分组,看传导在质地档内还剩多少信息量。plan_reconcile 应答加 rank_axis: transmission 一键,说明逐票对账的"主榜第 N 名"仍按原始分序,文案不动。 五、单测、开关、文档。新 test_plan_rank_axis.py 十例(含四开关设旧值逐字回旧、四带序、带内次级键、确定性、超期守卫、入池 rank、评析并集、卡内序、主题限额例外、备用开关),本地 ALL OK。test_plan_quality_rank.py 接线匹配串改成新调用点,test_plan_snapshot.py 加一条质地轴主题限额对照用例。config 加 PLAN_RANK_AXIS、CARD_SORT_BY_QUALITY、REVIEW_TARGETS_AXIS 三个开关与备用开关 POOL_RANK_KEEP_OLD,POOL_SOURCE 默认改 rank。.env.example、README 计划字段、台账 063、入池对接说明、下游对接说明一并改。 没有改的是什么、为什么不合并。分数编码 factors.py 一字未动——它注册在外部平台当因子,改它会污染平台的因子历史;次序改动全部放在装配层。api.py 不碰。三门槛一确认三风险不动,质地门保持"差降关注"。持仓管理系统按上游名次排是协同项,在另一仓库单独审批,不阻塞本次上线(它的看多分桶已把好公司排在前面)。 实测读数。开发机 python3 test_plan_rank_axis.py 与 python3 test_plan_quality_rank.py 均 ALL OK;PLAN_RANK_AXIS=transmission CARD_SORT_BY_QUALITY=0 POOL_SOURCE=tier REVIEW_TARGETS_AXIS=score 下 test_plan_rank_axis.py 仍 ALL OK(逐字回旧那一例断言与 09-14 旧序逐字相同)。test_card、test_pool_logic、test_plan_snapshot 全绿。既有的 test_review_targets、test_plan_review_window、test_plan_logic_state、test_plan_cache、test_plan_reviews_live 因缺 psycopg/fastapi 或本机 Python 3.9 不支持联合类型注解而只能在部署机跑,非本次引入。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-09-17 10:28:23 +08:00
"""选股计划排序轴换成公司质地(2026-09-17):传导降为雷达门与带内次级键。
离线,不连库不起服务。跑法:python3 test_plan_rank_axis.py,预期最后一行是 ALL OK。
逐字回旧那一例是 case1:四个开关都设旧值时,装配重排输出与 09-14 的 _rerank_by_quality 逐字节相同。
附录丙十例一一对应本文件的十个 test_*。
"""
import os
import sys
import types
# 离线不连库:装不上的驱动打空壳,pandas 本机装得上就用真的(重排要在真 Series 上验)。
for _n in ("pandas", "pymysql", "psycopg", "pymongo"):
if _n not in sys.modules:
try:
__import__(_n)
except Exception: # noqa: BLE001
_m = types.ModuleType(_n)
if _n == "pandas":
_m.DataFrame = type("DataFrame", (), {})
sys.modules[_n] = _m
import pandas as pd # noqa: E402 —— 重排就在 pd.Series 上做,直接用真的 pandas
sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
import card # noqa: E402
import config # noqa: E402
import plan # noqa: E402
import pool # noqa: E402
import review_targets # noqa: E402
FAILED = []
def t(name, cond, extra=""):
print((" ok " if cond else " FAIL ") + name + ((" " + str(extra)) if not cond else ""))
if not cond:
FAILED.append(name)
def _cr(overall, age_days=None):
if overall is None:
return None
d = {"overall": overall}
if age_days is not None:
d["age_days"] = age_days
return d
def _cards(spec: dict) -> dict:
"""spec:{代码: (质地档, 被指向[, 报告日龄])}。装成 collect 里 cards 的形状(只放本改动要读的两路)。"""
out = {}
for k, v in spec.items():
overall, pointed = v[0], v[1]
age = v[2] if len(v) > 2 else None
out[k] = {"company_review": _cr(overall, age), "gates": {"pointed": pointed}}
return out
def test_1_replay_transmission():
print("[case1 四开关设旧值:逐字回旧到 _rerank_by_quality]")
ranked = pd.Series({"A": 242.0, "B": 238.0, "C": 222.0, "D": 218.0})
cards = _cards({"A": ("差", True), "B": ("好", False), "C": ("好", True), "D": ("差", False)})
old = config.PLAN_RANK_AXIS
try:
config.PLAN_RANK_AXIS = "transmission"
out = plan._rerank(ranked, cards, True)
finally:
config.PLAN_RANK_AXIS = old
ref = plan._rerank_by_quality(ranked, cards, config.PLAN_QUALITY_BONUS)
t("序列顺序逐字相同", list(out.index) == list(ref.index), list(out.index))
t("分值逐字相同", list(out.values) == list(ref.values))
def test_2_bands_order():
print("[case2 质地带:好 > 中 > 无评析 > 差]")
ranked = pd.Series({"g": 210.0, "m": 210.0, "n": 210.0, "b": 210.0})
cards = _cards({"g": ("好", False), "m": ("中", False), "n": (None, False), "b": ("差", False)})
out = plan._rerank_by_axis(ranked, cards, "quality", 120, True)
t("好中无差", list(out.index) == ["g", "m", "n", "b"], list(out.index))
def test_3_within_band():
print("[case3 同带内:被指向优先,再按组内分]")
ranked = pd.Series({"p_lo": 213.0, "p_hi": 217.0, "np_hi": 218.0})
cards = _cards({"p_lo": ("好", True), "p_hi": ("好", True), "np_hi": ("好", False)})
out = plan._rerank_by_axis(ranked, cards, "quality", 120, True)
t("被指向优先且带内按组内分", list(out.index) == ["p_hi", "p_lo", "np_hi"], list(out.index))
def test_4_deterministic():
print("[case4 确定性:两次相同、末位键代码升序]")
ranked = pd.Series({"B": 210.0, "A": 210.0})
cards = _cards({"A": ("好", True), "B": ("好", True)})
o1 = list(plan._rerank_by_axis(ranked, cards, "quality", 120, True).index)
o2 = list(plan._rerank_by_axis(ranked, cards, "quality", 120, True).index)
t("两次装配顺序相同", o1 == o2, o1)
t("末位键代码升序", o1 == ["A", "B"], o1)
def test_5_stale_demotes():
print("[case5 超期一百二十天的好公司落到第一带]")
ranked = pd.Series({"fresh": 210.0, "mid": 210.0, "stale": 210.0})
cards = _cards({"fresh": ("好", False, 10), "mid": ("中", False, 10), "stale": ("好", False, 200)})
out = plan._rerank_by_axis(ranked, cards, "quality", 120, True)
t("超期好票落到无评析带(排到中之后)", list(out.index) == ["fresh", "mid", "stale"], list(out.index))
def test_6_pool_rank_source():
print("[case6 入池 rank:只取被指向的,数量等于 top,按新序]")
main_rows = [
{"code": "a", "pointed": True, "tier": "强传导", "rank_old": 3},
{"code": "b", "pointed": False, "tier": "强传导", "rank_old": 1},
{"code": "c", "pointed": True, "tier": "弱传导", "rank_old": 5},
{"code": "d", "pointed": True, "tier": "无传导", "rank_old": 2},
]
rows = pool.select_plan_rows(main_rows, 2, "rank", set())
t("只取被指向", all(r.get("pointed") for r in rows), [r["code"] for r in rows])
t("数量等于 top", len(rows) == 2, len(rows))
t("按主榜新序取前二", [r["code"] for r in rows] == ["a", "c"], [r["code"] for r in rows])
t("_pool_source 记 rank_top", all(r["_pool_source"] == "rank_top" for r in rows))
def test_7_review_targets_union():
print("[case7 评析名单两路并集:去重、按新序]")
main = [
{"code": "600001.SH", "name": "x1", "score": 300, "rank": 1},
{"code": "600002.SH", "name": "x2", "score": 260, "rank": 2},
{"code": "600003.SH", "name": "x3", "score": 320, "rank": 3},
]
both = review_targets.pick_main_targets(main, "both", 2, 1)
codes = [r["code"] for r in both]
# score 降序前二:x3(320)、x1(300);rank 升序前一:x1(rank1)。并集去重={x1,x3},按 rank 排 → x1,x3
t("并集去重", set(codes) == {"600001.SH", "600003.SH"}, codes)
t("按新序(rank)排", codes == ["600001.SH", "600003.SH"], codes)
only = review_targets.pick_main_targets(main, "score", 2, 1)
t("score 轴逐字回旧(score 降序前二)", [r["code"] for r in only] == ["600003.SH", "600001.SH"],
[r["code"] for r in only])
def test_8_card_sort_toggle():
print("[case8 卡内序开关:开则质地优先,关则回先判决再涨幅]")
rows = [
{"verdict": "候选", "quality_band": 0, "pct0": 5.0},
{"verdict": "候选", "quality_band": 3, "pct0": 1.0},
]
old = config.CARD_SORT_BY_QUALITY
try:
config.CARD_SORT_BY_QUALITY = True
on = sorted(rows, key=card.sort_key)
t("开:质地好在前", on[0]["quality_band"] == 3, on[0])
config.CARD_SORT_BY_QUALITY = False
off = sorted(rows, key=card.sort_key)
t("关:涨幅高在前(逐字回旧)", off[0]["pct0"] == 5.0, off[0])
finally:
config.CARD_SORT_BY_QUALITY = old
def test_9_theme_cap_exemption():
print("[case9 主题限额:质地轴下无传导票免限额,有主题仍每主题五只]")
no_theme = [{"code": f"n{i}", "evidence": None, "rank_axis": "quality"} for i in range(6)]
t("无传导票免五只限额", len(plan.pick_rows(no_theme, 20, 5, uncapped_no_theme=True)) == 6)
t("旧轴无主题同样不合桶", len(plan.pick_rows(no_theme, 20, 5, uncapped_no_theme=False)) == 6)
选股计划排序轴换成公司质地,传导降为雷达门与带内次级键(台账 063) 按 docs/选股计划调整方案_2026-09-17.md 落地。三份读数(09-02 §1.8、08-28 周报、09-11 抽查)一致:传导越强超额越负,传导分的公式奖励的正是被证明为负的"未动补涨"。所以把传导从排序主轴换成雷达门加带内次级键,公司质地成为排序主轴。改动全在计划装配层,四个开关全设旧值即逐字回旧。 一、排序轴换质地(plan.py)。新增 _rerank_by_axis 按(质地带、被指向、组内分、原始分、代码)词典序重排、_rerank 按 config.PLAN_RANK_AXIS 分派;组内分从原始分反解、档位不进次序;被指向以候选卡门槛一 gates.pointed 为准。调用点先用 _rerank_by_quality 算旧序拿 rank_old 再算新序。_pick 与 pick_rows 加 uncapped_no_theme:质地轴下无传导行免主题限额、不计数,否则主轴被限额推翻。_row 加 quality_band、rank_axis、pointed、rank_old 四键,score/score_adj/tier 值与含义不变。返回字典质地轴下加 rank_axis、rank_rule、quality_band_counts。encoding 追加一句。 二、候选卡内序与质地门(card.py)。新增 quality_band 函数(好三中二差零,无评析与证据不足与超期一百二十天归一),plan.py 与 card.py 共用它。judge 加 stale_days 参数、返回加 quality_band;质地门"差降关注"改用质地带为零并带上一百二十天守卫(超期报告不再降档)。sort_key 在判决与涨幅之间插入质地带、受 CARD_SORT_BY_QUALITY 控,关掉逐字回旧。三门槛一确认三风险一字未动。 三、入池与评析名单(pool.py、review_targets.py)。pool 把选行抽成纯函数 select_plan_rows:rank 源取主榜新序里被指向的前 POOL_TOP、_pool_source 记 rank_top,备用开关 POOL_RANK_KEEP_OLD 并进旧序强传导前若干、去重、受 POOL_MAX 兜底;tier 与 candidate 逐字保留。strategy_context_entry 加 quality_band、rank_axis、rank_old 三键。review_targets 新增纯函数 pick_main_targets:both 取原始分前一百与新序前五十的并集、去重按新序,score 逐字回旧;评析覆盖与排序轴解耦。 四、周报对照(plan_review.py)。第一节加主榜新序前二十与旧序前二十两份名单(rank_old 缺的旧快照跳过);档位分组外加档位乘质地带交叉分组,看传导在质地档内还剩多少信息量。plan_reconcile 应答加 rank_axis: transmission 一键,说明逐票对账的"主榜第 N 名"仍按原始分序,文案不动。 五、单测、开关、文档。新 test_plan_rank_axis.py 十例(含四开关设旧值逐字回旧、四带序、带内次级键、确定性、超期守卫、入池 rank、评析并集、卡内序、主题限额例外、备用开关),本地 ALL OK。test_plan_quality_rank.py 接线匹配串改成新调用点,test_plan_snapshot.py 加一条质地轴主题限额对照用例。config 加 PLAN_RANK_AXIS、CARD_SORT_BY_QUALITY、REVIEW_TARGETS_AXIS 三个开关与备用开关 POOL_RANK_KEEP_OLD,POOL_SOURCE 默认改 rank。.env.example、README 计划字段、台账 063、入池对接说明、下游对接说明一并改。 没有改的是什么、为什么不合并。分数编码 factors.py 一字未动——它注册在外部平台当因子,改它会污染平台的因子历史;次序改动全部放在装配层。api.py 不碰。三门槛一确认三风险不动,质地门保持"差降关注"。持仓管理系统按上游名次排是协同项,在另一仓库单独审批,不阻塞本次上线(它的看多分桶已把好公司排在前面)。 实测读数。开发机 python3 test_plan_rank_axis.py 与 python3 test_plan_quality_rank.py 均 ALL OK;PLAN_RANK_AXIS=transmission CARD_SORT_BY_QUALITY=0 POOL_SOURCE=tier REVIEW_TARGETS_AXIS=score 下 test_plan_rank_axis.py 仍 ALL OK(逐字回旧那一例断言与 09-14 旧序逐字相同)。test_card、test_pool_logic、test_plan_snapshot 全绿。既有的 test_review_targets、test_plan_review_window、test_plan_logic_state、test_plan_cache、test_plan_reviews_live 因缺 psycopg/fastapi 或本机 Python 3.9 不支持联合类型注解而只能在部署机跑,非本次引入。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-09-17 10:28:23 +08:00
themed = [{"code": f"t{i}", "evidence": {"theme": "锂电"}, "rank_axis": "quality"} for i in range(6)]
t("有主题仍受每主题五只", len(plan.pick_rows(themed, 20, 5, uncapped_no_theme=True)) == 5)
def test_10_pool_keep_old():
print("[case10 备用开关 keep_old:并进旧序强传导前 top,去重,受 POOL_MAX 兜底]")
main_rows = [
{"code": "a", "pointed": True, "tier": "强传导", "rank_old": 3},
{"code": "b", "pointed": False, "tier": "强传导", "rank_old": 1},
{"code": "e", "pointed": False, "tier": "强传导", "rank_old": 2},
]
rows = pool.select_plan_rows(main_rows, 2, "rank", {"强传导"}, keep_old=True)
codes = [r["code"] for r in rows]
t("被指向的 a 在", "a" in codes, codes)
t("旧序强传导前二并进(b、e)", "b" in codes and "e" in codes, codes)
t("同票不重复", len(codes) == len(set(codes)), codes)
old_max = config.POOL_MAX
try:
config.POOL_MAX = 2
rows2 = pool.select_plan_rows(main_rows, 2, "rank", {"强传导"}, keep_old=True)
t("POOL_MAX 兜底", len(rows2) <= 2, len(rows2))
finally:
config.POOL_MAX = old_max
选股计划修复小包:截取规则收一处、encoding 两轴都对、交接补记、周报改读快照(工作包甲与丙) 承接 docs/评审记录_2026-09-17.md 的三处必改与周报底本拍板,规格在 docs/上线与协同阶段工作方案与规格书_2026-09-17.md 工作包甲与丙。一个提交,09-18 复审。工作包乙(持仓管理系统按上游名次排)在另一仓库、另批,不在本提交。 工作包甲(修复三处必改)。 一、主题限额的截取规则收成一处。新增模块级纯函数 take_by_theme,装配路 collect 里的 _pick 与快照路模块级 pick_rows 都调它,只是各自用一个 theme_of 告诉它怎么从一条记录取主题。装配路的 _theme_of 与 _row 写 evidence 的取法同源:传导视图有证据行取它,否则已启动成员用已动成员视图补的主题;快照路取行上的 evidence.theme。这样已启动成员在两条路上都算进所在主题、受限额,同一天早上落盘的主榜前二十与接口读快照给持仓管理系统的前二十是同一份。这一步同时改正了旧轴下两条路对已启动成员计数的既有分歧,改的只是 md 与 main_shown 这条路,接口路原样不动。逐字回旧那一例不受影响。 二、encoding 句改成两轴都对。原来无条件追加"名次按质地带优先",旧轴下与实际次序相反、持仓管理系统会原样展示。改成"名次按开关 PLAN_RANK_AXIS:quality 时质地带优先、传导只在带内作次级键,transmission 时按 09-14 的质地调整分序"。 三、交接文档补一段。docs/交接_2026-09-10.md 末尾加"十一、2026-09-17 补记":改了什么、下游看到什么(四个新键、名次含义、逐票对账仍按原始分序、持仓管理系统前缀效应)、怎么回退(四个开关)、读数在哪;台账那一行从"最新到第 057 条"改成 063。四仓库同步。 工作包丙(周报改读当日快照,2026-09-17 已拍板)。周报对每个计划日先读当天落盘的 JSON 快照的全量主榜、观察档、候选单、关注单,读不出才回落现算。新增 plan_review._plan_for_review 与 _read_review_snapshot,开关 config.PLAN_REVIEW_SOURCE 默认 snapshot、设 live 回旧做法,每天的逐日注记里写明底本是快照还是现算。为什么:现算用的是跑周报那一刻的评析报告、查询不按日期截断,质地成主轴后会把晚到的报告回头算进当天名单;四周复核比的是当天真出过的两份名单,快照才是当天那份。 单测。test_plan_rank_axis.py 加两例:已启动成员在装配路与快照路都算进所在主题、theme_cap=5 下各只放五条(案 11);无主题行质地轴免限额放六条、旧轴归无传导桶限额五条(案 12)。新 test_plan_review_source.py:合成一份快照,验有快照读快照、无快照回落现算、开关 live 回旧,不连库。 没有改的是什么。工作包乙在持仓管理系统仓库、单独审批,不在本提交。factors.py 分数编码与 api.py 一字未动。四个开关全设旧值仍逐字回旧。 实测读数。开发机三件均 ALL OK:test_plan_rank_axis.py(十二例,含逐字回旧那例)、test_plan_snapshot.py、test_plan_quality_rank.py;四开关设旧值再跑 test_plan_rank_axis.py 仍 ALL OK;新 test_plan_review_source.py ALL OK。既有的 test_review_targets、test_plan_review_window、test_plan_logic_state、test_plan_cache、test_plan_reviews_live 因缺 psycopg/fastapi 或本机 Python 3.9 不支持联合类型注解只能在部署机跑,非本次引入。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-09-17 11:48:17 +08:00
def test_11_started_member_counts_theme():
print("[case11 必改一:已启动成员两条路都算进所在主题、受限额]")
# 六条同主题"锂电",前五条走传导视图证据行,第六条无证据行、由候选卡 moved_view 补主题
ev = {f"c{i}": ("锂电", 2, 0.3) for i in range(5)}
cards = {"c5": {"started_source": "moved_view", "theme": "锂电"}}
def _theme_of(kv): # 与 collect 里 _theme_of 同源:先传导视图证据行,再已动成员视图补充
k = kv[0]
e = ev.get(k)
if e:
return e[0]
c = cards.get(k) or {}
if c.get("started_source") == "moved_view" and c.get("theme"):
return c["theme"]
return None
items = [(f"c{i}", 200.0 - i) for i in range(6)]
picked = plan.take_by_theme(items, 20, 5, _theme_of, uncapped_no_theme=True)
t("装配路:同主题只放五条(含 moved_view 补主题那条算进主题)", len(picked) == 5, len(picked))
rows = [{"code": f"c{i}", "evidence": {"theme": "锂电"}, "rank_axis": "quality"} for i in range(6)]
t("快照路:同样六条只放五条", len(plan.pick_rows(rows, 20, 5)) == 5, len(plan.pick_rows(rows, 20, 5)))
def test_12_no_theme_by_axis():
print("[case12 必改一:无主题行两轴各归各——质地轴免限额,旧轴归无传导桶计数]")
items = [(f"n{i}", 200.0 - i) for i in range(6)]
none_theme = lambda kv: None # noqa: E731 —— 六条都无主题
t("质地轴(uncapped 真)放六条", len(plan.take_by_theme(items, 20, 5, none_theme, True)) == 6)
t("旧轴(uncapped 假)无主题同样免限额", len(plan.take_by_theme(items, 20, 5, none_theme, False)) == 6)
选股计划修复小包:截取规则收一处、encoding 两轴都对、交接补记、周报改读快照(工作包甲与丙) 承接 docs/评审记录_2026-09-17.md 的三处必改与周报底本拍板,规格在 docs/上线与协同阶段工作方案与规格书_2026-09-17.md 工作包甲与丙。一个提交,09-18 复审。工作包乙(持仓管理系统按上游名次排)在另一仓库、另批,不在本提交。 工作包甲(修复三处必改)。 一、主题限额的截取规则收成一处。新增模块级纯函数 take_by_theme,装配路 collect 里的 _pick 与快照路模块级 pick_rows 都调它,只是各自用一个 theme_of 告诉它怎么从一条记录取主题。装配路的 _theme_of 与 _row 写 evidence 的取法同源:传导视图有证据行取它,否则已启动成员用已动成员视图补的主题;快照路取行上的 evidence.theme。这样已启动成员在两条路上都算进所在主题、受限额,同一天早上落盘的主榜前二十与接口读快照给持仓管理系统的前二十是同一份。这一步同时改正了旧轴下两条路对已启动成员计数的既有分歧,改的只是 md 与 main_shown 这条路,接口路原样不动。逐字回旧那一例不受影响。 二、encoding 句改成两轴都对。原来无条件追加"名次按质地带优先",旧轴下与实际次序相反、持仓管理系统会原样展示。改成"名次按开关 PLAN_RANK_AXIS:quality 时质地带优先、传导只在带内作次级键,transmission 时按 09-14 的质地调整分序"。 三、交接文档补一段。docs/交接_2026-09-10.md 末尾加"十一、2026-09-17 补记":改了什么、下游看到什么(四个新键、名次含义、逐票对账仍按原始分序、持仓管理系统前缀效应)、怎么回退(四个开关)、读数在哪;台账那一行从"最新到第 057 条"改成 063。四仓库同步。 工作包丙(周报改读当日快照,2026-09-17 已拍板)。周报对每个计划日先读当天落盘的 JSON 快照的全量主榜、观察档、候选单、关注单,读不出才回落现算。新增 plan_review._plan_for_review 与 _read_review_snapshot,开关 config.PLAN_REVIEW_SOURCE 默认 snapshot、设 live 回旧做法,每天的逐日注记里写明底本是快照还是现算。为什么:现算用的是跑周报那一刻的评析报告、查询不按日期截断,质地成主轴后会把晚到的报告回头算进当天名单;四周复核比的是当天真出过的两份名单,快照才是当天那份。 单测。test_plan_rank_axis.py 加两例:已启动成员在装配路与快照路都算进所在主题、theme_cap=5 下各只放五条(案 11);无主题行质地轴免限额放六条、旧轴归无传导桶限额五条(案 12)。新 test_plan_review_source.py:合成一份快照,验有快照读快照、无快照回落现算、开关 live 回旧,不连库。 没有改的是什么。工作包乙在持仓管理系统仓库、单独审批,不在本提交。factors.py 分数编码与 api.py 一字未动。四个开关全设旧值仍逐字回旧。 实测读数。开发机三件均 ALL OK:test_plan_rank_axis.py(十二例,含逐字回旧那例)、test_plan_snapshot.py、test_plan_quality_rank.py;四开关设旧值再跑 test_plan_rank_axis.py 仍 ALL OK;新 test_plan_review_source.py ALL OK。既有的 test_review_targets、test_plan_review_window、test_plan_logic_state、test_plan_cache、test_plan_reviews_live 因缺 psycopg/fastapi 或本机 Python 3.9 不支持联合类型注解只能在部署机跑,非本次引入。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-09-17 11:48:17 +08:00
选股计划排序轴换成公司质地,传导降为雷达门与带内次级键(台账 063) 按 docs/选股计划调整方案_2026-09-17.md 落地。三份读数(09-02 §1.8、08-28 周报、09-11 抽查)一致:传导越强超额越负,传导分的公式奖励的正是被证明为负的"未动补涨"。所以把传导从排序主轴换成雷达门加带内次级键,公司质地成为排序主轴。改动全在计划装配层,四个开关全设旧值即逐字回旧。 一、排序轴换质地(plan.py)。新增 _rerank_by_axis 按(质地带、被指向、组内分、原始分、代码)词典序重排、_rerank 按 config.PLAN_RANK_AXIS 分派;组内分从原始分反解、档位不进次序;被指向以候选卡门槛一 gates.pointed 为准。调用点先用 _rerank_by_quality 算旧序拿 rank_old 再算新序。_pick 与 pick_rows 加 uncapped_no_theme:质地轴下无传导行免主题限额、不计数,否则主轴被限额推翻。_row 加 quality_band、rank_axis、pointed、rank_old 四键,score/score_adj/tier 值与含义不变。返回字典质地轴下加 rank_axis、rank_rule、quality_band_counts。encoding 追加一句。 二、候选卡内序与质地门(card.py)。新增 quality_band 函数(好三中二差零,无评析与证据不足与超期一百二十天归一),plan.py 与 card.py 共用它。judge 加 stale_days 参数、返回加 quality_band;质地门"差降关注"改用质地带为零并带上一百二十天守卫(超期报告不再降档)。sort_key 在判决与涨幅之间插入质地带、受 CARD_SORT_BY_QUALITY 控,关掉逐字回旧。三门槛一确认三风险一字未动。 三、入池与评析名单(pool.py、review_targets.py)。pool 把选行抽成纯函数 select_plan_rows:rank 源取主榜新序里被指向的前 POOL_TOP、_pool_source 记 rank_top,备用开关 POOL_RANK_KEEP_OLD 并进旧序强传导前若干、去重、受 POOL_MAX 兜底;tier 与 candidate 逐字保留。strategy_context_entry 加 quality_band、rank_axis、rank_old 三键。review_targets 新增纯函数 pick_main_targets:both 取原始分前一百与新序前五十的并集、去重按新序,score 逐字回旧;评析覆盖与排序轴解耦。 四、周报对照(plan_review.py)。第一节加主榜新序前二十与旧序前二十两份名单(rank_old 缺的旧快照跳过);档位分组外加档位乘质地带交叉分组,看传导在质地档内还剩多少信息量。plan_reconcile 应答加 rank_axis: transmission 一键,说明逐票对账的"主榜第 N 名"仍按原始分序,文案不动。 五、单测、开关、文档。新 test_plan_rank_axis.py 十例(含四开关设旧值逐字回旧、四带序、带内次级键、确定性、超期守卫、入池 rank、评析并集、卡内序、主题限额例外、备用开关),本地 ALL OK。test_plan_quality_rank.py 接线匹配串改成新调用点,test_plan_snapshot.py 加一条质地轴主题限额对照用例。config 加 PLAN_RANK_AXIS、CARD_SORT_BY_QUALITY、REVIEW_TARGETS_AXIS 三个开关与备用开关 POOL_RANK_KEEP_OLD,POOL_SOURCE 默认改 rank。.env.example、README 计划字段、台账 063、入池对接说明、下游对接说明一并改。 没有改的是什么、为什么不合并。分数编码 factors.py 一字未动——它注册在外部平台当因子,改它会污染平台的因子历史;次序改动全部放在装配层。api.py 不碰。三门槛一确认三风险不动,质地门保持"差降关注"。持仓管理系统按上游名次排是协同项,在另一仓库单独审批,不阻塞本次上线(它的看多分桶已把好公司排在前面)。 实测读数。开发机 python3 test_plan_rank_axis.py 与 python3 test_plan_quality_rank.py 均 ALL OK;PLAN_RANK_AXIS=transmission CARD_SORT_BY_QUALITY=0 POOL_SOURCE=tier REVIEW_TARGETS_AXIS=score 下 test_plan_rank_axis.py 仍 ALL OK(逐字回旧那一例断言与 09-14 旧序逐字相同)。test_card、test_pool_logic、test_plan_snapshot 全绿。既有的 test_review_targets、test_plan_review_window、test_plan_logic_state、test_plan_cache、test_plan_reviews_live 因缺 psycopg/fastapi 或本机 Python 3.9 不支持联合类型注解而只能在部署机跑,非本次引入。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-09-17 10:28:23 +08:00
def main():
for fn in (test_1_replay_transmission, test_2_bands_order, test_3_within_band,
test_4_deterministic, test_5_stale_demotes, test_6_pool_rank_source,
test_7_review_targets_union, test_8_card_sort_toggle, test_9_theme_cap_exemption,
选股计划修复小包:截取规则收一处、encoding 两轴都对、交接补记、周报改读快照(工作包甲与丙) 承接 docs/评审记录_2026-09-17.md 的三处必改与周报底本拍板,规格在 docs/上线与协同阶段工作方案与规格书_2026-09-17.md 工作包甲与丙。一个提交,09-18 复审。工作包乙(持仓管理系统按上游名次排)在另一仓库、另批,不在本提交。 工作包甲(修复三处必改)。 一、主题限额的截取规则收成一处。新增模块级纯函数 take_by_theme,装配路 collect 里的 _pick 与快照路模块级 pick_rows 都调它,只是各自用一个 theme_of 告诉它怎么从一条记录取主题。装配路的 _theme_of 与 _row 写 evidence 的取法同源:传导视图有证据行取它,否则已启动成员用已动成员视图补的主题;快照路取行上的 evidence.theme。这样已启动成员在两条路上都算进所在主题、受限额,同一天早上落盘的主榜前二十与接口读快照给持仓管理系统的前二十是同一份。这一步同时改正了旧轴下两条路对已启动成员计数的既有分歧,改的只是 md 与 main_shown 这条路,接口路原样不动。逐字回旧那一例不受影响。 二、encoding 句改成两轴都对。原来无条件追加"名次按质地带优先",旧轴下与实际次序相反、持仓管理系统会原样展示。改成"名次按开关 PLAN_RANK_AXIS:quality 时质地带优先、传导只在带内作次级键,transmission 时按 09-14 的质地调整分序"。 三、交接文档补一段。docs/交接_2026-09-10.md 末尾加"十一、2026-09-17 补记":改了什么、下游看到什么(四个新键、名次含义、逐票对账仍按原始分序、持仓管理系统前缀效应)、怎么回退(四个开关)、读数在哪;台账那一行从"最新到第 057 条"改成 063。四仓库同步。 工作包丙(周报改读当日快照,2026-09-17 已拍板)。周报对每个计划日先读当天落盘的 JSON 快照的全量主榜、观察档、候选单、关注单,读不出才回落现算。新增 plan_review._plan_for_review 与 _read_review_snapshot,开关 config.PLAN_REVIEW_SOURCE 默认 snapshot、设 live 回旧做法,每天的逐日注记里写明底本是快照还是现算。为什么:现算用的是跑周报那一刻的评析报告、查询不按日期截断,质地成主轴后会把晚到的报告回头算进当天名单;四周复核比的是当天真出过的两份名单,快照才是当天那份。 单测。test_plan_rank_axis.py 加两例:已启动成员在装配路与快照路都算进所在主题、theme_cap=5 下各只放五条(案 11);无主题行质地轴免限额放六条、旧轴归无传导桶限额五条(案 12)。新 test_plan_review_source.py:合成一份快照,验有快照读快照、无快照回落现算、开关 live 回旧,不连库。 没有改的是什么。工作包乙在持仓管理系统仓库、单独审批,不在本提交。factors.py 分数编码与 api.py 一字未动。四个开关全设旧值仍逐字回旧。 实测读数。开发机三件均 ALL OK:test_plan_rank_axis.py(十二例,含逐字回旧那例)、test_plan_snapshot.py、test_plan_quality_rank.py;四开关设旧值再跑 test_plan_rank_axis.py 仍 ALL OK;新 test_plan_review_source.py ALL OK。既有的 test_review_targets、test_plan_review_window、test_plan_logic_state、test_plan_cache、test_plan_reviews_live 因缺 psycopg/fastapi 或本机 Python 3.9 不支持联合类型注解只能在部署机跑,非本次引入。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-09-17 11:48:17 +08:00
test_10_pool_keep_old, test_11_started_member_counts_theme, test_12_no_theme_by_axis):
选股计划排序轴换成公司质地,传导降为雷达门与带内次级键(台账 063) 按 docs/选股计划调整方案_2026-09-17.md 落地。三份读数(09-02 §1.8、08-28 周报、09-11 抽查)一致:传导越强超额越负,传导分的公式奖励的正是被证明为负的"未动补涨"。所以把传导从排序主轴换成雷达门加带内次级键,公司质地成为排序主轴。改动全在计划装配层,四个开关全设旧值即逐字回旧。 一、排序轴换质地(plan.py)。新增 _rerank_by_axis 按(质地带、被指向、组内分、原始分、代码)词典序重排、_rerank 按 config.PLAN_RANK_AXIS 分派;组内分从原始分反解、档位不进次序;被指向以候选卡门槛一 gates.pointed 为准。调用点先用 _rerank_by_quality 算旧序拿 rank_old 再算新序。_pick 与 pick_rows 加 uncapped_no_theme:质地轴下无传导行免主题限额、不计数,否则主轴被限额推翻。_row 加 quality_band、rank_axis、pointed、rank_old 四键,score/score_adj/tier 值与含义不变。返回字典质地轴下加 rank_axis、rank_rule、quality_band_counts。encoding 追加一句。 二、候选卡内序与质地门(card.py)。新增 quality_band 函数(好三中二差零,无评析与证据不足与超期一百二十天归一),plan.py 与 card.py 共用它。judge 加 stale_days 参数、返回加 quality_band;质地门"差降关注"改用质地带为零并带上一百二十天守卫(超期报告不再降档)。sort_key 在判决与涨幅之间插入质地带、受 CARD_SORT_BY_QUALITY 控,关掉逐字回旧。三门槛一确认三风险一字未动。 三、入池与评析名单(pool.py、review_targets.py)。pool 把选行抽成纯函数 select_plan_rows:rank 源取主榜新序里被指向的前 POOL_TOP、_pool_source 记 rank_top,备用开关 POOL_RANK_KEEP_OLD 并进旧序强传导前若干、去重、受 POOL_MAX 兜底;tier 与 candidate 逐字保留。strategy_context_entry 加 quality_band、rank_axis、rank_old 三键。review_targets 新增纯函数 pick_main_targets:both 取原始分前一百与新序前五十的并集、去重按新序,score 逐字回旧;评析覆盖与排序轴解耦。 四、周报对照(plan_review.py)。第一节加主榜新序前二十与旧序前二十两份名单(rank_old 缺的旧快照跳过);档位分组外加档位乘质地带交叉分组,看传导在质地档内还剩多少信息量。plan_reconcile 应答加 rank_axis: transmission 一键,说明逐票对账的"主榜第 N 名"仍按原始分序,文案不动。 五、单测、开关、文档。新 test_plan_rank_axis.py 十例(含四开关设旧值逐字回旧、四带序、带内次级键、确定性、超期守卫、入池 rank、评析并集、卡内序、主题限额例外、备用开关),本地 ALL OK。test_plan_quality_rank.py 接线匹配串改成新调用点,test_plan_snapshot.py 加一条质地轴主题限额对照用例。config 加 PLAN_RANK_AXIS、CARD_SORT_BY_QUALITY、REVIEW_TARGETS_AXIS 三个开关与备用开关 POOL_RANK_KEEP_OLD,POOL_SOURCE 默认改 rank。.env.example、README 计划字段、台账 063、入池对接说明、下游对接说明一并改。 没有改的是什么、为什么不合并。分数编码 factors.py 一字未动——它注册在外部平台当因子,改它会污染平台的因子历史;次序改动全部放在装配层。api.py 不碰。三门槛一确认三风险不动,质地门保持"差降关注"。持仓管理系统按上游名次排是协同项,在另一仓库单独审批,不阻塞本次上线(它的看多分桶已把好公司排在前面)。 实测读数。开发机 python3 test_plan_rank_axis.py 与 python3 test_plan_quality_rank.py 均 ALL OK;PLAN_RANK_AXIS=transmission CARD_SORT_BY_QUALITY=0 POOL_SOURCE=tier REVIEW_TARGETS_AXIS=score 下 test_plan_rank_axis.py 仍 ALL OK(逐字回旧那一例断言与 09-14 旧序逐字相同)。test_card、test_pool_logic、test_plan_snapshot 全绿。既有的 test_review_targets、test_plan_review_window、test_plan_logic_state、test_plan_cache、test_plan_reviews_live 因缺 psycopg/fastapi 或本机 Python 3.9 不支持联合类型注解而只能在部署机跑,非本次引入。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-09-17 10:28:23 +08:00
fn()
print("-" * 70)
if FAILED:
print("FAILED %d: %s" % (len(FAILED), "; ".join(FAILED)))
return 1
print("ALL OK — 排序轴换质地:逐字回旧 / 四带序 / 带内次级键 / 确定性 / 超期守卫 / "
"入池 rank / 评析并集 / 卡内序 / 主题限额例外 / 备用开关")
return 0
if __name__ == "__main__":
sys.exit(main())