docs: make public configuration examples portable (#348)

Co-authored-by: Codex <noreply@openai.com>

Author: Pigbibi

.env.example

@@ -28,5 +28,5 @@ IBKR_FORCE_RUN=false
 
 # ── Execution Report ──
 EXECUTION_REPORT_OUTPUT_DIR=/tmp/quant_runtime_reports
-EXECUTION_REPORT_GCS_URI=gs://qsl-runtime-logs-shared/execution-reports
+EXECUTION_REPORT_GCS_URI=gs://your-bucket/execution-reports
 QSL_EXECUTION_REPORT_GCS_URI=

docs/ibkr_runtime_rollout.md

@@ -60,7 +60,7 @@ Gateway 后端至少放这些字段：
 先复制一份出来改成你的真实值：
 
 ```bash
-cd /Users/lisiyi/Projects/InteractiveBrokersPlatform
+cd /path/to/InteractiveBrokersPlatform
 cp docs/examples/ibkr-account-groups.paper.json /tmp/ibkr-account-groups.json
 ```
 

tests/test_public_config_examples.py

@@ -0,0 +1,28 @@
+from pathlib import Path
+from urllib.parse import urlparse
+
+
+REPOSITORY_ROOT = Path(__file__).resolve().parents[1]
+
+
+def test_env_example_uses_portable_execution_report_gcs_uri():
+    env_example = (REPOSITORY_ROOT / ".env.example").read_text(encoding="utf-8")
+    uri = next(
+        line.partition("=")[2]
+        for line in env_example.splitlines()
+        if line.startswith("EXECUTION_REPORT_GCS_URI=")
+    )
+    parsed = urlparse(uri)
+
+    assert parsed.scheme == "gs"
+    assert parsed.netloc == "your-bucket"
+    assert parsed.path not in {"", "/"}
+
+
+def test_runtime_rollout_uses_portable_repository_path():
+    rollout = (REPOSITORY_ROOT / "docs" / "ibkr_runtime_rollout.md").read_text(
+        encoding="utf-8"
+    )
+
+    assert "/Users/" not in rollout
+    assert "cd /path/to/InteractiveBrokersPlatform" in rollout