powerquant-cli 0.2.6__tar.gz → 0.2.7__tar.gz

{powerquant_cli-0.2.6 → powerquant_cli-0.2.7}/.gitignore

@@ -15,8 +15,6 @@ __pycache__/
 .venv/
 dist/
 build/
-tasks/draft/TASK-20260906-1704-akshare-minute-ingestion/samples/
-tasks/approved/TASK-20260906-2119-real-market-integration-review-fixes/samples/
 
 node_modules/
 apps/quant_frontend/public/data-dictionary.md

{powerquant_cli-0.2.6 → powerquant_cli-0.2.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: powerquant-cli
-Version: 0.2.6
+Version: 0.2.7
 Summary: Power Quant local research CLI
 Project-URL: Repository, https://github.com/Kepler452Byte/power-quant
 License-Expression: LicenseRef-PowerQuant-Proprietary AND MIT
@@ -37,18 +37,46 @@ uv tool upgrade powerquant-cli
 
 ## 接入行情
 
-向管理员获取行情读取密钥，无需注册账户。服务当前仅在 LAN/WireGuard 内可达。
+向管理员申请账户及具备 `market:read` 权限的平台 API Token。登录 JWT 不用于行情请求。
+
+首次配置一次，之后新开终端、切换目录仍可使用：
+
+```sh
+pq config set --market-url 'https://powerquant.cn/market/api/v1'
+pq config token
+pq config show
+```
+
+`token` 命令隐藏输入密钥，不加 `Bearer`，避免写入命令历史。`show` 显示地址、配置来源和是否已配置 Token，不显示密钥原文或前缀。
+
+家庭 LAN 可配置 `http://192.168.8.142:18026/market/api/v1`；公网 IP 临时入口为 `http://82.157.167.33/market/api/v1`。公网 HTTP 会明文传输 Token，只适合已明确接受风险的临时接入；长期公网访问使用可信 HTTPS 或 SSH/WireGuard 加密链路。直接使用 `https://82.157.167.33` 与现有域名证书不匹配。
+
+配置保存在当前系统用户的 `~/.powerquant/config.json`，与工作目录无关，不自动加载 `.env`。这是本地明文配置：POSIX 新目录权限 700、文件权限 600；Windows 依赖用户目录 ACL，不声称加密存储。不要提交或分享该文件。
+
+每项配置按环境变量 > 用户文件 > 默认值解析。默认地址为 `http://localhost:8002/api/v1`，默认 Token 为空。环境变量只影响当前终端及其启动的子进程，不改文件；显式空 Token 环境变量会覆盖已保存密钥。
+
+PowerShell 临时覆盖示例：
+
+```powershell
+$env:MARKET_BASE_URL="http://192.168.8.142:18026/market/api/v1"
+$env:MARKET_API_TOKEN="管理员签发的完整平台Token"
+```
+
+删除已保存的配置：
+
+```sh
+pq config unset market-token
+pq config unset market-url
+```
+
+随后准备本地行情快照：
 
 ```sh
-export MARKET_BASE_URL='http://服务器地址/market/api/v1'
-export MARKET_API_TOKEN='管理员提供的行情密钥'
 pq examples --directory powerquant-examples
 cd powerquant-examples/selection
 pq data prepare --config prepare.json
 ```
 
-PowerShell 使用 `$env:MARKET_BASE_URL="..."` 与 `$env:MARKET_API_TOKEN="..."`。
-
 按实际覆盖调整 prepare.json 的股票和日期，将返回 manifest_path 写入 compute.json、select.json；按示例 README 执行 compute、select 和 backtest。不同使用目的的快照须分别通过完整性检查。
 
 密钥到期或撤销后在线准备会失败，已下载快照仍可离线使用。行情密钥不用于定义发布；发布定义另使用 PQ_QUANT_URL/PQ_QUANT_TOKEN。默认本地目录为 ~/.powerquant。

powerquant_cli-0.2.7/README.md

@@ -0,0 +1,69 @@
+# Power Quant CLI
+
+本地行情准备、因子计算、选股、研究及策略回测；结果保存在本地 DuckDB 和文件。
+
+## 安装
+
+推荐通过 uv 安装独立工具环境：
+
+```sh
+uv tool install --python 3.12 powerquant-cli
+pq --help
+uv tool upgrade powerquant-cli
+```
+
+也支持在 Python 3.12+ 环境通过 `pip install powerquant-cli` 安装。
+
+## 接入行情
+
+向管理员申请账户及具备 `market:read` 权限的平台 API Token。登录 JWT 不用于行情请求。
+
+首次配置一次，之后新开终端、切换目录仍可使用：
+
+```sh
+pq config set --market-url 'https://powerquant.cn/market/api/v1'
+pq config token
+pq config show
+```
+
+`token` 命令隐藏输入密钥，不加 `Bearer`，避免写入命令历史。`show` 显示地址、配置来源和是否已配置 Token，不显示密钥原文或前缀。
+
+家庭 LAN 可配置 `http://192.168.8.142:18026/market/api/v1`；公网 IP 临时入口为 `http://82.157.167.33/market/api/v1`。公网 HTTP 会明文传输 Token，只适合已明确接受风险的临时接入；长期公网访问使用可信 HTTPS 或 SSH/WireGuard 加密链路。直接使用 `https://82.157.167.33` 与现有域名证书不匹配。
+
+配置保存在当前系统用户的 `~/.powerquant/config.json`，与工作目录无关，不自动加载 `.env`。这是本地明文配置：POSIX 新目录权限 700、文件权限 600；Windows 依赖用户目录 ACL，不声称加密存储。不要提交或分享该文件。
+
+每项配置按环境变量 > 用户文件 > 默认值解析。默认地址为 `http://localhost:8002/api/v1`，默认 Token 为空。环境变量只影响当前终端及其启动的子进程，不改文件；显式空 Token 环境变量会覆盖已保存密钥。
+
+PowerShell 临时覆盖示例：
+
+```powershell
+$env:MARKET_BASE_URL="http://192.168.8.142:18026/market/api/v1"
+$env:MARKET_API_TOKEN="管理员签发的完整平台Token"
+```
+
+删除已保存的配置：
+
+```sh
+pq config unset market-token
+pq config unset market-url
+```
+
+随后准备本地行情快照：
+
+```sh
+pq examples --directory powerquant-examples
+cd powerquant-examples/selection
+pq data prepare --config prepare.json
+```
+
+按实际覆盖调整 prepare.json 的股票和日期，将返回 manifest_path 写入 compute.json、select.json；按示例 README 执行 compute、select 和 backtest。不同使用目的的快照须分别通过完整性检查。
+
+密钥到期或撤销后在线准备会失败，已下载快照仍可离线使用。行情密钥不用于定义发布；发布定义另使用 PQ_QUANT_URL/PQ_QUANT_TOKEN。默认本地目录为 ~/.powerquant。
+
+## Python
+
+公开请求模型与调用入口位于 quant_cli.api，与 CLI 使用同一应用服务。
+
+## 使用许可
+
+自有代码采用随包附带的专有许可证：允许安装、查看源码、为自用进行修改，以及商业使用；未经书面授权不得再分发或转售本软件及其修改版本。第三方组件保留各自许可证。行情访问仍需要有效 Token；本许可证不授予行情数据的使用或再分发权。

{powerquant_cli-0.2.6 → powerquant_cli-0.2.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "powerquant-cli"
-version = "0.2.6"
+version = "0.2.7"
 description = "Power Quant local research CLI"
 readme = "README.md"
 requires-python = ">=3.12"

powerquant_cli-0.2.7/src/quant_cli/app/config/__init__.py

@@ -0,0 +1 @@
+"""用户连接配置命令。"""

powerquant_cli-0.2.7/src/quant_cli/app/config/config_cli.py

@@ -0,0 +1,71 @@
+"""持久化行情连接配置；Token 通过隐藏交互录入，输出始终脱敏。"""
+
+from enum import StrEnum
+from typing import Annotated
+
+import typer
+
+from quant_cli.common.utils.cli_utils import cli_errors, output
+from quant_cli.config.connection_config import (
+    get_config_path,
+    load_saved_config,
+    resolve_market_connection,
+    update_saved_config,
+)
+
+app = typer.Typer(help="保存和查看当前用户的行情连接配置", no_args_is_help=True)
+
+
+class ConfigKey(StrEnum):
+    MARKET_URL = "market-url"
+    MARKET_TOKEN = "market-token"
+
+
+@app.command("set")
+@cli_errors
+def set_config(
+    market_url: Annotated[str, typer.Option("--market-url", "--url", help="行情 API 基础地址")],
+) -> None:
+    """保存行情服务 URL；不会修改当前进程的环境变量。"""
+    update_saved_config("market_url", market_url)
+    output({"status": "saved", "path": str(get_config_path()), "key": "market_url"})
+
+
+@app.command("token")
+@cli_errors
+def set_token() -> None:
+    """隐藏输入平台 Token，避免写入命令历史与进程参数。"""
+    value = typer.prompt("平台 Token（不加 Bearer）", hide_input=True, err=True)
+    update_saved_config("market_token", value)
+    output({"status": "saved", "path": str(get_config_path()), "key": "market_token"})
+
+
+@app.command("show")
+@cli_errors
+def show_config() -> None:
+    """展示已保存和当前生效的配置、来源；不输出密钥原文或前缀。"""
+    saved = load_saved_config()
+    effective = resolve_market_connection()
+    output(
+        {
+            "path": str(get_config_path()),
+            "saved": {
+                "market_url": saved.get("market_url"),
+                "token_configured": bool(saved.get("market_token")),
+            },
+            "effective": {
+                "market_url": effective.url,
+                "token_configured": bool(effective.token),
+                "url_source": effective.url_source,
+                "token_source": effective.token_source,
+            },
+        }
+    )
+
+
+@app.command("unset")
+@cli_errors
+def unset_config(key: ConfigKey) -> None:
+    """删除一项已保存配置，环境变量覆盖仍然有效。"""
+    update_saved_config(key.value.replace("-", "_"), None)
+    output({"status": "removed", "key": key.value})

{powerquant_cli-0.2.6 → powerquant_cli-0.2.7}/src/quant_cli/app/data/data_dependency.py

@@ -1,14 +1,15 @@
-from pqdata import MarketClient
-
 """量化数据组装；数据库会话不再参与行情读取。"""
 
 from pathlib import Path
 
+from pqdata import MarketClient
 from quant_core.app.backtest.backtest_input_schema import BacktestMarketComponents
 from quant_core.app.trading_runtime.replay.exchange_state_resolver import ExchangeStateResolver
 from quant_core.app.trading_runtime.replay.market_runtime_service import ReplayMarketEventSource
 from quant_core.app.trading_runtime.replay.market_state_resolver import MarketStateResolver
 
+from quant_cli.config.connection_config import resolve_market_connection
+
 
 def load_backtest_market(manifest_path: Path, max_rows: int) -> BacktestMarketComponents:
     """从已校验本地快照组装回放输入，不访问 SDK 或数据库。"""
@@ -27,9 +28,8 @@ def load_backtest_market(manifest_path: Path, max_rows: int) -> BacktestMarketCo
 
 def build_market_query() -> MarketClient:
     """显式在线准备入口，配置仅为服务地址与令牌。"""
-    import os
-
+    connection = resolve_market_connection()
     return MarketClient(
-        os.getenv("MARKET_BASE_URL", "http://localhost:8002/api/v1"),
-        token=os.getenv("MARKET_API_TOKEN", ""),
+        connection.url,
+        token=connection.token,
     )

{powerquant_cli-0.2.6 → powerquant_cli-0.2.7}/src/quant_cli/app/quant_cli.py

@@ -8,6 +8,7 @@ from typing import Annotated
 import typer
 
 from quant_cli.app.backtest.cli.local_backtest_cli import app as backtest
+from quant_cli.app.config.config_cli import app as config
 from quant_cli.app.data.cli.data_cli import app as data
 from quant_cli.app.factor.cli.local_factor_cli import app as factor
 from quant_cli.app.job.cli.local_job_cli import app as job
@@ -22,6 +23,7 @@ app.add_typer(factor, name="factor")
 app.add_typer(research, name="research")
 app.add_typer(backtest, name="backtest")
 app.add_typer(strategy, name="strategy")
+app.add_typer(config, name="config")
 
 
 @app.command()

powerquant_cli-0.2.7/src/quant_cli/config/__init__.py

@@ -0,0 +1 @@
+"""CLI 用户连接配置，不读取服务端环境文件。"""

powerquant_cli-0.2.7/src/quant_cli/config/connection_config.py

@@ -0,0 +1,133 @@
+"""行情连接配置：环境变量覆盖用户文件，密钥不参与展示与错误输出。"""
+
+import json
+import os
+import tempfile
+from dataclasses import dataclass, field
+from pathlib import Path
+from urllib.parse import urlsplit
+
+from filelock import FileLock
+
+DEFAULT_MARKET_URL = "http://localhost:8002/api/v1"
+CONFIG_KEYS = {"market_url", "market_token"}
+
+
+@dataclass(frozen=True)
+class MarketConnection:
+    url: str
+    token: str = field(repr=False)
+    url_source: str
+    token_source: str
+
+
+def get_config_path() -> Path:
+    """当前系统用户的配置路径，独立于终端和工作目录。"""
+    return Path.home() / ".powerquant" / "config.json"
+
+
+def validate_market_url(value: str) -> str:
+    """拒绝凭据、查询参数、片段和非 HTTP(S) 地址，不回显输入。"""
+    try:
+        url = urlsplit(value)
+        port = url.port
+        valid = (
+            url.scheme in {"http", "https"}
+            and bool(url.hostname)
+            and not url.username
+            and not url.password
+            and not url.query
+            and not url.fragment
+            and not any(character.isspace() for character in value)
+            and (port is None or port > 0)
+        )
+    except ValueError:
+        valid = False
+    if not valid:
+        raise ValueError("行情地址必须是无凭据、查询参数和片段的 HTTP(S) 基础 URL")
+    return value.rstrip("/")
+
+
+def _validate_token(value: str) -> None:
+    if any(character.isspace() for character in value):
+        raise ValueError("Token 不能包含空白字符，请输入完整密钥，不加 Bearer 前缀")
+
+
+def load_saved_config() -> dict[str, str]:
+    """加载已保存配置；损坏时明确失败，不静默回退到其他服务器。"""
+    path = get_config_path()
+    if not path.exists():
+        return {}
+    try:
+        document = json.loads(path.read_text(encoding="utf-8"))
+    except (OSError, ValueError) as exc:
+        raise ValueError("无法读取用户连接配置，请检查 ~/.powerquant/config.json") from exc
+    if (
+        not isinstance(document, dict)
+        or set(document) - CONFIG_KEYS
+        or any(not isinstance(value, str) for value in document.values())
+    ):
+        raise ValueError("用户连接配置格式不合法")
+    if "market_url" in document:
+        validate_market_url(document["market_url"])
+    if "market_token" in document:
+        _validate_token(document["market_token"])
+    return document
+
+
+def update_saved_config(key: str, value: str | None) -> None:
+    """加锁修改并原子替换文件；POSIX 新目录 700、配置文件 600。"""
+    if key not in CONFIG_KEYS:
+        raise ValueError("不支持的配置项")
+    if value is not None:
+        if key == "market_url":
+            value = validate_market_url(value)
+        else:
+            if not value:
+                raise ValueError("Token 不能为空；删除配置请使用 pq config unset")
+            _validate_token(value)
+    path = get_config_path()
+    path.parent.mkdir(mode=0o700, parents=True, exist_ok=True)
+    with FileLock(str(path) + ".lock"):
+        document = load_saved_config()
+        if value is None:
+            document.pop(key, None)
+        else:
+            document[key] = value
+        temporary: Path | None = None
+        try:
+            descriptor, name = tempfile.mkstemp(prefix=".config-", dir=path.parent)
+            temporary = Path(name)
+            with os.fdopen(descriptor, "w", encoding="utf-8") as stream:
+                json.dump(document, stream, ensure_ascii=False, indent=2)
+                stream.write("\n")
+                stream.flush()
+                os.fsync(stream.fileno())
+            temporary.chmod(0o600)
+            os.replace(temporary, path)
+        except OSError as exc:
+            raise ValueError("无法保存用户连接配置，请检查用户目录权限") from exc
+        finally:
+            if temporary is not None:
+                temporary.unlink(missing_ok=True)
+
+
+def resolve_market_connection() -> MarketConnection:
+    """按环境变量、用户文件、默认值分别解析 URL 和 Token。"""
+    saved = (
+        {} if {"MARKET_BASE_URL", "MARKET_API_TOKEN"} <= os.environ.keys() else load_saved_config()
+    )
+    url = os.environ.get("MARKET_BASE_URL", saved.get("market_url", DEFAULT_MARKET_URL))
+    token = os.environ.get("MARKET_API_TOKEN", saved.get("market_token", ""))
+    url = validate_market_url(url)
+    _validate_token(token)
+    return MarketConnection(
+        url=url,
+        token=token,
+        url_source="environment"
+        if "MARKET_BASE_URL" in os.environ
+        else ("file" if "market_url" in saved else "default"),
+        token_source="environment"
+        if "MARKET_API_TOKEN" in os.environ
+        else ("file" if "market_token" in saved else "default"),
+    )

powerquant_cli-0.2.7/tests/unit/test_connection_config.py

@@ -0,0 +1,169 @@
+"""真实用户文件、配置命令与行情客户端的连接配置回归。"""
+
+import json
+import os
+import subprocess
+import sys
+from pathlib import Path
+
+import pytest
+from typer.testing import CliRunner
+
+from quant_cli.app.quant_cli import app
+from quant_cli.config.connection_config import (
+    DEFAULT_MARKET_URL,
+    get_config_path,
+    load_saved_config,
+    resolve_market_connection,
+    update_saved_config,
+    validate_market_url,
+)
+
+
+@pytest.fixture(autouse=True)
+def isolated_config(monkeypatch, tmp_path):
+    monkeypatch.setattr(Path, "home", lambda: tmp_path)
+    monkeypatch.delenv("MARKET_BASE_URL", raising=False)
+    monkeypatch.delenv("MARKET_API_TOKEN", raising=False)
+
+
+def test_default_connection():
+    connection = resolve_market_connection()
+    assert connection.url == DEFAULT_MARKET_URL
+    assert connection.token == ""
+    assert connection.url_source == connection.token_source == "default"
+    assert not get_config_path().exists()
+
+
+def test_saved_connection_survives_a_new_process(tmp_path):
+    update_saved_config("market_url", "http://82.157.167.33/market/api/v1/")
+    update_saved_config("market_token", "test-platform-secret")
+    script = """
+import json, sys
+from pathlib import Path
+Path.home = classmethod(lambda cls: Path(sys.argv[1]))
+from quant_cli.config.connection_config import resolve_market_connection
+c = resolve_market_connection()
+print(json.dumps({'url': c.url, 'token_matches': c.token == 'test-platform-secret'}))
+"""
+    result = subprocess.run(
+        [sys.executable, "-c", script, str(tmp_path)], capture_output=True, text=True, check=True
+    )
+    assert json.loads(result.stdout) == {
+        "url": "http://82.157.167.33/market/api/v1",
+        "token_matches": True,
+    }
+    if os.name == "posix":
+        assert get_config_path().stat().st_mode & 0o777 == 0o600
+        assert get_config_path().parent.stat().st_mode & 0o777 == 0o700
+
+
+def test_environment_overrides_each_field_without_changing_file(monkeypatch):
+    update_saved_config("market_url", "https://example.com/market/api/v1")
+    update_saved_config("market_token", "saved-secret")
+    original = get_config_path().read_bytes()
+    monkeypatch.setenv("MARKET_API_TOKEN", "environment-secret")
+    connection = resolve_market_connection()
+    assert connection.url == "https://example.com/market/api/v1"
+    assert connection.token == "environment-secret"
+    assert connection.url_source == "file"
+    assert connection.token_source == "environment"
+    monkeypatch.setenv("MARKET_BASE_URL", "http://localhost:9000/api/v1")
+    assert resolve_market_connection().url == "http://localhost:9000/api/v1"
+    assert get_config_path().read_bytes() == original
+
+
+def test_empty_environment_token_does_not_reuse_saved_secret(monkeypatch):
+    update_saved_config("market_token", "saved-secret")
+    monkeypatch.setenv("MARKET_API_TOKEN", "")
+    assert resolve_market_connection().token == ""
+
+
+def test_cli_hidden_token_and_show_never_output_secret():
+    runner = CliRunner()
+    assert (
+        runner.invoke(app, ["config", "set", "--url", "http://localhost:9000/api/v1"]).exit_code
+        == 0
+    )
+    token = runner.invoke(app, ["config", "token"], input="test-hidden-secret\n")
+    assert token.exit_code == 0, token.output
+    assert "test-hidden-secret" not in token.output
+    shown = runner.invoke(app, ["config", "show"])
+    assert shown.exit_code == 0
+    assert "test-hidden-secret" not in shown.output
+    assert json.loads(shown.stdout)["effective"]["token_configured"]
+    assert "test-hidden-secret" not in repr(resolve_market_connection())
+    assert runner.invoke(app, ["config", "unset", "market-token"]).exit_code == 0
+    assert load_saved_config() == {"market_url": "http://localhost:9000/api/v1"}
+
+
+@pytest.mark.parametrize(
+    "url",
+    [
+        "[http://example.com](http://example.com)",
+        "ftp://example.com",
+        "https://u:secret@example.com",
+        "https://example.com?token=secret",
+        "https://example.com#token",
+        "https://example.com:99999",
+        "https://",
+        "",
+        "http://example.com/ white space",
+    ],
+)
+def test_invalid_url_does_not_echo_credentials(url):
+    with pytest.raises(ValueError) as error:
+        validate_market_url(url)
+    assert "secret" not in str(error.value)
+    assert not get_config_path().exists()
+
+
+def test_corrupted_file_fails_without_exposing_content(monkeypatch):
+    path = get_config_path()
+    path.parent.mkdir()
+    path.write_text('{"market_token": "hidden-secret"', encoding="utf-8")
+    result = CliRunner().invoke(app, ["config", "show"])
+    assert result.exit_code == 1
+    assert "hidden-secret" not in result.output
+    monkeypatch.setenv("MARKET_BASE_URL", "https://example.com/api/v1")
+    monkeypatch.setenv("MARKET_API_TOKEN", "override-secret")
+    assert resolve_market_connection().token == "override-secret"
+
+
+def test_market_client_uses_saved_connection(monkeypatch):
+    from quant_cli.app.data import data_dependency
+
+    update_saved_config("market_url", "https://example.com/market/api/v1")
+    update_saved_config("market_token", "test-secret")
+    observed = {}
+
+    def fake_client(url, *, token):
+        observed.update(url=url, token=token)
+        return observed
+
+    monkeypatch.setattr(data_dependency, "MarketClient", fake_client)
+    assert data_dependency.build_market_query() == {
+        "url": "https://example.com/market/api/v1",
+        "token": "test-secret",
+    }
+
+
+def test_invalid_token_is_not_saved_or_echoed():
+    result = CliRunner().invoke(app, ["config", "token"], input="Bearer hidden-secret\n")
+    assert result.exit_code == 1
+    assert "hidden-secret" not in result.output
+    assert not get_config_path().exists()
+
+
+def test_failed_atomic_replace_preserves_previous_config(monkeypatch):
+    update_saved_config("market_token", "old-secret")
+    original = get_config_path().read_bytes()
+
+    def fail_replace(*args):
+        raise OSError("test write failure")
+
+    monkeypatch.setattr(os, "replace", fail_replace)
+    with pytest.raises(ValueError, match="无法保存"):
+        update_saved_config("market_token", "new-secret")
+    assert get_config_path().read_bytes() == original
+    assert not list(get_config_path().parent.glob(".config-*"))

{powerquant_cli-0.2.6 → powerquant_cli-0.2.7}/uv.lock

@@ -365,7 +365,7 @@ wheels = [
 
 [[package]]
 name = "powerquant-cli"
-version = "0.2.6"
+version = "0.2.7"
 source = { editable = "." }
 dependencies = [
     { name = "duckdb" },

powerquant_cli-0.2.6/README.md

@@ -1,41 +0,0 @@
-# Power Quant CLI
-
-本地行情准备、因子计算、选股、研究及策略回测；结果保存在本地 DuckDB 和文件。
-
-## 安装
-
-推荐通过 uv 安装独立工具环境：
-
-```sh
-uv tool install --python 3.12 powerquant-cli
-pq --help
-uv tool upgrade powerquant-cli
-```
-
-也支持在 Python 3.12+ 环境通过 `pip install powerquant-cli` 安装。
-
-## 接入行情
-
-向管理员获取行情读取密钥，无需注册账户。服务当前仅在 LAN/WireGuard 内可达。
-
-```sh
-export MARKET_BASE_URL='http://服务器地址/market/api/v1'
-export MARKET_API_TOKEN='管理员提供的行情密钥'
-pq examples --directory powerquant-examples
-cd powerquant-examples/selection
-pq data prepare --config prepare.json
-```
-
-PowerShell 使用 `$env:MARKET_BASE_URL="..."` 与 `$env:MARKET_API_TOKEN="..."`。
-
-按实际覆盖调整 prepare.json 的股票和日期，将返回 manifest_path 写入 compute.json、select.json；按示例 README 执行 compute、select 和 backtest。不同使用目的的快照须分别通过完整性检查。
-
-密钥到期或撤销后在线准备会失败，已下载快照仍可离线使用。行情密钥不用于定义发布；发布定义另使用 PQ_QUANT_URL/PQ_QUANT_TOKEN。默认本地目录为 ~/.powerquant。
-
-## Python
-
-公开请求模型与调用入口位于 quant_cli.api，与 CLI 使用同一应用服务。
-
-## 使用许可
-
-自有代码采用随包附带的专有许可证：允许安装、查看源码、为自用进行修改，以及商业使用；未经书面授权不得再分发或转售本软件及其修改版本。第三方组件保留各自许可证。行情访问仍需要有效 Token；本许可证不授予行情数据的使用或再分发权。