xtquant-share 1.4.1__tar.gz → 1.4.2__tar.gz

{xtquant_share-1.4.1 → xtquant_share-1.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xtquant-share
-Version: 1.4.1
+Version: 1.4.2
 Summary: Xtreme Quant Share - eXtreme transparent sharing proxy for XtQuant on macOS/Linux
 Author-email: Jason Hu <63170682@qq.com>
 License-Expression: GPL-3.0-only
@@ -53,6 +53,7 @@ Dynamic: license-file
 - ✅ **服务实例标识** - `get_instance_id()` 轻量感知 server 重启；行情订阅幂等自动去重，阻断底层 miniquote 订阅累积
 - ✅ **异步回调** - 支持交易事件（on_stock_*）与行情 tick 订阅回调（`xtdata.register_quote_callback` + `subscribe_whole_quote`）
 - ✅ **无感切换** - 大QMT ↔ miniQMT 无感切换（行情侧），自动探测 miniQMT 可用性，不可用自动切 bigqmt 通道（复用 xtquant_big_convert）
+- ✅ **资产兜底** - 大QMT 日志资金心跳 → 总资产/可用/市值/负债（miniQMT 独立交易不可用时仍能读资产）
 - ✅ **完整日志** - API调用日志，记录函数名、参数、耗时
 - ✅ **零学习成本** - 无需记忆新 API
 
@@ -111,7 +112,7 @@ python -m xqshare.server
 ### 客户端快速测试
 
 ```bash
-export XQSHARE_REMOTE_HOST="21.214.136.216"
+export XQSHARE_REMOTE_HOST="203.0.113.10"
 xtdata get_stock_list_in_sector --sector-name "沪深A股" --limit 10
 ```
 
@@ -201,7 +202,7 @@ xttrader  order_cancel --order-id 1082130745
 **推荐：使用环境变量配置（避免敏感信息泄露）**
 ```bash
 # 设置环境变量
-export XQSHARE_REMOTE_HOST="21.214.136.216"
+export XQSHARE_REMOTE_HOST="203.0.113.10"
 export XQSHARE_CLIENT_SECRET="your-secret"
 
 # 获取股票列表
@@ -233,10 +234,10 @@ python examples/query_positions.py
 **备选：命令行参数（覆盖环境变量）:**
 ```bash
 # 显式指定服务端地址
-python examples/get_stock_list.py --host 21.214.136.216 --sector "沪深300"
+python examples/get_stock_list.py --host 203.0.113.10 --sector "沪深300"
 
 # 显式指定认证密钥
-python examples/get_tick_data.py --host 21.214.136.216 --secret "your-secret" --codes "000001.SZ"
+python examples/get_tick_data.py --host 203.0.113.10 --secret "your-secret" --codes "000001.SZ"
 
 # 查看帮助
 python examples/get_stock_list.py --help
@@ -250,11 +251,11 @@ python examples/get_stock_list.py --help
 from xqshare import XtQuantRemote, connect, disconnect, xtdata, xttrader, xttype
 
 # 方式1：类实例（推荐）
-with XtQuantRemote("21.214.136.216", client_secret="xxx") as xt:
+with XtQuantRemote("203.0.113.10", client_secret="xxx") as xt:
     stocks = xt.xtdata.get_stock_list_in_sector("沪深A股")
 
 # 方式2：全局便捷函数
-connect(host="21.214.136.216", client_secret="xxx")
+connect(host="203.0.113.10", client_secret="xxx")
 stocks = xtdata.get_stock_list_in_sector("沪深A股")
 disconnect()
 ```
@@ -263,6 +264,7 @@ disconnect()
 - `xt.xtdata` - 行情数据模块
 - `xt.xttype` - 类型定义模块（StockAccount 等）
 - `xt.datadir` - QMT datadir 文件解析模块（无需 miniQMT 进程）
+- `xt.assetlog` / `xt.get_asset()` - 大QMT 日志资金心跳 → 资产快照（trader 不可用时的兜底）
 - `xt.create_trader()` - 创建交易实例（需自行 connect）
 - `xt.create_trader_and_connect()` - 创建交易实例并等待真实连接建立（推荐用于下单）
 
@@ -302,7 +304,7 @@ QMT_DATADIR_PATH=D:\国金证券QMT交易端\datadir
 ```python
 from xqshare import XtQuantRemote
 
-with XtQuantRemote("21.214.136.216", client_secret="my-secret") as xt:
+with XtQuantRemote("203.0.113.10", client_secret="my-secret") as xt:
     # 读取 K 线数据（直接解析 .DAT 文件，无需 miniQMT 进程）
     df = xt.datadir.kline("600000.SH", "1d")
     print(df.tail())
@@ -338,7 +340,7 @@ with XtQuantRemote("21.214.136.216", client_secret="my-secret") as xt:
 ```python
 import xqshare
 
-xqshare.connect(host="21.214.136.216", client_secret="my-secret")
+xqshare.connect(host="203.0.113.10", client_secret="my-secret")
 
 # 与 xqshare.xtdata 用法完全对称
 df = xqshare.datadir.kline("600000.SH", "1d")
@@ -368,12 +370,58 @@ RuntimeError: datadir 不可用：未配置 QMT_DATADIR_PATH 且无法自动推
 
 ---
 
+## assetlog：日志资金心跳 → 资产
+
+miniQMT / 独立交易模式被券商关闭后，`xttrader.query_stock_asset` 会报「交易服务端未启动」。但大QMT 客户端登录后，每 3~12 秒会往 `<QMT>/userdata/log/XtClient_YYYYMMDD.log` 写一条资金心跳：
+
+```
+2026-11-09 17:12:11,309 [INFO] ... [calc] update fund [2_10039_1000_<ACCOUNT>] bal 138879.92 avai 55757.92 debt 0.00 mv 83122.00
+```
+
+`xqshare.assetlog` 增量 tail 这个文件，给出总资产 / 可用资金 / 市值 / 负债。
+
+### Server 端配置（Windows）
+
+```ini
+# 日志目录（可选）：不配则按 QMT_USERDATA_PATH 推断为 <QMT安装>/userdata/log
+QMT_LOG_DIR=C:\Install\pazq_qmt\pazq_qmt_2.0.8.0\userdata\log
+
+# 判为过期的阈值（秒），默认 60
+QMT_ASSETLOG_STALE_S=60
+```
+
+### Client 端使用
+
+```python
+from xqshare import XtQuantRemote
+
+with XtQuantRemote("203.0.113.10", client_secret="my-secret") as xt:
+    snap = xt.get_asset("<ACCOUNT_ID>")   # 或 xt.assetlog.get_asset(...)
+    print(snap["total_asset"], snap["cash"], snap["market_value"], snap["stale"])
+    # 138879.92 55757.92 83122.0 False
+```
+
+> ⚠️ 这是**推送快照**，不是查询接口：断线就停，返回值带 `as_of` / `age_s` / `stale`，用之前先看新鲜度。
+
+### 能力边界
+
+| 项 | 是否支持 | 说明 |
+|----|---------|------|
+| 总资产 / 可用 / 市值 / 负债 | ✅ | 心跳里直接有 |
+| 持仓明细 | ❌ | 日志没有逐票数量与成本 |
+| 冻结资金 | ❌ | `accountdetail` 行的 marketvalue 是 DBL_MAX，整行不可信 |
+| 即时查询 | ❌ | 只有 3~12 秒的推送节拍 |
+
+详细字段与异常说明见 [doc/xqshare-api.md](doc/xqshare-api.md#8-assetlog-模块-api)。
+
+---
+
 ## 使用示例
 
 ```python
 from xqshare import XtQuantRemote
 
-with XtQuantRemote("21.214.136.216", client_secret="my-secret") as xt:
+with XtQuantRemote("203.0.113.10", client_secret="my-secret") as xt:
     # 获取股票列表
     stocks = xt.xtdata.get_stock_list_in_sector("沪深A股")
     print(f"股票数量: {len(stocks)}")
@@ -396,7 +444,7 @@ with XtQuantRemote("21.214.136.216", client_secret="my-secret") as xt:
 ```python
 from xqshare import XtQuantRemote
 
-with XtQuantRemote("21.214.136.216", client_secret="my-secret") as xt:
+with XtQuantRemote("203.0.113.10", client_secret="my-secret") as xt:
     # 创建交易实例并等待真实连接建立（推荐）
     # userdata_path 可通过环境变量 QMT_USERDATA_PATH 配置
     trader = xt.create_trader_and_connect("C:\\QMT\\userdata_mini")
@@ -478,7 +526,7 @@ logs/client_20260228.log
 **客户端也会记录调用：**
 ```python
 # 设置日志级别
-xt = XtQuantRemote("21.214.136.216", log_level="DEBUG")
+xt = XtQuantRemote("203.0.113.10", log_level="DEBUG")
 ```
 
 客户端日志示例：
@@ -590,7 +638,7 @@ python -m xqshare.server --ssl --cert server.crt --key server.key
 
 ```python
 xt = XtQuantRemote(
-    host="21.214.136.216",
+    host="203.0.113.10",
     use_ssl=True,
     ssl_verify=False  # 自签名证书需禁用验证
 )
@@ -608,7 +656,7 @@ xt = XtQuantRemote(
 
 ```python
 xt = XtQuantRemote(
-    host="21.214.136.216",
+    host="203.0.113.10",
     auto_reconnect=True,
     max_retries=10,
     heartbeat_interval=15,
@@ -779,8 +827,8 @@ tail -f logs/client_*.log
 
 ```bash
 # 检查网络
-ping 21.214.136.216
-telnet 21.214.136.216 18812
+ping 203.0.113.10
+telnet 203.0.113.10 18812
 ```
 
 ### 查看服务状态

{xtquant_share-1.4.1 → xtquant_share-1.4.2}/README.md

@@ -11,6 +11,7 @@
 - ✅ **服务实例标识** - `get_instance_id()` 轻量感知 server 重启；行情订阅幂等自动去重，阻断底层 miniquote 订阅累积
 - ✅ **异步回调** - 支持交易事件（on_stock_*）与行情 tick 订阅回调（`xtdata.register_quote_callback` + `subscribe_whole_quote`）
 - ✅ **无感切换** - 大QMT ↔ miniQMT 无感切换（行情侧），自动探测 miniQMT 可用性，不可用自动切 bigqmt 通道（复用 xtquant_big_convert）
+- ✅ **资产兜底** - 大QMT 日志资金心跳 → 总资产/可用/市值/负债（miniQMT 独立交易不可用时仍能读资产）
 - ✅ **完整日志** - API调用日志，记录函数名、参数、耗时
 - ✅ **零学习成本** - 无需记忆新 API
 
@@ -69,7 +70,7 @@ python -m xqshare.server
 ### 客户端快速测试
 
 ```bash
-export XQSHARE_REMOTE_HOST="21.214.136.216"
+export XQSHARE_REMOTE_HOST="203.0.113.10"
 xtdata get_stock_list_in_sector --sector-name "沪深A股" --limit 10
 ```
 
@@ -159,7 +160,7 @@ xttrader  order_cancel --order-id 1082130745
 **推荐：使用环境变量配置（避免敏感信息泄露）**
 ```bash
 # 设置环境变量
-export XQSHARE_REMOTE_HOST="21.214.136.216"
+export XQSHARE_REMOTE_HOST="203.0.113.10"
 export XQSHARE_CLIENT_SECRET="your-secret"
 
 # 获取股票列表
@@ -191,10 +192,10 @@ python examples/query_positions.py
 **备选：命令行参数（覆盖环境变量）:**
 ```bash
 # 显式指定服务端地址
-python examples/get_stock_list.py --host 21.214.136.216 --sector "沪深300"
+python examples/get_stock_list.py --host 203.0.113.10 --sector "沪深300"
 
 # 显式指定认证密钥
-python examples/get_tick_data.py --host 21.214.136.216 --secret "your-secret" --codes "000001.SZ"
+python examples/get_tick_data.py --host 203.0.113.10 --secret "your-secret" --codes "000001.SZ"
 
 # 查看帮助
 python examples/get_stock_list.py --help
@@ -208,11 +209,11 @@ python examples/get_stock_list.py --help
 from xqshare import XtQuantRemote, connect, disconnect, xtdata, xttrader, xttype
 
 # 方式1：类实例（推荐）
-with XtQuantRemote("21.214.136.216", client_secret="xxx") as xt:
+with XtQuantRemote("203.0.113.10", client_secret="xxx") as xt:
     stocks = xt.xtdata.get_stock_list_in_sector("沪深A股")
 
 # 方式2：全局便捷函数
-connect(host="21.214.136.216", client_secret="xxx")
+connect(host="203.0.113.10", client_secret="xxx")
 stocks = xtdata.get_stock_list_in_sector("沪深A股")
 disconnect()
 ```
@@ -221,6 +222,7 @@ disconnect()
 - `xt.xtdata` - 行情数据模块
 - `xt.xttype` - 类型定义模块（StockAccount 等）
 - `xt.datadir` - QMT datadir 文件解析模块（无需 miniQMT 进程）
+- `xt.assetlog` / `xt.get_asset()` - 大QMT 日志资金心跳 → 资产快照（trader 不可用时的兜底）
 - `xt.create_trader()` - 创建交易实例（需自行 connect）
 - `xt.create_trader_and_connect()` - 创建交易实例并等待真实连接建立（推荐用于下单）
 
@@ -260,7 +262,7 @@ QMT_DATADIR_PATH=D:\国金证券QMT交易端\datadir
 ```python
 from xqshare import XtQuantRemote
 
-with XtQuantRemote("21.214.136.216", client_secret="my-secret") as xt:
+with XtQuantRemote("203.0.113.10", client_secret="my-secret") as xt:
     # 读取 K 线数据（直接解析 .DAT 文件，无需 miniQMT 进程）
     df = xt.datadir.kline("600000.SH", "1d")
     print(df.tail())
@@ -296,7 +298,7 @@ with XtQuantRemote("21.214.136.216", client_secret="my-secret") as xt:
 ```python
 import xqshare
 
-xqshare.connect(host="21.214.136.216", client_secret="my-secret")
+xqshare.connect(host="203.0.113.10", client_secret="my-secret")
 
 # 与 xqshare.xtdata 用法完全对称
 df = xqshare.datadir.kline("600000.SH", "1d")
@@ -326,12 +328,58 @@ RuntimeError: datadir 不可用：未配置 QMT_DATADIR_PATH 且无法自动推
 
 ---
 
+## assetlog：日志资金心跳 → 资产
+
+miniQMT / 独立交易模式被券商关闭后，`xttrader.query_stock_asset` 会报「交易服务端未启动」。但大QMT 客户端登录后，每 3~12 秒会往 `<QMT>/userdata/log/XtClient_YYYYMMDD.log` 写一条资金心跳：
+
+```
+2026-11-09 17:12:11,309 [INFO] ... [calc] update fund [2_10039_1000_<ACCOUNT>] bal 138879.92 avai 55757.92 debt 0.00 mv 83122.00
+```
+
+`xqshare.assetlog` 增量 tail 这个文件，给出总资产 / 可用资金 / 市值 / 负债。
+
+### Server 端配置（Windows）
+
+```ini
+# 日志目录（可选）：不配则按 QMT_USERDATA_PATH 推断为 <QMT安装>/userdata/log
+QMT_LOG_DIR=C:\Install\pazq_qmt\pazq_qmt_2.0.8.0\userdata\log
+
+# 判为过期的阈值（秒），默认 60
+QMT_ASSETLOG_STALE_S=60
+```
+
+### Client 端使用
+
+```python
+from xqshare import XtQuantRemote
+
+with XtQuantRemote("203.0.113.10", client_secret="my-secret") as xt:
+    snap = xt.get_asset("<ACCOUNT_ID>")   # 或 xt.assetlog.get_asset(...)
+    print(snap["total_asset"], snap["cash"], snap["market_value"], snap["stale"])
+    # 138879.92 55757.92 83122.0 False
+```
+
+> ⚠️ 这是**推送快照**，不是查询接口：断线就停，返回值带 `as_of` / `age_s` / `stale`，用之前先看新鲜度。
+
+### 能力边界
+
+| 项 | 是否支持 | 说明 |
+|----|---------|------|
+| 总资产 / 可用 / 市值 / 负债 | ✅ | 心跳里直接有 |
+| 持仓明细 | ❌ | 日志没有逐票数量与成本 |
+| 冻结资金 | ❌ | `accountdetail` 行的 marketvalue 是 DBL_MAX，整行不可信 |
+| 即时查询 | ❌ | 只有 3~12 秒的推送节拍 |
+
+详细字段与异常说明见 [doc/xqshare-api.md](doc/xqshare-api.md#8-assetlog-模块-api)。
+
+---
+
 ## 使用示例
 
 ```python
 from xqshare import XtQuantRemote
 
-with XtQuantRemote("21.214.136.216", client_secret="my-secret") as xt:
+with XtQuantRemote("203.0.113.10", client_secret="my-secret") as xt:
     # 获取股票列表
     stocks = xt.xtdata.get_stock_list_in_sector("沪深A股")
     print(f"股票数量: {len(stocks)}")
@@ -354,7 +402,7 @@ with XtQuantRemote("21.214.136.216", client_secret="my-secret") as xt:
 ```python
 from xqshare import XtQuantRemote
 
-with XtQuantRemote("21.214.136.216", client_secret="my-secret") as xt:
+with XtQuantRemote("203.0.113.10", client_secret="my-secret") as xt:
     # 创建交易实例并等待真实连接建立（推荐）
     # userdata_path 可通过环境变量 QMT_USERDATA_PATH 配置
     trader = xt.create_trader_and_connect("C:\\QMT\\userdata_mini")
@@ -436,7 +484,7 @@ logs/client_20260228.log
 **客户端也会记录调用：**
 ```python
 # 设置日志级别
-xt = XtQuantRemote("21.214.136.216", log_level="DEBUG")
+xt = XtQuantRemote("203.0.113.10", log_level="DEBUG")
 ```
 
 客户端日志示例：
@@ -548,7 +596,7 @@ python -m xqshare.server --ssl --cert server.crt --key server.key
 
 ```python
 xt = XtQuantRemote(
-    host="21.214.136.216",
+    host="203.0.113.10",
     use_ssl=True,
     ssl_verify=False  # 自签名证书需禁用验证
 )
@@ -566,7 +614,7 @@ xt = XtQuantRemote(
 
 ```python
 xt = XtQuantRemote(
-    host="21.214.136.216",
+    host="203.0.113.10",
     auto_reconnect=True,
     max_retries=10,
     heartbeat_interval=15,
@@ -737,8 +785,8 @@ tail -f logs/client_*.log
 
 ```bash
 # 检查网络
-ping 21.214.136.216
-telnet 21.214.136.216 18812
+ping 203.0.113.10
+telnet 203.0.113.10 18812
 ```
 
 ### 查看服务状态

{xtquant_share-1.4.1 → xtquant_share-1.4.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "xtquant-share"
-version = "1.4.1"
+version = "1.4.2"
 description = "Xtreme Quant Share - eXtreme transparent sharing proxy for XtQuant on macOS/Linux"
 readme = "README.md"
 license = "GPL-3.0-only"

{xtquant_share-1.4.1 → xtquant_share-1.4.2}/tests/test_client_permission.py

@@ -184,14 +184,14 @@ class TestClientEnvConfig:
         with patch('xqshare.client.rpyc.connect', return_value=mock_conn):
             with patch('xqshare.client.BgServingThread'):
                 with patch.dict(os.environ, {
-                    "XQSHARE_REMOTE_HOST": "21.214.136.216",
+                    "XQSHARE_REMOTE_HOST": "203.0.113.10",
                     "XQSHARE_REMOTE_PORT": "18888",
                     "XQSHARE_CLIENT_ID": "env-client",
                     "XQSHARE_CLIENT_SECRET": "env-secret"
                 }):
                     client = XtQuantRemote(heartbeat_interval=0)
 
-                    assert client._host == "21.214.136.216"
+                    assert client._host == "203.0.113.10"
                     assert client._port == 18888
                     assert client._client_id == "env-client"
                     assert client._client_secret == "env-secret"

xtquant_share-1.4.2/tests/test_qmt_assetlog.py

@@ -0,0 +1,226 @@
+# -*- coding: utf-8 -*-
+"""qmt_assetlog（大QMT 日志资金心跳 → 资产快照）单元测试。"""
+import os
+import time
+
+import pytest
+
+from xqshare.qmt_assetlog import QmtAssetLogReader
+
+
+ACC = "307100903096"
+ACC2 = "307199913362"
+KEY = f"2_10039_1000_{ACC}"
+KEY2 = f"3_10039_1000_{ACC2}"
+
+
+def _line(ts, key, bal, avai, mv, debt=0.0, sv=None):
+    sv = mv if sv is None else sv
+    return (
+        f"{ts},309 [INFO] [0x00003b88] [0x00000754] [17:12:11,191] [calc] "
+        f"update fund [{key}] bal {bal} avai {avai} debt {debt} "
+        f"mv {mv} sv {sv} em 0.00 um 0.00\n"
+    )
+
+
+def _write_log(log_dir, date_str, lines):
+    path = os.path.join(log_dir, f"XtClient_{date_str}.log")
+    with open(path, "w", encoding="utf-8") as f:
+        f.writelines(lines)
+    return path
+
+
+class _Clock:
+    def __init__(self, ts):
+        self.ts = ts
+
+    def __call__(self):
+        return self.ts
+
+    def advance(self, seconds):
+        self.ts += seconds
+
+
+def _epoch(date_str, hhmmss="17:12:11"):
+    return time.mktime(time.strptime(f"{date_str[:4]}-{date_str[4:6]}-{date_str[6:]} {hhmmss}",
+                                     "%Y-%m-%d %H:%M:%S"))
+
+
+def test_get_asset_parses_fields(tmp_path):
+    date = "20261109"
+    _write_log(tmp_path, date, [
+        "2026-11-09 17:12:00,001 [INFO] unrelated line\n",
+        _line("2026-11-09 17:12:11", KEY, "138879.92", "55757.92", "83122.00"),
+    ])
+    reader = QmtAssetLogReader(str(tmp_path), clock=_Clock(_epoch(date, "17:12:12")))
+
+    snap = reader.get_asset(ACC)
+
+    assert snap["account"] == ACC
+    assert snap["account_key"] == KEY
+    assert snap["total_asset"] == pytest.approx(138879.92)
+    assert snap["cash"] == pytest.approx(55757.92)
+    assert snap["market_value"] == pytest.approx(83122.00)
+    assert snap["debt"] == pytest.approx(0.0)
+    assert snap["as_of"] == "2026-11-09 17:12:11"
+    assert snap["age_s"] == pytest.approx(1.0)
+    assert snap["stale"] is False
+    assert snap["raw"]["sv"] == pytest.approx(83122.00)
+    assert snap["raw"]["um"] == pytest.approx(0.0)
+
+
+def test_incremental_read_only_new_bytes(tmp_path):
+    date = "20261109"
+    path = _write_log(tmp_path, date, [
+        _line("2026-11-09 17:12:11", KEY, "100.0", "50.0", "50.0"),
+    ])
+    reader = QmtAssetLogReader(str(tmp_path), clock=_Clock(_epoch(date, "17:12:12")))
+    assert reader.get_asset(ACC)["total_asset"] == pytest.approx(100.0)
+
+    with open(path, "a", encoding="utf-8") as f:
+        f.write(_line("2026-11-09 17:12:14", KEY, "200.0", "60.0", "140.0"))
+
+    snap = reader.get_asset(ACC)
+    assert snap["total_asset"] == pytest.approx(200.0)
+    assert snap["as_of"] == "2026-11-09 17:12:14"
+
+
+def test_partial_line_is_buffered_until_newline(tmp_path):
+    date = "20261109"
+    path = os.path.join(tmp_path, f"XtClient_{date}.log")
+    full = _line("2026-11-09 17:12:11", KEY, "300.0", "100.0", "200.0")
+    with open(path, "w", encoding="utf-8") as f:
+        f.write(full[:-1])  # 去掉换行，模拟写到一半
+
+    reader = QmtAssetLogReader(str(tmp_path), clock=_Clock(_epoch(date, "17:12:12")))
+    with pytest.raises(LookupError):
+        reader.get_asset(ACC)
+
+    with open(path, "a", encoding="utf-8") as f:
+        f.write("\n")
+
+    assert reader.get_asset(ACC)["total_asset"] == pytest.approx(300.0)
+
+
+def test_multiple_accounts_require_explicit_account(tmp_path, monkeypatch):
+    monkeypatch.delenv("QMT_ACCOUNT_ID", raising=False)
+    date = "20261109"
+    _write_log(tmp_path, date, [
+        _line("2026-11-09 17:12:11", KEY, "100.0", "50.0", "50.0"),
+        _line("2026-11-09 17:12:13", KEY2, "0.11", "0.11", "0.0"),
+    ])
+    reader = QmtAssetLogReader(str(tmp_path), clock=_Clock(_epoch(date, "17:12:20")))
+
+    with pytest.raises(ValueError):
+        reader.get_asset()
+
+    assert reader.get_asset(ACC2)["total_asset"] == pytest.approx(0.11)
+    assert set(reader.list_accounts()) == {KEY, KEY2}
+
+
+def test_unknown_account_raises(tmp_path):
+    date = "20261109"
+    _write_log(tmp_path, date, [
+        _line("2026-11-09 17:12:11", KEY, "100.0", "50.0", "50.0"),
+    ])
+    reader = QmtAssetLogReader(str(tmp_path), clock=_Clock(_epoch(date, "17:12:12")))
+
+    with pytest.raises(LookupError):
+        reader.get_asset("999999")
+
+
+def test_no_heartbeat_raises(tmp_path):
+    date = "20261109"
+    _write_log(tmp_path, date, ["2026-11-09 17:12:00,001 [INFO] nothing here\n"])
+    reader = QmtAssetLogReader(str(tmp_path), clock=_Clock(_epoch(date, "17:12:12")))
+
+    with pytest.raises(LookupError):
+        reader.get_asset(ACC)
+
+
+def test_stale_after_threshold(tmp_path):
+    date = "20261109"
+    _write_log(tmp_path, date, [
+        _line("2026-11-09 17:12:11", KEY, "100.0", "50.0", "50.0"),
+    ])
+    clock = _Clock(_epoch(date, "17:12:12"))
+    reader = QmtAssetLogReader(str(tmp_path), stale_after=30, clock=clock)
+
+    assert reader.get_asset(ACC)["stale"] is False
+
+    clock.advance(31)
+    snap = reader.get_asset(ACC)
+    assert snap["stale"] is True
+    assert snap["age_s"] == pytest.approx(32.0)
+    assert snap["stale_after_s"] == pytest.approx(30.0)
+
+
+def test_falls_back_to_latest_previous_log(tmp_path):
+    """当天文件还没生成（刚过 0 点/客户端未启动）时读最近一份。"""
+    _write_log(tmp_path, "20261108", [
+        _line("2026-11-08 15:00:00", KEY, "88.0", "8.0", "80.0"),
+    ])
+    reader = QmtAssetLogReader(
+        str(tmp_path), clock=_Clock(_epoch("20261109", "00:00:10"))
+    )
+
+    snap = reader.get_asset(ACC)
+    assert snap["total_asset"] == pytest.approx(88.0)
+    assert snap["stale"] is True
+
+
+def test_missing_directory_raises(tmp_path):
+    with pytest.raises(FileNotFoundError):
+        QmtAssetLogReader(str(tmp_path / "nope"))
+
+
+def test_truncated_file_is_reread(tmp_path):
+    date = "20261109"
+    path = _write_log(tmp_path, date, [
+        _line("2026-11-09 17:12:11", KEY, "100.0", "50.0", "50.0"),
+    ])
+    reader = QmtAssetLogReader(str(tmp_path), clock=_Clock(_epoch(date, "17:12:12")))
+    assert reader.get_asset(ACC)["total_asset"] == pytest.approx(100.0)
+
+    with open(path, "w", encoding="utf-8") as f:  # 模拟日志被重写/清空
+        f.write(_line("2026-11-09 17:12:20", KEY, "500.0", "200.0", "300.0"))
+
+    assert reader.get_asset(ACC)["total_asset"] == pytest.approx(500.0)
+
+# ── server 端初始化 ──────────────────────────────────────────────────────────
+
+def test_server_infers_log_dir_from_userdata_path(tmp_path, monkeypatch):
+    import logging
+    from xqshare import server
+
+    monkeypatch.setattr(server, "logger", logging.getLogger("test.assetlog"))
+    (tmp_path / "userdata" / "log").mkdir(parents=True)
+    monkeypatch.setenv("QMT_USERDATA_PATH", str(tmp_path / "userdata_mini"))
+    monkeypatch.delenv("QMT_LOG_DIR", raising=False)
+    server.XtQuantService._assetlog_reader = None
+    try:
+        server._init_assetlog_reader()
+        assert isinstance(server.XtQuantService._assetlog_reader, QmtAssetLogReader)
+        assert server.XtQuantService._assetlog_dir == str(tmp_path / "userdata" / "log")
+    finally:
+        server.XtQuantService._assetlog_reader = None
+        server.XtQuantService._assetlog_dir = None
+        server.XtQuantService._assetlog_error = None
+
+
+def test_server_reports_missing_log_dir(tmp_path, monkeypatch):
+    import logging
+    from xqshare import server
+
+    monkeypatch.setattr(server, "logger", logging.getLogger("test.assetlog"))
+    monkeypatch.delenv("QMT_LOG_DIR", raising=False)
+    monkeypatch.setenv("QMT_LOG_DIR", str(tmp_path / "nope"))
+    server.XtQuantService._assetlog_reader = None
+    try:
+        server._init_assetlog_reader()
+        assert server.XtQuantService._assetlog_reader is None
+        assert "不存在" in server.XtQuantService._assetlog_error
+    finally:
+        server.XtQuantService._assetlog_reader = None
+        server.XtQuantService._assetlog_dir = None
+        server.XtQuantService._assetlog_error = None