tradingSystem/docs/账户资金口径核查_2026-10-26.md

79 lines
8.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 账户总资产与可用资金口径核查
2026-10-26,北京时间。用户提供 16:07 页面截图,账户总资产约 193.63 万元,可用资金约 345.09 万元。本次先在 155 模拟仓只读核查,再在开发机修复和验证。修复 f90d5e7 已于 16:44 部署到 155,运行判收见文末。没有操作 188,没有改动账户或账本记录。
## 真机证据与原因
16:08:45 读取资金快照 seq=1426810,接收时间原值为 2026-10-26 16:07:13。该列由容器 datetime.now() 写入,按北京时间解读。账户值如下。
| 项目 | 金额(元) | 来源 |
| --- | ---: | --- |
| 总资产 | 1,936,261.62 | QMT total_asset |
| 可用余额 | 1,806,071.62 | QMT available_cash |
| 冻结资金 | 0.00 | QMT frozen_cash |
| 账户持仓估值 | 130,190.00 | QMT market_value |
| 卖出回笼统计 | 1,644,823.13 | QMT sell_return_today |
| 页面错误可用值 | 3,450,894.75 | PMS 将可用余额与回笼统计相加 |
账户可用余额加账户持仓估值,恰好等于账户总资产。回笼资金已经体现在可用余额中,PMS 又加一次,造成 1,644,823.13 元重复计入。这是 portfolio.cash_view 的计算错误,不是现金账多写了一笔。该加法来自 2026-07-30 提交 0ab611b,2026-08-06 DEVLOG 已记“有卖出时再核实”的悬项,原单测也把重复加款钉成了正确结果。今天选股切换没有修改这段计算。
同一个 cash_avail 同时用于页面、建仓资金封顶及规则闸,所以不能只改页面减去差额。需要修正统一资金入口,确保买入校验直接使用账户可用余额。不得用“总资产减行情市值”反算现金,也不改运行总规模来掩盖问题。
第二处是估值来源混用。PMS 15:00 收盘分钟行情与 QMT 同时返回的持仓价格如下,数量三票全部一致。
| 股票 | 数量 | PMS 收盘行情 | QMT 持仓价格 | QMT 市值减 PMS 市值 |
| --- | ---: | ---: | ---: | ---: |
| 三花智控 002050.SZ | 1,800 | 34.41 | 32.53 | -3,384.00 |
| 科士达 002518.SZ | 400 | 27.49 | 26.14 | -540.00 |
| 厦钨新能 688778.SH | 1,400 | 37.13 | 43.70 | 9,198.00 |
| 合计 | | | | 5,274.00 |
页面持仓市值 124,916 元来自行情,账户估值 130,190 元来自 QMT。账户总资产继续采用 QMT 报告值,两者放在同一排却没有区分来源,因此去掉重复回笼后仍会差 5,274 元。新收到快照只证明通道新鲜,不能证明 QMT 内部的估值行情已更新;本次未进入 QMT 服务核查其价格生成路径,也不能据此把 QMT 总资产改为 PMS 的估算值。
策略仓位 6.25% 的分母是用户设定的 200 万元,计算为 124,916 / 2,000,000,不是按账户总资产计算。这是既有仓位纪律,不随本次账户显示修复改变。
## 已准备的修复
portfolio.cash_view 直接采用 available_cash,忽略回笼统计对余额的加成;账户市值和冻结资金随同一资金快照透传给总览。顶部前三项统一展示账户总资产、账户可用资金和账户持仓市值,增加来源说明。原仓位标签改为策略仓位,说明分母与估值来源。持仓明细、综合盈亏、组合风控继续使用原行情估值。
修正接口契约中造成误解的说明及不闭合的示例数值。ws_codec 和规则闸注释同步澄清。新增 batch47 九例,覆盖真实异常快照、买不起的单不能靠重复回笼过闸、回笼已在可用余额时可以再投、可用为零、冻结不重复扣、缺项、过期及两套估值互不污染。原 wiring 中的错误断言一并纠正。
开发机运行以下验证,预期为 ALL SUITES PASS,实际 51 批、1174 例通过,含三道页面护栏。浏览器使用独立无登录测试上下文访问本地固定数据预览,1920 与 1280 宽度核对卡片数值、说明和窄栏换行,无页面脚本错误。预览不连接业务服务。
```bash
/tmp/pms-junda-20261026/venv312/bin/python scripts/run_tests.py
```
真机见过的是原因、原始资金和两套估值。修复提交时的线上判收为未判收;当时没有推送或部署新补丁,没有改库、调参或重启服务。部署前需按 AGENTS.md 确认本次服务器操作范围,在 155 使用提交归档构建匹配镜像并断网回归,再于无在途、无待入账回报时 force-recreate 四个 PMS 服务。188 不在本次范围。QMT 内部估值价格与 sell_return_today 的统计期间仍需下游进一步核实,本次修复不依赖这些统计作为可用余额。
## 155 部署与运行判收
用户明确授权后,修复 f90d5e78a0841b3bcdaf9194f32fd5b109757c95 已推送到既有 origin/main 和 codex/account-funds-20261026。部署只涉及 155 模拟仓。没有改运行参数、建表或执行数据修补,没有操作桥或 188。
在 155 的私有临时目录展开 git archive 提交归档,使用现有运行镜像的依赖层重新构建候选镜像。构建替换全部 /app 源码,未混入开发机未提交研究或服务器本地文件。没有依赖变更。以下命令在 155 运行,没有注入业务环境或挂载工作树,预期输出 ALL SUITES PASS,实际完整 51 批、1174 例通过,包含九例资金回归及三道页面护栏。
```bash
# 155 模拟仓服务器。
docker run --rm --network none pms:funds-f90d5e7 python scripts/run_tests.py
```
16:44:05 暂停页面与两个调度进程后再次核对,出口无在途委托、收件箱无待入账回报、QMT 在线、三只持仓数量一致。正式工作树从 e7242f6 快进到 f90d5e7,将已测候选镜像作为运行镜像,使用 docker compose up -d --no-build --force-recreate 重建四个 PMS 服务。四者于北京时间 16:44:06 启动,运行镜像均为 sha256:1ba8087ea579e8fcfd48e842635cc5794b32ddc1b335d05bc17938573cc7f42d,重启计数为零。旧镜像基线、提交归档、运行镜像及已跟踪源码分别核对;新镜像与归档、服务器已跟踪 Python 源码指纹均为 f95d7c112d3f,不以挂载后的指纹一致代替镜像检查。
16:44:37 新代码读取资金快照 seq1427270,接收时间原值为 16:44:10,按容器北京时间解释。总览的现金为 1,806,071.62 元,账户市值为 130,190 元,总资产为 1,936,261.62 元,冻结资金为零,等式闭合。卖出回笼统计仍为 1,644,823.13 元,已不再重复加款。行情估值 124,916 元、策略仓位 6.25%、持仓盈亏 -10,746.80 元均保持原口径。
前后比对 232 项有效运行参数,全部不变。24 行持仓的数量、成本等核对字段,344 行批次账,1270 条成交回报以及资金流水摘要均不变。资金流水表原本为空,本次没有补造记录。QMT 上行水位继续推进,无重同步标记,无在途和待入账回报。四服务启动日志没有 ERROR、CRITICAL 或 Traceback。网页 /health 返回 ok,数据库及交易日历正常,容器健康为 healthy。实际 HTTP 返回的页面文件摘要与提交一致,说明部署后的页面内容已更新;浏览器布局验收使用前文记录的本地隔离预览,本次未使用真实登录会话做浏览器验收。
以下复核命令只在 155 运行,预期健康为 ok,四服务均为 running 且镜像一致、重启计数为零,只读核对脚本正常退出并打印无在途、无待入账和账实数量一致。
```bash
# 155 模拟仓服务器。
curl -fsS http://127.0.0.1:38100/health
docker inspect pms-web pms-worker pms-beat pms-ws --format '{{.Name}} {{.State.Status}} {{.Image}} {{.RestartCount}}'
docker exec -e PYTHONPATH=/app -i pms-web python - < /home/factor/pms_logs/funds-fix-20261026/deploy-check.py
```
运行态判收为真机见过。私有证据留在 /home/factor/pms_logs/funds-fix-20261026,包含断网回归、前后数据摘要、参数摘要、队列核对、实际页面文件及启动日志。服务器原有 deploy.sh 可执行位修改和未跟踪文件保留。回退引用为 codex/pre-funds-20261026,旧镜像为 pms:rollback-before-funds-20261026;如需回退,必须同时恢复相应源码与镜像再重建四服务,不能只换镜像,因为 155 有源码挂载。本次没有执行回退。
尚未判收的是 QMT 估值价格与 PMS 行情相差 5,274 元的上游生成原因,以及其回笼统计的时间范围。新总览统一了账户快照口径,没有把 QMT 估值标成最新行情。此修复没有人为发单,后续自然交易的实际资金拦截行为仍待发生时核对。