@microi.net/cli 5.9.9 → 6.0.1

package/skills/playwright-e2e/SKILL.md

@@ -1,189 +1,191 @@
----
-name: playwright-e2e
-description: 按 Microi 系统真实业务逻辑进行 Playwright 全自动化、全面测试。用于测试 PC Vue、本地多 ApiBase/OsClient 独立浏览器上下文、远端运行目标识别、前端微服务菜单切换与 keep-alive/LRU、uni-app H5、网站、界面引擎、移动商城、ApiEngine/FormEngine 契约、登录流程、写入闭环、网络防护、截图、报告和 Playwright Test for VSCode 集成。
----
-
-> **Microi吾码基础规范（强制）：** 任何 AI 模型与宿主每次新建或接续吾码任务，先完整读取 `../workspace-conventions/SKILL.md`，必须执行版本播报、`@microi.net/cli` 后台自动升级、Skills/MCP 同步和进度播报。安装与诊断读取 `../microi-codex-installer/SKILL.md`；更新失败延后重试，不阻断当前工作。
-
-# Microi 吾码 Playwright E2E 自动化测试
-
-> **2026-05 更新（重要）**：Microi.Agent 插件生成的E2E 配置、用例和帮助器保留在 `<projectRoot>/.microi-e2e/`；运行产物统一输出到 `<gitRoot>/.tmp/microi-e2e/<项目相对路径>/`，**不再**写入 `tests/e2e/`、根目录 `playwright.config.js` 或 `.env.e2e.example`。
-> - `playwright.config.js` 位于 `.microi-e2e/playwright.config.js`，`testDir` 为 `./` （即 `.microi-e2e/specs/`）
-> - 报告、截图、trace、video 和 test-results 放在对应 `.tmp/microi-e2e/` 项目子目录
-> - 上下文 `.microi-e2e/.microi-playwright-context.json`
-> - 本文档下方仍有大量 `tests/e2e/...` 写法，均为历史风格示意，**实际生成路径以 `.microi-e2e/` 为准**。手写测试（如 `tests/blueprint-e2e.spec.mjs`）不受影响。
-
-`E2E` 是 `End-to-End`，中文通常叫"端到端测试"。它强调从用户入口开始，穿过前端页面、接口引擎、表单引擎、权限、缓存、数据库等真实链路，验证一条业务路径是否真的可交付。
-
-真实依赖与发布范围沿用 `../workspace-conventions/SKILL.md` 的“平台回归与独立应用测试归属”：常规验证指定 MCP 实际使用的 MySQL、MongoDB、Redis 和 MinIO 或 OSS/HDFS，不要求额外 SQL Server 环境；仅用户明确指定 SQL Server 问题时才做其专项。按 [发布测试矩阵](../microi-system-delivery/references/progressive-02-自动化测试必须覆盖的坑.md#按指定-mcp-选择发布测试矩阵) 记录实际覆盖，保留正常登录、业务闭环与资源收尾，不以连接成功代替真实读写验收。
-
+---
+name: playwright-e2e
+description: 按 Microi 系统真实业务逻辑进行 Playwright 全自动化、全面测试。用于测试 PC Vue、本地多 ApiBase/OsClient 独立浏览器上下文、远端运行目标识别、前端微服务菜单切换与 keep-alive/LRU、uni-app H5、网站、界面引擎、移动商城、ApiEngine/FormEngine 契约、登录流程、写入闭环、网络防护、截图、报告和 Playwright Test for VSCode 集成。
+---
+
+> **Microi吾码基础规范（强制）：** 任何 AI 模型与宿主每次新建或接续吾码任务，先完整读取 `../workspace-conventions/SKILL.md`，必须执行版本播报、`@microi.net/cli` 后台自动升级、Skills/MCP 同步和进度播报。安装与诊断读取 `../microi-codex-installer/SKILL.md`；更新失败延后重试，不阻断当前工作。
+
+# Microi 吾码 Playwright E2E 自动化测试
+
+每轮测试成功、失败、取消或中断退出时，在 `finally` / teardown 中关闭本任务 browser/context 和临时写入进程，再按 [测试临时文件随任务清理](../workspace-conventions/SKILL.md#测试临时文件必须随任务清理强制) 删除本任务 `.tmp` 下的一次性脚本、夹具及无用途的截图、trace、video、日志和编译副本。交付必需证据先最小归档并回读，失败排查只暂留有明确归属和清理时机的最小集合；报告和截图路径规则不构成永久保留许可，结束后必须单独验收清理结果。
+
+> **2026-05 更新（重要）**：Microi.Agent 插件生成的E2E 配置、用例和帮助器保留在 `<projectRoot>/.microi-e2e/`；运行产物统一输出到 `<gitRoot>/.tmp/microi-e2e/<项目相对路径>/`，**不再**写入 `tests/e2e/`、根目录 `playwright.config.js` 或 `.env.e2e.example`。
+> - `playwright.config.js` 位于 `.microi-e2e/playwright.config.js`，`testDir` 为 `./` （即 `.microi-e2e/specs/`）
+> - 报告、截图、trace、video 和 test-results 放在对应 `.tmp/microi-e2e/` 项目子目录
+> - 上下文 `.microi-e2e/.microi-playwright-context.json`
+> - 本文档下方仍有大量 `tests/e2e/...` 写法，均为历史风格示意，**实际生成路径以 `.microi-e2e/` 为准**。手写测试（如 `tests/blueprint-e2e.spec.mjs`）不受影响。
+
+`E2E` 是 `End-to-End`，中文通常叫"端到端测试"。它强调从用户入口开始，穿过前端页面、接口引擎、表单引擎、权限、缓存、数据库等真实链路，验证一条业务路径是否真的可交付。
+
+真实依赖与发布范围沿用 `../workspace-conventions/SKILL.md` 的“平台回归与独立应用测试归属”：常规验证指定 MCP 实际使用的 MySQL、MongoDB、Redis 和 MinIO 或 OSS/HDFS，不要求额外 SQL Server 环境；仅用户明确指定 SQL Server 问题时才做其专项。按 [发布测试矩阵](../microi-system-delivery/references/progressive-02-自动化测试必须覆盖的坑.md#按指定-mcp-选择发布测试矩阵) 记录实际覆盖，保留正常登录、业务闭环与资源收尾，不以连接成功代替真实读写验收。
+
 <!-- microi-progressive:begin -->
-<!-- microi-progressive:chunk id=playwright-e2e-000 sha256=a6ef528a2a940fd0f58efaee6b73eb5dbc159db93d95afedf41c7b8642536d18 -->
-## 是否需要 `-e2e` 后缀
-
-建议保留 `playwright-e2e` 这个 skill 名称。
-
-- Playwright 也能做接口测试、组件测试和截图巡检，但在 Microi 中最关键的价值是“像真实用户一样跑通低代码系统”。
-- `-e2e` 能让 AI 明确区分它和 `v8-debugging`、`v8-crud-api`、`playwright-ct` 等其他能力。
-- 如果未来要补更细的能力，可以新增 `playwright-api` 或 `visual-regression`，不要把当前 skill 改成泛泛的 `playwright`。
-
+<!-- microi-progressive:chunk id=playwright-e2e-000 sha256=f04614f276c139cfa50b9e46e89857675c6dc5e7cf0cfbfde76d6e6dbe9746c9 -->
+## 是否需要 `-e2e` 后缀
+
+建议保留 `playwright-e2e` 这个 skill 名称。
+
+- Playwright 也能做接口测试、组件测试和截图巡检，但在 Microi 中最关键的价值是“像真实用户一样跑通低代码系统”。
+- `-e2e` 能让 AI 明确区分它和 `v8-debugging`、`v8-crud-api`、`playwright-ct` 等其他能力。
+- 如果未来要补更细的能力，可以新增 `playwright-api` 或 `visual-regression`，不要把当前 skill 改成泛泛的 `playwright`。
+
 <!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=playwright-e2e-001 sha256=b3970a9a4603447651520667c05ab4ecfae01b65b3f752e9f318007c5e2699c1 -->
-## 适用范围
-
-- PC 管理端：`Microi.Client`、租户后台、运营后台。
-- uni-app H5：移动商城、会员中心、H5 工作台。
-- Page Engine 页面：大屏、仪表盘、官网页面。
-- 接口引擎验收：直接用 Playwright `request` 调 `/apiengine/{ApiEngineKey}`。
-- 交付冒烟：登录、主导航、核心业务流、退出登录、关键页面截图。
-
-不适合把 Playwright 用来替代 V8 单函数调试。单个接口引擎的入参输出优先用 VS Code 插件远程执行、MCP `microi_run_engine` 或后端单元测试。
-
+<!-- microi-progressive:chunk id=playwright-e2e-001 sha256=703786ae7a5a52cb39664f1c82de7fb7aa7dfece511046d3757da64918c23063 -->
+## 适用范围
+
+- PC 管理端：`Microi.Client`、租户后台、运营后台。
+- uni-app H5：移动商城、会员中心、H5 工作台。
+- Page Engine 页面：大屏、仪表盘、官网页面。
+- 接口引擎验收：直接用 Playwright `request` 调 `/apiengine/{ApiEngineKey}`。
+- 交付冒烟：登录、主导航、核心业务流、退出登录、关键页面截图。
+
+不适合把 Playwright 用来替代 V8 单函数调试。单个接口引擎的入参输出优先用 VS Code 插件远程执行、MCP `microi_run_engine` 或后端单元测试。
+
 <!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=playwright-e2e-002 sha256=5874137c92e16fd5cc729fd9c23d051caa3e64438fc7bee1d717ae9c5a0f2a90 -->
-## 临时文件与产物放置规则（必须遵守）
-
-AI 在工作区内生成的**一次性临时脚本、诊断文件、截图、测试报告**等，**绝对不能放在工作区根目录**，必须放在以下指定位置：
-
-| 类型 | 放置位置 |
-|------|---------|
-| 一次性 Python/JS/PS1 脚本 | `<workspace-root>/.tmp/` |
-| 诊断截图、调试输出 | `<workspace-root>/.tmp/screenshots/` 或子目录 |
-| E2E 配置、用例、帮助器 | `<projectRoot>/.microi-e2e/` |
-| E2E 截图、报告、trace、video、test-results | `<gitRoot>/.tmp/microi-e2e/<项目相对路径>/` |
-| AI 一次性 Playwright 脚本、截图、日志、报告 | `<workspace-root>/.tmp/`、`<workspace-root>/.tmp/screenshots/`、`<workspace-root>/.tmp/reports/` |
-| 性能测试报告 | `<workspace-root>/.microi-performance/`（仅限此目录） |
-
-**禁止在根目录创建的文件类型**：`*.mjs`、`*.py`、`*.ps1`、`*.sh`（一次性脚本）、`*.png`、`screenshots/`、`node_modules/`（无 package.json 时）、`obj/`（非 .NET 项目文件）、`dark-mode-*/`、`test-*/` 等临时目录。
-
-`.tmp/` 目录已在 `.gitignore` 中排除，AI 可以在此创建临时文件。收尾清理只允许针对已确认归属的本任务子目录；删除前核对解析后的绝对路径、所有权和保留价值，不得整体删除共享 `.tmp/` 或其它任务的产物。临时文件保留不等于允许保留测试进程或容器。
-
-**2026-06 强制补充**：AI 手写的一次性 Playwright 验证脚本、运行日志、截图和报告只能写到工作区根目录 `.tmp/`。不要写到 `Microi.Client/`、`Microi.Server/`、`microi.doc/` 或其它子项目目录，即使这些目录已有 `tests/` 目录也不例外。只有 Microi.Agent 插件正式初始化的可复用 E2E 工程，才使用 `.microi-e2e/`。
-
+<!-- microi-progressive:chunk id=playwright-e2e-002 sha256=acef3e589cf11f3c197ee0b0ccf56d96b3f286263d54161b3c260e07c2090ed0 -->
+## 临时文件与产物放置规则（必须遵守）
+
+AI 在工作区内生成的**一次性临时脚本、诊断文件、截图、测试报告**等，**绝对不能放在工作区根目录**，必须放在以下指定位置：
+
+| 类型 | 放置位置 |
+|------|---------|
+| 一次性 Python/JS/PS1 脚本 | `<workspace-root>/.tmp/` |
+| 诊断截图、调试输出 | `<workspace-root>/.tmp/screenshots/` 或子目录 |
+| E2E 配置、用例、帮助器 | `<projectRoot>/.microi-e2e/` |
+| E2E 截图、报告、trace、video、test-results | `<gitRoot>/.tmp/microi-e2e/<项目相对路径>/` |
+| AI 一次性 Playwright 脚本、截图、日志、报告 | `<workspace-root>/.tmp/`、`<workspace-root>/.tmp/screenshots/`、`<workspace-root>/.tmp/reports/` |
+| 性能测试报告 | `<workspace-root>/.microi-performance/`（仅限此目录） |
+
+**禁止在根目录创建的文件类型**：`*.mjs`、`*.py`、`*.ps1`、`*.sh`（一次性脚本）、`*.png`、`screenshots/`、`node_modules/`（无 package.json 时）、`obj/`（非 .NET 项目文件）、`dark-mode-*/`、`test-*/` 等临时目录。
+
+`.tmp/` 目录已在 `.gitignore` 中排除，AI 可以在此创建临时文件。收尾清理只允许针对已确认归属的本任务子目录；删除前核对解析后的绝对路径、所有权和保留价值，不得整体删除共享 `.tmp/` 或其它任务的产物。临时文件保留不等于允许保留测试进程或容器。
+
+**2026-06 强制补充**：AI 手写的一次性 Playwright 验证脚本、运行日志、截图和报告只能写到工作区根目录 `.tmp/`。不要写到 `Microi.Client/`、`Microi.Server/`、`microi.doc/` 或其它子项目目录，即使这些目录已有 `tests/` 目录也不例外。只有 Microi.Agent 插件正式初始化的可复用 E2E 工程，才使用 `.microi-e2e/`。
+
 <!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=playwright-e2e-003 sha256=247ddb9017c174f0daa88d1f6e4220c5530b79c5ac976e61e128ed8bd0aa1fea -->
-## 标准目录
-
-前端项目中推荐使用 `tests/e2e`，而不是根目录 `e2e`，这样能和单元测试、组件测试并列。
-
-```text
-<frontend-project>/
-  playwright.config.js
-  tests/
-    e2e/
-      helpers/
-        microi.js
-      specs/
-        auth.spec.js
-        smoke.spec.js
-        <business-flow>.spec.js
-      screenshots/
-      report/
-```
-
+<!-- microi-progressive:chunk id=playwright-e2e-003 sha256=69b8842a221a0de60f8605c5059deee391be0f16f0b6cbc5ddfb3cfd210268db -->
+## 标准目录
+
+前端项目中推荐使用 `tests/e2e`，而不是根目录 `e2e`，这样能和单元测试、组件测试并列。
+
+```text
+<frontend-project>/
+  playwright.config.js
+  tests/
+    e2e/
+      helpers/
+        microi.js
+      specs/
+        auth.spec.js
+        smoke.spec.js
+        <business-flow>.spec.js
+      screenshots/
+      report/
+```
+
 <!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=playwright-e2e-004 sha256=f71fe44f7d5753b93804dac958ea8205cddcaee25188a8417b33770e305c46ed -->
-## 必备环境变量
-
-```bash
-PW_BASE_URL=http://127.0.0.1:5180
-PW_API_BASE=https://api.example.com
-PW_OS_CLIENT=demo
-PW_WEB_SERVER_COMMAND="npm run dev:h5 -- --host 0.0.0.0 --port 5180"
-PW_WEB_SERVER_URL=http://127.0.0.1:5180
-PW_BROWSER_CHANNEL=msedge
-```
-
-常用业务变量：
-
-```bash
-PW_LOGIN_ENGINE=member_login
-PW_TEST_ACCOUNT=<从本地配置读取或用环境变量覆盖>
-PW_TEST_PASSWORD=<从本地配置读取或用环境变量覆盖>
-PW_HOME_PATH=/#/pages/index/index
-```
-
+<!-- microi-progressive:chunk id=playwright-e2e-004 sha256=4f5e11baf4651c11b5f9819a0b4f33ce2590db1733d4db72814bd1a25daf56ff -->
+## 必备环境变量
+
+```bash
+PW_BASE_URL=http://127.0.0.1:5180
+PW_API_BASE=https://api.example.com
+PW_OS_CLIENT=demo
+PW_WEB_SERVER_COMMAND="npm run dev:h5 -- --host 0.0.0.0 --port 5180"
+PW_WEB_SERVER_URL=http://127.0.0.1:5180
+PW_BROWSER_CHANNEL=msedge
+```
+
+常用业务变量：
+
+```bash
+PW_LOGIN_ENGINE=member_login
+PW_TEST_ACCOUNT=<从本地配置读取或用环境变量覆盖>
+PW_TEST_PASSWORD=<从本地配置读取或用环境变量覆盖>
+PW_HOME_PATH=/#/pages/index/index
+```
+
 <!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=playwright-e2e-005 sha256=a66696c3263f060d0b7be309a527fca6a9bad95dd534eabbe84f1b6539770d8e -->
-## 本地测试账号自动发现
-
-当没有显式传入 `PW_TEST_ACCOUNT` / `PW_TEST_PASSWORD` / `MICROI_OSCLIENT` 时，AI 不要把账号密码写入后端配置来制造旁路：
-
-1. 读取 `Microi.Server/Microi.net.Api/.microi-local`，取得当前环境名。
-2. 账号密码只从用户本轮明确提供、`PW_TEST_ACCOUNT` / `PW_TEST_PASSWORD`、CI Secret 或既有受保护登录态取得；`appsettings.*.json` 不再保存测试账号密码。
-3. 这些值只作为自动化进程的登录输入或接口请求参数使用。日志、最终回复、截图说明、报告和异常消息中必须写成 `<redacted>` 或“本地配置凭据”，不要展开真实账号密码、Token、连接串或 Redis 密码。
-4. 如果凭据不存在或登录失败，再报告具体阻塞点，例如“未提供受保护测试凭据”“本地后端未启动”“登录接口返回 Code=0”，不要泛泛说无法测试。
-
-### 跨 ApiBase / OsClient 本地自动化（强制）
-
-1. 复用工作区唯一的 `61500` Vite 服务，但每组 `ApiBase + OsClient` 创建独立
-   `browser.newContext()`；禁止在同一个 context 的多个 Page 中混测不同租户。
-2. 本地入口固定把参数放在 `#` 前：
-   `http://localhost:61500/?OsClient=${encodeURIComponent(osClient)}&ApiBase=${encodeURIComponent(apiBase)}#/route`。
-   URL 参数应覆盖 `index.html`、`src/config.json`、Pinia 和 localStorage。
-3. 页面初始化后读取 `window.__MICROI_RUNTIME_ENDPOINT__`，断言实际 ApiBase/OsClient 与测试目标
-   完全一致再登录或点击业务。该对象不得包含 Token。
-4. 从线上地址复现时，先在一次性独立 context 读取上述对象；旧版回退到页面全局值、
-   `localStorage['microi.net']` 和域名租户解析。不能根据标题猜租户，也不能复用线上 context 跑本地。
-5. 人工第二租户至少使用无痕窗口；多个无痕窗口可能共享同一临时会话，更多并行目标使用独立
-   Profile/`--user-data-dir`。自动化收尾只关闭自己创建的 context/browser。
-
+<!-- microi-progressive:chunk id=playwright-e2e-005 sha256=51567cea5fca434f9b031fef0871454100cf4715dfb65695dc1722bd275399be -->
+## 本地测试账号自动发现
+
+当没有显式传入 `PW_TEST_ACCOUNT` / `PW_TEST_PASSWORD` / `MICROI_OSCLIENT` 时，AI 不要把账号密码写入后端配置来制造旁路：
+
+1. 读取 `Microi.Server/Microi.net.Api/.microi-local`，取得当前环境名。
+2. 账号密码只从用户本轮明确提供、`PW_TEST_ACCOUNT` / `PW_TEST_PASSWORD`、CI Secret 或既有受保护登录态取得；`appsettings.*.json` 不再保存测试账号密码。
+3. 这些值只作为自动化进程的登录输入或接口请求参数使用。日志、最终回复、截图说明、报告和异常消息中必须写成 `<redacted>` 或“本地配置凭据”，不要展开真实账号密码、Token、连接串或 Redis 密码。
+4. 如果凭据不存在或登录失败，再报告具体阻塞点，例如“未提供受保护测试凭据”“本地后端未启动”“登录接口返回 Code=0”，不要泛泛说无法测试。
+
+### 跨 ApiBase / OsClient 本地自动化（强制）
+
+1. 复用工作区唯一的 `61500` Vite 服务，但每组 `ApiBase + OsClient` 创建独立
+   `browser.newContext()`；禁止在同一个 context 的多个 Page 中混测不同租户。
+2. 本地入口固定把参数放在 `#` 前：
+   `http://localhost:61500/?OsClient=${encodeURIComponent(osClient)}&ApiBase=${encodeURIComponent(apiBase)}#/route`。
+   URL 参数应覆盖 `index.html`、`src/config.json`、Pinia 和 localStorage。
+3. 页面初始化后读取 `window.__MICROI_RUNTIME_ENDPOINT__`，断言实际 ApiBase/OsClient 与测试目标
+   完全一致再登录或点击业务。该对象不得包含 Token。
+4. 从线上地址复现时，先在一次性独立 context 读取上述对象；旧版回退到页面全局值、
+   `localStorage['microi.net']` 和域名租户解析。不能根据标题猜租户，也不能复用线上 context 跑本地。
+5. 人工第二租户至少使用无痕窗口；多个无痕窗口可能共享同一临时会话，更多并行目标使用独立
+   Profile/`--user-data-dir`。自动化收尾只关闭自己创建的 context/browser。
+
 <!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=playwright-e2e-006 sha256=6aeefebda3a9e598564c53c2f8028a4ccefe2291c4c7c7ae4781ca15fb5d0697 -->
-## 后端改动后的 E2E 前置动作
-
-如果本轮任务修改过 `Microi.Server/**` 后端源码、配置、控制器、服务、依赖项目或接口行为，跑 Playwright、页面截图、接口验收或前后端联调前，必须先按 `workspace-conventions` 的“后端代码改动后的重启验收”完成：
-
-1. 编译后端。
-2. 停止旧的本地 `Microi.net.Api` 进程。
-3. 在 `Microi.Server/Microi.net.Api` 目录用 `dotnet run --launch-profile Microi.net.Api` 重新启动。
-4. 从 launch profile 回读实际地址（当前标准工作区为 `https://localhost:61501`），验证端口已监听并且进程未立即崩溃。
-
-不要只说“代码已编译”或“需要用户自己重启后端”；除非用户明确要求不要中断当前服务，否则 AI 要主动完成重启。
-
+<!-- microi-progressive:chunk id=playwright-e2e-006 sha256=88e1002cae934acd2de5af2f77f371a9ea152a525eecf11b49fe182b16a56044 -->
+## 后端改动后的 E2E 前置动作
+
+如果本轮任务修改过 `Microi.Server/**` 后端源码、配置、控制器、服务、依赖项目或接口行为，跑 Playwright、页面截图、接口验收或前后端联调前，必须先按 `workspace-conventions` 的“后端代码改动后的重启验收”完成：
+
+1. 编译后端。
+2. 停止旧的本地 `Microi.net.Api` 进程。
+3. 在 `Microi.Server/Microi.net.Api` 目录用 `dotnet run --launch-profile Microi.net.Api` 重新启动。
+4. 从 launch profile 回读实际地址（当前标准工作区为 `https://localhost:61501`），验证端口已监听并且进程未立即崩溃。
+
+不要只说“代码已编译”或“需要用户自己重启后端”；除非用户明确要求不要中断当前服务，否则 AI 要主动完成重启。
+
 <!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=playwright-e2e-007 sha256=ee40e4f023e1da07269f9ebb82522720c4f014cfc9500885db09778dd819b9a6 -->
-## 服务自启动纪律（必做）
-
-执行自动化测试、截图巡检、接口引擎回读、`/apiengine/{key}` 验收时，如果本地后端或前端不可达，不能把 `fetch failed`、`ECONNREFUSED`、`000 Failed to connect`、端口无人监听当作任务终点。必须先自动启动所需服务，再继续完整验证。
-
-同一工作区有多个 AI 对话时，服务自启动还必须遵守共享生命周期：
-
-- 先执行 `../workspace-conventions/SKILL.md` 的“本地测试程序与依赖生命周期”统一规则：优先复用健康的本地源码程序、隔离目录中的编译产物和同组既有依赖，不按测试任务重复创建 Docker/Compose。需要双节点时启动两个本机程序进程连接同组依赖，不等于建立两套 Docker 环境。
-- API 服务启动前执行 `node Microi.Server/tools/release-lock.mjs assert api <工作区根>`，PC 服务使用 `assert pc`。Playwright `webServer`、自愈脚本或 AI 只在对应范围发布时等待；官网/Agent 发布不阻塞 `61500/61501`。同时启动前后端时分别检查两项。旧锁仅在真实进程证明所属范围后缩小阻塞范围，未知锁继续保护，不得删除活跃锁。
-- 端口健康且 PID/命令行属于当前工作区时直接复用，不得每个对话都无条件“先杀再启动”。
-  必须重载源码时才串行重启，并在状态播报中说明旧/新 PID。
-- 本地长期后端使用项目目录中的 `dotnet run --launch-profile Microi.net.Api`，禁止把
-  `bin/Release/net10.0` 或 `bin/Release/publish` 的 DLL 作为长期测试服务，否则会锁住
-  一键发布的 Release 输出。
-- 每次测试成功、失败、取消或因资源不足暂停时，都必须结束本次创建的 browser/context、临时 webServer 及其它自有测试进程；按统一规则收回新建临时容器，并独立回读进程、监听端口和容器状态确认无残留。复用的既有共享服务保持原状。VS Code 持有的
-  `playwright test-server` 与用户 Edge/Chrome 不属于孤儿清理；禁止按进程名结束所有
-  `node/dotnet/chrome/msedge`。
-- 只读盘点或精确停止使用 `Microi.Server/tools/Microi.LocalProcessManager.ps1` 的
-  `Status`、`StopBackend`、`StopFrontend`，不能让用户在任务管理器里猜 PID。
-
-默认本地后端：
-
-```powershell
-Push-Location Microi.Server/Microi.net.Api
-dotnet run --launch-profile Microi.net.Api
-Pop-Location
-```
-
-普通本地启动不要手动设置 `ASPNETCORE_ENVIRONMENT` / `DOTNET_ENVIRONMENT`；后端会读取 `Microi.Server/Microi.net.Api/.microi-local`，再加载对应的 `appsettings.{Env}.json`。如果测试脚本显式注入环境变量，则以脚本注入为准。
-
-默认 PC 前端：
-
-```powershell
-Push-Location Microi.Client
-npm run dev -- --host 0.0.0.0 --port 61500
-Pop-Location
-```
-
-uni-app H5 或移动端前端按项目自身命令启动，例如 `npm run dev:h5 -- --host 0.0.0.0 --port 5192` 或测试配置里的 `PW_WEB_SERVER_COMMAND`。如果目标测试同时依赖 PC 管理端和移动 H5，需要分别启动对应前端；不要用一个前端服务替代另一个业务入口。
-
-执行顺序：先检查端口/健康接口是否可达；不可达则用后台终端启动；等待服务输出监听地址；再重试接口同步、页面打开、Playwright 截图和断言。只有启动命令失败、缺少依赖、数据库连接失败、端口冲突无法自动换端口且无替代配置时，才算真正阻塞，并且要报告具体失败命令和错误。
-
+<!-- microi-progressive:chunk id=playwright-e2e-007 sha256=5efaf4a0ce03afc3cfc7863e0b7adadbcfcbb031bc64a1c543d611b9a489bccf -->
+## 服务自启动纪律（必做）
+
+执行自动化测试、截图巡检、接口引擎回读、`/apiengine/{key}` 验收时，如果本地后端或前端不可达，不能把 `fetch failed`、`ECONNREFUSED`、`000 Failed to connect`、端口无人监听当作任务终点。必须先自动启动所需服务，再继续完整验证。
+
+同一工作区有多个 AI 对话时，服务自启动还必须遵守共享生命周期：
+
+- 先执行 `../workspace-conventions/SKILL.md` 的“本地测试程序与依赖生命周期”统一规则：优先复用健康的本地源码程序、隔离目录中的编译产物和同组既有依赖，不按测试任务重复创建 Docker/Compose。需要双节点时启动两个本机程序进程连接同组依赖，不等于建立两套 Docker 环境。
+- API 服务启动前执行 `node Microi.Server/tools/release-lock.mjs assert api <工作区根>`，PC 服务使用 `assert pc`。Playwright `webServer`、自愈脚本或 AI 只在对应范围发布时等待；官网/Agent 发布不阻塞 `61500/61501`。同时启动前后端时分别检查两项。旧锁仅在真实进程证明所属范围后缩小阻塞范围，未知锁继续保护，不得删除活跃锁。
+- 端口健康且 PID/命令行属于当前工作区时直接复用，不得每个对话都无条件“先杀再启动”。
+  必须重载源码时才串行重启，并在状态播报中说明旧/新 PID。
+- 本地长期后端使用项目目录中的 `dotnet run --launch-profile Microi.net.Api`，禁止把
+  `bin/Release/net10.0` 或 `bin/Release/publish` 的 DLL 作为长期测试服务，否则会锁住
+  一键发布的 Release 输出。
+- 每次测试成功、失败、取消或因资源不足暂停时，都必须结束本次创建的 browser/context、临时 webServer 及其它自有测试进程；按统一规则收回新建临时容器，并独立回读进程、监听端口和容器状态确认无残留。复用的既有共享服务保持原状。VS Code 持有的
+  `playwright test-server` 与用户 Edge/Chrome 不属于孤儿清理；禁止按进程名结束所有
+  `node/dotnet/chrome/msedge`。
+- 只读盘点或精确停止使用 `Microi.Server/tools/Microi.LocalProcessManager.ps1` 的
+  `Status`、`StopBackend`、`StopFrontend`，不能让用户在任务管理器里猜 PID。
+
+默认本地后端：
+
+```powershell
+Push-Location Microi.Server/Microi.net.Api
+dotnet run --launch-profile Microi.net.Api
+Pop-Location
+```
+
+普通本地启动不要手动设置 `ASPNETCORE_ENVIRONMENT` / `DOTNET_ENVIRONMENT`；后端会读取 `Microi.Server/Microi.net.Api/.microi-local`，再加载对应的 `appsettings.{Env}.json`。如果测试脚本显式注入环境变量，则以脚本注入为准。
+
+默认 PC 前端：
+
+```powershell
+Push-Location Microi.Client
+npm run dev -- --host 0.0.0.0 --port 61500
+Pop-Location
+```
+
+uni-app H5 或移动端前端按项目自身命令启动，例如 `npm run dev:h5 -- --host 0.0.0.0 --port 5192` 或测试配置里的 `PW_WEB_SERVER_COMMAND`。如果目标测试同时依赖 PC 管理端和移动 H5，需要分别启动对应前端；不要用一个前端服务替代另一个业务入口。
+
+执行顺序：先检查端口/健康接口是否可达；不可达则用后台终端启动；等待服务输出监听地址；再重试接口同步、页面打开、Playwright 截图和断言。只有启动命令失败、缺少依赖、数据库连接失败、端口冲突无法自动换端口且无替代配置时，才算真正阻塞，并且要报告具体失败命令和错误。
+
 <!-- /microi-progressive:chunk -->
 ## 详细参考路由（渐进披露）
 

package/skills/scripts/validate-progressive-disclosure.mjs

@@ -6,6 +6,14 @@ import { fileURLToPath } from 'node:url'
 const skillsRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
 const manifest = JSON.parse(fs.readFileSync(path.join(skillsRoot, '.progressive-disclosure-manifest.json'), 'utf8'))
 const hash = (value) => crypto.createHash('sha256').update(value).digest('hex')
+// Git 检出可转换 LF/CRLF；只兼容这两种逐字符换行表示，正文和末尾换行仍必须完整匹配。
+const getTextForHash = (value, expected) => {
+  if (hash(value) === expected) return value
+  const lf = value.replace(/\r\n/g, '\n')
+  if (hash(lf) === expected) return lf
+  const crlf = lf.replace(/\n/g, '\r\n')
+  return hash(crlf) === expected ? crlf : null
+}
 const lineCount = (value) => value.length === 0 ? 0 : value.split(/\r?\n/).length
 
 // 可只验证显式修改的 Skill；默认仍检查全库，不能为并行工作区的历史漂移改写共同基线。
@@ -21,7 +29,8 @@ for (const [skillName, skill] of selected) {
   const begin = entry.indexOf('<!-- microi-progressive:begin -->')
   if (begin < 0) throw new Error(`${skillName}: missing progressive begin marker`)
   const prefix = entry.slice(0, begin)
-  if (hash(prefix) !== skill.prefixSha256) throw new Error(`${skillName}: entry prefix changed`)
+  const checkedPrefix = getTextForHash(prefix, skill.prefixSha256)
+  if (checkedPrefix === null) throw new Error(`${skillName}: entry prefix changed`)
   if (lineCount(entry) > manifest.policy.maxEntryLines) throw new Error(`${skillName}: entry exceeds line budget`)
 
   const sources = new Map([[`${skillName}/SKILL.md`, entry]])
@@ -44,11 +53,13 @@ for (const [skillName, skill] of selected) {
     const contentEnd = source.indexOf(close, contentStart)
     if (contentEnd < 0) throw new Error(`${skillName}: unterminated chunk ${chunk.id}`)
     const raw = source.slice(contentStart, contentEnd)
-    if (hash(raw) !== chunk.sha256) throw new Error(`${skillName}: chunk ${chunk.id} changed`)
-    ordered[chunk.ordinal] = raw
+    const checkedRaw = getTextForHash(raw, chunk.sha256)
+    if (checkedRaw === null) throw new Error(`${skillName}: chunk ${chunk.id} changed`)
+    ordered[chunk.ordinal] = checkedRaw
     checkedChunks += 1
   }
-  const reconstructed = prefix + ordered.join('')
+  // 每段使用其登记SHA已精确匹配的换行表示，恢复历史混合EOL；总原文仍必须逐字节命中。
+  const reconstructed = checkedPrefix + ordered.join('')
   if (hash(reconstructed) !== skill.originalSha256) {
     throw new Error(`${skillName}: reconstructed knowledge differs from original`)
   }

package/skills/scripts/validate-progressive-disclosure.test.mjs

@@ -0,0 +1,108 @@
+import assert from 'node:assert/strict'
+import crypto from 'node:crypto'
+import fs from 'node:fs'
+import path from 'node:path'
+import { spawnSync } from 'node:child_process'
+import { fileURLToPath } from 'node:url'
+import test from 'node:test'
+
+const scriptsRoot = path.dirname(fileURLToPath(import.meta.url))
+const validator = path.join(scriptsRoot, 'validate-progressive-disclosure.mjs')
+const tempRoot = path.resolve(scriptsRoot, '../../.tmp/progressive-disclosure-eol-regression')
+const hash = value => crypto.createHash('sha256').update(value).digest('hex')
+const eol = (value, ending) => value.replace(/\r\n/g, '\n').replace(/\n/g, ending)
+const prefix = '---\nname: sample\n---\n# Sample\n\n'
+const bodies = ['## First\nALPHA\n\n', '## Second\nBETA\n\n']
+const close = '<!-- /microi-progressive:chunk -->'
+
+function runFixture(options = {}) {
+  const { sourceEol = '\n', manifestEol = '\n', prefixManifestEol = manifestEol, chunkManifestEols = [manifestEol, manifestEol], referenceEol = sourceEol, mutation = '' } = options
+  fs.mkdirSync(tempRoot, { recursive: true })
+  const root = fs.mkdtempSync(path.join(tempRoot, 'case-'))
+  // 只删除本次创建的普通私有夹具；原校验器与清单始终只读。
+  try {
+    const scripts = path.join(root, 'scripts')
+    fs.mkdirSync(scripts)
+    fs.mkdirSync(path.join(root, 'sample/references'), { recursive: true })
+    fs.copyFileSync(validator, path.join(scripts, 'validate-progressive-disclosure.mjs'))
+    const chunks = bodies.map((body, ordinal) => ({
+      id: `sample-${ordinal}`, ordinal,
+      destination: ordinal === 0 ? 'sample/SKILL.md' : 'sample/references/detail.md',
+      sha256: hash(eol(body, chunkManifestEols[ordinal]))
+    }))
+    if (mutation === 'reordered') chunks.forEach(chunk => { chunk.ordinal = 1 - chunk.ordinal })
+    const manifest = {
+      version: 1,
+      policy: { maxEntryLines: 285 },
+      skills: { sample: {
+        prefixSha256: hash(eol(prefix, prefixManifestEol)),
+        originalSha256: hash(eol(prefix, prefixManifestEol) + bodies.map((body, index) => eol(body, chunkManifestEols[index])).join('')),
+        references: [{ path: 'references/detail.md' }], chunks
+      } }
+    }
+    if (mutation === 'original-hash') manifest.skills.sample.originalSha256 = '0'.repeat(64)
+    const block = (index, body) => `<!-- microi-progressive:chunk id=${chunks[index].id} sha256=${chunks[index].sha256} -->\n${body}${close}\n`
+    let actualPrefix = prefix
+    let firstBody = bodies[0]
+    if (mutation === 'prefix-text') actualPrefix = prefix.replace('Sample', 'Changed')
+    if (mutation === 'prefix-whitespace') actualPrefix = prefix.replace('# Sample', '# Sample ')
+    if (mutation === 'chunk-text') firstBody = firstBody.replace('ALPHA', 'DELTA')
+    if (mutation === 'trailing-newline') firstBody = firstBody.slice(0, -1)
+    if (mutation === 'lone-cr') firstBody = firstBody.replace('ALPHA', 'AL\rPHA')
+    let entry = actualPrefix + '<!-- microi-progressive:begin -->\n' + block(0, firstBody) + '<!-- microi-progressive:end -->\n'
+    if (mutation === 'begin-missing') entry = entry.replace('<!-- microi-progressive:begin -->', '<!-- removed -->')
+    const reference = mutation === 'chunk-missing' ? '# Empty reference\n' : '# Reference\n' + block(1, bodies[1])
+    const files = [path.join(root, '.progressive-disclosure-manifest.json'), path.join(root, 'sample/SKILL.md'), path.join(root, 'sample/references/detail.md')]
+    fs.writeFileSync(files[0], JSON.stringify(manifest))
+    fs.writeFileSync(files[1], eol(entry, sourceEol))
+    fs.writeFileSync(files[2], eol(reference, referenceEol))
+    const before = files.map(file => hash(fs.readFileSync(file)))
+    const result = spawnSync(process.execPath, [path.join(scripts, 'validate-progressive-disclosure.mjs'), 'sample'], {
+      cwd: root, encoding: 'utf8', timeout: 10_000, windowsHide: true
+    })
+    assert.equal(result.error, undefined)
+    assert.equal(result.signal, null)
+    assert.deepEqual(files.map(file => hash(fs.readFileSync(file))), before, 'validation must not rewrite source or manifest')
+    return result
+  } finally {
+    assert.equal(fs.realpathSync(root), root)
+    assert.equal(fs.lstatSync(root).isSymbolicLink(), false)
+    assert.ok(root.startsWith(tempRoot + path.sep))
+    fs.rmSync(root, { recursive: true })
+    assert.equal(fs.existsSync(root), false)
+  }
+}
+
+for (const [name, options] of [
+  ['exact LF manifest and source', {}],
+  ['mixed recorded EOL reconstructs exact original after LF checkout', { sourceEol: '\n', prefixManifestEol: '\r\n', chunkManifestEols: ['\n', '\r\n'] }],
+  ['mixed recorded EOL reconstructs exact original after CRLF checkout', { sourceEol: '\r\n', prefixManifestEol: '\n', chunkManifestEols: ['\r\n', '\n'] }],
+  ['exact CRLF manifest and source', { sourceEol: '\r\n', manifestEol: '\r\n' }],
+  ['CRLF manifest survives LF checkout', { sourceEol: '\n', manifestEol: '\r\n' }],
+  ['LF manifest survives CRLF checkout', { sourceEol: '\r\n', manifestEol: '\n' }],
+  ['reference checkout ending may differ without changing text', { sourceEol: '\n', referenceEol: '\r\n', manifestEol: '\r\n' }]
+]) {
+  test(name, () => {
+    const result = runFixture(options)
+    assert.equal(result.status, 0, result.stderr)
+    assert.match(result.stdout, /Validated 1 skills and 2 lossless chunks/)
+  })
+}
+
+for (const [name, mutation, error] of [
+  ['prefix body remains significant', 'prefix-text', /entry prefix changed/],
+  ['prefix whitespace is not trimmed', 'prefix-whitespace', /entry prefix changed/],
+  ['chunk body remains significant', 'chunk-text', /chunk sample-0 changed/],
+  ['manifest chunk reordering remains rejected', 'reordered', /reconstructed knowledge differs/],
+  ['wrong original hash remains rejected', 'original-hash', /reconstructed knowledge differs/],
+  ['missing chunk remains rejected', 'chunk-missing', /missing chunk sample-1/],
+  ['last newline remains significant', 'trailing-newline', /chunk sample-0 changed/],
+  ['standalone CR is not a line ending conversion', 'lone-cr', /chunk sample-0 changed/],
+  ['missing progressive begin remains rejected', 'begin-missing', /missing progressive begin marker/]
+]) {
+  test(name, () => {
+    const result = runFixture({ sourceEol: '\n', manifestEol: '\r\n', mutation })
+    assert.equal(result.status, 1)
+    assert.match(result.stderr, error)
+  })
+}

package/skills/ui-design/SKILL.md

@@ -215,7 +215,7 @@ Microi 项目必须支持用户或项目级形态偏好：`data-mci-shape="round
 - **弹窗与抽屉边界有区别**：表单对话框采用中性细边界、柔和遮罩与模糊背景，标题顶部不加装饰色线；抽屉必须贴边且无圆角，可在顶部保留克制的 2–3px 主题色识别线。两者都使用连续的柔和表单画布和紧凑操作区；设计器双击字段弹窗必须可拖动，并继续提供控件专项配置入口。
 - **平台 Dialog 统一壳**：除 Drawer 外，框架弹层、微应用弹层、系统设置、商城、通知与业务表单默认使用 20–24px 大圆角、上下左右居中、标题栏可拖动的 Dialog；禁止页面自行恢复方角壳或顶部主题色粗线。标题栏左侧依次提供语义图标、英文眉题、大字标题和可选小字副标题；右上关闭按钮与标题区垂直居中并必须有可辨识的按钮底色。内容区使用连续、固定的柔和背景和整齐栅格；底部操作区右对齐大号关闭/保存按钮，两者都带语义图标。拖动与窗口缩放必须按弹层真实宽高重新约束，四边至少保留 8–18px 可视余量，不得把内容拖出视口。Teleport 到 `body` 的微应用弹层必须在弹层根同步 `data-mci-ui-root`、主题与必要 token，不能只依赖原祖先 CSS 变量。遮罩毛玻璃由 `sys_config.FormMaskBlur=1/true` 全局显式开启，缺失或 `0/false` 默认关闭；`prefers-reduced-motion` 只能停止动画与过渡，不得擅自反转静态毛玻璃配置。
 - **Dialog 关闭按钮可见性**：右上关闭按钮固定使用 40×40px（移动端不低于 40px）中性灰底、细边框和 10–12px 圆角，不能只显示悬空的细线 X；亮色和暗色主题都必须保持可辨识背景。hover/focus-visible 时使用更深一级灰底、主题色图标和清晰焦点环。底部关闭/取消/保存按钮高度不低于 42px、最小宽度 96px，并保持右对齐与 12px 间距。
-- **Tabs 统一视觉**：顶部工作区、数据列表 PageTabs、表单 Tabs 与右侧关联数据 Tabs 使用同一套清爽、独立标签视觉。横向 Tabs 禁止铺设贯穿整行的有色轨道、边框底板、下划线或其它装饰线；未选项保持透明，悬停与选中只使用克制的文字色、浅色独立表面和轻阴影。纵向 Tabs 可使用截图式中性浅色分组容器，选中项是独立浅色卡片。数字角标放在标签文本之后且不得挤压标题；过渡只用于交互，并尊重 `prefers-reduced-motion`。
+- **Tabs 统一视觉**：顶部工作区、数据列表 PageTabs、表单 Tabs 与右侧关联数据 Tabs 使用同一套清爽、独立标签视觉。横向 Tabs 禁止铺设贯穿整行的有色轨道、边框底板、下划线或其它装饰线；未选项保持透明，悬停与选中只使用克制的文字色、浅色独立表面和轻阴影。纵向 Tabs 可使用截图式中性浅色分组容器，选中项是独立浅色卡片。数字角标放在标签文本之后且不得挤压标题；过渡只用于交互，并尊重 `prefers-reduced-motion`。框架 `Top/TopSide` 的一级主导航属于站点导航，使用独立短底线标识当前位置，不将该样式扩散到上述 Tabs。
 - **表格与卡片行为完整**：桌面数据卡片采用连续白色表面、弱边界和轻阴影，操作区不得再叠加有色底板或硬分割线；表格模块门头的标题/副标题卡片与每个动态统计卡片必须彼此独立，父布局保持透明，禁止用一个大卡片或外框把标题和全部统计项包在一起。表格默认取消无意义的纵向网格，只保留浅表头与轻量横向行节奏，工具栏和分页不得层层套框。`PageBtns`、`BatchSelect`、行内/行外 V8 按钮均不可因改版丢失；需多选而当前未选中时，应先把当前记录纳入选中集再执行。
 - **启动状态可理解、可恢复**：Vue 挂载和业务就绪是两个状态。进度到 100% 后若仍在初始化，应显示“正在连接/后端响应较慢/仍在等待”等阶段文字；明确失败时提供原因摘要与刷新重试，禁止撤掉启动层后留下空白页。
 - **侧栏清爽但层级清晰**：压缩无效间距，保留足够点击区域、选中态、父子层级和键盘焦点；颜色、圆角、阴影必须来自主题 token。