tradingSystem/docs/技术面接入与三源合议_进度交接_2026-09-11.md

技术面接入与三源合议 · 进度交接（2026-09-11）

这份文档给下一次接手（新开上下文）用。对照《技术面接入与三源合议方案_2026-09-11.md》， 说清做到哪、剩什么、剩下的接入怎么做、有哪些坑。配合 DEVLOG.md 最新几条节点一起读。

一句话现状

技术面接入（工作包一）已完成并在模拟仓 155 真机判收通过；三源合议（工作包二）的三块「大脑」——纯逻辑、装配服务、仓位矩阵——已完成、开发机全量绿、已提交；剩下的是把它们接进下单链路（扫描分流、增持门、候选排序、页面合议行），这是全工作包风险最高的地方，留给下一轮专注做。另有提议卡重构（用户临时要求）已完成。

一、对照方案的工作包进度

工作包	内容	状态
一 技术面取数落表映射与页面	新表、tech_repo、tech_service、调度位、三接口、页面四项	完成 + 155 真机判收（映射覆盖 176/177）
二 三源合议与仓位矩阵	见下方拆解	三块大脑完成，接入未做
三 离场纪律	eval_tech_exit、SAR 盘中止损线、紧止盈自动挂载	未做
四 选股系统打分	akg-factor-bridge 仓库改质地调整分	未做（另一仓库，单独审批）
五 文档台账登记	台账 006-011、README 调度总表、接口契约	部分（见下）
额外	提议卡重构（卡面结论 + 弹窗详情 + 技术面行）	完成，本地冒烟过，未 155 真机判收

工作包二拆解：

• 纯逻辑三模块 app/core/fund_rules.py、timing_rules.py、consensus.py：完成（tech_rules 工作包一已做）。
• 装配服务 app/services/consensus_service.py + downstream_repo.fetch_nightly_verdicts（批量读昨夜定性）：完成。
• advice_service.advise_v2() 基本面×技术面仓位矩阵：完成（旧 advise 原样保留）。
• 新建仓扫描接入合议路由：未做。
• 持仓增持门：未做。
• 候选按基本面立场排序：未做。
• 提议卡合议行（页面）：未做（提议卡已重构成四行来源，合议行加第五行或顶部结论）。

二、提交与部署状态

远程（origin 在 192.168.18.24，分支 main）当前到 0dd5b68。八个提交：

0dd5b68 三源合议工作包二(三)：advise_v2 基本面×技术面仓位矩阵
be7884d 三源合议工作包二(二)：装配服务与批量读昨夜定性
84207d5 三源合议工作包二(一)：基本面/择时/合议三个纯逻辑模块
5fa6881 修技术面分页：按 matched 拉完，不再用页大小判最后一页
a33bae5 修 batch20 提议卡守卫断言：propVerdictLine 重构后移进详情弹窗
83022e1 提议卡重构：卡面留结论、详情进弹窗、加技术面
d895802 技术面接入工作包一(页面)：顶栏新鲜度芯片、持仓研究面列、单票抽屉技术面节
0d39845 技术面接入工作包一(后端)：取数落表、相位合成与映射打通

模拟仓 155 当前部署到 be7884d（分页修复那次 git pull 拉到的）。0dd5b68（advise_v2）已推远程但 155 未拉——advise_v2 是新函数、还没被调用，155 缺它不影响运行，下次部署接入时一起拉即可。

真实仓 188 未动（本次全部在模拟仓 155）。

三、真机判收状态（只写「真机见过」或「未判收」）

• 工作包一技术面：真机见过。155 上 make test ALL SUITES PASS、20 张表就绪（pms_tech_daily 建出）、pull_and_map 分页拉全 4991、映射覆盖 176/177 只（看空 54 / 中性 111 / 看多 11）。明天 6:30 调度会自动这样拉。
• 提议卡重构：未判收。开发机注入假提议起本地服务，截图确认卡面四行结论、技术面弹窗三指标块、公司深度弹窗四段分组渲染正确、不白屏；155 上要等真实提议才判收。
• 工作包二三块：未判收（还没接入，没有运行路径；开发机全量单测 771 例绿）。

四、真机抓到并修掉的两个坑（脱库单测测不到，都加了哨兵）

1. upsert 的 ON DUPLICATE 用绑定参数触发 pymysql 批量陷阱：ON DUPLICATE KEY UPDATE col = :col 在 executemany 多行合并时，UPDATE 子句的占位符不展开却仍算参数，5000 行批量落表参数错位、SQL 留裸 % 报 1064。改用 VALUES(列) 引用插入值。哨兵在 test_batch27。
2. 分页误判最后一页：接口每页上限 1000 < 页大小 1500，旧逻辑「返回数小于页大小」第一页就判到底，只落 1000/4991。改为优先按 matched 终止、空页停、页大小设 1000。哨兵在 test_batch27。

两个都是「脱库单测 mock 了落表 / 注入了 fetch，测不到真实 SQL 与真实接口分页」，靠 155 真机首验才暴露。下一轮接入后同样要 155 判收，别只信开发机单测。

五、剩下的接入怎么做（下一轮的活）

核心洞察：合议接入完全复用现有「判决分流」的手法。 action_engine.scan_open 循环里（app/core/action_engine.py 约 780-800 行）已经有一套判决分流：在名额判断之前按 verdict 分流——仅展示不占名额、关注打 needs_user_confirm、候选放行；而且开关（params["open_route_by_verdict"]）关掉时那段一行不执行、旧行为逐字保留。合议路由要的是同一件事，照抄这个位置和手法。

四处改动，每处都要守「开关关掉即逐字回旧」：

1. proposal_service._scan_open（约 289 行调 ae.scan_open 之前）：PMS_CONSENSUS_ROUTE 开着时，对候选 cands 批量装配合议——一次取昨夜定性（consensus_service.nightly_map）和技术面映射（consensus_service.state_map），逐只 consensus_service.assemble，把 consensus（含 route/四块）和 hard_keys 的六键挂到每个 cand。开关关掉整段不做，cands 原样进 scan_open。

2. action_engine.scan_open（约 792 行、判决分流 VERDICT_DISPLAY 那段之后、名额判断之前）：加合议分流，纯逻辑读 cand 上挂好的 consensus.route：跳过/观察 → 写 skipped（观察的处置词 wait_tech）、continue（不占名额不占金额）；交人 → 打 needs_user_confirm 与原因；放行 → 照常。开关走 params["consensus_route"]。

3. advice_service：候选定档改用 advise_v2(c, params, fund=..., tech=...)（矩阵），fund/tech 从 cand 挂的合议四块取。六键进硬数字，且六键一个都不进 judge.OPEN_JUDGE_KEYS（附录丁）。advise_v2 已写好、开发机验过矩阵逐格。落点在候选组装 action_engine._open_candidate（约 611-716 行）或 proposal_service._make_proposal（约 848 行，现在那里调 apply_judge/resize），要接上 advise_v2 那一档并让数量按它重算（沿用 resize_to_advice）。

4. 持仓增持门（action_engine）：合议看空停增持侧三类（回踩补足 eval_fill、盈利加仓 eval_add、补仓 eval_dca）；技术面看空跳过回踩补足与盈利加仓；基本面看空跳过补仓；减持侧不受门影响。持仓行的合议由 consensus_service 早上装配（类似 logic_state 的 decorate_positions），挂到持仓行给动作引擎读。

候选排序（工作包二第 4 点）：plan_feed.select_candidates 里，先按基本面立场分桶（看多桶在前）再按分数，在主题限额与截断之前生效；技术面不参与排序只当门；观察档里质地看多的行进池默认关（PMS_PLAN_OBSERVE_IF_FUND_BULL 默认 False）。

页面合议行：提议卡已重构成四行来源（选股系统/决策系统/公司深度/技术面），合议再加一行「合议」显示三方多数方向与强弱，点开看三票与路由理由；候选栏每行加质地与技术芯片、处置词 wait_tech（等技术面开口）；管理视图持仓总览修一处证据列印两遍的显示错误并加研究面列。

哨兵与登记：动作求值器次序若加 eval_tech_exit（工作包三）要改哨兵；六键不进 OPEN_JUDGE_KEYS 要在 test_batch28 或新批次加断言；PMS_CONSENSUS_WEAK_CONFIRM（合议一方表态强制交人）目前未登记（consensus.decide 内置了「一方表态交人」，若要开关控制需 decide 加参数并登记）。

参数：PMS_FUND_REQUIRED、PMS_FUND_STALE_DAYS、PMS_FUND_CONSENSUS_GOOD_MIN、PMS_CONSENSUS_ROUTE 已登记进 param_store 的 RUNTIME_EXTRA。接入时若读新参数（如 PMS_TECH_GATE_INCREASE 增持门、PMS_PLAN_RANK_BY_QUALITY 排序、PMS_TECH_VOL_CONFIRM 盘中放量），要同步登记且保证有读取处（否则死参数扫描红）。

六、pending 清单

1. 155 部署 advise_v2 与后续接入：现部署在 be7884d，缺 0dd5b68 及之后的接入。接入做完一起部署，收盘后或盘前，先经用户审批（本次曾把宿主 UTC 误当北京时间、盘中当盘前部署过，务必看容器内时间：容器 datetime.now() 是北京时间，宿主 date 是 UTC）。
2. README 调度总表补齐（工作包五）：现描述「九个调度位」过时，实际 13 位（含 06:30 tech_pull）。
3. 台账 007-011（工作包五）：目前只补了 006（技术面相位与五阈值）。007 基本面立场规则、008 待定、009 合议路由、010 SAR 离场、011 弱基本面紧止盈随对应工作包补。
4. 工作包三（离场纪律）、工作包四（选股打分，另一仓库单独审批） 未做。
5. 提议卡重构 155 真机判收：等 155 有真实提议时看卡面四行、点弹窗。

七、验证命令

开发机（跑全量单测，用临时 venv）。 预期最后一行 ALL SUITES PASS。

cd /Users/baobao/Documents/work/project/tradingSystem && /private/tmp/claude-501/-Users-baobao-Documents-work-project-tradingSystem/f7c4a696-e3d8-4465-961a-04f82eb3e424/scratchpad/venv/bin/python scripts/run_tests.py

（venv 在会话 scratchpad 下、跨会话要重建：python3 -m venv <venv> && <venv>/bin/pip install -r requirements.txt。）

模拟仓 155（部署与判收，重建容器先经用户审批，看容器内北京时间避开盘中）。 预期 make test 见 ALL SUITES PASS，pull_and_map 行数五千上下、映射只数接近持仓加候选。

cd /home/factor/project/tradingSystem && git pull --ff-only && make deploy && make test && docker compose run --rm --no-deps pms-web python -c "from app.services import tech_service as t; import json; print(json.dumps(t.status(), ensure_ascii=False)[:400])"

八、下一轮的第一步

读这份文档 + DEVLOG 最新两条节点 + 方案第五节工作包二第 5-6 点 + 附录乙丙丁；然后从「五、剩下的接入」的第 1、2 处开始（proposal_service 装配挂候选 + action_engine.scan_open 合议分流），每处先写「开关关掉时逐字节相同」的单测再改，改完开发机全量绿、再 155 判收看提议真按合议分流。