docs: add step-by-step Windows installation

2026-08-18 10:59:14 +00:00
parent b3fa2315ba
commit 2e275b684d
7 changed files with 218 additions and 18 deletions
@@ -77,6 +77,8 @@ https://approval.justconn.top/downloads/dingmcp/install.md

 用户把这个链接交给 Agent 后，Agent 只需校验并运行一个原生 Node 安装器。安装器使用固定 Ed25519 公钥验证清单和发布物，把轻量客户端安装到稳定的用户数据目录，并统一返回 `bridgePath`、`skillPath`、`loginCommand` 和标准 `mcpConfig`；不再区分 Agent 品牌，不全局安装 npm 包，也不会猜测或直接修改 Agent 的私有配置。安装器会立即在受保护的本地会话中检查登录并返回机器可读 `postInstall`：未登录时直接带回当前授权链接，网关暂时不可用也不会使安装回滚。Agent 随后按自身官方方式安装 Skill、注册并信任本地 stdio MCP；不能热加载连接器时再新建会话或重启。用户端不安装 DWS，不需要企业凭证。

+公开 `install.md` 是一份可直接交给 Agent 执行的逐步教程，Windows PowerShell 为完整主路径，另附 Linux/macOS 命令。它覆盖环境检查、下载与 SHA-256 校验、安装 JSON 验收、Skill/MCP 注册、连接器信任、首次登录、钉钉 OA 与薪福通双来源验证、更新、卸载和故障恢复。Windows 必须原样使用安装器返回的本地 `.cmd` stdio 配置；远程网关 URL 不能直接配置为 MCP，否则宿主可能显示 HTTP 302 或把本地 Bridge 误判为崩溃。
+
 Agent 必须在安装后立即展示 `postInstall.authChallenge.directUrl`，不得等到第一次审批查询，也不得声称链接已另行推送。用户授权后，Agent 通过 `approval_login` 确认登录并用 `source=all` 做一次双来源只读验证；首次成功认证响应还会在普通 `content.text` 和 `structuredContent.onboarding` 中返回一次性的简短使用示例，展示后不会重复，也不会自动执行任何写操作。

 授权链接约十分钟有效。过期后不需要更新或重装：MCP 已加载时再次调用 `approval_login`；尚未加载时执行安装结果中的 `loginCommand`（等价于稳定客户端的 `login --json`）。两条入口复用同一本地 OAuth 会话，都会返回当前有效链接或自动生成新链接。
@@ -1,6 +1,8 @@
 # 钉钉审批客户端安装任务

-用户提供本文件或链接，即表示授权你为当前用户安装或更新“钉钉审批”客户端、Skill 和名为 `dingtalk-approval` 的 MCP；不代表授权执行任何审批写操作。
+用户把本文件或本文件的链接交给你，即表示授权你为当前用户安装或更新“钉钉审批”客户端、Skill 和名为 `dingtalk-approval` 的 MCP。该授权不包含同意、拒绝、退回、撤回或发起任何审批。
+
+请从“步骤 1”开始逐项执行并验收，不要跳步，不要让用户手工填写企业凭证，也不要根据经验自行改写安装器返回的路径或 MCP 配置。Windows 是完整支持的平台，必须优先使用下面的 PowerShell 步骤。

 ## 固定发布入口

@@ -15,24 +17,205 @@
 - 统一网关：`{{GATEWAY_URL}}`
 - Node.js：`>=22.13.0`

-首次安装通过上述 HTTPS 地址和固定 SHA-256 建立信任；安装器随后必须使用固定公钥验证 Ed25519 清单签名和全部发布物哈希。任一 URL、证书、签名或哈希不匹配时立即停止。不得索取 AppKey、AppSecret、AuthoritySecret、CorpId、userId、员工号、Cookie 或 Token。
+首次安装通过上述 HTTPS 地址和固定 SHA-256 建立信任；安装器随后必须使用固定公钥验证 Ed25519 清单签名和全部发布物哈希。URL、TLS、签名或哈希任一不匹配都必须停止。不得索取 AppKey、AppSecret、AuthoritySecret、CorpId、userId、员工号、Cookie 或 Token。

-## 执行
+## 完成标准

-1. 在仅当前用户可访问的临时目录下载安装器和发布公钥，分别核对上述 SHA-256。
-2. 执行以下唯一通用安装入口，并读取其 JSON 结果：
+只有以下条件全部成立，才能告诉用户“安装完成，可以使用”：
+
+1. Node.js 版本满足要求，安装器与公钥 SHA-256 均正确；
+2. 安装器 JSON 返回 `ok: true`；
+3. 已按当前 Agent 的官方方式安装返回的 `skillPath`；
+4. 已原样使用返回的 `mcpConfig` 注册并信任本地 stdio MCP；
+5. `approval_login` 确认已登录；
+6. `approval_list_todos` 的双来源验证中，钉钉 OA 与薪福通都为 `ok`；
+7. 未执行任何审批写操作。
+
+## 步骤 1：检查运行环境
+
+在当前用户权限下运行：

 ```text
-node <已校验的安装器路径> install --manifest-url {{MANIFEST_URL}} --public-key <已校验的公钥路径> --json
+node --version
+npm --version
 ```

-3. 安装器会立即尝试准备登录。读取返回的 `postInstall`，不得等到用户第一次查询审批：若状态为 `authorization_required`，必须把 `authChallenge.directUrl` 原样写入当前回复；若为 `authenticated`，直接继续验证；若为 `unavailable`，保留安装并在 MCP 加载后调用 `approval_login` 重试。不得声称链接已通过其他渠道推送。保存返回的 `loginCommand` 供本次安装流程恢复使用。
-4. 按当前 Agent 的官方方式安装返回的 `skillPath`，并使用 `mcpConfig` 只新增或替换名为 `dingtalk-approval` 的本地 stdio MCP。安装器本身不会猜测或修改 Agent 的私有配置。
-5. 如果当前 Agent 要求信任本地连接器，请完成其官方信任流程。连接器不能热加载时，新建会话或完整重启 Agent，并恢复本节尚未完成的登录步骤。
-6. 用户完成网页授权后调用 `approval_login`。工具不会通过其他消息通道自动推送链接，必须把 `content.text` 中的完整登录 URL 原样写入当前回复。然后按 `postInstall.verifyTool` 只读调用 `approval_list_todos`，确认钉钉 OA 与薪福通均可读取。成功响应包含 `onboarding.firstRun=true` 时，把其中的简短示例和安全提示展示一次，但不要自动执行示例。安装阶段不得处理审批，也不得在登录和双来源验证完成前声称“已可使用”。
+Node.js 必须为 `22.13.0` 或更高版本，npm 必须可用。不要使用管理员权限、`sudo`、全局 npm 安装、DWS 或浏览器自动化。若刚安装或升级 Node.js，先打开一个新的终端，再重新执行版本检查。

-登录链接过期时绝不能重新安装：如果 MCP 已加载，重新调用一次 `approval_login`；如果连接器尚未信任、加载或重启完成，执行安装结果中的 `loginCommand`，读取新的 `authChallenge.directUrl` 并原样展示。该命令只检查登录或生成新链接，不下载发布物、不修改 Agent 配置。
+## 步骤 2：下载并校验首次安装文件

-更新时重复执行同一安装入口；安装器会保留 OAuth 登录会话，稳定 Bridge 路径不会随 Node/NVM 版本改变。更新成功后重新连接名为 `dingtalk-approval` 的 MCP；Agent 不能单独重启连接器时，新建会话或重启 Agent。卸载时先从 Agent 删除同名条目，再执行安装结果中的 `cliPath uninstall --yes --json`。卸载默认清除运行时、Skill、安装记录和 OAuth 会话。
+不要在浏览器中复制下载内容，不要对 URL 解码、重新编码或手工拼接。原样使用上面的 HTTPS URL。

-授权页面会先展示请求客户端、回调域名、权限范围或设备授权码。应让用户本人核对并确认，不得替用户自动提交 consent。网关短暂不可用时保留现有登录状态并稍后重试，不要删除会话文件或主动要求用户重新授权。
+### Windows（PowerShell）
+
+在普通 PowerShell 中逐行运行：
+
+```powershell
+$dingInstallDir = Join-Path ([System.IO.Path]::GetTempPath()) ("dingmcp-install-" + [guid]::NewGuid().ToString("N"))
+New-Item -ItemType Directory -Path $dingInstallDir -Force | Out-Null
+$dingInstaller = Join-Path $dingInstallDir "installer.mjs"
+$dingPublicKey = Join-Path $dingInstallDir "release-signing-public.pem"
+Invoke-WebRequest -Uri "{{INSTALLER_URL}}" -OutFile $dingInstaller
+Invoke-WebRequest -Uri "{{PUBLIC_KEY_URL}}" -OutFile $dingPublicKey
+$dingInstallerHash = (Get-FileHash -Algorithm SHA256 $dingInstaller).Hash.ToLowerInvariant()
+$dingPublicKeyHash = (Get-FileHash -Algorithm SHA256 $dingPublicKey).Hash.ToLowerInvariant()
+if ($dingInstallerHash -ne "{{INSTALLER_SHA256}}") { throw "安装器 SHA-256 不匹配，停止安装" }
+if ($dingPublicKeyHash -ne "{{PUBLIC_KEY_SHA256}}") { throw "发布公钥 SHA-256 不匹配，停止安装" }
+```
+
+任一 `Invoke-WebRequest` 或哈希检查失败都必须停止，不能忽略错误继续。
+
+### Linux / macOS（POSIX shell）
+
+```bash
+ding_install_dir="$(mktemp -d)"
+curl --fail --location --output "$ding_install_dir/installer.mjs" "{{INSTALLER_URL}}"
+curl --fail --location --output "$ding_install_dir/release-signing-public.pem" "{{PUBLIC_KEY_URL}}"
+printf '%s  %s\n' '{{INSTALLER_SHA256}}' "$ding_install_dir/installer.mjs" | sha256sum --check --strict
+printf '%s  %s\n' '{{PUBLIC_KEY_SHA256}}' "$ding_install_dir/release-signing-public.pem" | sha256sum --check --strict
+```
+
+macOS 没有 `sha256sum` 时，使用 `shasum -a 256` 分别计算并精确比较，不得跳过校验。
+
+## 步骤 3：执行唯一通用安装入口
+
+### Windows（PowerShell）
+
+继续使用步骤 2 的同一个 PowerShell：
+
+```powershell
+$dingInstallJson = & node $dingInstaller install --manifest-url "{{MANIFEST_URL}}" --public-key $dingPublicKey --json
+if ($LASTEXITCODE -ne 0) { throw "钉钉审批安装器执行失败：$dingInstallJson" }
+$dingInstall = $dingInstallJson | ConvertFrom-Json
+if ($dingInstall.ok -ne $true) { throw "钉钉审批安装失败：$($dingInstall.error)" }
+$dingInstall | ConvertTo-Json -Depth 20
+```
+
+### Linux / macOS
+
+```bash
+node "$ding_install_dir/installer.mjs" install --manifest-url "{{MANIFEST_URL}}" --public-key "$ding_install_dir/release-signing-public.pem" --json
+```
+
+这是唯一通用安装入口。安装器会在稳定的当前用户数据目录安装客户端与 Skill，不会全局安装 npm 包，也不会修改 Agent 私有配置。保留完整 JSON 结果，后续只使用其中的真实字段，不要猜路径。
+
+安装结果至少必须包含：
+
+- `ok: true`、`status: "installed"` 和 `version`；
+- `cliPath`、`bridgePath`、`skillPath`；
+- `loginCommand`；
+- `mcpConfig.mcpServers.dingtalk-approval`；
+- `postInstall`。
+
+Windows 的 `bridgePath` 和 `mcpConfig...command` 正常应以 `dingtalk-approval-bridge.cmd` 结尾。路径中可能包含空格；保留完整字符串，不要拆分，不要去掉 `.cmd`，不要改为 `node`、`npx` 或远程 URL。
+
+## 步骤 4：安装 Skill 并注册 MCP
+
+1. 按当前 Agent 的官方方式安装 `skillPath` 指向的整个目录，而不是只复制 `SKILL.md`。确认目录中同时存在 `SKILL.md` 和 `references/create-approval.md`。
+2. 使用 `mcpConfig` 只新增或替换名称精确为 `dingtalk-approval` 的连接器。安装器本身不会猜测或修改 Agent 的私有配置。
+3. 如果 Agent 接受完整 MCP JSON，原样使用整个 `mcpConfig`；如果界面只接受单个服务器配置，原样使用 `mcpConfig.mcpServers.dingtalk-approval`。
+4. 该连接器必须是本地 `stdio`，`command` 必须是返回的本地 `bridgePath`，`args` 必须为空数组。Windows 中必须保留 JSON 已正确转义的反斜杠。
+5. 不要把 `{{GATEWAY_URL}}` 或 `https://approval.justconn.top/mcp` 作为 MCP URL、command 或参数；Bridge 会从已签名安装状态取得网关地址。
+6. 不要添加 `--url`、企业凭证、用户 ID、额外环境变量或 shell 包装器。
+
+正确配置的形态由安装器返回，语义如下；示例路径不能代替真实返回值：
+
+```json
+{
+  "mcpServers": {
+    "dingtalk-approval": {
+      "type": "stdio",
+      "command": "<安装器返回的本地 bridgePath；Windows 为 .cmd>",
+      "args": []
+    }
+  }
+}
+```
+
+## 步骤 5：处理首次登录状态
+
+安装器已经主动尝试准备登录。读取返回的 `postInstall` 及其 `status`，不得等到用户第一次查询审批：
+
+- `authorization_required`：在完成本地 Skill/MCP 配置的同一轮回复中，把 `postInstall.authChallenge.directUrl` 作为完整、可点击的 URL 原样发给用户；不得只说“已生成”或“已推送”。同时说明链接有有效期，需由用户本人核对授权页面并确认。
+- `authenticated`：已有登录可复用，不需要再次让用户授权，继续步骤 6 和步骤 7。
+- `unavailable`：客户端安装仍然有效。先完成步骤 4；连接器加载后调用 `approval_login` 重试。不要删除会话、不要重装。
+
+保存 `loginCommand.command` 和 `loginCommand.args`。如果首次链接过期且 MCP 尚未加载，按该对象原样执行命令；Windows PowerShell 的通用执行方式是：
+
+```powershell
+$dingLoginJson = & $dingInstall.loginCommand.command @($dingInstall.loginCommand.args)
+$dingLogin = $dingLoginJson | ConvertFrom-Json
+$dingLogin | ConvertTo-Json -Depth 20
+```
+
+把新结果中的 `authChallenge.directUrl` 原样展示。该命令只检查登录或生成新链接，不下载发布物、不修改 Agent 配置。MCP 已加载时则直接重新调用 `approval_login`。登录链接过期时绝不能重新安装。
+
+## 步骤 6：信任并加载连接器
+
+1. 如果当前 Agent 要求信任本地连接器，按其官方界面或命令确认名称为 `dingtalk-approval` 的连接器。
+2. 如果不能热加载，完整退出并重新启动 Agent，或新建一个确定会重新读取 MCP 配置的会话；只刷新聊天内容通常不够。
+3. 重启后确认能发现 `approval_login`、`approval_list_todos` 等钉钉审批工具。当前版本应发现 13 个工具。
+4. 若连接器进程退出、显示 302 或无法启动，先执行步骤 9 的 Windows 排障，不要把连接器改成远程 HTTP MCP。
+
+## 步骤 7：确认登录并验证两个审批来源
+
+用户完成网页授权后：
+
+1. 调用 `approval_login`。工具不会通过其他消息通道自动推送链接；如果响应仍给出 URL，必须把 `content.text` 中的完整登录 URL 原样写入当前回复。
+2. 登录成功后，按 `postInstall.verifyTool` 调用一次只读的 `approval_list_todos`，即 `source="all"`、空搜索、`limit=1`。
+3. 检查结果中的 `sourceStatus`：`dingtalk.status` 和 `xft.status` 都必须是 `ok`。`disabled`、`auth_required`、`unavailable` 或缺少任一来源都不算安装验证完成。
+4. 验证期间只读取最多一条待办，不调用任何写工具。
+5. 成功响应包含 `onboarding.firstRun=true` 时，把其中的简短示例和安全提示向用户展示一次，不要自动执行示例。
+
+## 步骤 8：向用户报告结果
+
+最终只需清楚报告：已安装的版本、Skill 与 MCP 已加载、登录是否成功、钉钉 OA 与薪福通是否都通过只读验证。可以给出一次性使用示例。不要向用户倾倒安装 JSON、内部路径、Token、审批引用或诊断细节，除非用户正在排障。
+
+安装阶段不得处理审批，也不得在登录和双来源验证完成前声称“已可使用”。
+
+## 步骤 9：Windows 常见故障排查
+
+按顺序排查，不要跳到重装：
+
+1. **显示 302 或启动后立即退出**：检查连接器是否被错误配置成 `{{GATEWAY_URL}}` 或其他 HTTP URL。正确配置必须是 `type: "stdio"`，`command` 为本机 `dingtalk-approval-bridge.cmd`，`args: []`。重新复制安装结果中的 `mcpConfig`。
+2. **路径不存在或 Node 升级后失效**：不要引用 Node/NVM 的版本目录。执行安装结果中的 `cliPath`，或运行 `dingtalk-approval print-config --format mcp-json` 重新取得稳定配置。
+3. **Bridge 仍无法启动**：执行 `<cliPath> doctor --json`。只有所有 `checks` 都为 `ok: true` 才继续；把失败检查和错误原文报告给维护者，不要提供 Token 或会话文件。
+4. **提示找不到 npm-cli.js**：当前 Node 安装不完整。安装带 npm 的 Node.js 22.13+，打开新 PowerShell，重新检查 `node --version` 和 `npm --version` 后再运行安装器。
+5. **路径包含空格**：不要手写命令行字符串。把安装器返回的整个 `mcpConfig` 作为 JSON 对象交给 Agent；在 PowerShell 中执行 CLI 时用调用运算符 `&` 和独立参数。
+6. **连接器一直未出现**：确认已信任本地连接器并完整重启 Agent。不要通过反复重装刷新连接器。
+7. **授权链接过期**：MCP 已加载就再次调用 `approval_login`；否则执行保存的 `loginCommand`。不要重装。
+
+## 更新
+
+更新不需要重新下载首次安装器。使用上次安装结果中的 `cliPath`：
+
+Windows PowerShell：
+
+```powershell
+$dingUpdateJson = & $dingInstall.cliPath update --json
+$dingUpdate = $dingUpdateJson | ConvertFrom-Json
+$dingUpdate | ConvertTo-Json -Depth 20
+```
+
+Linux / macOS：
+
+```text
+<cliPath> update --json
+```
+
+更新会复用已固定的签名清单地址和公钥并保留 OAuth 会话。更新成功后，重新使用返回的 `mcpConfig` 核对同名连接器，并重新连接 MCP；必要时完整重启 Agent。然后重复步骤 7 的登录确认和双来源只读验证。
+
+## 卸载
+
+1. 按当前 Agent 的官方方式删除名称精确为 `dingtalk-approval` 的 MCP/连接器条目。
+2. 执行安装结果中的 `cliPath uninstall --yes --json`；Windows PowerShell 可运行：
+
+```powershell
+& $dingInstall.cliPath uninstall --yes --json
+```
+
+3. 确认返回 `uninstalled` 或 `cleanup_scheduled`。后者表示当前 CLI 退出后完成自清理。
+
+卸载默认清除客户端运行时、Skill、安装记录和 OAuth 会话。不要手工递归删除未知目录。
+
+授权页面会展示请求客户端、回调域名、权限范围或设备授权码。必须由用户本人核对并确认，不得替用户自动提交 consent。网关短暂不可用时保留现有登录状态并稍后重试，不要删除会话文件或主动要求用户重新授权。
@@ -116,6 +116,8 @@ https://approval.justconn.top/downloads/dingmcp/install.md

 Agent 只需校验安装器和公钥 SHA-256，再调用原生安装器。安装器验证 `manifest.sig` 和全部 artifact 哈希，将内置运行依赖的客户端以 npm 离线模式安装到稳定用户目录并返回标准 MCP 配置；终端安装过程不会从 npm registry 下载额外代码。Bridge 的稳定绝对路径不会包含 NVM 的具体 Node 版本，配置也不再携带 `--url`；网关地址由受签名保护的安装状态提供。

+公开 `install.md` 必须保留从环境检查到双来源验收的完整编号步骤，并把 Windows PowerShell 作为独立主路径，而不是 POSIX 命令的附注。Windows 安装说明至少要覆盖 `Invoke-WebRequest` 下载、`Get-FileHash` 校验、JSON 解析、`.cmd` stdio 配置、路径空格、连接器信任与完整重启、独立登录续期、`doctor --json`、更新和卸载。教程必须明确禁止把网关 HTTPS URL 直接注册为 MCP。
+
 安装器对每个下载设置 30 秒超时，并在流式读取时执行 25 MB 硬上限，不会先把无界响应完整缓冲到内存。Windows 必须能定位由当前 Node 安全启动的 `npm-cli.js`；不会退回到受 Node 安全加固影响的 `npm.cmd` 隐式执行。

 安装器不会识别 Agent 品牌或直接修改其配置。所有 Agent 都使用返回的 `skillPath` 和标准 `mcpConfig`，按自身官方方式安装 Skill、注册并信任名为 `dingtalk-approval` 的本地 stdio MCP；不能热加载连接器时再新建会话或重启。
@@ -7,6 +7,7 @@
 - `release:build`、`test-bundle:build` 和 `release:verify` 成功，`SHA256SUMS` 校验通过，发行物不包含 `.secrets`、`.runtime`、数据库、私钥或机器私有路径。
 - Nginx bootstrap 只开放 ACME challenge；正式站点启用 HSTS，mutable 发行文件返回 `no-cache`，客户端 tgz 才返回 immutable。连续两次部署时公开目录始终对应一个完整签名清单，旧版本保留数符合策略。
 - 从新生成的公开 `install.md` 在干净的用户级目录安装，不使用 `sudo`；安装结果主动返回 `postInstall`，可发现全部 13 个 MCP 工具。
+- 在干净 Windows 用户环境用公开教程的 PowerShell 路径完成下载、两项 SHA-256 校验、安装 JSON 解析和 stdio 注册；实际 `command` 以 `.cmd` 结尾、`args` 为空，不含网关 URL，并通过 `doctor --json`。同时验证路径含空格、连接器信任和完整重启场景。
 - 验证安装结果返回 `loginCommand`：未加载 MCP 时执行 `login --json` 能复用现有运行时生成或检查登录链接，不下载发布物；链接过期后生成新链接，已登录时不再返回挑战，未安装时明确失败。
 - 首次安装不等待业务查询即产生一条可传递链接；挑战阶段 onboarding 仍为 pending，授权后的首次成功响应在普通文本中展示一次示例，此后不重复。
 - 授权后钉钉 OA 与薪福通均为 `ok`，网关重启后登录状态仍可恢复；登录准备暂时失败不会回滚安装或删除原 OAuth 会话。
@@ -481,11 +481,13 @@ function installResult(
  postInstall: PostInstallResult,
 ): Record<string, unknown> {
  const nextSteps = [
-    "按当前 Agent 的官方方式安装 skillPath，并添加名为 dingtalk-approval 的 stdio MCP。",
-    "立即处理 postInstall：若有 authChallenge.directUrl，必须在当前回复中原样展示，不得声称已另行推送，也不得等待用户首次查询审批。",
-    "用户授权后调用 approval_login；登录成功后按 verifyTool 做一次双来源只读验证，并展示一次性使用示例。",
-    "宿主若不能热加载 MCP，请新建会话或完整重启；恢复上述登录流程后再宣告安装完成，不得执行任何审批写操作。",
-    "登录链接过期时绝不重新安装：MCP 已加载就再次调用 approval_login；尚未加载就执行 loginCommand。",
+    "1. 检查 ok=true，并保存 cliPath、skillPath、mcpConfig、loginCommand 和 postInstall；不得自行猜测或改写路径。",
+    "2. 按当前 Agent 的官方方式安装整个 skillPath，并只新增或替换名为 dingtalk-approval 的本地 stdio MCP。必须原样使用 mcpConfig；Windows 保留返回的 .cmd command 和空 args，禁止把网关 URL 配成 MCP。",
+    "3. 按当前 Agent 的官方流程信任连接器；不能热加载时完整重启 Agent或新建会重新读取 MCP 配置的会话。",
+    "4. 立即处理 postInstall：若有 authChallenge.directUrl，必须在当前回复中原样展示，不得声称已另行推送，也不得等待用户首次查询审批。",
+    "5. 用户授权后调用 approval_login；登录成功后按 verifyTool 做一次双来源只读验证，确认钉钉 OA 与薪福通均为 ok，并展示一次性使用示例。",
+    "6. 登录链接过期时绝不重新安装：MCP 已加载就再次调用 approval_login；尚未加载就执行 loginCommand。",
+    "7. 登录和双来源验证全部完成前不得宣告可用；安装期间不得执行任何审批写操作。",
  ];
  return {
    ok: true,
@@ -121,7 +121,9 @@ test("generic installer preserves identity across safe updates, rollback, downgr
  const installOutput = JSON.parse(output.pop()!);
  assert.equal(installOutput.restartRequired, undefined);
  assert.match(installOutput.nextSteps.join(" "), /当前 Agent.*skillPath.*stdio MCP/);
+  assert.match(installOutput.nextSteps.join(" "), /Windows.*\.cmd.*禁止把网关 URL 配成 MCP/s);
  assert.match(installOutput.nextSteps.join(" "), /立即处理 postInstall.*不得等待用户首次查询审批/s);
+  assert.match(installOutput.nextSteps.join(" "), /双来源只读验证.*钉钉 OA 与薪福通均为 ok/s);
  assert.equal(installOutput.postInstall.status, "authorization_required");
  assert.equal(installOutput.postInstall.authChallenge.directUrl, "https://approval.example.test/oauth/device?user_code=INSTALL-1234");
  assert.deepEqual(installOutput.loginCommand, {
@@ -17,6 +17,14 @@ test("customer distribution is a generic single-login gateway bridge", () => {
  assert.match(installer, /读取返回的 `postInstall`.*不得等到用户第一次查询审批/s);
  assert.match(installer, /登录链接过期.*绝不能重新安装.*approval_login.*loginCommand/s);
  assert.match(installer, /onboarding\.firstRun=true.*简短示例.*不要自动执行/s);
+  assert.match(installer, /Windows（PowerShell）/);
+  assert.match(installer, /Invoke-WebRequest[\s\S]*Get-FileHash[\s\S]*ConvertFrom-Json/);
+  assert.match(installer, /dingtalk-approval-bridge\.cmd/);
+  assert.match(installer, /显示 302 或启动后立即退出[\s\S]*type: \"stdio\"[\s\S]*doctor --json/);
+  assert.match(installer, /sourceStatus[\s\S]*dingtalk\.status[\s\S]*xft\.status[\s\S]*都必须是 `ok`/);
+  assert.match(installer, /更新[\s\S]*update --json[\s\S]*卸载[\s\S]*uninstall --yes --json/);
+  assert.match(installer, /不能热加载[\s\S]*完整退出并重新启动 Agent/);
+  assert.doesNotMatch(installer, /npm install -g|npx\s/);
  assert.doesNotMatch(installer, /通过当前 Messenger/);
  assert.doesNotMatch(installer, /DWS_CLI_PATH|dingtalk-workspace-cli|APP_MODE=local/);