From 3aef5d9b459b1ab49cd71e868fdda5bb570d6a80 Mon Sep 17 00:00:00 2001
From: Pigbibi <20649888+Pigbibi@users.noreply.github.com>
Date: Mon, 6 Jul 2026 19:01:19 +0800
Subject: [PATCH 1/3] docs: clarify QSL architecture role

Co-Authored-By: Codex <noreply@openai.com>
---
 README.md       | 9 +++++++++
 README.zh-CN.md | 9 +++++++++
 2 files changed, 18 insertions(+)

diff --git a/README.md b/README.md
index 136048f..01d2cf5 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,14 @@
 # QmtPlatform
 
+
+## QSL architecture role
+
+- **Layer**: `runtime-platform`.
+- **Responsibility**: QMT / miniQMT A-share execution runtime.
+- **Owns**: QMT runtime controls and A-share platform integration.
+- **Consumes**: CnEquityStrategies, CnEquitySnapshotPipelines artifacts, QuantPlatformKit, QuantRuntimeSettings.
+- **Must not**: own strategy research logic or publish snapshot artifacts.
+
 A-share quant platform layer for **miniQMT / QMT**, built on `QuantPlatformKit` and `CnEquityStrategies`.
 
 Current scope is **dry-run first**: evaluate strategy targets and preview orders without submitting to the broker.
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 0e4da5e..6d641e1 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -1,5 +1,14 @@
 # QmtPlatform
 
+
+## QSL 架构角色
+
+- **层级**：`执行平台`。
+- **职责**：QMT / miniQMT A 股执行运行时。
+- **事实源/归属**：QMT runtime 控制和 A 股平台集成。
+- **消费对象**：CnEquityStrategies、CnEquitySnapshotPipelines artifacts、QuantPlatformKit、QuantRuntimeSettings。
+- **禁止事项**：承载策略研究逻辑或发布 snapshot artifacts。
+
 A 股量化平台层，基于 `QuantPlatformKit` 和 `CnEquityStrategies` 构建，对接 **miniQMT / QMT**。
 
 当前范围为**仅干跑**：评估策略目标并预览订单，不向券商提交实盘。

From edfe4cb4200e489b76095e32e7b5ab8db6ae1b25 Mon Sep 17 00:00:00 2001
From: Pigbibi <20649888+Pigbibi@users.noreply.github.com>
Date: Mon, 6 Jul 2026 19:18:26 +0800
Subject: [PATCH 2/3] ci: respect internal dependency pins

Co-Authored-By: Codex <noreply@openai.com>
---
 .github/workflows/ci.yml | 22 ++++++++--------------
 1 file changed, 8 insertions(+), 14 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index c550d95..00e24d2 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -20,26 +20,20 @@ jobs:
         id: quant-platform-kit-ref
         run: |
           set -euo pipefail
-          ref="main"
-          for candidate in "${GITHUB_HEAD_REF:-}" "${GITHUB_BASE_REF:-}"; do
-            if [ -n "$candidate" ] && git ls-remote --exit-code --heads https://github.com/QuantStrategyLab/QuantPlatformKit.git "$candidate" >/dev/null 2>&1; then
-              ref="$candidate"
-              break
-            fi
-          done
+          ref="$(grep -Eo 'QuantPlatformKit\.git@[0-9a-f]+' pyproject.toml | head -n1 | sed 's/.*@//')"
+          if [ -n "${GITHUB_HEAD_REF:-}" ] && git ls-remote --exit-code --heads https://github.com/QuantStrategyLab/QuantPlatformKit.git "${GITHUB_HEAD_REF}" >/dev/null 2>&1; then
+            ref="${GITHUB_HEAD_REF}"
+          fi
           echo "ref=${ref}" >> "$GITHUB_OUTPUT"
 
       - name: Resolve CnEquityStrategies ref
         id: cn-equity-strategies-ref
         run: |
           set -euo pipefail
-          ref="main"
-          for candidate in "${GITHUB_HEAD_REF:-}" "${GITHUB_BASE_REF:-}"; do
-            if [ -n "$candidate" ] && git ls-remote --exit-code --heads https://github.com/QuantStrategyLab/CnEquityStrategies.git "$candidate" >/dev/null 2>&1; then
-              ref="$candidate"
-              break
-            fi
-          done
+          ref="$(grep -Eo 'CnEquityStrategies\.git@[0-9a-f]+' pyproject.toml | head -n1 | sed 's/.*@//')"
+          if [ -n "${GITHUB_HEAD_REF:-}" ] && git ls-remote --exit-code --heads https://github.com/QuantStrategyLab/CnEquityStrategies.git "${GITHUB_HEAD_REF}" >/dev/null 2>&1; then
+            ref="${GITHUB_HEAD_REF}"
+          fi
           echo "ref=${ref}" >> "$GITHUB_OUTPUT"
 
       - name: Resolve CnEquitySnapshotPipelines ref

From f9595b7bf9b868a658327936b0c251318617a7c8 Mon Sep 17 00:00:00 2001
From: Pigbibi <20649888+Pigbibi@users.noreply.github.com>
Date: Mon, 6 Jul 2026 19:23:37 +0800
Subject: [PATCH 3/3] ci: keep qmt dependency refs pinned

Co-Authored-By: Codex <noreply@openai.com>
---
 .github/workflows/ci.yml | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 00e24d2..e4d8e7a 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -21,9 +21,6 @@ jobs:
         run: |
           set -euo pipefail
           ref="$(grep -Eo 'QuantPlatformKit\.git@[0-9a-f]+' pyproject.toml | head -n1 | sed 's/.*@//')"
-          if [ -n "${GITHUB_HEAD_REF:-}" ] && git ls-remote --exit-code --heads https://github.com/QuantStrategyLab/QuantPlatformKit.git "${GITHUB_HEAD_REF}" >/dev/null 2>&1; then
-            ref="${GITHUB_HEAD_REF}"
-          fi
           echo "ref=${ref}" >> "$GITHUB_OUTPUT"
 
       - name: Resolve CnEquityStrategies ref
@@ -31,9 +28,6 @@ jobs:
         run: |
           set -euo pipefail
           ref="$(grep -Eo 'CnEquityStrategies\.git@[0-9a-f]+' pyproject.toml | head -n1 | sed 's/.*@//')"
-          if [ -n "${GITHUB_HEAD_REF:-}" ] && git ls-remote --exit-code --heads https://github.com/QuantStrategyLab/CnEquityStrategies.git "${GITHUB_HEAD_REF}" >/dev/null 2>&1; then
-            ref="${GITHUB_HEAD_REF}"
-          fi
           echo "ref=${ref}" >> "$GITHUB_OUTPUT"
 
       - name: Resolve CnEquitySnapshotPipelines ref