From 09e65883245320683ac8859888a73b6ef71c5ff6 Mon Sep 17 00:00:00 2001
From: Pigbibi <20649888+Pigbibi@users.noreply.github.com>
Date: Mon, 6 Jul 2026 19:00:58 +0800
Subject: [PATCH] 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 ea28385..630f860 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,14 @@
 # InteractiveBrokersPlatform
 
+
+## QSL architecture role
+
+- **Layer**: `runtime-platform`.
+- **Responsibility**: Interactive Brokers multi-market execution runtime.
+- **Owns**: IBKR connectivity, paper/live controls, account/runtime integration.
+- **Consumes**: UsEquityStrategies, HkEquityStrategies, snapshot artifacts, QuantPlatformKit, QuantRuntimeSettings.
+- **Must not**: own strategy research logic or bypass dry-run checks.
+
 [Chinese README](README.zh-CN.md)
 
 > Investing involves risk. This project does not provide investment advice and is for education, research, and engineering review only.
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 9757eba..9ff363f 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -1,5 +1,14 @@
 # InteractiveBrokersPlatform
 
+
+## QSL 架构角色
+
+- **层级**：`执行平台`。
+- **职责**：Interactive Brokers 多市场执行运行时。
+- **事实源/归属**：IBKR 连接、paper/live 控制、账户/runtime 集成。
+- **消费对象**：UsEquityStrategies、HkEquityStrategies、snapshot artifacts、QuantPlatformKit、QuantRuntimeSettings。
+- **禁止事项**：承载策略研究逻辑或绕过 dry-run checks。
+
 [English README](README.md)
 
 > 投资有风险。本项目不构成投资建议，仅用于学习、研究和工程审阅。