From 15d18a76e2cd28a424f84325bb3cb1240adf4792 Mon Sep 17 00:00:00 2001
From: zlt <zlt@zlt.com>
Date: Thu, 17 Sep 2026 11:24:02 +0800
Subject: [PATCH] =?UTF-8?q?=E6=96=B9=E6=A1=88=E5=89=AF=E6=9C=AC=E5=90=8C?=
 =?UTF-8?q?=E6=AD=A5=EF=BC=9A=E5=A4=8D=E5=AE=A1=E8=AE=B0=E5=BD=95=E4=B8=8E?=
 =?UTF-8?q?=E4=B8=8A=E7=BA=BF=E5=8D=8F=E5=90=8C=E9=98=B6=E6=AE=B5=E5=B7=A5?=
 =?UTF-8?q?=E4=BD=9C=E6=96=B9=E6=A1=88=EF=BC=882026-09-17=EF=BC=89?=
 =?UTF-8?q?=EF=BC=8C=E9=80=89=E8=82=A1=E8=AE=A1=E5=88=92=E8=B0=83=E6=95=B4?=
 =?UTF-8?q?=E6=96=B9=E6=A1=88=E4=BA=94=E5=A4=84=E6=96=87=E5=AD=97=E4=BF=AE?=
 =?UTF-8?q?=E8=AE=A2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
---
 ...Šçº¿ä¸Žå��å�Œé˜¶æ®µå·¥ä½œæ–¹æ¡ˆä¸Žè§„格书_2026-09-17.md | 265 ++++++++++++++++++
 docs/评审记录_2026-09-17.md                   | 111 ++++++++
 docs/选股计划调整方案_2026-09-17.md           |  10 +-
 3 files changed, 381 insertions(+), 5 deletions(-)
 create mode 100644 docs/上线与��阶段工作方案与规格书_2026-09-17.md
 create mode 100644 docs/评审记录_2026-09-17.md

diff --git a/docs/上线与��阶段工作方案与规格书_2026-09-17.md b/docs/上线与��阶段工作方案与规格书_2026-09-17.md
new file mode 100644
index 0000000..0c6536f
--- /dev/null
+++ b/docs/上线与��阶段工作方案与规格书_2026-09-17.md
@@ -0,0 +1,265 @@
+# 上线与��阶段工作方案与规格书（2026-09-17）：修��包��仓管�系统���周报底本
+
+> 2026-09-17 下�写，供��与开�。承接两份规格书：《选股计划调整方案与规格书_2026-09-17》（排�轴�质地，代�已交付，�审� `docs/评审记录_2026-09-17.md`）与《部署与判收阶段方案与规格书_2026-09-16》（数�基座 09-18�09-22�09-29 三个部署日，原样�动）。
+> 开�者�以是人，也�以是大模型。写法�守 `.claude/output-styles/readable-chinese.md`。第一到第�一节是正文，附录是实现细节，标了「��读�，但开�者动手�必须读对应工作包的附录。
+> 基线：选股系统仓库 `main` 4d7ca55（�本方案推�），选股系统机器�在 3d3f317，等 09-21 拉。数�基座 `master` 79abcf2�开�分支 `nextphase-2026-09` 末尾为本方案副本�交，基座机�在 3f45294，等 09-18 拉。�仓管�系统仓库 `main` �在 a78e737 之�的文档�交，机器上的代�未动。
+> 本文件是四个仓库�字�步的副本之一，改一份��步其余。
+
+---
+
+## 一�这一阶段为最终目标买什么
+
+排�轴�质地的代�已�写完并�审。这一阶段�把它干净地上线，并让下游真正�到这个�。买三样东西。
+
+1. **09-22 的第一份质地�计划，两�路给出�一份。** �审查出装�路与快照路对"已�动�员"的主题��判定�一致，�一天 md 与接��能给出��的�二�。修��包把截�规则收�一处实现，�上线。
+2. **�仓管�系统的候选�与选股系统�一个�。** 今天它拿到三百��缀�自己按"基本�立场桶�原始分"�排，两边是两套质地��排�的。��项让它在上游是质地轴时按上游�次排�关掉自己的分桶，选股系统�入池��仓管�系统三处��。这� 09-17 的规格书里标为"�批"，本方案就是那次审批的规格。
+3. **09-25 起的周报读的是当天真正出过的计划。** 周报现在把�个计划日�新装�一�，用的是跑周报那一刻的评�报告。四周�核比的是两份���更好，两份都应该是当天�盘的那份。这一����。
+
+---
+
+## 二�原则
+
+沿用五�：加�改；开关关掉�字回旧；�日�跑结果一致；��回测�因����IC；评价�用候选��盘周报。本阶段�守两�。
+
+1. 一处规则一处实现。两�路��一个结果，就让两�路调�一个函数，�在两处�写一����测钉。
+2. 下游按上游的�，��自�明�。上游给了�次与主轴�，下游读它，��排。
+
+---
+
+## 三��哪几件事
+
+三个工作包。甲在选股系统仓库，乙在�仓管�系统仓库外加选股系统的一处�改，丙在选股系统仓库����。
+
+### 工作包甲：修��包（选股系统仓库，必�）
+
+对应评审记录第四节的三处必改，一个�交，09-18 �审�推�，09-21 拉。
+
+1. **主题��的截�规则收�一处。** 新建一个模�级纯函数�"按主题��截�"，`collect` 里的 `_pick` 与模�级的 `pick_rows` 都调它，�是�自告诉它怎么从一�记录�主题。主题的�法与 `_row` 写 `evidence` 的�法��，�已动�员视图的补充。这样已�动�员在两�路上都算进所在主题����；没有主题的行在质地轴下�����计数。为什么这样改：�是给装�路加一个"已�动�员也算主题"的特判，而是让两�路根本没有第二份规则。
+2. **`encoding` ��在质地轴下追加。** 旧轴下这��与实际次�相�，�仓管�系统会把它原样展示给人看。
+3. **交接文档补一段。** 在 `docs/交接_2026-09-10.md` 末尾加一节带日期的补记，�账那一行改� 063，四仓库�步。
+4. **�测。** `test_plan_rank_axis.py` 加两例：已�动�员在两�路上都算进所在主题；无主题行在质地轴下����在旧轴下归"无传导"桶计数。`test_plan_snapshot.py` 里"拿真实快照�行比对"那一例�动，它在部署机上是这件事的最终读数。
+
+细节�附录甲。
+
+### 工作包乙：�仓管�系统按上游�次排（�仓管�系统仓库，�加选股系统一处�改）
+
+**�什么。** �仓管�系统�候选时，上游计划带 `rank_axis` 为 quality 就按上游�次��排，��按立场桶与原始分�排；上游没带这个键（旧计划�或选股系统回退）就走现在的路。一个开关，默认开，�上游的键自门控，所以 09-22 之�它什么都�改。
+
+**为什么。** 入池已�改�"新�里被指�的�五�"，选股系统的候选�已�是质地�。�仓管�系统若�按自己的立场桶排，三处里就它一处是�一个�，四周�核时说�清它拿到的�三�为什么与选股系统的�三��一样。它的立场桶本�就是在没有上游质地�时的替代�，上游有了，替代�退场。
+
+**六件事。**
+
+1. 计划应答归一时把�行新加的四个键与顶层的 `rank_axis`�`rank_rule` 带进�，缺就是空。
+2. 候选选择函数加一个�数"按上游�次排"，�在计划的 `rank_axis` 为 quality 时生效，生效时排�键是上游�次�����次按原始分��，立场桶���与。返回里加一键写明本次用的是哪��。
+3. �数表加 `PMS_PLAN_RANK_BY_UPSTREAM`，默认开，说明文字写清自门控。
+4. �册快照的元数�里写一键 `rank_mode`，让选股系统的周报能还原当天交付��的�。
+5. 选股系统 `plan_review.pms_roster` 读到元数�里 `rank_mode` 为 upstream 时按�册里的�次���� N，�则按原始分���� N（今天的写法）。这一处�改放在选股系统仓库，�工作包丙或�独一个�交。
+6. �测��账�对接说明。既有的 `scripts/test_batch29_units.py` 里已有按质地分桶的三例，�边加三例。�账一�，编� 016。�仓管�系统的对接说明加一段"�缀效应"，与选股系统下游对接说明那段�义。
+
+**上线。** �仓管�系统在选股系统机器上，��挂载进容器，改代�����进程，���用户���收盘��。放在 09-23 收盘�，��是 09-22 的六处读数干净。�与 09-21 的选股系统拉代��一天，��两处�时�化说�清。
+
+细节�附录乙。
+
+### 工作包丙：周报改读当日快照（选股系统仓库，��点一）
+
+**�什么。** 周报对�个计划日先找当天的 JSON 快照，读它的全�主榜与观察档行�候选��关注�；快照�存在或读�出�回�到现在的�新装�。加开关 `PLAN_REVIEW_SOURCE`，默认 snapshot，设 live 回今天的�法。周报第一节注记�天用的是哪�底本。
+
+**为什么。** �新装�用的是跑周报那一刻的评�报告，评�查询���票最新一次�行��按日期截断，所以 09-22 的��在 09-25 算会用上 09-24 的报告。四周�核比的是当天真正出过的两份��。快照�盘时的注释写�"它是�盘与对账的唯一底本"，周报应该读它。
+
+**它改�什么。** 从 09-02 有快照那天起的所有周报��都改按快照�数，与之�周报的�径��。09-25 之��会有人比对旧�径，所以现在切最�事。旧�径�开关�时能回。
+
+细节�附录丙。
+
+### 已排定�本方案�改的事
+
+数�基座三个部署日按《部署与判收阶段方案与规格书_2026-09-16》附录甲�乙�丙执行，09-28 建议级�包�审（��点�一）与 09-30 判收读数��。选股系统 09-21 拉代�与接�容器��按《选股计划调整方案_2026-09-17》第四节执行。
+
+---
+
+## 四�日程
+
+北京时间。�天�写这一阶段新增或改动的事，数�基座的部署日�列�字。
+
+| 日期 | 星期 | �什么 |
+|---|---|---|
+| 09-17 | 三 | �审完�。开�者�工作包甲，一个�交；��点一通过则工作包丙并进�一个�交 |
+| 09-18 | 四 | 上�我�审工作包甲（�丙），通过�推�。收盘�数�基座 09-18 部署窗（附录甲，原样）。开�者开始工作包乙 |
+| 09-19 | 六 | 工作包乙交付，�选股系统那一处�改。我�审 |
+| 09-21 | 一 | 收盘�选股系统机器拉代�，接�容器��并预热，�审批，�开七点到七点�与八点�到�点零五 |
+| 09-22 | 二 | 07:15 �核首份质地�计划的六处读数，�核"两�路�一份�二�"。收盘�数�基座第二批（附录乙） |
+| 09-23 | 三 | 09-22 读数干净，则收盘����仓管�系统进程上线工作包乙，�审批 |
+| 09-24 | 四 | 08:45 �核�仓管�系统的候选�等于上游�次� |
+| 09-25 | 五 | 首份带两份对照��的周报，底本按��点一 |
+| 09-28 | 一 | 数�基座建议级�包�审（若�） |
+| 09-29 | 二 | 数�基座第三批与�端�建（附录丙） |
+| 09-30 | 三 | 数�基座判收读数 |
+| 10-16 �� | | 排�轴四周�核，按《选股计划调整方案》工作包四第四�决定�留或切回 |
+| 长��第一周 | | 总评审 |
+
+---
+
+## 五�开关与�数
+
+新增三个，其余沿用两份规格书。
+
+| 键 | 仓库 | 默认 | 说明 |
+|---|---|---|---|
+| `PLAN_REVIEW_SOURCE` | 选股系统 | snapshot | 周报底本。live 回"�日�新装�"。��点一 |
+| `PMS_PLAN_RANK_BY_UPSTREAM` | �仓管�系统 | 开 | 上游计划 `rank_axis` 为 quality 时按上游�次排�关掉立场桶；上游没带这个键时无作用 |
+| �册元数� `rank_mode` | �仓管�系统写�选股系统读 | 无 | upstream 或 quality_bucket 或 score，周报�此还原交付��的� |
+
+选股系统机器的 `.env` ��需�加任何键。�仓管�系统的�数走它自己的�数表，页��改。
+
+---
+
+## 六�验�方�
+
+��命令标明在哪�机器上�行。选股系统机器与�仓管�系统在�一�：`ssh -p 2280 factor@192.168.16.155`，两个仓库分别在 `~/project/akg-factor-bridge` 与 `~/project/tradingSystem`。
+
+**本地（选股系统仓库，工作包甲交付�）。** 预期三行都是 ALL OK。
+
+```bash
+cd /Users/baobao/Documents/work/project/akg-factor-bridge && python3 test_plan_rank_axis.py 2>&1 | tail -1 && python3 test_plan_snapshot.py 2>&1 | tail -1 && python3 test_plan_quality_rank.py 2>&1 | tail -1
+```
+
+**本地（选股系统仓库）。** �字回旧。预期末行 ALL OK。
+
+```bash
+cd /Users/baobao/Documents/work/project/akg-factor-bridge && PLAN_RANK_AXIS=transmission CARD_SORT_BY_QUALITY=0 POOL_SOURCE=tier REVIEW_TARGETS_AXIS=score python3 test_plan_rank_axis.py 2>&1 | tail -1
+```
+
+**本地（�仓管�系统仓库，工作包乙交付�）。** 预期末行 ALL SUITES PASS，例数�增��。
+
+```bash
+cd /Users/baobao/Documents/work/project/tradingSystem && python3 scripts/run_tests.py 2>&1 | tail -3
+```
+
+**选股系统机器（09-22 早上 07:15 �）。** 两�路�一份�二�。这�读数是必改一的最终判收。预期打出快照文件�与 True。
+
+```bash
+cd ~/project/akg-factor-bridge && docker exec akg_factor_bridge python3 -c "import json,glob,plan; p=sorted(glob.glob('data/plan/plan_*.json'))[-1]; s=json.load(open(p)); sp=s['shown_params']; got=[r['code'] for r in plan.pick_rows(s['main'], sp['top'], sp['theme_cap'])]; print(p, got==[r['code'] for r in s['main_shown']])"
+```
+
+**选股系统机器（09-22）。** 首份质地�计划的六处读数，命令与预期照《选股计划调整方案_2026-09-17》第六节，��抄一�。
+
+**选股系统机器（09-24 早上 08:45 �）。** �仓管�系统的候选�等于上游�次�。读它当天的�册快照与元数�。预期 `rank_mode` 为 upstream，打出的�次�列严格递增。
+
+```bash
+cd ~/project/akg-factor-bridge && docker exec akg_factor_bridge python3 -c "
+import json, db
+df = db.read_mysql('pms', 'SELECT roster_json, meta_json FROM pms_plan_snapshot ORDER BY id DESC LIMIT 1')
+meta = json.loads(df.iloc[0]['meta_json'] or '{}'); roster = json.loads(df.iloc[0]['roster_json'] or '[]')
+print('rank_mode =', meta.get('rank_mode'))
+rows = [r for r in roster if str(r.get('b') or 'main') == 'main']
+print('�册��的�次：', [r.get('r') for r in rows[:10]])" 2>&1 | grep -v Warning
+```
+
+**选股系统机器（09-25 周报�）。** 周报底本。预期第一节�天的注记写"底本：快照"，两份对照��都在。
+
+```bash
+cd ~/project/akg-factor-bridge && grep -n "底本\|新��二�\|旧��二�" $(ls -t data/review/�盘_*_next_close.md | head -1) | head -12
+```
+
+---
+
+## 七�回退
+
+- 工作包甲没有开关，它修的是规则�一致，�需�回退路径。真�回到 4d7ca55 的行为�能回代�，但那个行为本身是错的。
+- 工作包乙把 `PMS_PLAN_RANK_BY_UPSTREAM` 关掉�回今天的�法，�用��，�数表页��改。
+- 工作包丙把 `PLAN_REVIEW_SOURCE` 设 live �回今天的�法。
+- 排�轴整体回退�按《选股计划调整方案》第七节四个开关设旧值。�仓管�系统那边因为自门控，上游一回退它自动回旧，�用动。
+
+---
+
+## 八���点
+
+代定的写"建议"，动工���问。�改就改这里。
+
+1. **周报底本改读快照（工作包丙）。** 建议�，�工作包甲�一个�交，默认读快照，开关�回。�由在第三节。��的�，四周�核读到的是"以�核当天的评�回头算的��"，�在周报里写明。
+2. **�仓管�系统��项的默认值与上线日。** 建议默认开��上游的 `rank_axis` 自门控，09-23 收盘�上线。�与 09-21 �一天。
+3. **�交 4d7ca55 �本方案推�。** 代定。修��包在它上���一个。
+4. **两份对照��的�径。** 代定：两份都是全���二�，�设主题��，与周报其余����径。它比的是排�规则，�是当天交付的那二��；交付���有"候选�"与"强传导交付��"两行。
+5. **工作包乙里选股系统那一处�改（`pms_roster` 按 `rank_mode` ��）** 代定�工作包丙�一个�交，若丙��则�独一个�交。
+
+---
+
+## ��交付�求
+
+1. �个工作包一个�交，全中文�无�缀，格�"主题：改了什么"，��账的带�账�。正文写清改了哪些函数�没改什么�为什么��并。
+2. 先写�测�改代�，尤其是工作包甲那两例。
+3. 工作包甲交付��：�交��三个测试文件末行��字回旧那一例的�字�`git show --stat`。
+4. 工作包乙交付��：�交��`run_tests.py` 末三行与例数对比�三例新�测的�字��账 016 原文�选股系统那一处�改的�交�。
+5. 工作包丙交付��：�交��开关��本地用一份��快照跑通周报�数的�测末行。
+6. �加键�删键，既有键的值与�义��。
+
+---
+
+## ��评审方�
+
+评审者�看��。工作包甲核三件事：截�规则是�是�剩一处实现�两�路的主题�法是����旧轴下无主题行是��归"无传导"桶计数。工作包乙核四件事：自门控是��看计划顶层的 `rank_axis`�立场桶在上游�下是�完全��与�旧计划下是��字回旧��册元数�是�写了 `rank_mode`。工作包丙核两件事：无快照日是�回��开关设 live 是��字回今天。判定三档��。评审记录写 `docs/评审记录_<日期>.md`。
+
+## �一�风险与预判
+
+1. 09-22 早上"两�路�一份�二�"那�读数若是 False，说明工作包甲没修干净，当天接�以快照路为准，�仓管�系统拿到的�是自洽的一份，�影�交易，但�当天修。
+2. �仓管�系统切到上游��，页�上"候选榜第 N �"与它的候选�第一次一致，人看到的�次会跳一次，属预期。
+3. 周报改读快照�，09-18 与 09-21 两个旧�日的"主榜新��二�"其实是旧��二�，注记写明。
+4. 工作包乙上线那天若�仓管�系统进程��失败，回退是���，代�在挂载目录里但进程还是旧的，行为��。
+5. �册元数�的 `rank_mode` �从工作包乙上线那天起有，之�的�册周报�按原始分还原，注记写明"历� N 与���还原"那�已有。
+
+---
+
+## 附录甲（��读）：工作包甲实现
+
+行�按选股系统仓库 `main` 4d7ca55。
+
+**截�函数。** 在 `plan.py` 模�级新增：
+
+```python
+def take_by_theme(items, n, theme_cap, theme_of, uncapped_no_theme):
+    """按主题��截�。items �迭代；theme_of(item) 回主题字符串，无主题回 None。
+    有主题的�主题最多 theme_cap �（0 �设�）。无主题的：uncapped_no_theme 为真时
+    �����计数；为�时归"（无传导）"一个桶计数（旧轴原样）。�够 n ���。"""
+```
+
+- `collect` 里的 `_pick`（约 523 到 541 行）改�一行调用：`take_by_theme(ranked.items(), n, theme_cap, lambda kv: _theme_of(kv[0]), uncapped_no_theme)`。
+- `_theme_of(k)` 是 `collect` 内的�函数，与 `_row`（约 546 到 552 行）写 `evidence` 的�法��：传导视图有��行� `e[0]`；没有��行�且候选�的 `started_source` 为 moved_view 且带 `theme`，� `c["theme"]`；�则 None。最好把 `_row` 里那几行也改�先调 `_theme_of` �拼字典，让两处�有一份�法。
+- `pick_rows`（约 1014 到 1037 行）改�调用�一个函数：`theme_of` � `((r.get("evidence") or {}).get("theme")) or None`，`uncapped_no_theme` 的缺�推断��。
+- `encoding`（约 712 行）：把追加那��挪到 `axis == "quality"` 的分支里，或改�"�次按 PLAN_RANK_AXIS：quality 时质地带优先，传导�在带内作次级键；transmission 时按 09-14 的调整分�"这样两�都对的写法。
+- 交接段骨架：标题"�一�2026-09-17 补记：排�主轴��公�质地"；四段：改了什么（一�）�下游看到什么（四个新键��次�义��票对账接��是原始分�）�怎么回退（四个开关）�读数在哪（评�目标��表�周报两份��）。�账那一行改�"最新到第 063 �"。
+
+**�测（`test_plan_rank_axis.py` 加两例）。**
+
+11. 已�动�员算进所在主题：六�记录�主题"锂电"，其中第六�通过 `theme_of` �到主题的路�是候选�的 moved_view 补充；`take_by_theme` 在 `theme_cap=5` 下�放五�；�用�样六�构造�带 `evidence.theme` 的行喂 `pick_rows`，也�放五�。
+12. 无主题行两轴�归�：六�无主题记录，`uncapped_no_theme` 为真放六�，为�放五�（归"无传导"桶）。
+
+既有 `test_plan_snapshot.py` 第 50 到 58 行两例��通过。
+
+## 附录乙（��读）：工作包乙实现
+
+行�按�仓管�系统仓库 `main` 当�代�，文件 `app/services/plan_feed.py`。
+
+- `_rows`（约 279 到 330 行）加四键：`"quality_band": _int_or_none(it.get("quality_band"))`�`"pointed"`（值�空时转布尔，�则 None）�`"rank_axis": _text_or_none(it.get("rank_axis"))`�`"rank_old": _int_or_none(it.get("rank_old"))`。
+- `parse_plan`（约 339 到 395 行）返回字典加两键：`"rank_axis": _text_or_none(payload.get("rank_axis"))`�`"rank_rule": _text_or_none(payload.get("rank_rule"))`。
+- `select_candidates`（约 440 行起）签�加 `rank_by_upstream: bool = False`。生效�件 `upstream = bool(rank_by_upstream) and plan.get("rank_axis") == "quality"`。生效时排�键为 `(x.get("rank") or 10 ** 9, -(x.get("score") or 0.0))`，`rank_by_quality` ���与；�生效时两个既有分支�字�动。返回字典加 `"rank_mode"`：upstream�quality_bucket�score 三选一。`items` �项加 `quality_band`�`pointed`�`rank_axis`�`rank_old` 四键原样�传。
+- �数�（约 620 到 636 行）加 `"rank_by_upstream": ps.get_bool("PMS_PLAN_RANK_BY_UPSTREAM", True)`；调用点（约 1086 到 1094 行）传入。`app/services/param_store.py` 约 119 行�加登记：`"PMS_PLAN_RANK_BY_UPSTREAM": (True, bool, "上游计划带 rank_axis=quality 时按上游�次排�关掉立场分桶；上游没带时无作用（关掉�回按分桶排）")`。
+- �册快照元数�：`app/repo/pms_repo.py` 约 839 行的�入语�已有 `meta_json` 列，在 `plan_feed` 里构造元数�的那处加 `"rank_mode"`，值�自本次 `select_candidates` 返回的 `rank_mode`。
+- 选股系统 `plan_review.pms_roster`（`plan_review.py` 约 120 到 140 行）：查询多� `meta_json`；`rank_mode` 为 upstream 时 `rows.sort(key=lambda r: r.get("r") if r.get("r") is not None else 1 << 60)`，�则��按 `s` ��。注记字符串加一�"�按�册元数� rank_mode 还原"。
+- �测：`scripts/test_batch29_units.py` 约 298 到 324 行�加三例：上游 `rank_axis` 为 quality 且开关开时按�次排且立场桶��与；上游没带 `rank_axis` 时开关开也�字回按分桶排；`rank_mode` 三��值�对。若 `run_tests.py` 的文档字符串里写了�批例数，按哨兵改数。
+- �账 016，五段�。对接说明加"�缀效应"一段。
+- 上线（选股系统机器，收盘�，�审批）：`docker compose --profile sched --profile ws restart -t 30`，���用 `docker exec pms-ws date` 看容器时间确认已收盘。
+
+## 附录丙（��读）：工作包丙实现
+
+文件 `plan_review.py`，行�按 4d7ca55。
+
+- `run`（约 374 行）把 `data = plan.collect(day, top=5000, obs_top=5000, theme_cap=0)` 改�先试快照：路径用 `regime.snapshot_path(day)`，读出的字典里 `main` 与 `observe` 就是全�行，`candidates` 与 `watch` 在顶层。把它整��与 `collect` 返回�形的字典（`_full` 里放 `main` 与 `observe`），��的代�一行�改。快照�存在�� JSON�或 `main` �是列表，回�到 `plan.collect`，注记写"底本：现算（无快照）"。
+- 开关 `config.PLAN_REVIEW_SOURCE`，默认 snapshot；设 live 时直接走 `plan.collect`。
+- �天的注记里加"底本：快照"或"底本：现算"，�进第一节。
+- �测：新文件 `test_plan_review_source.py`，��一份最�快照写进临时目录，断言读到的 `_full.main` 与 `candidates` �自快照；删掉文件�断言回�路径被走到（用�的 `plan.collect` 计数）。�连库。
+
+## 附录�（��读）：文件清�
+
+工作包甲：`plan.py`�`test_plan_rank_axis.py`�`docs/交接_2026-09-10.md`（四仓库）。
+工作包乙：�仓管�系统 `app/services/plan_feed.py`�`app/services/param_store.py`��册元数�的构造处�`scripts/test_batch29_units.py`�`scripts/run_tests.py`（仅例数）�`docs/�盘决定�账.md`�对接说明；选股系统 `plan_review.py`。
+工作包丙：`plan_review.py`�`config.py`�`.env.example`�新 `test_plan_review_source.py`。
+清�外一律�动。
diff --git a/docs/评审记录_2026-09-17.md b/docs/评审记录_2026-09-17.md
new file mode 100644
index 0000000..1ba3149
--- /dev/null
+++ b/docs/评审记录_2026-09-17.md
@@ -0,0 +1,111 @@
+# 评审记录（2026-09-17）：选股计划排�轴�质地，�交 4d7ca55
+
+> 评审对象：选股系统仓库 `main` 上的�交 4d7ca55（开�者 2026-09-17 上�交付，交付时未推�）。基线 6138c01。
+> 评审��：`docs/选股计划调整方案_2026-09-17.md` 第�节"评审方�"。评审者�看��。
+> 写法�守 `.claude/output-styles/readable-chinese.md`。本文件是四个仓库�字�步的副本之一。
+
+---
+
+## 一�结论
+
+**有�件通过。** 代�主体与规格书一致，五个测试文件本地全绿，四个开关设旧值时�字回旧�立，分数编�与三门槛一确认三风险都没有动。三处必改，��一个修��交，09-21 拉代�之��完并�审。两�建议级�阻塞。一���项。
+
+三处必改�一��。
+
+1. 装�路与快照路对"已�动�员"的主题��判定�一致。�一天的计划，早上�盘的主榜�二�与接�读快照给出的�二��能�是�一批。
+2. 计划里的 `encoding` 说明�在旧轴下也写"�次按质地带优先"，与旧轴的实际次�相�。
+3. 交接文档一段没写，规格书工作包五第三�没有完�。
+
+修��包的规格写在《上线与��阶段工作方案与规格书_2026-09-17》工作包甲。本记录�写核对结果与�由。
+
+---
+
+## 二�我亲手跑出的��
+
+**本地�测（开�机，选股系统仓库）。** 五个文件末行全部 ALL OK：`test_plan_rank_axis.py`�`test_plan_quality_rank.py`�`test_card.py`�`test_pool_logic.py`�`test_plan_snapshot.py`。四个开关设旧值�跑 `test_plan_rank_axis.py`，� ALL OK。七个改动的模� `py_compile` 通过。开�者说�能在部署机跑的五个测试文件，我本机�样跑�起�，原因与他说的一致：缺 `psycopg` 或 `fastapi`，或本机 Python 3.9 �支���类型注解。这是既有状况，�是本次引入。
+
+一��说明：`test_plan_snapshot.py` 里"拿真实快照�行比对"那一例在本机是**跳过**的，因为本机没有快照文件。它�有在部署机上跑�真正生效。必改一正是它会查出的那件事。
+
+**旧路径等价（开�机）。** 入池的 `tier` 与 `candidate` 两个分支从内�代�抽�了纯函数 `select_plan_rows`。我用�机��的主榜行�了三百轮对照，�轮六�组�（两个��乘三�档�白��），新函数与旧内�逻辑的输出零差异。
+
+**部署机�读读数（选股系统机器，09-16 快照）。** 仓库�在 3d3f317，与规格书基线一致。`.env` 里有 `POOL_TOP=50`�`POOL_MAX=100`�`CARD_REQUIRE_STARTED=0`，没有 `POOL_SOURCE`�`PLAN_RANK_AXIS`�`POOL_THEME_CAP`，所以拉代��默认值直接生效，与规格书第五节说的一致。
+
+09-16 快照主榜全�五百三�二行。质地分布：好�六�中四�八�差一百三�四�无评�三百三�四。我按规格书的�典�在这份快照上模拟了一�质地�，�二�里好�六�中四。�二�里有六行没有传导主题，正好�在"第六�起被��顶掉"的�置，规划代�那��现在真实数�上�立。�二�里"储能"主题五�，正好碰到��边界。
+
+"已�动�员"的行（��由已动�员视图补上的行）全�八行，旧��次八�二�三百五�三�三百���四百��一�五百�五百二��五百二�六�五百三�。旧��二�里没有它们；模拟质地��二�里有一行。这就是必改一在真实数�上的样�。
+
+---
+
+## 三��项核对
+
+按规格书第�节的核对步骤��记。
+
+1. **diff 对照附录己的文件清�。** �五个文件改动，全在清�内。`factors.py` 与 `api.py` 没有出现在 `git show --stat` 里。清�里的"交接文档"没有改，�必改三。
+2. **本地跑测试文件。** �第二节。
+3. **四个开关设旧值时的�字回旧断言是�是真断言。** 是，但覆盖方��说清。第一例�断言 `_rerank` 在旧轴下与 09-14 的 `_rerank_by_quality` �列与分值�字相�，它验的是分派。�外三个开关�有自己的旧路径断言：入池旧路径由我的三百轮对照补上，评���的 `score` 分支是第七例，�内�关掉是第八例，主题��例外关掉是第�例。四��起��是"四开关�字回旧"。
+4. **主题��的例外�在质地轴下生效。** 是。装�时按 `config.PLAN_RANK_AXIS` 传入，快照路按行上的 `rank_axis` 推断。回退那天读旧快照�按质地轴截�，这是对的，因为那份快照的�就是质地�。但两�路对"已�动�员"的判定�一致，�必改一。
+5. **�内��入池�评���三处的次级键与去�。** �内�在判决与涨幅之间�入负的质地带，关掉时元组与旧实现�字相�。入池 `rank` ���被指�的行�按新�截�五�，备用开关并进旧�强传导�五��去��� `POOL_MAX` 兜底。评���两路并集去��按新��次排，`score` 分支按原始分。三处都有确定的末�键。
+6. **`_row` �加键。** 是。加了 `quality_band`�`rank_axis`�`pointed` 三键，质地轴下�加 `rank_old`。`score`�`score_adj`�`tier` 的值与�义没有�。顶层 `encoding` 的值�了，�必改二。
+7. **分数编�。** `factors.py` 一字未动。组内分从原始分�解，档�用整除，与编�一致，我�个区间验过。
+8. **旧��次。** `rank_old` �自全��，�是截断�的�。主榜与观察档两个�列的代����，两张�次表�并�会互相覆盖。
+9. **一百二�天守�。** 守�是活的：评�摘�里的 `age_days` 由数�日�报告�行日算出，�值真实。守�对质地带�质地门��内�三处生效。它**�对**旧轴的加�八分生效，`score_adj` 也��守�。这与规格书第五节表里那一行的写法�一致，但代�是对的，因为规格书交付�求第四��求 `score_adj` 的值��。规格书这一行我已改正，�第五节建议三。
+10. **入池���的验�命令是��立。** �立。入池走 `plan.collect` �五百行的宽池�主题��� `POOL_THEME_CAP`（默认零），�交给纯函数选行；规格书第六节那�命令拿快照全�行喂�一个纯函数，两边看到的是�一个�。
+11. **评�目标��拿到的是全�行。** 是。`persist` 收到的是�盘快照，`main` 是全�新�行，�行带原始分与新��次。
+12. **周报的底本。** 周报�读快照，它用 `plan.collect` 把当日�新装�一���全�行。两份对照��都从这份�算�。这是既有�法，�是本次引入，但它决定了四周�核读到的是什么，�第六节��项。
+
+---
+
+## 四�必改
+
+### 必改一：装�路与快照路对"已�动�员"的主题��判定�一致
+
+**是什么。** 主榜截�有两�路。装�路是 `collect` 里的内部函数 `_pick`，早上出计划时用它截主榜�二�，写进 md 与快照的 `main_shown`。快照路是模�级函数 `pick_rows`，接�读快照时用它按请求�数截�，�仓管�系统�的三百��缀从这里�。两�路本该�一套规则，`test_plan_snapshot.py` 拿真实快照�行比对钉�这件事。
+
+这次的例外判定在两�路上写法��。装�路看的是传导视图有没有这�票的��行：没有��行就当无主题����。快照路看的是行上的 `evidence.theme`：没有主题����。差别出在"已�动�员"上。已�动�员在传导视图里没有��行，但装�时 `_row` 会用已动�员视图的目标环节把 `evidence.theme` 补上（`plan.py` 约 550 行）。于是�一�已�动�员，装�路把它当无主题�����计数，快照路把它算进所在主题����。
+
+**为什么以�没炸。** 旧�下这些行排在八��以�，碰�到�二�的��。旧代�里两�路对它们其实也�一致（装�路把它们归进"无传导"桶计数，快照路归进所在主题），�是�影��二�。质地�把被指�的已�动�员�到了�列，09-16 快照模拟出��二�里有一行，"储能"�正好五�碰到边界，差一�就会让两�路给出��的第二��。
+
+**�果。** �一天，md 与快照里的 `main_shown` 是一份�二�，接�给�仓管�系统的是�一份。规格书第二节"�日�跑结果一致"这�原则在两�路之间失守。部署机上跑 `test_plan_snapshot.py` 会在第一个出事的交易日�红。
+
+**修法。** �在两处�打补�，改�一处实现两处调用：把"按主题��截�"抽�模�级纯函数，装�路与快照路都调它，主题的�法与 `_row` 写 `evidence` 的�法��（�已动�员视图的补充）。这样装�路对已�动�员的判定也��"算进所在主题"，与快照路一致。这一步�时改正了旧轴下的既有分歧，改的�是 md 与 `main_shown` 这�路对已�动�员的计数，接�路（�仓管�系统读的那�）原样�动。�字回旧那一例�测��影�。细节与�测在工作方案附录甲。
+
+### 必改二：`encoding` �在旧轴下写错了
+
+`collect` 返回的 `encoding` 一�无�件追加了"�次按质地带优先，传导�在带内作次级键（开关 PLAN_RANK_AXIS）"。旧轴下�次�按质地带优先，这��与实际相�。�仓管�系统把这�原样收进它的状�页给人看。修法是�在质地轴下追加，或把��改��件�写法。一行改动。
+
+### 必改三：交接文档一段没写
+
+规格书工作包五第三��求交接文档一段并四仓库�步，�交里没有。修法是在最新一份交接文档 `docs/交接_2026-09-10.md` 末尾加一节带日期的补记，把�账那一行从"最新到第 057 �"改� 063，四仓库�步。交接段的骨架在工作方案附录甲。
+
+---
+
+## 五�建议级（�阻塞）
+
+1. **评��� `score` 分支�是�字回旧。** 旧代��快照��一百，快照�是 09-14 的调整分�；新代�按原始分排�一百。差别�在第一百�附近被加�八分挪动的几�。评����管覆盖，这点差别没有�果。�改，记在这里。
+2. **两处�瑕疵。** `_rerank_by_axis` 的 `axis` �数没有用到；`card.sort_key` 在函数体内导入 `config`。都�影�行为。
+3. **规格书两处文字改正。** 第五节表里 `COMPANY_REVIEW_STALE_DAYS` 那一行说守�对加�分也生效，工作包二第二�说"也��加�分"，与代�和交付�求第四�矛盾，按代�改正。附录乙说周报"从快照 `_full` 读主榜行"，实际是现算�� `_full`，按实际改正。这两处我已�改在规格书里，�本记录�步。
+4. **周报里"主榜新��二�"对改动�的日�。** 09-25 周报的窗�� 09-18 与 09-21 两个旧�日，那两天这一行的��其实就是旧��二�，标签会略有误导。旧���那一行对这两天正确地跳过了。周报一段注记��，�改代�。
+
+---
+
+## 六���项：周报的底本
+
+周报用 `plan.collect` 把�个计划日�新装�一�，而�是读当天�盘的快照。�新装�用的是跑周报那一刻的评�报告：查询���票最新一次�行，�按日期截断。于是 09-22 的"新��二�"在 09-25 算出�时，用的是 09-25 手里的质地档。一家 09-24 �有报告的公�，会被回头算进 09-22 的�列。
+
+这在质地是次级项的时候是�事，在质地�为主轴之��是。四周�核比的是"新��二�与旧��二��更好"，两份��都应该是当天真正出过的那份。快照�盘时的注释写�"它是�盘与对账的唯一底本"，周报�没有读它。
+
+我的建议是周报改�先读当日快照的全�行，没有快照的日��回�到�新装�，加一个开关默认读快照。改动�，但它改�周报所有既有��的�数方�，从 09-02 有快照那天起的读数会与旧周报的�径��，所以�用户��。写在工作方案工作包丙与��点一。
+
+---
+
+## 七�答开�者的两个问题
+
+**���现在推�。** �审已��完，�必等 09-19。�交 4d7ca55 我�本记录一起推到远端，修��包在它上���一个。选股系统机器�在 09-21 收盘�由人拉代�，中间远端有一个待修的�交没有风险。
+
+**���现在补交接段。** �，放进修��包，与必改一�必改二�一个�交。
+
+---
+
+## 八�附：文件清�对照
+
+�交改了�五个文件：`plan.py`�`card.py`�`pool.py`�`review_targets.py`�`plan_review.py`�`plan_reconcile.py`�`config.py`�`.env.example`�`README.md`�`docs/�盘决定�账.md`�`docs/选股计划入池_对接说明.md`�`docs/选股说明_下游对接.md`�新 `test_plan_rank_axis.py`�`test_plan_quality_rank.py`�`test_plan_snapshot.py`。附录己清�里�差交接文档。清�外没有文件被动。
diff --git a/docs/选股计划调整方案_2026-09-17.md b/docs/选股计划调整方案_2026-09-17.md
index 8e931bf..723a441 100644
--- a/docs/选股计划调整方案_2026-09-17.md
+++ b/docs/选股计划调整方案_2026-09-17.md
@@ -36,7 +36,7 @@
 沿用五�：加�改；开关关掉�字回旧；�日�跑结果一致；��回测�因����IC；评价�用候选��盘周报。本方案�加三�。
 
 1. 分数编��动。`factors.py` 里"主榜分等于二百加档�乘二�加组内分"的编�注册在外部平�当因�，改它会污染平�的因�历�。次�的改动全部放在计划装�这一层，与 09-14 那次质地�排（�账 058）�一个�点。
-2. 质地�认新鲜的报告。质地进任何判决或排�都��一个新鲜度守�（一百二�天），与逻辑状�第五路和�仓管�系统的基本�立场��径。今天质地门与加�八分�看日龄，是一处�一致，顺手对�。
+2. 质地�认新鲜的报告。质地进任何判决或排�都��一个新鲜度守�（一百二�天），与逻辑状�第五路和�仓管�系统的基本�立场��径。今天质地门与加�八分�看日龄，是一处�一致；质地门顺手对�，旧轴的加�八分��原样（09-17 �审修订，�第五节表）。
 3. 评�覆盖�能被排�轴�死。评�目标��如果��新��一百，新被指�的公�永远排在已评�公���，永远得�到报告。���与排�轴解耦。
 
 ---
@@ -68,7 +68,7 @@
 **�什么。** 三门槛�一确认�三风险一个字�动（生产上门槛二"已�动"本�就关�）。改两处。
 
 1. �内�从"先判决��当日涨幅"改�"先判决��质地带��当日涨幅"。候选�与关注�的�次由此��质地优先。开关 `CARD_SORT_BY_QUALITY`，默认开，关掉回旧�。
-2. 质地门"差�关注"与工作包一的质地带共用�一个判定函数，带上一百二�天守�；超期报告���档，也��加�分。
+2. 质地门"差�关注"与工作包一的质地带共用�一个判定函数，带上一百二�天守�；超期报告���档。旧轴下的加�八分�� 09-14 原样，�加守�（09-17 �审修订，�由�第五节表）。
 
 **为什么�把质地��门槛。** 无评�的公�还能进候选（排在��），是为了�让评�覆盖�到的新公�被系统性排除。质地差已�进�了候选，等价于门槛，�必�改判决逻辑。
 
@@ -101,7 +101,7 @@
 | 日期 | 星期 | �什么 |
 |---|---|---|
 | 09-17 到 09-18 | 三到四 | 开�五个工作包，本地�测全绿，一个�交，交第�节的�� |
-| 09-19 | 六 | 我�审 |
+| 09-19 | 六 | 原定我�审。实际 09-17 已�审（`docs/评审记录_2026-09-17.md`），修��包 09-18 �审 |
 | 09-21 | 一 | 收盘�选股系统机器拉代�，次日 07:10 的计划就是新�（盘�链�步都是�进程，读挂载目录里的新代�）。接�容器�建议�窗��一次并预热计划接�，�审批��开七点到七点�与八点�到�点零五：接�进程内存里��旧的装�代�，JSON 走快照直通没问题，但 md 格�的主榜表与快照读�到时的实时回�会走旧� |
 | 09-22 | 二 | 第一份新�计划。看候选���三���入池��三处读数，交回 |
 | 09-25 | 五 | 第一次带两份��对照的周报（二�点�分由基座触�） |
@@ -119,7 +119,7 @@
 | `CARD_SORT_BY_QUALITY` | 1 | �内�先质地带；0 回"先判决�涨幅" |
 | `POOL_SOURCE` | rank | 新增�值；tier 与 candidate �留 |
 | `REVIEW_TARGETS_AXIS` | both | score 回"�按原始分�一百" |
-| `COMPANY_REVIEW_STALE_DAYS` | 120 | 已有；从此对质地带�质地门�加�分都生效 |
+| `COMPANY_REVIEW_STALE_DAYS` | 120 | 已有；从此对质地带�质地门��内�生效。旧轴的加�八分�加守�，因为 `score_adj` 的值�求��（09-17 �审修订） |
 | `PLAN_QUALITY_BONUS` | 8 | 已有；�在 transmission 轴下起作用 |
 | `POOL_RANK_KEEP_OLD` | 0 | 备用：旧�强传导�五�并进池，�在"池包�候选"���核�过时打开 |
 
@@ -255,7 +255,7 @@ cd ~/project/akg-factor-bridge && grep -n "新��二�\|旧��二�\|档
 - `pool.py` 约 293 到 301 行：把选行那段抽�纯函数 `select_plan_rows(main_rows, top, source, tiers, keep_old=False)`，离线�测。`rank` 分支：`[r for r in main_rows if r.get("pointed")][:top]`，`_pool_source` 记 `rank_top`；`keep_old` 为真时�并进按 `rank_old` 排的强传导� `top`，去�，`_pool_source` 记 `rank_old_strong`，总数� `POOL_MAX` 兜底；`tier` 与 `candidate` 分支�字�留。入池上下文 `strategy_context_entry` �加 `quality_band`�`rank_axis`�`rank_old` 三键。
 - `plan_reconcile.py` 的应答加 `rank_axis: "transmission"` 一键，文案�动。
 - `review_targets.py` 约 14 到 15 行与 `build_rows`：`persist(date, snap)` 拿到的 `snap["main"]` 已是新�的全部行，�行带 `score` 与 `rank`。`both` 时主榜���"按 `score` ���一百"与"按 `rank` ���五�"的并集，去��按 `rank` 排；`score` 时��按 `score` ���一百（�字回旧）。观察档照旧�二�。
-- `plan_review.py` 约 378 到 384 行从快照 `_full` 读主榜行；约 419 行附近加两份��"主榜新��二�"（按 `rank`）与"主榜旧��二�"（按 `rank_old`，缺该键的旧快照跳过这两份��）；约 431 到 436 行的档�分组外�加档�乘质地带的交�分组，分组�写"档�×质地=强传导×好"这样；`compare_table` �动。
+- `plan_review.py` 约 374 行用 `plan.collect` 把当日�新装�一��� `_full`（�是读快照；改读快照�《上线与��阶段工作方案与规格书_2026-09-17》工作包丙）；约 419 行附近加两份��"主榜新��二�"（按 `rank`）与"主榜旧��二�"（按 `rank_old`，缺该键的旧快照跳过这两份��）；约 431 到 436 行的档�分组外�加档�乘质地带的交�分组，分组�写"档�×质地=强传导×好"这样；`compare_table` �动。
 
 ## 附录丙（��读）：�测清�