feat: 结题报告初稿助手首版 v1.0.1（draft-closing-report-default）

tests/integration/README.md

@@ -0,0 +1,48 @@
+# integration（可选集成 / 真实外联）
+
+本目录**默认不执行**：
+
+- ``python tests/run_tests.py`` 只收集 ``tests/`` 根目录下 ``test_*.py``，**不会**进入本目录。
+- 本目录下文件一律为 ``*.py.sample``，pytest / unittest **默认也不会**按普通 ``test_*.py`` 收集。
+
+## 与 samples 的区别
+
+| 维度 | `tests/samples/` | `tests/integration/` |
+|------|------------------|------------------------|
+| 目的 | 默认可**升级**为根目录 `test_*.py` 的 **业务单元 / service 契约 / golden** 范式 | **外联联调**范式：网络、浏览器、仿真或真实系统 |
+| 默认执行 | `.sample` 不执行；复制到根目录并改名后才进入默认套件 | **永远不**作为默认 unittest 的一部分；复制后仍需显式环境变量与手动/CI 任务触发 |
+| 典型内容 | `FakeAdapter`、fixture、隔离 DB | `localhost` 仿真、真实 API、真实 RPA（最高风险） |
+
+**原则**：只要会访问**网络**、**浏览器**、**真实或仿真外部系统**，应优先放在 `integration`（并保持 `.sample` 直至团队同意启用），而不是写进默认 `tests/test_*.py`。
+
+## 何时使用
+
+| 场景 | 建议 ``OPENCLAW_TEST_TARGET`` | 其它条件 |
+|------|------------------------------|----------|
+| 本地 / CI 对接**仿真 HTTP** | ``simulator_api`` | 仿真服务如 ``http://localhost:5180`` |
+| **仿真页面** / 录播 RPA | ``simulator_rpa`` | 本地页面或沙箱浏览器 profile |
+| **真实 API** | ``real_api`` | **仅手动触发** |
+| **真实 RPA**（最高风险） | ``real_rpa`` | **仅手动触发** |
+
+## 环境变量（与 ``adapter_test_utils`` 一致）
+
+- **目标档位**：``OPENCLAW_TEST_TARGET``  
+  取值：``unit`` | ``mock`` | ``simulator_api`` | ``simulator_rpa`` | ``real_api`` | ``real_rpa``  
+  默认未设置等价于 ``unit``。
+
+## 安全约束
+
+- **禁止**在样例或复制后的测试代码中硬编码真实账号、密码、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,23 @@
+# -*- coding: utf-8 -*-
+# 样例：复制为 test_real_api_contract.py；需 OPENCLAW_TEST_TARGET=real_api。
+"""真实 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)
+        # 禁止在此文件写入真实 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。
+"""
+真实 RPA / 桌面自动化（**最高风险**，仅手动触发）。
+
+默认只读思路示例：打开沙箱门户、读取标题、**不提交表单**。
+写操作测试同样须显式设 ``OPENCLAW_TEST_TARGET=real_rpa`` 后手动触发。
+"""
+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()