diff --git a/AGENTS.md b/AGENTS.md index 1afb49d..50d9de8 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -24,6 +24,20 @@ 3. 按影响范围验证。单测必须隔离配置、禁止联网;部署前用候选镜像完成断网回归。页面改动跑三道护栏,布局与交互另做浏览器验收。纯文档修改检查内容和链接即可。 4. 在开发机修改,经Git提交后部署,提交说明用简短中文。交付说明改动、验证机器、实际结果和未完成事项。重要节点追加`DEVLOG.md`;当前状态写接续记录,注明核验时间。历史回执不等于当前健康,本地通过不等于真机判收。 +## 使用 GPT-6.2 协作 + +- 先明确谁要完成什么操作、成功时能看到什么结果。分别核实用户描述的现象和建议的做法。若证据指向另一个问题,说明它如何导致当前现象,以及解决它能恢复什么能力。 +- 出方案前先查仓库和已确认的决定。业务目标、交易边界或界面偏好有多种合理解释,且答案会改变方案时,集中问清关键取舍。可逆的实现细节按现有惯例推进,交付时说明影响结果的假设。 +- 简单改动直接沿现有入口完成。跨策略、账本或系统的改动先从业务事实推导约束,追到最早失效点。再推演对其他调用方、交易员下一步操作和长期维护的影响。复杂取舍可借鉴其他领域的成熟办法,例如借用会计逐笔对账的做法核对委托、成交与现金流水,说明这个办法在什么条件下成立。 +- 选定复杂方案前,找出最能推翻它的反例,与至少一种可行做法比较。用实际入口验证关键边界,例如撤单后晚到成交、数据恢复时旧缓存仍生效。查提交、改文案可用轻量推理,涉及交易授权、资金归属或架构取舍时深入推演。遵循会话指定的模型,交付时写清决定方案的证据和待验证的判断。 + +## 架构、交接与定期复盘 + +- 接手项目、调整架构或清理旧逻辑时,从现用分支、引入行为的提交、相关 PR 和决定台账追到当前调用方。区分有意保留的职责、兼容旧记录的路径和已经失效的前提。提议删除时列出调用方、在手数据、回放及回退依赖的核验结果。 +- 从新工程师要办的第一件事出发检查命名与职责。找出让人反复跨文件寻找同一判断、或用一个词指多个业务阶段的位置,给出具体简化办法及须保留的行为。 +- 按月复盘,用户指定窗口时按其窗口。同类问题复发时及时补记。查窗口内全部 PR,按创建、首次评审、修订和合并时刻定位最慢的几项,再从讨论或检查记录核实等待原因。注明缺失的时间点。没有 PR 时直接报告,用提交和回执复盘实际工作。 +- 将缺陷、需求变化、候选返修、实际回滚和重复补丁分开,追问同一约束为何多次失守。可机器判定的共因优先补隔离回归或检查,稳定约束写到适用目录,多步取证复用已有技能。用原故障反例检验预防措施,下次复盘检查是否复发。 + ## 故障修复与防止返工 - 修复前先写清违反的业务约束、规则来源和适用范围。错误实现不能成为新规则;补一个限制时,同时核对原来允许的动作仍然可达。 diff --git a/DEVLOG.md b/DEVLOG.md index 54c594e..e960ca4 100644 --- a/DEVLOG.md +++ b/DEVLOG.md @@ -3320,3 +3320,9 @@ a44c994于10:53:29仅发布155的web,镜像pms:proposal-copy-a44c994。开发 候选修复在入队及实际发送前拦截当日旧单已报撤销或过期后同股同向换编号重报,不把拦截当作成交已核对;不因普通价差撤换已发委托。新微盘建仓委托有效至北京时间当日15:00,若用户授权更早结束则以较早时间为准。保留暂停、移出名单等撤单路径。累计盈亏优先用有效券商资产与既有净投入,仍提示策略账本待核对。不追改旧委托或账本、不操作188,155尚未部署候选修复。 开发机91组隔离禁网回归通过,包括页面三道护栏、跨父指令的实际发送前拦截、旧委托与新委托的日期边界、微盘收盘有效期和券商资产盈亏回归。未做候选镜像和真机验收;恢复自动建仓前,需核对券商原始委托与成交并完成账实对账。 + +## 2026-11-20 换机同步与项目规则核对 + +开发机按 11 月 19 日换机接续切至 `codex/pms-order-pnl-fix`。检查近两周的 112 个远端提交、Gitea 全部状态 PR 列表及实际跟踪的五份 AGENTS、三个项目技能。具体分支差异、11 月 19 日盘后对账结果与历史包袱见[系统功能与规则接续](docs/系统功能与规则接续_2026-11-20.md)。 + +补齐 GPT-6.2 协作、架构交接和月度复盘约定,同步并行分支的一条后端授权规则。按用户决定,首次新建页面时再安装指定设计技能。开发机核对文档链接、提交引用与规则差异,本次没有改动交易程序或部署服务。 diff --git a/app/AGENTS.md b/app/AGENTS.md index 6937ad0..704b866 100644 --- a/app/AGENTS.md +++ b/app/AGENTS.md @@ -10,6 +10,7 @@ - 业务参数走`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)。 diff --git a/app/web/AGENTS.md b/app/web/AGENTS.md index 5649309..60d0f6f 100644 --- a/app/web/AGENTS.md +++ b/app/web/AGENTS.md @@ -8,6 +8,7 @@ - 使用真实只读响应重放页面时,明确这是浏览器复现,不称为真实登录验收。检查展示不得误触发写接口。 - 用交易员能理解的短句。统一称基本面、技术面、择时,必要说明放悬停;表格操作列在页面内可见,不堆内部实现词。 - 后续页面修改沿用现有布局、字号、间距、配色、组件和交互习惯。新增信息优先融入原有区域,不另起一套视觉样式;整体改版以用户明确要求为准。 +- 新建页面先检查项目的 `.agents/skills/landing-page-design/SKILL.md`,缺少时从仓库根目录运行 `npx skills add elayadesign/ai-design-skills --skill landing-page-design -a codex` 安装到项目。用它梳理主操作、信息层级与留白,以相邻交易页面作为视觉和交互样板。营销首屏、转化文案及品牌配色仅适用于相应业务场景。验收时并排查看新旧页面,确认简洁、美观且交易操作易找。[设计技能来源](https://github.com/elayadesign/ai-design-skills) - 信号流按已确认原型保持完整单行,顺序为时间、持仓或关注标签、可点击股票名称、原信号系统名称、原信号短内容、原级别。保留“决策系统”“资金分布”等用户可理解的现有名称,不改为内部项目名。持仓标签优先,关注与持仓共用现有信号入口、排序、上限和分类,不另设关注区;无真实信号不占行。研究观察、每日完成、等待和超时均留在原个股详情,不生成信号行。不增加原始读数、长理由、行内折叠或展开按钮;原有效期和其他信号规则保持。 - 看多红、看空绿、中性灰、无读数虚框。指标的冷暖阈值柱图沿用现有蓝、金、灰,不把阈值高低强行解释成看多看空。 - 宽基信号行不加“宽基”“15分”“日内”等前置标签,保留“宽基观测”来源、信号短内容和级别;观察范围留在悬停或详情中。宽基名称按跟踪指数显示固定类别简称,不显示基金公司,不从全名删词猜测;同类产品不合并信号,点击仍查看对应基金全名和代码,不增加名称悬停。普通股票的持仓、关注和计划标签保持原规则。 diff --git a/docs/开发入口.md b/docs/开发入口.md index a121fad..f5491b6 100644 --- a/docs/开发入口.md +++ b/docs/开发入口.md @@ -1,5 +1,7 @@ # 开发资料入口 +11 月 20 日换机从[系统功能、近两周提交与规则核对](系统功能与规则接续_2026-11-20.md)开始。当前交接线为 `codex/pms-order-pnl-fix`。最近的 155 发布、补账与自然验收待办见[11 月 19 日回执](155模拟仓重复成交与导出验收_2026-11-19.md)。下方各专题保留当时的核验结果。 + 11月18日13:09最新:[资金提示的预期延迟与故障区分](资金提示预期延迟与故障区分_2026-11-18.md)。本次为午休新增603087尚待接入被误报,原池实时资金正常;午后首轮13:00不在基线有效窗口,13:03六路自然计算完成。13:08:30仅发布155 web与worker的cac3ba3,开发机90组、两候选89/87组断网通过;13:09确认原始登记时间自然传递,15只优先股正常、提示为空、账本正常。其他来源仍按各自发布周期核验。 11月18日10:35最新:[关注持仓信号过滤核验](关注持仓信号过滤核验_2026-11-18.md)。PMS未按名单身份过滤资金或股价类别,125组实际页面计算函数回放一致;14只均有ITD及MTF资金计算证据。果麦文化盘中跌11.82%但独立股价生产者未发布,历史同版本有301股票跌约8%的提醒,生产者代码、名单与去重仍待定位,尚未修复。不能以资金恢复代替股价提醒验收。 diff --git a/docs/系统功能与规则接续_2026-11-20.md b/docs/系统功能与规则接续_2026-11-20.md new file mode 100644 index 0000000..3f2bc78 --- /dev/null +++ b/docs/系统功能与规则接续_2026-11-20.md @@ -0,0 +1,39 @@ +# 系统功能、近两周提交与规则核对 + +2026 年 11 月 20 日 09:20(北京时间),在开发机抓取项目远端并核对 Gitea。换机前本地停在 `372e350`,按 11 月 19 日交接切到 `codex/pms-order-pnl-fix` 的 `1fd640b`,包含原工作线之后的 43 个提交。远端 `main` 仍为 10 月 26 日的 `27cd570`。本次只在开发机核验,以下运行结果均注明其实际发生日期。 + +## 从交易员的任务进入代码 + +| 要做的事 | 入口与职责 | +| --- | --- | +| 判断一只股票能否建仓 | 上游计划、人工关注和已有持仓各有资格条件。PMS 汇集基本面、技术面和择时,向 bionic 取研判,结合用户命令及预算形成提议。当前依据、采纳后能否执行、当时为何决定分别留痕。[提议服务](../app/services/proposal_service.py) | +| 管理主观量化与微盘轮动 | 两个策略各记本金、现金与持仓。主观量化支持分批建仓、网格和退出纪律。微盘按版本化篮子轮动,盘中单次授权有独立的有效期与撤销条件。[策略执行](../app/services/strategy_runner.py) · [微盘执行](../app/services/rotation_execution.py) | +| 跟踪一笔交易,核对数量和资金 | PMS 登记命令、父指令和子委托,worker 将委托入队,唯一的 QMT 连接发送并收取回报。实际成交按原委托和策略入账。页面可分别查看交易进度、账户累计盈亏和策略持仓,也可导出。[委托执行](../app/services/execution_orders.py) · [成交更正](../app/services/trade_correction.py) · [账户导出](../app/services/publish_export.py) | +| 观察市场和持仓风险 | 持仓与关注股票进入信号监测,宽基页面展示日度资金、当日分时和正式发布的信号。ETF 观测只供查看。逐路核验资格、计算和发布可以区分数据异常与当时未触发。[信号服务](../app/services/signal_service.py) · [宽基观测](../app/services/etf_observation.py) | + +## 两周内发生的变化 + +按北京时间 11 月 7 日至 20 日取全部远端分支,核验时共有 112 个不同的提交对象。105 个在换机分支,另 7 个只在同期并行的 `codex/trading-rule-alignment-20261118`。Gitea 仓库的全部状态 PR 接口返回空列表,计数为 0,Git 同期也无合并提交。评审等待和最慢 PR 均无可排名的样本。[仓库 PR](http://192.168.18.24:3000/zlt/tradingSystem/pulls) + +| 时间 | 对交易和使用的影响 | +| --- | --- | +| 11 月 9 至 10 日 | 总览区分账户累计盈亏与策略持仓盈亏。网格按真实成交批次续卖余量;随后修正负净成本的收益及人工关注入池、择时恢复。代表提交 `2d673b0`、`6fddc50`。 | +| 11 月 11 至 13 日 | 三组独立证据合成择时,人工关注取得独立的监测资格。提议摘要和详情统一当前分析,保留决策当时的依据。宽基增加当日分时查询、方向图与指数简称。代表提交 `9dbdd84`、`e4a77bf`、`71f8278`、`9bb5ef1`、`975fa5a`。 | +| 11 月 16 至 18 日 | 纠正把单次试探预算扩大成整轮禁买的实现,衔接人工止损,修复技术读数保存。资金监测按逐股、逐来源检查,区分午休新增名单的正常等待和真实故障;故障技能与业务证据检查入库。代表提交 `35838b8`、`28abddf`、`1cad2b3`、`cac3ba3`。 | +| 11 月 18 至 19 日,并行分支 | `06cfb0a`、`165d252` 涉及逐票授权、持仓接管和最终买入出口的禁令。该线还留下候选 worker 的 92 组中 2 组未通过及其后当日父指令的回执。与换机线共同祖先为 `4b34f42`。本次只同步其中一条后端工作规则。[分支接续](http://192.168.18.24:3000/zlt/tradingSystem/src/branch/codex/trading-rule-alignment-20261118/docs/交易规则修复与历史复盘_2026-11-18.md) | +| 11 月 19 日,换机分支 | 微盘支持当日独立授权、保护限价和撤销,两个页面共用指标和逐笔进展。随后恢复账户累计盈亏展示,在入队与发送前拦截重复下单,并核对晚到成交。16:58 后完成补账,17:00 的历史回执显示 50 只持仓及账户现金差额均为零。QMT 工作台补记的上游原因和下一交易时段自然防重仍需各自的证据。[原始验收与待办](155模拟仓重复成交与导出验收_2026-11-19.md) | + +## 架构取舍与返工 + +- **有意保留的边界。** 从 7 月的命令与方案骨架 `b3fdb4a`、QMT 接入 `c4833ba`,到 10 月分策略轮动 `e13740e`、11 月成交更正 `f756344`,交易指令和实际成交始终需要独立追溯。11 月 19 日旧单先报撤销或过期,后来同一券商委托号出现补记成交。PMS 必须同时保住授权上限和真实账本。这也是保留父指令、多次委托尝试和独立成交编号的理由。[成交证据](155模拟仓重复成交与导出验收_2026-11-19.md) +- **两次返工指向同一个验收缺口。** 试探预算曾把后续独立审批的合法动作一并拦住;补账时 14 笔晚到买入核平了股数,账户现金仍差 3,037 元,最后定位到两组已平仓卖出。前者需同时验证拒绝与放行,后者需按原委托分别核数量、价格与现金。补账记录里首次尝试的事务回滚有明确证据;这个回滚不能计为生产版本回滚。[试探预算纠正](建平仓规则对齐与人工止损验收_2026-11-16.md) · [补账回执](155模拟仓重复成交与导出验收_2026-11-19.md) +- **交接时最容易找错的位置。** 微盘的“等待”可能发生在父指令复核、QMT 受理或成交入账三个阶段。`rotation_display.wait_text` 仍靠匹配原因文字翻译部分状态,改一处执行文案可能改变两个页面的展示。后续改动可由执行方返回已有业务阶段和原因码,展示层统一翻译;迁移时用旧记录回放,保留无法识别原因的处理。[展示实现](../app/services/rotation_display.py) +- **可清理的旧入口。** 8 月的静态首页备份仅被当时的改版文档引用。当前首页路由加载 `index.html`,但整个静态目录对外提供文件,旧文档还给出直接覆盖首页的回退命令。可先将该说明标为历史,并核查是否还有外部书签或回退依赖,再把备份移出运行目录,历史版本仍可从 Git 取回。[旧回退说明](../UI_TRADER_V2_PLAN.md) · [当前页面路由](../app/web/main.py) + +## 规则和技能是否入库 + +10 月 28 日的 `e337df6` 提交了分目录规则、发布和 QMT 排障两项技能;11 月 12 日的 `5f41c86` 确立了交易员视角;11 月 18 日的 `1cad2b3` 新增故障复盘技能和历史反例;11 月 19 日的 `00f72df` 补充了交易进度和同类页面一致性。同步前换机分支有五份 AGENTS 文件、三个项目技能,缺少成套的 GPT-6.2 协作、架构交接、PR 效率复盘和新页面设计技能安装约定。 + +本次将通用约定写入[根规则](../AGENTS.md),并将并行分支已有的跨入口授权规则同步到[后端规则](../app/AGENTS.md)。复盘沿用现有[故障技能](../.agents/skills/pms-incident-review/SKILL.md)和[月度复盘](月度故障与返工根因复盘_2026-11-18.md)。GPT-6.2 的提问、按风险投入推理和验证要求均作为开发协作习惯,不改变 bionic 的研判模型或生产配置。[OpenAI 模型使用指南](https://developers.openai.com/api/docs/guides/latest-model) + +新页面按[页面目录规则](../app/web/AGENTS.md)在首次开发时安装指定设计技能;本次仅登记安装方式,仓库仍保留三个 PMS 技能。页面沿用现有交易界面的布局、密度、颜色与交互。[上游安装说明](https://github.com/elayadesign/ai-design-skills)