仓位上限 {{ pct(ov.portfolio_cap) }}
+
账户持仓市值?
{{ money(ov.account_market_value) }}
+
策略仓位?上限 {{ pct(ov.portfolio_cap) }}
{{ pct(ov.portfolio_pct) }}
持仓综合盈亏?
{{ money(ov.float_pnl) }} {{ ov.float_pnl_pct==null?'':pct(ov.float_pnl_pct) }}
diff --git a/docs/账户资金口径核查_2026-10-26.md b/docs/账户资金口径核查_2026-10-26.md
new file mode 100644
index 0000000..db93a5f
--- /dev/null
+++ b/docs/账户资金口径核查_2026-10-26.md
@@ -0,0 +1,47 @@
+# 账户总资产与可用资金口径核查
+
+2026-10-26,北京时间。用户提供 16:07 页面截图,账户总资产约 193.63 万元,可用资金约 345.09 万元。本次先在 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 的统计期间仍需下游进一步核实,本次修复不依赖这些统计作为可用余额。
diff --git a/scripts/run_tests.py b/scripts/run_tests.py
index 3222c28..fc91018 100644
--- a/scripts/run_tests.py
+++ b/scripts/run_tests.py
@@ -5,6 +5,7 @@
运行: docker compose run --rm pms-web python scripts/run_tests.py
包含 (例数按 2026-10-26 隔离回归实跑校正):
+ test_batch47_units.py 账户资金去重、买入额度与账户展示和策略估值分离 (9 例)
test_batch46_units.py 质地排序切换、档位准入、命令分配与白名单优先 (11 例)
test_batch45_units.py 父指令总量:回放延迟、部分成交、跨日预留、故障守成与影子模式 (16 例)
test_batch43_units.py 逐票来源核验、实际API至SQL事务、故障回滚与幂等 (14 例)
@@ -200,6 +201,7 @@ SUITES = ["test_core_units.py", "test_batch2_units.py", "test_batch3_units.py",
"test_batch38_units.py", "test_batch39_units.py", "test_batch40_units.py", "test_batch41_units.py", "test_batch42_units.py", "test_batch43_units.py", "test_batch44_units.py",
"test_batch45_units.py",
"test_batch46_units.py",
+ "test_batch47_units.py",
"test_page_copy_guard.py",
"test_page_enum_guard.py",
"test_page_wiring_guard.py",
diff --git a/scripts/test_batch47_units.py b/scripts/test_batch47_units.py
new file mode 100644
index 0000000..edd67ab
--- /dev/null
+++ b/scripts/test_batch47_units.py
@@ -0,0 +1,105 @@
+"""账户资金口径:防止回笼重复计入,账户展示与策略估值分开。"""
+import unit_test_guard # noqa: F401
+import os
+import sys
+import unittest
+
+sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+from app.core import rule_gate
+from app.services import portfolio
+from test_wiring import install_fakes
+from test_batch3_units import ctx
+
+
+FUNDS = dict(total_asset=1936261.62, available_cash=1806071.62,
+ frozen_cash=0.0, sell_return_today=1644823.13, market_value=130190.0)
+
+
+class AccountFundsTest(unittest.TestCase):
+ def setUp(self):
+ self.fake = install_fakes(params={'PMS_TOTAL_SCALE': '2000000'})
+
+ def funds(self, **values):
+ data = dict(FUNDS, **values)
+ self.fake.qmt.put_snapshot(kind='funds', data=data)
+ return data
+
+ def gate(self, qty):
+ view = portfolio.positions_view()
+ caps = portfolio.caps_ctx(view, ts_code='600000.SH')
+ return rule_gate.check(side='buy', action='OPEN', qty=qty, price=10,
+ ctx=ctx(caps=caps))
+
+ def test_real_snapshot_sale_stat_does_not_create_extra_cash(self):
+ self.funds()
+ cash = portfolio.cash_view()
+ self.assertEqual(cash['cash_avail'], 1806071.62)
+ self.assertAlmostEqual(cash['cash_avail'] + cash['account_market_value'], cash['total_asset'])
+
+ def test_gate_rejects_order_only_affordable_with_double_count(self):
+ self.funds(available_cash=5000, sell_return_today=10000, total_asset=5000, market_value=0)
+ result = self.gate(1000)
+ self.assertFalse(result['passed'])
+ self.assertTrue(any(x.startswith('INSUFFICIENT_CASH:') for x in result['failed']))
+ self.assertEqual(result['hard_numbers']['cash_avail'], 5000)
+
+ def test_returned_sale_cash_remains_usable_in_reported_balance(self):
+ self.funds(available_cash=12000, sell_return_today=8000, total_asset=12000, market_value=0)
+ result = self.gate(1000)
+ self.assertTrue(result['passed'], result)
+
+ def test_zero_available_is_not_replaced_by_sale_stat(self):
+ self.funds(available_cash=0, sell_return_today=10000, total_asset=10000, frozen_cash=10000, market_value=0)
+ result = self.gate(100)
+ self.assertFalse(result['passed'])
+ self.assertEqual(result['hard_numbers']['cash_avail'], 0)
+
+ def test_frozen_cash_is_not_subtracted_twice(self):
+ self.funds(available_cash=8000, frozen_cash=2000, total_asset=10000, market_value=0)
+ result = self.gate(800)
+ self.assertTrue(result['passed'], result)
+ self.assertEqual(portfolio.overview()['frozen_cash'], 2000)
+
+ def test_missing_available_does_not_infer_cash_from_other_fields(self):
+ self.funds(available_cash=None)
+ cash = portfolio.cash_view()
+ self.assertEqual(cash['source'], 'estimate')
+ self.assertIsNone(cash['cash_avail'])
+ self.assertIsNone(cash['account_market_value'])
+
+ def test_stale_snapshot_does_not_masquerade_as_current_account(self):
+ self.fake.qmt.put_snapshot(kind='funds', data=FUNDS, age_sec=901)
+ result = portfolio.overview()
+ self.assertEqual(result['cash_source'], 'estimate')
+ for key in ('cash_avail', 'total_asset', 'account_market_value', 'frozen_cash'):
+ self.assertIsNone(result[key])
+
+ def test_account_display_does_not_change_strategy_valuation(self):
+ self.fake = install_fakes(prices={'002050.SZ': 34.41, '002518.SZ': 27.49, '688778.SH': 37.13},
+ positions=[{'ts_code': '002050.SZ', 'total_qty': 1800, 'avg_cost': 36.697},
+ {'ts_code': '002518.SZ', 'total_qty': 400, 'avg_cost': 27.549},
+ {'ts_code': '688778.SH', 'total_qty': 1400, 'avg_cost': 41.849}],
+ params={'PMS_TOTAL_SCALE': '2000000'})
+ self.funds()
+ result = portfolio.overview()
+ self.assertEqual(result['account_market_value'], 130190)
+ self.assertEqual(result['portfolio_mv'], 124916)
+ self.assertEqual(result['portfolio_pct'], 0.0625)
+ self.assertEqual(result['float_pnl'], -10746.8)
+ caps = portfolio.caps_ctx(portfolio.positions_view())
+ self.assertEqual(caps['portfolio_mv'], 124916)
+ self.assertEqual(caps['cash_avail'], 1806071.62)
+
+ def test_missing_account_value_is_not_replaced_by_market_estimate(self):
+ self.fake = install_fakes(prices={'600000.SH': 10}, positions=[
+ {'ts_code': '600000.SH', 'total_qty': 100, 'avg_cost': 8}])
+ self.funds(market_value=None, frozen_cash=None)
+ result = portfolio.overview()
+ self.assertIsNone(result['account_market_value'])
+ self.assertIsNone(result['frozen_cash'])
+ self.assertEqual(result['portfolio_mv'], 1000)
+ self.assertEqual(result['cash_avail'], 1806071.62)
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/scripts/test_wiring.py b/scripts/test_wiring.py
index 3f59af4..b17abf9 100644
--- a/scripts/test_wiring.py
+++ b/scripts/test_wiring.py
@@ -1449,7 +1449,7 @@ def _():
assert fake.instructions["INS_A2"]["status"] == "EXPIRED"
-@case("组合快照·真钱取 ws 资金快照(含当日回笼); 取不到则标明是估的")
+@case("组合快照·真钱取 ws 可用余额,不重复加回笼;取不到则标明是估的")
def _():
from app.services import portfolio
fake = install_fakes(prices={"600000.SH": 10.0}, params={"PMS_TOTAL_SCALE": "2000000"})
@@ -1463,10 +1463,10 @@ def _():
v = portfolio.positions_view()
t = v["totals"]
assert t["cash_source"] == "ws", t
- # 当日卖出回笼 T+0 可用, 必须算进去 —— 不算就把"卖一只买另一只"判成资金不足
- assert t["cash_avail"] == round(971251.56 + 48900.0, 2), t
+ # available_cash 已含可用回笼,统计字段不再相加。
+ assert t["cash_avail"] == 971251.56, t
assert t["total_asset"] == 981448.56, t
- # 这一行是整件事的由来: 按 scale 估出来 200 万, 账户真钱只有 102 万, 差着一倍
+ # 按 scale 估出来 200 万,账户真钱只有约 97 万,两者不能混用。
assert t["cash_est"] > t["cash_avail"], (t["cash_est"], t["cash_avail"])
# caps_ctx 要把真钱与来源一起带给规则闸, 否则闸门只能降级
caps = portfolio.caps_ctx(v, ts_code="600000.SH")