diff --git a/.agents/skills/pms-qmt-diagnose/SKILL.md b/.agents/skills/pms-qmt-diagnose/SKILL.md
new file mode 100644
index 0000000..4cdf75f
--- /dev/null
+++ b/.agents/skills/pms-qmt-diagnose/SKILL.md
@@ -0,0 +1,29 @@
+---
+name: pms-qmt-diagnose
+description: 排查PMS与QMT连接、验签拒绝、序号缺口、委托失联或成交对账异常,整理双方联调证据。正常页面开发和策略研究不触发。
+---
+
+# PMS与QMT联调排障
+
+先读[QMT协议](../../../QMT_WS_PROTOCOL.md)及[开发入口](../../../docs/开发入口.md)指向的最新状态。历史地址、空仓、暂停或SIG_INVALID记录只能作线索,不能作为当前故障结论。沿用会话授权,不扩大实例范围。
+
+## 建立当前事实
+
+1. 标明采样时间及换算依据,核对实际端点、唯一连接进程、dispatch模式、表前缀、用户暂停和resync。读取连续确认、最高已收、暂存缺口及最近消息;ONLINE只是连接状态。
+2. 区分PMS验证上行签名失败、QMT发出的SIG_INVALID、旧消息补发和当前新拒绝。记录产生时间、实际收到时间、type、msg_id、seq和关联请求。不能仅凭拒绝文案推断请求来自本PMS。
+3. 委托问题逐层查命令、父指令、子委托、出口状态、QMT受理号、成交及入账。计划量不等于已发送量,受理不等于成交;先核实最新在途状态,不因页面旧文案补单。
+4. 查看新账户资金及持仓快照、待处理消息和待归属成交,将两策略合计与QMT核对。发现通道或账本故障按现有守成机制处理,保留证据。
+
+## 需要双方材料时
+
+只收集覆盖问题时段的日志和相关函数,不要求对方发整个仓库或完整环境文件。材料包括:实际部署提交与进程入口;连接ID和来源IP;失败请求及其拒绝的生成、入库、入队和发送链路;双方公钥指纹与规范串摘要;消息序列、回放和确认存储的环境隔离方式。
+
+不要索取私钥。原始签名报文如含敏感业务数据,留在受控位置;共享版脱敏,并注明修改过的报文不能直接用于验签。未经用户明确要求,不向外部发送材料。既有材料结构可参考[10月27日联调包](../../../docs/联调材料/QMT验签与序号缺口_2026-10-27/README.md),只按需要读取。
+
+若需断连隔离或被动抓包,先完成只读定位,定义最小范围、停止条件和恢复步骤,在已有授权内执行。不能另开竞争WS连接,不能通过忽略签名、重置序号或反复重连消除表面症状。
+
+## 恢复判定
+
+连续确认随新消息推进、暂存缺口清零、无新验签拒绝或被动断线后,再核验新资金、在途和待处理回报及账户对账。确认恢复并留痕后才清resync;仅恢复本次维护设置、且未被用户新命令覆盖的暂停。
+
+交付区分已观察事实、推断、对方自述及待提供证据。保留“旧实例干扰”一类假设,直到来源和部署证据齐全;短时健康不等于历史根因已经查明。
diff --git a/.agents/skills/pms-release/SKILL.md b/.agents/skills/pms-release/SKILL.md
new file mode 100644
index 0000000..e88dde1
--- /dev/null
+++ b/.agents/skills/pms-release/SKILL.md
@@ -0,0 +1,35 @@
+---
+name: pms-release
+description: 发布PMS代码或策略规则到已授权实例,并核验运行与回退条件。用于部署、升级、重建服务;普通代码编辑、回测和文档整理不触发。
+---
+
+# PMS发布与核验
+
+从仓库[开发入口](../../../docs/开发入口.md)找到当前任务的部署记录。授权沿用根目录规则与会话,不因本技能新增确认,也不把既有155授权扩大到188或无关系统。
+
+## 发布前
+
+- 核对目标主机、项目路径、表前缀、dispatch模式、用户暂停、实际镜像与挂载。读取当前服务有效配置,不用旧`.env`替换现用配置;密钥和私有覆盖文件不导出到Git或报告。
+- 查看本机及服务器差异、拟发布提交和在途任务。先完成代码提交,构建可追溯镜像;需要拉取时检查是否夹带其他未获发布安排的提交。服务器私有修改保留。
+- 选择受影响服务,不为版本整齐重建无关容器。涉及worker时避开当前任务或温和排空;涉及WS时确保旧进程结束后才启动唯一新连接。
+- 在开发机完成相应验证,再对服务器候选镜像进行断网、无业务配置的全量回归。不得连接运行库做单测。页面变化按页面目录规则另验收。
+
+在部署服务器对本次构建的候选镜像执行,替换下列占位名;预期末行为`ALL SUITES PASS`:
+
+```bash
+docker run --rm --network none --cpus 1 --memory 512m --read-only --tmpfs /tmp:rw,size=128m CANDIDATE_IMAGE python scripts/run_tests.py
+```
+
+## 实施与判收
+
+- 备份实际配置、镜像和必要数据,记录操作意图及回退条件。迁移先在隔离库演练,再核对实际代理的事务与锁行为;跨策略数量、现金、成本和历史归属不能只验表存在。
+- 源码在镜像中,更新代码必须构建并force-recreate受影响服务。`make deploy`会拉取、重建和建表,确认整套动作适用后才使用;定向发布沿用该实例私有覆盖配置。`restart`不是代码发布方式。
+- 策略参数经ParamStore读写。版本、快照、目标数量与在手轮次需匹配;盘中改规则不倒填08:50冻结,不用旧版本快照执行新策略。接入档位遵循用户最新决定,不额外设置观察天数。
+- 核验实际镜像、启动时间、配置、页面健康、自然调度和实际回执。交易链路还须检查连续确认、缺口、最新资金、在途、待入账及策略合计对账,不能只看容器运行或ONLINE。需要定位异常时再读[pms-qmt-diagnose](../pms-qmt-diagnose/SKILL.md)。
+- 不注入虚假信号或测试委托制造验收。分开记录隔离回放、本地浏览器复现、真机实际发生与未判收;未出现自然切换就如实保留待办。
+
+## 回退与交付
+
+失败时先停止新增风险动作,保留账本和在途回报。回退前检查已产生的成交、数据迁移及绑定规则,不能直接倒退表结构、覆盖新历史或把持仓强行切回旧版本。记录具体阻塞与恢复条件。
+
+在DEVLOG和本阶段接续中写明提交、镜像、北京时间、实际动作、验证机器和证据、未完成事项。仅文档或离线研究产物更新不因此重启业务容器;已通过的检查不为凑次数重复运行。
diff --git a/AGENTS.md b/AGENTS.md
index 42ab5a0..7a902ec 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,150 +1,34 @@
-# AGENTS.md
+# 项目工作规则
-本文件是 Codex 在本仓库工作的项目指令,也是项目开发规则的唯一维护入口。`CLAUDE.md` 保留兼容入口,指向本文件。
+用可读中文沟通和写文档,句子完整,少用符号和自造缩写。PMS负责命令、数量和账本;bionic负责研判与择时;QMT负责委托成交。
-用可读中文沟通和写文档。写完整句子,一句一事,少用符号,不自造缩写。术语先用白话解释。命令和表格内部不受此限。这些规则直接保存在本文件,不依赖开发机上缺失的输出风格文件。
+## 工作流程
-## 接续开发从哪里开始
+1. 开工先看`git status --short`、`git worktree list`和相关提交。保护已有未提交文件及其他工作树,不覆盖、不清理。新分支用`codex/`前缀;推送状态直接核对远程。
+2. 从[开发入口](docs/开发入口.md)选择本任务资料,不通读历史日志。修改前读取目标目录及其父目录的适用规则,包括存在的`AGENTS.override.md`;从仓库根目录启动不能假定子目录规则已经自动加载。
+3. 按影响范围验证。单测必须隔离配置、禁止联网;部署前用候选镜像完成断网回归。页面改动跑三道护栏,布局与交互另做浏览器验收。纯文档修改检查内容和链接即可。
+4. 在开发机修改,经Git提交后部署,提交说明用简短中文。交付说明改动、验证机器、实际结果和未完成事项。重要节点追加`DEVLOG.md`;当前状态写接续记录,注明核验时间。历史回执不等于当前健康,本地通过不等于真机判收。
-当前接续记录是 `docs/开发接续_2026-10-12.md`。接手中断的工作时先读它,再按任务查设计文档。它记录了两个 Claude 修复的整合状态、测试隔离方式、尚未执行的探针和部署判收。
+## 授权边界
-开工先看 `git status --short`、`git worktree list` 和相关提交。已有的未提交文件与其他工作树属于用户正在进行的工作,不覆盖、不清理。判断是否推送要直接核对远程,不凭过期的 `origin/main` 引用下结论。
+- 按当前任务及会话已有授权推进,不因旧文档或技能重复索要许可。当前155模拟PMS的必要服务器、容器、数据库操作及PMS重启已获授权;不扩展为宿主机重启、新的破坏性清账或其他系统的写操作。
+- 188真实PMS不在本阶段范围内。执行前核对主机、实例表前缀、运行模式及实际镜像。范围不清或确需超出授权时才询问,并说明具体原因。
+- 用户新增命令和暂停优先于既有计划。已经取消的观察期、旧参数和历史暂停不能重新套用;运行值到ParamStore及实际回执核实。
-创建新分支时默认用 `codex/` 前缀。旧的 `claude/` 分支仍是有效的 Git 分支,保留名字和工作树即可接续。合并时核对测试文件是否重名,不能让一批测试覆盖另一批。
+## 关键禁区
-历史交接里的服务器状态只代表记录当天。过期的执行日期不会自动变成今天的执行授权。2026-10-12 用户确认先以当前仓库为准,原定 10-09 的两项探针均未执行。
+- 命令至上。自动动作不得突破用户约束,命令冲突交用户裁决。研判不可用按既定保守规则和人工确认降级,不自建第二套研判。
+- 先记账后动作,故障守成。指令落表后才下发,以QMT实际持仓对账;不伪造信号、成交、冻结时间或验收结果,不将研究结论自动上线。
+- QMT只保留一个`pms-ws`连接。禁止扩副本、忽略验签、归零序号或反复重连掩盖缺口。`ONLINE`不代表确认、资金和账本都正常。
+- 资金占用不得重复计算。成交按委托和策略归属,不跨策略认领,不回灌已归档旧仓。规则版本、快照与在手轮次必须一致。
+- 业务参数经ParamStore读取。密钥只由环境注入并登记`SECRET_KEYS`,不入库、不进页面、日志或Git。SQL严格单表,跨表数据在服务层组合。
+- 测试不得连接真实服务或用真实成交补账。新外部依赖补内存桩,不靠吞异常通过测试。
+- 改Python后必须构建镜像并重建受影响容器,`restart`不能更新代码。先检查实际挂载和私有覆盖文件,不为追平版本重复重启。
-## 这是什么
+## 按需入口
-这是一套命令驱动的持仓管理系统,代码里和文档里都简称 PMS(Position Management System,持仓管理系统)。它在整条交易链路里只负责一段:用户在管理页面下达大方向命令,例如设定总规模、调仓位上限、升降仓、对某只股票做 T;PMS 据此把命令拆成分股分批的方案,并管理账本(批次、摊薄成本、安全垫、纪律)。
+- 后端分层与数据约束:[app/AGENTS.md](app/AGENTS.md)。前端另读[app/web/AGENTS.md](app/web/AGENTS.md)。
+- 测试与脚本:[scripts/AGENTS.md](scripts/AGENTS.md)。历史实验:[research/AGENTS.md](research/AGENTS.md)。
+- 部署时使用[pms-release](.agents/skills/pms-release/SKILL.md);QMT联调或排障时使用[pms-qmt-diagnose](.agents/skills/pms-qmt-diagnose/SKILL.md)。普通改文档不加载这两个技能。
-链路上还有另外两个系统,它们不在本仓库里,但 PMS 时时与它们打交道:
-
-1. 决策系统,代码里叫 bionic。它负责研判(该不该做)与盘中择时(何时做)。PMS 不自建研判栈,研判和择时都可以委托它。
-2. 下游系统,即 QMT 侧的执行服务。它只负责挂单成交。PMS 经一条 WebSocket 长连接直连它。
-
-一句话概括分工:PMS 管「做什么、多少」,决策系统管「该不该、何时」,下游只管执行。
-
-## 三条铁律(改任何东西前先读)
-
-这三条写在 README 开头,是整个系统的设计前提,违反它们的改动一律是错的。
-
-1. 命令至上。自动决策不得突破用户的命令参数;冲突时命令优先;命令之间的冲突交用户裁决。
-2. 分工不越权。研判不可用时降级为保守规则加人工确认,绝不自建第二套研判。
-3. 先记账后动作,故障即守成。指令先落表再下发;出了故障不产生新指令;账本与下游定期对账,以下游为实际持仓的事实源。
-
-## 常用命令
-
-日常操作都由 `Makefile` 包了一层,`make help` 看全部目标。下面这些是最常用的。所有 `make` 命令都在部署 PMS 的服务器上跑(源码打进容器镜像,本机直接跑 Python 会因为缺少容器环境而对不上)。
-
-```bash
-make deploy # 一句话部署:git pull → 重建镜像 → 重建容器(force-recreate)→ 建表
-make deploy-local # 同上但跳过 git pull(本地已经改好时用)
-make test # 跑全部单测(不连库,秒级)。应输出 ALL SUITES PASS
-make watch # 盯盘看这一个:通道/账户/在途指令/出口委托/账本持仓 一屏看完,只读
-make health # 页面健康检查(配置装载自证 + 库连通自证)
-make check # 实机连通性与表结构自检(需要真实 .env)
-```
-
-跑单元测试有两种粒度。跑全部用 `make test`,它会先比对容器镜像与工作树的代码指纹,对不上就报警(防「git pull 了没重建,跑的还是旧代码而且照样通过」)。只跑某一批时,直接把那个测试文件当脚本跑:
-
-```bash
-# 只跑某一批(例:择时实现B 与规则闸那一批)
-docker compose run --rm --no-deps pms-web python scripts/unit_test_guard.py scripts/test_batch3_units.py
-```
-
-每个 `scripts/test_batch*.py` 都是能独立运行的脚本,`scripts/run_tests.py` 只是把它们逐个 subprocess 起来。测试设计为不连接外部服务,服务层用内存桩(见 `scripts/test_wiring.py` 的 `FakeRepo`)。
-
-**单测必须隔离配置并禁止联网。** `scripts/run_tests.py` 逐批经 `scripts/unit_test_guard.py` 启动,清除业务环境变量,在没有 `.env` 的临时目录运行。各测试文件直接运行时也先安装联网护栏。Python 套接字调用会在连接前被阻断,即使业务代码吞掉异常,整批仍以失败退出。`install_fakes` 已补齐观察读数仓储与扫描中遗漏的外部依赖。新增服务调用必须补内存桩,不能依赖异常降级让测试通过。
-
-开发机可以在单独虚拟环境安装 `requirements.txt` 后经隔离入口跑全量回归。服务器部署前仍要用匹配镜像的断网容器验证,不能把本地通过称作服务器验收。2026-09-20 留下的四行历史假数据尚未清理,修测试不会自动删除库里的旧记录。
-
-## 改代码时最容易踩的坑
-
-**改了 Python 代码必须重建镜像加 force-recreate,绝不能用 `docker compose restart`。** 源码是打进镜像的,`restart` 只是把老容器停了再起,跑的还是旧镜像里的旧代码,而且一点报错都没有。`make deploy` 和 `make up` 走的都是正确路径。这是本项目头号坑,`Makefile` 顶部、`scripts/deploy.sh`、`run_tests.py` 里都反复写了这一条。
-
-**模拟仓 155 是个例外,要另记(2026-09-20 实测)。** 155 的项目目录里有一个服务器本地文件 `docker-compose.override.yml`,内容同仓库里的 `docker-compose.dev.yml`,它把整个仓库目录绑定挂载到四个容器的 `/app`。这个文件被 `.gitignore` 忽略,仓库里看不到;真实仓 188 没有它。后果有三条。一,在 155 上 `git pull` 之后,页面静态文件立刻就是新的,后端四个进程仍是旧代码,直到重启或 `make deploy`。二,`make test` 与 `make stale` 起的一次性容器读的也是工作树,所以在 155 上「指纹一致」恒成立,查不出「拉了代码没重启」。三,往 155 拉代码等于把页面先上线了,拉之前先看 `git log` 里有没有别的会话提交的、还没到上线日的改动。`make deploy` 在两台机器上都仍是对的做法。
-
-**2026-10-27更新。** 用户授权立即重启模拟PMS后,155四服务已取消`/app`源码挂载,改为运行经过验证的镜像。服务器私有`docker-compose.override.yml`保留各服务有效环境及镜像,旧配置已备份。上述9月20日的挂载现象是历史状态;后续仍须通过`docker inspect`确认,不得默认继续存在。当前部署证据见`docs/微盘30整体部署判收_2026-10-27.md`。
-
-**下发模式由参数 `PMS_DISPATCH_MODE` 决定,实际以页面顶部横幅为准,不要拿这段文字当现状。** 设置文件的初值是 `shadow`(影子模式:指令照常生成、过规则闸、记账、置为已下发,但不写下游,需人工在 QMT 侧执行,成交由回放任务按先进先出认领回账本)。但模拟仓 155 运行时已切到 `ws`,指令经 `pms-ws` 真向模拟 QMT 发出、自主动作按档位可自动执行,不再需要人工下单。真实仓 188 的 PMS 尚未追平到最新代码,上线等 QMT 侧,追平部署时按真实仓准备包的初始参数清单先进影子期。切换只是 `PMS_DISPATCH_MODE` 与 `PMS_QMT_WS_ENABLED` 两个开关加一次联调,不是再写代码。改动涉及下单链路时,务必先确认自己面对的是哪一套实例、此刻是哪个模式。
-
-**业务参数一律走 ParamStore 读,不要直接读 settings。** `config/settings.py` 里的业务参数(`PMS_TOTAL_SCALE`、各种档位阈值等)只是「初值」。运行时以数据库表 `pms_runtime_param` 的值为准,页面改参数即时生效。取业务参数统一经 `app/services/param_store.py`,直接读 settings 会让页面调参失效。基础设施类配置(连接串、密钥)才从 settings 与 `.env` 读。
-
-**密钥只从 `.env` 注入,不入库、不进 ParamStore、不上页面。** 会话密钥、QMT 通道的两把 Ed25519 密钥都属此类。新增密钥类配置时,要同时登记进 `param_store.py` 的 `SECRET_KEYS`,否则它会被当成可调参数暴露到页面快照里。
-
-## 架构分层
-
-代码在 `app/` 下按依赖方向分层,越靠上越纯。
-
-- `app/core/`:纯逻辑,零外部依赖,可单测。系统的算数与纪律都在这里——批次拆分与组合约束(`sizer.py`)、摊薄成本与安全垫状态机(`cushion.py`)、命令目录与校验(`command_spec.py`)、方案生成(`planner.py`)、规则闸终检(`rule_gate.py`)、择时实现B(`exec_timing.py`)、动作引擎(`action_engine.py`)、QMT 协议编解码与签名(`ws_codec.py`)等。改核心逻辑先在这一层,它有最密的单测覆盖。
-- `app/db/session.py`:三个数据库的连接,外加一道严格单表访问守卫(下面单列一节)。
-- `app/repo/`:单表数据访问层。每个函数只碰一张表。
-- `app/services/`:编排层,把 core 的纯逻辑接上 repo 的取数与落表。命令下达在 `command_service.py`,方案转指令与出手在 `executor.py`,下发通道适配器在 `dispatcher.py`,运行参数中心在 `param_store.py`,组合快照在 `portfolio.py`。
-- `app/ws/runner.py`:常驻的 QMT 连接进程,容器名 `pms-ws`。它只做通道,不碰账本。
-- `app/web/`:FastAPI 后端加一个单页前端(`static/index.html`,Vue3 加 ElementPlus,无构建步骤)。
-- `app/scheduler.py`:Celery beat 调度总表与调度守卫。调度位以代码和 `scripts/test_wiring.py` 中的哨兵清单为准。
-
-进程边界值得单独理解一下。出手的 `executor` 跑在短命的 Celery worker 任务里,而 QMT 连接必须是一条常驻长连接(协议规定 PMS 只准开一条,多开会让指令乱序)。两者只经数据库耦合:worker 把待发委托写进出口表 `pms_qmt_order`,`pms-ws` 进程亚秒轮询取走并签名发出;QMT 的回报落进 `pms_qmt_inbox`,再由回放任务认领进账本。因此 `pms-ws` 这个服务绝不能扩副本。
-
-三组容器服务:默认起 `pms-web`(管理页面,端口 38100);`--profile sched` 起 `pms-beat` 和 `pms-worker`(调度与执行);`--profile ws` 起 `pms-ws`(QMT 直连)。
-
-## 严格单表访问守卫
-
-153 代理库不支持多表联查,写错了要到线上才报错。为把这条纪律钉死,`app/db/session.py` 在每条 SQL 的执行入口做静态检查,出现 JOIN、逗号连表、跨表子查询一律拒绝抛异常。写数据访问代码时,一条 SQL 只能碰一张表;要联的数据在 service 层分两次查再在内存里拼。`upsert` 语句里的 `ON DUPLICATE KEY UPDATE` 是这道守卫的历史误伤点,改 upsert 时留意。
-
-## 数据库与外部依赖
-
-三个 MySQL 库(键名与 bionic 对齐,同一份 `.env` 可服务两个系统):`PROXY_DB_URL` 是 153 代理,放 PMS 全部自有表加决策系统结论表;`SOURCE_DB_EXT_DSN` 是因子库,当前 PMS 不用;`DB_MYSQL_URL` 是大盘指数库,只做页面区制提示。建表脚本是 `scripts/init_db.py`,建表语句在 `ddl_pms_v1.sql`。
-
-Redis 有几路:决策系统的盘中信号流与风控卖出流、实时行情、PMS 自己的 Celery 总线。**`redis` 依赖必须锁在 5.x**:6.x 默认按 RESP3 握手,而现网的 Redis 版本偏旧会回 `unknown command HELLO`,导致行情与调度总线一起断。`requirements.txt` 已锁版本,升级依赖时别放开。
-
-## 时区口径(很容易读错)
-
-不能按「哪个系统」一刀切,要按「哪种时间」分。容器时钟与容器日志正文是北京时间,不要加八小时。数据库里的时间戳列(如各种 `created_at`、`updated_at`)是 UTC,读的时候要加八小时。日期列(如 `trade_date`、`audit_date`)是北京日期,不换算。写记录时一律用北京时间,引用数据库时间列先加八小时并标注已换算。完整依据见 `DEVLOG.md` 开头。
-
-**待核实的例外。** 上段是历史约定。PMS 自有表的部分列实际是 `DATETIME`,`pms_repo.py` 与 `qmt_repo.py` 用容器内 `datetime.now()` 写值。10-08 的两个探针因此提出先用心跳和快照校准时区。用户已确认探针尚未执行,2026-10-12 部署核对已确认 155 宿主机为 UTC,容器为北京时间,`pms_ws_state.heartbeat_at` 的 DATETIME 原值与容器北京时间同步,该字段不加八小时。其他列仍要核对写入路径和实际时区,并明确标注原值与换算依据,不把两种口径混在同一份读数里。
-
-## 前端的两个坑
-
-管理页面是无构建步骤的单页,这两个坑都实际炸过页面,都写在 README 里。
-
-1. 模板里不能用自闭合的自定义标签。`` 这种写法浏览器 HTML 解析器不认,会把后面所有内容当成它的子节点;若它带 `v-if` 且条件为假,整页就跟着消失。一律写成 ``。
-2. `setup()` 里定义给模板用的东西必须真的 `return` 出去。漏一个函数没接出去,用到它的地方会在渲染时报错并白屏。`scripts/test_page_wiring_guard.py` 就是为这个坑加的护栏(2026-09-10 白屏即漏了十一个显示函数所致)。
-
-页面有三道静态护栏:`scripts/test_page_enum_guard.py`、`scripts/test_page_wiring_guard.py`、`scripts/test_page_copy_guard.py`。改页面后要一起跑,涉及布局和交互时还要浏览器验收。
-
-页面措辞要专业,不出现内部设计词,不自造简写。同一概念统一用基本面、技术面、择时三种维度。看多用红色,看空用绿色,中性用灰色,无读数用虚框。说明放在悬停里,表格要能在中栏完整显示。
-
-## 加测试时的登记纪律
-
-`scripts/run_tests.py` 把「缺一个测试文件」当失败处理,而不是当「跳过」——因为镜像旧了的时候,新加的那批测试正好全部「不存在」,一条没跑却会报全部通过。所以新增一个 `test_batch*.py`,必须同时登记进 `scripts/run_tests.py` 的 `SUITES` 清单和它上面的例数说明表,否则会被判失败。
-
-代码里还有若干「哨兵断言」,改了对应的东西就得回到那里改断言,断言不动就是漏了。清单写在 `run_tests.py` 顶部的注释里(DDL 表数、调度位、API 路由、密钥名单、动作求值器次序等)。改这些结构性的东西时先去那份清单对一遍。
-
-## 部署与运维纪律
-
-在开发机修改代码,通过git提交,然后在服务器上部署
-
-部署方式与服务器信息以 `DEVLOG.md` 开头那段为准(PMS 跑在哪台机、决策系统与因子桥各在哪、各自怎么生效)。有模拟仓与真实仓两套实例,靠表名前缀(`PMS_TABLE_PREFIX`)与容器名前缀区分,共用同一套代码。对真实仓做写操作前先确认清楚是哪一套。
-
-服务器上的容器操作偏敏感:不要随意重启或关停容器,涉及容器与数据库的操作先与用户确认,不碰本仓库以外的项目。登录到哪台机、面对的是哪一套实例,不清楚时先问。
-
-每次交付写明验证命令在哪台机器上运行,以及预期结果。一个命令块只放一台机器的命令。重要节点及时追加到 `DEVLOG.md`,包含做了什么、动了哪些文件、部署方式、真机判收、还欠着什么。判收只写「真机见过」或「未判收」,本地通过不代替真机判收。
-
-## 文档地图
-
-仓库根目录有大量设计与交接文档,需要细节时按主题查这几份:
-
-- `README.md`:总览,最全。上面各节多是从它摘的。
-- `DEVLOG.md`:开发节点流水账,每条含「做了什么、动了哪些文件、部署方式、真机判收、还欠什么」五样。查某个改动的来龙去脉看这里。
-- `docs/开发接续_2026-10-12.md`:Claude 到 Codex 的仓库迁移记录、修复整合、155 部署判收和当前待办入口。
-- `POSITION_MGMT_DESIGN.md`:总体设计定稿。
-- `QMT_WS_PROTOCOL.md`:PMS 与 QMT 的 WebSocket 协议,下发通道的唯一实现依据。
-- `BIONIC_PMS_INTERFACE.md`:PMS 与决策系统的接口契约(研判闸与盘中择时两个接口)。
-- `UPSTREAM_PLAN_API.md`:上游选股计划接口的接入记录,候选池的事实源。
-- `docs/复盘决定台账.md`:近期改动按「台账」编号推进,提交信息里的台账号对应到这里。
-
-## 提交约定
-
-提交信息用简短中文,描述这次改动的行为而非罗列文件。近期工作按台账编号组织,提交里出现的台账号可回到 `docs/复盘决定台账.md` 对照。
+规则按上述范围维护,不复制多份。`CLAUDE.md`保留原样,停止同步维护;后续修改和提交不要求附带它。最新参数、镜像、故障与实验结果放接续文档,不继续堆入本文件。
diff --git a/DEVLOG.md b/DEVLOG.md
index f6488a6..aa84142 100644
--- a/DEVLOG.md
+++ b/DEVLOG.md
@@ -2444,3 +2444,16 @@ QMT仍有序号缺口,16:23确认1441965、最高1442003、暂存32条。16:24
判收:开发机核对Git、部署记录、标定及平滑报告,摘要本地链接均存在,git diff --check通过;复核任务更新成功并回读确认。运行状态引用10月28日12:49:37的既有真机证据,不声称本次重新核验。无代码修改,不重复运行全量测试。
还欠着:新版本自然冻结、完整微盘入退场和实际成交仍需按最新运行证据判收。股汇上游漏日生成原因尚待核实。不会因汇总自动新增研究或策略变更。
+
+
+## 2026-10-28 · 精简Codex规则并拆分目录与按需技能
+
+做了什么:按用户要求,先核对官方目录指令和技能加载机制,再将根AGENTS.md由150行、17174字节缩至34行、3720字节,减少约78%。主文件保留工作流程、已有授权和关键禁区;明确155授权内不反复确认,188不在本阶段范围内。
+
+动了哪些文件:新增app、app/web、scripts、research四份目录规则,新增pms-release与pms-qmt-diagnose两个仓库技能,以及docs/开发入口.md。README的重复开发约定改为指向统一入口,旧迁移记录中的双文件同步提交要求标为历史。CLAUDE.md内容完全未改,停止同步维护。
+
+验证:开发机核对官方文档,本机Codex CLI版本为0.163.0-alpha.10.2。调用skills/list只读接口,在仓库根目录和app/web均实际发现两个enabled技能,无本仓库加载错误,未启动模型回合。两个技能通过Skill Creator校验,35个本地链接有效,项目目录规则组合未超过默认32KiB限制,git diff --check通过。校验所需PyYAML仅安装到/tmp专用目录,不改应用依赖。
+
+部署方式与判收:仅文档和技能,经Git提交保存,没有访问155、188或QMT,没有改应用代码、业务参数或运行容器。未重新跑无关业务回归,不声称完成新的交易真机判收。新会话实际目录指令链尚未另外启动验证,官方机制、手工路径检查与本机技能发现分别记录在开发入口。
+
+还欠着:无本次文档重整阻塞。运行接入待办继续按微盘阶段接续,不因本次改规则而重启或重做历史实验。已有DEVLOG的114行、复盘台账的10行及未跟踪研究材料保留。
diff --git a/README.md b/README.md
index 3e53462..5456743 100644
--- a/README.md
+++ b/README.md
@@ -8,10 +8,13 @@
## 文档与交付物
+当前工作从[AGENTS.md](AGENTS.md)和[开发入口](docs/开发入口.md)开始。本文保留系统说明及历史初始化、联调步骤,涉及旧参数、影子模式、测试委托和回退的内容须结合最新接续与会话授权判断。
+
| 文件 | 内容 |
|---|---|
-| `AGENTS.md` | Codex 项目指令与统一开发规则。`CLAUDE.md` 保留兼容入口 |
-| `docs/开发接续_2026-10-12.md` | 中断后的工作接续:两个未合入修复、未执行探针、待确认事项与本地验证边界 |
+| `AGENTS.md` | 工作流程、授权边界和关键禁区。目录规则与按需技能见 `docs/开发入口.md`;`CLAUDE.md` 保留原样,不再同步维护 |
+| `docs/开发入口.md` | 按任务查找目录规则、部署与QMT排障技能、当前接续和历史证据 |
+| `docs/开发接续_2026-10-12.md` | 通用迁移、修复整合与历史判收。当前专题状态由开发入口指向最新接续 |
| `POSITION_MGMT_DESIGN.md` | 总体设计 **V0.4(定稿,开发启动)**:命令系统与管理页面/账本/仓位框架/动作引擎/两道关口/择时执行/下游通道。功能一次性开发,上线按依赖分三步切换 |
| `QMT_WS_PROTOCOL.md` | **PMS ↔ QMT WebSocket 指令与回报协议 V1.0(定稿)**:传输与重连、Ed25519 签名与幂等、消息集、状态机、断线补发与对账兜底、部署前检查清单。**这是下发通道的唯一实现依据** |
| `QMT_INTERFACE_REQUIREMENTS.md` | 与 QMT 侧的数据与接口需求清单 **V2.0**:A 部分(只读数据)与 C 部分(切换约定)有效;**B 部分的表通道已废止**,改由上面的 ws 协议承担 |
@@ -495,12 +498,4 @@ docker compose --profile ws up -d pms-ws && docker compose logs -f pms-ws
## 开发约定
-- 开发机与服务器经 git 同步代码;**构建与运行统一走 Docker**(`docker compose build` → 容器内 `python scripts/run_tests.py` → `up -d`),测试结果回传后迭代。
-- 153 代理侧数据库严格单表访问;该纪律已落到 `app/db/session.py` 的静态守卫,违规 SQL 在执行前抛 `MultiTableSQL`。持仓系统内部代码统一 Tushare 点式(`600000.SH`),读决策系统结论表时转前缀式。
- > 2026-07-28 修了守卫本身的一个误判:`ON DUPLICATE KEY UPDATE` 后面跟的是列名不是表名,原来会被当成第二张表,于是**所有 upsert 一执行就抛 `MultiTableSQL`**——页面改参数、`ensure_position`、日报落库、行业映射导入四条路径全中。单测走内存桩不经过该函数,所以一直没暴露。回归用例在 `test_batch6_units.py` 的 [G] 组。
-- 配置分两层:基础设施连接串在 `.env`(服务器手工维护,不入库,模板见 `.env.example`);业务参数在 `config/settings.py` 只是初值,上线后经管理页面修改并持久化到 `pms_runtime_param` 表。**业务代码禁止直接读 settings 取业务参数**,一律走 `services/param_store.py`。
- > 例外是**密钥**:`PMS_QMT_SIGN_SEED_HEX` / `PMS_QMT_PEER_PUBKEY_B64` 只走 `.env`(协议 §10.1.1),已列入 `param_store.SECRET_KEYS`——页面读不到、改不了、快照里也不出现。新增密钥类配置记得同步加进那个元组,否则它会被当成普通业务参数显示在参数设置页上。
-- 新增纯逻辑一律进 `app/core/`(零外部依赖 + 配套单测);需要连库的编排进 `app/services/`,并保证连库失败时降级而非崩页。ws 通道的协议编解码在 `app/core/ws_codec.py`,改动后**必须先跑通协议 §2.1.1 的测试向量**(`test_batch6_units.py` 的 [A] 组)——规范化串两边写不一致的话,联调只会告诉你"签名验不过",看不出差在哪一段。
-- **关键路径禁止丢弃返回值。** 本系统里大量写入函数失败时不抛异常,只回 `{"ok": False, ...}` 或影响 0 行——`param_store.set_param`、`dispatcher.dispatch/cancel`、`executor.cancel_instruction`、`proposal_service.bump_once_guards`、`portfolio.save_neg_streak`、`qmt_repo.update_order` 都是。**写这类调用时返回值必须接住并处理**,否则写入没发生而调用方照常报成功。`test_batch10_units.py` 的 [A] 组 AST 扫全库守着这条;新加一个软失败函数,记得同时加进它的 `SOFT_FAIL` 名单。
-- 里程碑(设计定稿、建表、各期上线)及时 git 提交。
-- **接手前先读三份**:本文件 → `POSITION_MGMT_DESIGN.md`(V0.4 定稿,**勿改设计**)→ `QMT_WS_PROTOCOL.md`(V1.0 定稿,下发通道的唯一依据)。三份读完即可开工,不需要额外的口头背景。
+工作流程和授权边界统一维护在[AGENTS.md](AGENTS.md),技术限制在[后端目录规则](app/AGENTS.md)及相应子目录中。部署、QMT联调和测试按[开发入口](docs/开发入口.md)选择资料,不在本节重复维护,也不再要求每次通读三份设计文档。
diff --git a/app/AGENTS.md b/app/AGENTS.md
new file mode 100644
index 0000000..6937ad0
--- /dev/null
+++ b/app/AGENTS.md
@@ -0,0 +1,25 @@
+# 后端目录规则
+
+本文件适用于`app/`及其子目录;根目录规则继续适用。
+
+## 分层与契约
+
+- `core/`只放纯逻辑,不接数据库或网络。`repo/`负责单表访问,`services/`编排取数、判断、落表和动作。跨表数据分次读取,在服务层组合。
+- `db/session.py`会拒绝JOIN、逗号连表和跨表子查询。不要绕过守卫;修改upsert时检查`ON DUPLICATE KEY UPDATE`兼容性。
+- `executor`在worker中把委托写入出口表,`ws/runner.py`只负责传输与回报落库,不直接改策略账本。回放服务按委托归属记账,兼顾重复、迟到和部分成交。
+- 业务参数走`services/param_store.py`;`config/settings.py`只是业务初值和基础设施配置。新密钥同时登记`SECRET_KEYS`和相应测试,不进入参数快照。
+- 资金冻结、在途买入、卖出释放及策略划拨使用既有统一占用口径。新增执行路径不能另算一份余额;划拨不是盈利。
+- 关键写入和下发函数可能返回`ok=False`或影响0行而不抛异常,必须检查返回值并处理失败。新软失败函数同步登记`test_batch10_units.py`的`SOFT_FAIL`。
+- 内部股票代码使用Tushare点式,例如`600000.SH`;访问上游时在边界转换。改`core/ws_codec.py`后验证协议签名向量,不能只看连接成功。
+- 修改接口先查对应契约:QMT用[协议](../QMT_WS_PROTOCOL.md),bionic用[接口说明](../BIONIC_PMS_INTERFACE.md),上游选股用[计划接口](../UPSTREAM_PLAN_API.md)。架构定位见[README](../README.md)。
+
+## 数据与时间
+
+- 数据源由`db/session.py`选择,表前缀区分实例。不要硬编码生产前缀,也不要凭旧文档判断某库“当前不用”。
+- 交易日期按北京日期处理。时间戳先核对列类型、写入代码、会话时区及实际读数,不能统一加八小时。容器日志使用北京时间;已核验的`pms_ws_state.heartbeat_at`为北京时间DATETIME原值。
+- 区分数据日期、计算时间、冻结时间和执行日期。修订另存版本,空结果不解释为退出,展示重算结果不冒充历史执行记录。
+- Redis客户端保持`redis` 5.x约束。升级前须验证现网服务端协议兼容性,不能直接放开到默认RESP3的版本。
+
+## 验证入口
+
+后端、DDL、路由或调度变化,按[scripts目录规则](../scripts/AGENTS.md)检查测试桩和哨兵。改`web/`时还要读该目录的规则。临时日志不得输出密钥、完整连接串或登录凭据。
diff --git a/app/web/AGENTS.md b/app/web/AGENTS.md
new file mode 100644
index 0000000..2db34fd
--- /dev/null
+++ b/app/web/AGENTS.md
@@ -0,0 +1,12 @@
+# 页面目录规则
+
+本文件补充`app/AGENTS.md`,适用于`app/web/`。
+
+- 页面是Vue3与ElementPlus直接加载的HTML,无构建步骤。自定义标签必须显式闭合,例如``,不能写成自闭合标签。
+- `setup()`中供模板使用的变量与函数必须在返回值中导出。新增后端枚举要同时维护前端翻译及对应守卫名单。
+- 每次页面修改都跑`test_page_enum_guard.py`、`test_page_wiring_guard.py`、`test_page_copy_guard.py`,经仓库隔离入口执行。布局或交互变化还需浏览器检查相关桌面与窄屏尺寸、控制台、点击和关闭行为。
+- 使用真实只读响应重放页面时,明确这是浏览器复现,不称为真实登录验收。检查展示不得误触发写接口。
+- 用交易员能理解的短句。统一称基本面、技术面、择时,必要说明放悬停;表格操作列在页面内可见,不堆内部实现词。
+- 看多红、看空绿、中性灰、无读数虚框。指标的冷暖阈值柱图沿用现有蓝、金、灰,不把阈值高低强行解释成看多看空。
+- 策略展示为“主观量化”和“微盘轮动”,持仓分别用标签页。数量和阈值来自当前规则,不能把30或50写死;策略详情新标签页打开,不替换当前管理页。
+- 明确区分计划数量、实际委托、受理、成交与入账。没有出口委托不能显示“已下单”,请求失败或旧行情不能显示成正常完成。
diff --git a/docs/开发入口.md b/docs/开发入口.md
new file mode 100644
index 0000000..1bbfa8a
--- /dev/null
+++ b/docs/开发入口.md
@@ -0,0 +1,32 @@
+# 开发资料入口
+
+这里按任务选择资料,不要求每次读完全部文档。长期规则在根目录与各目录的AGENTS.md中,当前状态在阶段接续,操作过程在DEVLOG。`CLAUDE.md`已停止同步维护,保留原样;无需随规则修改一起提交。
+
+## 按任务读取
+
+| 任务 | 入口 |
+| --- | --- |
+| 当前微盘接入、参数和运行待办 | [阶段接续与实验意见](微盘轮动阶段接续_2026-10-28.md);需要部署证据再读[50股发布记录](微盘轮动50股参数发布_2026-10-28.md) |
+| PMS通用迁移与既有修复 | [开发接续](开发接续_2026-10-12.md),按主题查对应节;旧时点未完成项可能已有后续结论 |
+| 架构与接口 | [README模块地图](../README.md)、[总体设计](../POSITION_MGMT_DESIGN.md);改接口再读[QMT协议](../QMT_WS_PROTOCOL.md)、[bionic接口](../BIONIC_PMS_INTERFACE.md)或[计划接口](../UPSTREAM_PLAN_API.md) |
+| 后端、前端、测试、研究 | [后端规则](../app/AGENTS.md)、[页面规则](../app/web/AGENTS.md)、[脚本规则](../scripts/AGENTS.md)、[研究规则](../research/AGENTS.md),仅选择所涉及目录 |
+| 部署与运行核验 | [pms-release](../.agents/skills/pms-release/SKILL.md);命令目录为`make help`,并非所有目标都是只读 |
+| QMT验签、序号、委托与对账问题 | [pms-qmt-diagnose](../.agents/skills/pms-qmt-diagnose/SKILL.md) |
+| 决策原因与历史证据 | [复盘台账](复盘决定台账.md)及[DEVLOG](../DEVLOG.md),按日期、提交或主题搜索 |
+
+## 指令加载机制核对
+
+2026年10月28日核对官方说明,并检查本机CLI版本`0.163.0-alpha.10.2`。本机可见的是打包程序,没有可直接审阅的加载器源码;以下机制依据官方文档,不声称已在新会话验证全部自动加载行为。用户配置未显式覆盖下述目录文件名及大小选项。
+
+- Codex启动时读取全局指令,再沿项目根目录到工作目录读取;每层按`AGENTS.override.md`、`AGENTS.md`、配置的备用名顺序选一个。更深目录的规则在其范围内优先,默认合计上限32KiB。不会递归自动读取所有子目录。因此根文件要求跨目录修改前主动读取适用规则。[官方目录指令](https://learn.chatgpt.com/docs/agent-configuration/agents-md)
+- 项目技能放在`.agents/skills//SKILL.md`。Codex沿工作目录向项目根目录发现技能,先提供名称、简介和路径;任务匹配或显式调用时才读正文,引用资料再按需读取。正文之外的普通Markdown不是自动加载规则。[官方技能机制](https://learn.chatgpt.com/docs/build-skills)
+
+本仓库没有修改全局配置,没有把CLAUDE.md设成备用规则名,也没有创建覆盖文件来屏蔽上层规则。技能只定义流程,不额外授权外部操作。当前会话不会因文件改写而自动撤回已经进入上下文的旧文本;以用户本次要求和新文件为准,新会话再核对实际加载来源。
+
+本机实际调用Codex的`skills/list`只读接口,从仓库根目录和`app/web`两处均发现`pms-release`、`pms-qmt-diagnose`,状态为enabled且无本仓库加载错误。没有启动模型回合或代理任务。此检查证明技能发现有效,不冒充已经执行了发布或排障流程。
+
+## 维护方式
+
+稳定且必须遵守的限制放适用目录的AGENTS.md;部署、联调等跨目录步骤放技能;临时参数、镜像、故障与研究结论放有日期的接续记录。新增入口应解决实际重复工作,不把同一规则复制到多处,不因一次事故堆出全局审批流程。
+
+本次调整只涉及文档与技能,没有改变应用代码、测试程序、部署配置或155运行状态。目录规则、技能格式和本地引用可在开发机检查;没有执行新的部署、QMT探针或真实下单。
diff --git a/docs/开发接续_2026-10-12.md b/docs/开发接续_2026-10-12.md
index aceb0bf..871dd9d 100644
--- a/docs/开发接续_2026-10-12.md
+++ b/docs/开发接续_2026-10-12.md
@@ -86,7 +86,7 @@
Codex 使用仓库中的 `AGENTS.md` 加载项目规则,依据见 [官方项目指令文档](https://learn.chatgpt.com/docs/agent-configuration/agents-md)。本次会话也已实际收到根目录 `AGENTS.md`。以后在新会话中可要求先复述项目三条铁律和当前接续事项,核对读取的是新入口。
-迁移改动目前保存在本地工作区,尚未提交或推送。后续提交必须同时包含 `AGENTS.md` 和 `CLAUDE.md`,以及它们引用的本接续记录,不能只提交兼容入口。业务讨论稿、探针和台账的原有修改应另行安排提交。
+以下为10月12日迁移时的历史要求:迁移改动当时尚未提交或推送,要求同时提交 `AGENTS.md`、`CLAUDE.md` 及本接续记录。该次迁移已经完成。2026年10月28日起用户要求停止同步维护 `CLAUDE.md`,后续无需随规则修改附带提交它;现行入口见[开发资料入口](开发入口.md)。业务讨论稿、探针和台账的原有修改继续保留。
## 六、迁移阶段的验证与后续安排
diff --git a/research/AGENTS.md b/research/AGENTS.md
new file mode 100644
index 0000000..acc0295
--- /dev/null
+++ b/research/AGENTS.md
@@ -0,0 +1,14 @@
+# 历史实验规则
+
+本文件适用于`research/`。研究结果不直接修改运行策略,用户决定上线后另走发布流程。
+
+- 先固定问题、基线、参数范围、样本区间、信号与成交时序、费用及评价指标,再运行。追加试验另存版本,不用新结果倒改原实验口径。
+- 沿用已验证的数据缓存,记录来源、覆盖、修复、缺失与摘要;修改数据后重核受影响基线。保留用户已有研究材料,不把未跟踪数据当垃圾。
+- 所有指标仅使用当时已知数据。历史分布不含当日,滚动窗口按实验约定预热,收盘信号次日执行。资格、历史ST、上市时长、退市覆盖和复权方法明确披露。
+- 将独立微盘绝对收益、相对收益和两策略联合收益分开。缺少主观量化历史持仓或实际筹资时序时,不编造联合收益。
+- 适当检查基线复现、现金与持仓守恒、截断重跑和费用敏感性。新测试走配置隔离及断网入口,不访问运行数据库。
+- 研究账户若用可分割复权单位和统一摩擦,不能宣称已覆盖整手、最低佣金或实际开盘容量;成交约束和退市样本不足写入结论。
+- 同一历史的多个参数组合不是独立样本。少量交易轮次、已经看过的年份及反复选参,不能包装成统计显著或独立样本外验证。
+- 输出协议、可复现代码、数据摘要、结果和局限;研究图检查标注与单位。历史收益改善不证明流动性必然再平衡,也不自动证明参数最优。
+
+当前微盘工作从[阶段接续](../docs/微盘轮动阶段接续_2026-10-28.md)进入,标定和平滑结论在其链接的报告中。研究与线上版本分别记录,避免拿离线提交当部署证据。
diff --git a/scripts/AGENTS.md b/scripts/AGENTS.md
new file mode 100644
index 0000000..da4f5a8
--- /dev/null
+++ b/scripts/AGENTS.md
@@ -0,0 +1,26 @@
+# 测试与运维脚本规则
+
+本文件适用于`scripts/`;其他目录修改代码时,按根规则来此查测试入口。
+
+## 单测隔离
+
+- `run_tests.py`逐批调用`unit_test_guard.py`,清除业务环境变量,在无`.env`的临时目录运行并阻断套接字。只跑一批也必须走同一隔离入口;新增可直接运行的测试沿用现有安装护栏方式。
+- 新增服务调用需补`test_wiring.py`中的`install_fakes`或对应内存桩;真实连接尝试即失败,不能靠业务层吞异常让测试通过。
+- 新增`test_batch*.py`同时登记`run_tests.py`的`SUITES`和例数说明。缺失测试文件必须失败,不能当跳过。
+- DDL、调度、API、密钥、动作求值顺序及仓储签名变化,检查`run_tests.py`顶部哨兵位置清单及实际断言,不照抄历史表数或测试总数。
+- 合并分支时检查测试文件是否重名,不能让一批测试覆盖另一批;缺项不能靠删登记解决。
+
+开发机在安装了项目依赖的独立虚拟环境中、从仓库根目录执行:
+
+```bash
+python scripts/run_tests.py
+python scripts/unit_test_guard.py scripts/test_batch48_units.py
+```
+
+全量预期末行为`ALL SUITES PASS`。单批编号按改动选择,不固定只跑微盘。纯文档修改不要求全量回归。页面三道护栏由全量入口覆盖,也可分别经隔离入口运行。
+
+## 运行脚本
+
+`make help`是命令目录,不能把每个目标都当只读探针。`make test`用于部署服务器,发布前还须对匹配的候选镜像断网验证,步骤见[pms-release](../.agents/skills/pms-release/SKILL.md)。
+
+新脚本应区分只读检查和实际写入,并验证重复执行及失败后的状态。`tick`、回放、建表、清账和重建账本都有业务副作用,不在活跃交易账户上当作普通单测。隔离演练使用独立数据库与前缀,不使用会认领真实成交的shadow路径。历史探针文件和文档中的日期不自动构成今天的执行授权。