cfquant 0.2.43__tar.gz → 0.2.46__tar.gz

{cfquant-0.2.43 → cfquant-0.2.46}/LTtx/tx/LTtx_server.py

@@ -87,7 +87,9 @@ def ensure_modules_with_version(modules: dict):
                     raise ImportError()
                 else:
                     print(f"[AutoInstall] {import_name} 已安装，版本为 {installed_version}，满足要求")
-        except ImportError:
+        except ImportError:
+            if os.environ.get("CFQUANT_MANAGEMENT_TOKEN_FILE"):
+                raise RuntimeError("Managed cfquant requires %s; install it in the configured Python environment" % pip_name)
             # 安装或升级
             install_target = pip_name if required_version == "latest" else "%s>=%s" % (pip_name, required_version)
             print(f"[AutoInstall] 正在安装/升级 {pip_name} → {required_version}...")
@@ -201,10 +203,13 @@ def _lttx_log_dir():
     configured = os.environ.get("CFQUANT_LTTX_LOG_DIR")
     if configured:
         return os.path.abspath(configured)
-    log_dir = os.environ.get("CFQUANT_LOG_DIR")
-    if log_dir:
-        return os.path.abspath(os.path.join(log_dir, "lttx"))
-    return os.path.abspath("log_data")
+    log_dir = os.environ.get("CFQUANT_LOG_DIR")
+    if log_dir:
+        return os.path.abspath(os.path.join(log_dir, "lttx"))
+    home = os.environ.get("CFQUANT_HOME")
+    if home:
+        return os.path.abspath(os.path.join(home, "log", "lttx"))
+    return os.path.join(_project_root(), "log", "lttx")
 
 def _cleanup_lttx_logs(log_dir):
     try:
@@ -234,7 +239,7 @@ def main_save_log():
         os.makedirs(log_dir, exist_ok=True)
         _cleanup_lttx_logs(log_dir)
     except:
-        log_dir = os.path.abspath("log_data")
+        log_dir = os.path.join(_project_root(), "log", "lttx")
         try:
             os.makedirs(log_dir, exist_ok=True)
         except:
@@ -250,7 +255,8 @@ def main_save_log():
             f.write(str(data)+'\n')
             
 msg = '%s>>>>>>>[info] LTtx程序启动'%(time.strftime("%Y-%m-%d %H:%M:%S"))
-threading.Thread(target = main_save_log).start()
+log_thread = threading.Thread(target=main_save_log, name="lttx-log-writer", daemon=True)
+log_thread.start()
 
 def close_con(client):
     try:
@@ -1111,7 +1117,7 @@ def main():
     update_time = '2025-09-04'
     import multiprocessing
     config = load_config()
-    port = int(config['port'])
+    port = int(os.environ.get('CFQUANT_LTTX_PORT') or config['port'])
     tocken = config['token']
     ip = get_local_ip()
     if tcp_port_open('127.0.0.1', port):

{cfquant-0.2.43 → cfquant-0.2.46}/LTtx/tx/tx.py

@@ -194,10 +194,13 @@ class txl:
         tx_log_dir = os.environ.get("CFQUANT_TX_LOG_DIR")
         if tx_log_dir:
             return os.path.abspath(tx_log_dir)
-        log_dir = os.environ.get("CFQUANT_LOG_DIR")
-        if log_dir:
-            return os.path.abspath(os.path.join(log_dir, "tx_log"))
-        return os.path.abspath(os.path.join(os.getcwd(), "log", "tx_log"))
+        log_dir = os.environ.get("CFQUANT_LOG_DIR")
+        if log_dir:
+            return os.path.abspath(os.path.join(log_dir, "lttx"))
+        home = os.environ.get("CFQUANT_HOME")
+        if home:
+            return os.path.abspath(os.path.join(home, "log", "lttx"))
+        return os.path.abspath(os.path.join(os.getcwd(), "log", "lttx"))
 
     def delete_file(self,file_name):
         msg = '删除tx运行日志%s'%(file_name)

{cfquant-0.2.43/cfquant.egg-info → cfquant-0.2.46}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: cfquant
-Version: 0.2.43
+Version: 0.2.46
 Summary: QMT local bridge and xtquant-compatible Python client.
 License: MIT
 Requires-Python: >=3.8
@@ -153,9 +153,9 @@ set CFQUANT_PYTHON_EXE=C:\Users\用户名\anaconda3\envs\quant\python.exe
 start_cfquant.bat
 ```
 
-Web 控制台启动后，请在初始化配置中确认或修改 Python 解释器路径。后续启动会优先使用已保存的路径；启动选择结果和失败原因记录在 `log\cfquant_startup.log`。
+Web 控制台启动后，请在初始化配置中确认或修改 Python 解释器路径。后续启动会优先使用已保存的路径；启动选择结果和失败原因记录在 `log\startup\cfquant_startup.log`。
 
-自动安装失败时，启动窗口会保持打开，并把安装日志写入 `log\cfquant_startup.log`，修复 Python、网络或权限问题后重新启动即可。
+自动安装失败时，启动窗口会保持打开，并把安装日志写入 `log\startup\cfquant_startup.log`，修复 Python、网络或权限问题后重新启动即可。
 
 项目默认使用清华 PyPI 镜像安装依赖，适合中国大陆网络环境。启动脚本、网页源码更新、`requirements.txt` 安装以及 LTtx 缺失依赖自动安装都会遵循这个设置。需要切换到企业私有源或其他镜像时，可在启动前设置 `CFQUANT_PIP_INDEX_URL` 环境变量。
 
@@ -236,8 +236,8 @@ cfquant Web 每次启动时都会读取已保存的绑定：只要账号处于
 
 | 现象 | 优先检查 |
 |---|---|
-| 双击启动窗口后立即退出 | 查看 `log\cfquant_startup.log`；确认 Python 路径存在，或设置 `CFQUANT_PYTHON_EXE`。 |
-| 页面打不开 | 查看最新的 `log\cfquant_web_server.*.stderr.log`；确认 8765 端口没有被其他程序占用。 |
+| 双击启动窗口后立即退出 | 查看 `log\startup\cfquant_startup.log`；确认 Python 路径存在，或设置 `CFQUANT_PYTHON_EXE`。 |
+| 页面打不开 | 查看最新的 `log\web\cfquant_web_server.*.stderr.log`；确认 8765 端口没有被其他程序占用。 |
 | 页面在线但 QMT 不在线 | 确认 QMT 已登录、QMT 目录正确，并按绑定页提示重新导入或启动入口策略。 |
 | `ModuleNotFoundError: cfquant` | 在运行策略的同一个解释器中执行 `python -m pip install --upgrade cfquant`，再用 `python -c "import cfquant; print(cfquant.__file__)"` 验证。 |
 | 行情为空 | 先用页面接口测试确认证券代码、周期和行情权限；标准行情异常时可对照 `xtdata.get_market_data_ex`。 |
@@ -245,6 +245,43 @@ cfquant Web 每次启动时都会读取已保存的绑定：只要账号处于
 
 完整日志位于项目的 `log` 目录。提交问题时，请附上启动日志、页面状态和使用的 Python 版本，删除账号、密码、Token、订单和持仓等敏感信息后再提交。
 
+## 第三方项目自动化接入
+
+`cfquant.management.RuntimeManager` 支持隐藏启动后台服务、通过代码初始化及绑定账号、配置是否自动启动 QMT，并通过官网或 GitHub 更新服务和回滚。无需打开网页，后台服务使用独立目录，更新不会覆盖第三方进程已经导入的 SDK。
+
+```python
+from cfquant.management import RuntimeManager
+
+runtime = RuntimeManager(home=r"D:\MyApp\cfquant")
+runtime.start()  # 隐藏启动；遵循各账号保存的 QMT 启动设置
+runtime.initialize(
+    account_id="YOUR_ACCOUNT_ID", account_type="STOCK",
+    qmt_dir=r"D:\QMT", mode="ctypes",
+    auto_start_qmt=False, strategy_autorun=True, live=False,
+)
+# 用户自行启动并登录 QMT；首次部署前需关闭 QMT。
+runtime.wait_ready("YOUR_ACCOUNT_ID", timeout=120)
+runtime.configure_client()
+
+# 用户关闭 QMT 后，可通过 runtime.updates.apply() 更新后台服务。
+```
+
+查询当前运行版本、已安装版本和远端版本，以及按需自动更新：
+
+```python
+versions = runtime.version_info(force=True)
+print(versions["running_version"], versions["installed_version"], versions["latest_version"])
+
+result = runtime.updates.ensure_latest()  # 重新检查；有更新才安装并重启后台服务
+print(result["status"], result["message"])
+# up_to_date / 已是最新版本：不会下载、重启或关闭 QMT。
+# updated / 已更新；check_failed / 无法确认远端版本；local_newer / 本地版本更高。
+```
+
+`version_info(include_remote=False)` 只查询本地版本；`updates.check(force=True)` 只检查更新。按需更新也识别同版本号的安装包变化，首次安装包哈希未知时会执行一次更新以建立记录。真正需要更新时，默认要求先关闭相关 QMT；也可显式传入 `auto_close_qmt=True` 允许自动关闭。`restart=False` 可留待调用方重启。部分 QMT 部署失败返回 `update_incomplete`，已安装但尚未重启返回 `restart_required`；执行更新失败会抛出 `ManagementError`。
+
+模拟／实盘参数需与实际账号一致。完整的启动策略、更新接口、重复绑定行为与错误处理见 [第三方项目管理 SDK](docs/第三方项目管理SDK.md)。
+
 ## 从 `xtquant` 迁移到 `cfquant`
 
 安装和初始化完成后，通常不需要重写原有策略。先把外部策略中指向 `xtquant` 的导入改成 `cfquant` 对应模块，再按下面的顺序验证。cfquant 负责外部 Python 与 QMT 之间的桥接，QMT 仍然需要登录并运行 Web 绑定页部署的入口策略。