新增完善测试模板

tests/integration/README.md

@@ -0,0 +1,43 @@
+# integration（可选集成 / 真实外联）
+
+本目录**默认不执行**：
+
+- ``python tests/run_tests.py`` 只收集 ``tests/`` 根目录下 ``test_*.py``，**不会**进入本目录。
+- 本目录下文件一律为 ``*.py.sample``，pytest / unittest **默认也不会**按普通 ``test_*.py`` 收集。
+
+## 何时使用
+
+| 场景 | 建议 ``OPENCLAW_TEST_TARGET`` | 其它条件 |
+|------|------------------------------|----------|
+| 本地 / CI 对接**仿真 HTTP** | ``simulator_api`` | 仿真服务如 ``http://localhost:5180`` |
+| **仿真页面** / 录播 RPA | ``simulator_rpa`` | 本地页面或沙箱浏览器 profile |
+| **真实 API**（只读优先） | ``real_api`` | ``ALLOW_REAL_API=1``；写操作另需 ``ALLOW_WRITE_ACTIONS=1`` |
+| **真实 RPA**（最高风险） | ``real_rpa`` | ``ALLOW_REAL_RPA=1``；**仅手动触发** |
+
+## 环境变量（与 ``adapter_test_utils`` 一致）
+
+- **目标档位**（二选一键名，后者为历史拼写）：``OPENCLAW_TEST_TARGET`` 或 ``OPENCLOW_TEST_TARGET``  
+  取值：``unit`` | ``mock`` | ``simulator_api`` | ``simulator_rpa`` | ``real_api`` | ``real_rpa``  
+  默认未设置等价于 ``unit``。
+
+- **授权开关**（显式 ``1`` 才启用）：
+  - ``ALLOW_REAL_API=1``
+  - ``ALLOW_REAL_RPA=1``
+  - ``ALLOW_WRITE_ACTIONS=1``（对写操作 / 提交表单类步骤）
+
+## 安全约束
+
+- **禁止**在样例或复制后的测试代码中硬编码真实账号、密码、token、cookie、生产 URL。
+- 凭证应来自**平台密钥库**、受控环境变量或本机安全配置（``.env`` 已列入 ``tests/.gitignore``，勿提交）。
+- 真实 RPA 可能对 ERP/TMS/WMS 等产生真实操作；**务必**沙箱账号、只读权限，并由人工触发 CI job。
+
+## 如何运行某个样例
+
+1. 将目标 ``*.sample`` 复制为 ``test_*.py``（去掉 ``.sample``）。
+2. 按技能修改其中的占位 URL / 路由 / 断言。
+3. 使用 **pytest** 指向该文件（或整目录），并导出上表所需环境变量。
+
+```powershell
+$env:OPENCLAW_TEST_TARGET = "simulator_api"
+pytest tests/integration/test_simulator_api_contract.py -v
+```

tests/integration/test_real_api_contract.py.sample

@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+# 样例：复制为 test_real_api_contract.py；需 OPENCLAW_TEST_TARGET=real_api 且 ALLOW_REAL_API=1。
+"""真实 HTTP API（只读优先；默认跳过）。"""
+from __future__ import annotations
+
+import unittest
+
+from adapter_test_utils import should_skip_profile
+
+
+class TestRealApiContractSample(unittest.TestCase):
+    def test_skip_by_default(self) -> None:
+        skip, reason = should_skip_profile("real_api", write=False)
+        if skip:
+            raise unittest.SkipTest(reason)
+        # 写操作示例（复制后使用）：
+        # skip_w, _ = should_skip_profile("real_api", write=True)
+        # 需要 ALLOW_WRITE_ACTIONS=1
+        # 禁止在此文件写入真实 token；从 vault / 环境注入读取 endpoint。
+        self.assertFalse(skip)
+
+
+if __name__ == "__main__":
+    unittest.main()

tests/integration/test_real_rpa_contract.py.sample

@@ -0,0 +1,26 @@
+# -*- coding: utf-8 -*-
+# 样例：复制为 test_real_rpa_contract.py；需 OPENCLAW_TEST_TARGET=real_rpa 且 ALLOW_REAL_RPA=1。
+"""
+真实 RPA / 桌面自动化（**最高风险**，仅手动触发）。
+
+默认只读思路示例：打开沙箱门户、读取标题、**不提交表单**。
+任何写操作必须 ``should_skip_profile('real_rpa', write=True)`` 且 ``ALLOW_WRITE_ACTIONS=1``。
+"""
+from __future__ import annotations
+
+import unittest
+
+from adapter_test_utils import should_skip_profile
+
+
+class TestRealRpaContractSample(unittest.TestCase):
+    def test_skip_by_default(self) -> None:
+        skip, reason = should_skip_profile("real_rpa", write=False)
+        if skip:
+            raise unittest.SkipTest(reason)
+        # 真实技能中：连接企业沙箱门户，执行只读断言；禁止默认操作生产系统。
+        self.assertFalse(skip)
+
+
+if __name__ == "__main__":
+    unittest.main()

tests/integration/test_simulator_api_contract.py.sample

@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+# 样例：复制为 test_simulator_api_contract.py 后，在 OPENCLAW_TEST_TARGET=simulator_api 下用 pytest 或 unittest 运行。
+"""仿真 HTTP API 契约（默认跳过；不引入 requests 运行时依赖）。"""
+from __future__ import annotations
+
+import unittest
+
+from adapter_test_utils import should_skip_profile
+
+
+class TestSimulatorApiContractSample(unittest.TestCase):
+    """演示：仅当 ``OPENCLAW_TEST_TARGET=simulator_api`` 时不跳过。"""
+
+    def test_skip_unless_simulator_api_target(self) -> None:
+        skip, reason = should_skip_profile("simulator_api")
+        if skip:
+            raise unittest.SkipTest(reason)
+        # 真实技能中：在此使用 urllib 访问 localhost 仿真，或通过 adapter factory 注入 stub。
+        # 禁止默认连接生产 ERP/TMS。
+        self.assertTrue(True)
+
+
+if __name__ == "__main__":
+    unittest.main()

tests/integration/test_simulator_rpa_contract.py.sample

@@ -0,0 +1,21 @@
+# -*- coding: utf-8 -*-
+# 样例：复制为 test_simulator_rpa_contract.py 后按需运行；默认跳过。
+"""仿真页面 / RPA 契约（不默认启动浏览器）。"""
+from __future__ import annotations
+
+import unittest
+
+from adapter_test_utils import should_skip_profile
+
+
+class TestSimulatorRpaContractSample(unittest.TestCase):
+    def test_skip_unless_simulator_rpa_target(self) -> None:
+        skip, reason = should_skip_profile("simulator_rpa")
+        if skip:
+            raise unittest.SkipTest(reason)
+        # 真实技能中：可替换为 Playwright 连接 http://localhost:5180/select 等仿真入口。
+        self.assertFalse(skip)
+
+
+if __name__ == "__main__":
+    unittest.main()