dsh-crwu-workbench 0.0.15 → 0.0.17

package/CHANGELOG.md

@@ -7,6 +7,109 @@
 `cordis_define` + `cordis_run` 装配，版本号用 DSH 的 `pkg-N`）；它已在本仓收尾时删除
 （见 `0.0.1` 一节），下面 `legacy · pkg-43` 及更早的记录是它的历史。
 
+## package · 0.0.17 · 2026-09-29 · fix · 登录失败归因分两支 + 登录临时目录由插件指定
+
+员工在 Windows 上点「扫码登录氚云 / 钉钉登录」持续失败。开发者诊断给出的结构化事实是
+`req = res = ran = danger-full-access`、`denied=false`、`runnerFailed=false`、`started=true` ——
+**DSH 没有拦这次调用**；原文却是
+
+```
+create fallback browser profile directory: mkdir C:\Users\51019\AppData\Local\crwu: Access is denied.
+(system TEMP failed: mkdir C:\Users\51019\AppData\Local\Temp\crwu-scan-556823159: Access is denied.)
+```
+
+两条路径都在 `AppData\Local` 下、都被拒，而同一时刻 `dws auth status` 是 ok（`~/.dws` 可写）。
+本版据此做两件事，都只动插件侧：
+
+1. **登录的临时目录改由插件指定**（`src/host/system/auth-scratch.ts`）：先建
+   `<home>/.dsh/crwu-workbench/auth-tmp`，再把 `TMPDIR`/`TMP`/`TEMP` 指过去
+   （POSIX `mkdir -p … && TMPDIR=… <cmd>`；PowerShell `New-Item -Force …; $env:TMP=…; & <cmd>`）。
+   依据是员工机器上的事实：系统 TEMP 与用户缓存目录都被拒，而插件状态目录（`<home>/.dsh/…`）可写。
+   **不动 `LOCALAPPDATA`**（Chromium 自己的组件目录仍走系统默认）；主目录未知时原样返回命令，不伪造。
+   `runCrwu` 增加可选 `scratchDir`（只有会就地起浏览器的那条命令用）。
+2. **归因分两支，不许合成一句**（`LoginAdvice.policyBlocked`）：结构化事实说降级 / 拒绝 / 实际受限
+   → 「被文件策略挡在工作区之外」，动作是切「完全权限」；**事实干净却照样 `Access is denied`
+   → 「被这台机器拒绝（不是 DSH 的文件策略）」**，明说"切权限不会有用"，并给退路
+   （氚云 `crwu h3yun session bind --token`、钉钉先试「设备码登录（无浏览器时）」）。
+   上一版把两支合成一句"请切完全权限" —— 员工按提示切了，而日志证明根本不是策略问题（误导）。
+3. 面板「账号连接」的前置说明同步改口径，并回到"设备码登录（**无浏览器时**）"
+   （它不是"沙箱挡浏览器"的退路：同样要抢 `<HOME>/.dws` 的锁）。
+
+**已证伪**：把两支合成策略支 → 5 条变红；把 scratch 的 env 前缀去掉（只建目录不指过去）→ 2 条变红。
+
+### ① 登录失败归因：两支分开，不许合成一句
+
+**症状**：员工第一次用（Windows 与 macOS 都报）时，点「扫码登录氚云」「钉钉登录」浏览器起不来；
+面板给的却是 CLI 的原话 —— 氚云 `mkdir C:\…\Temp\crwu-scan-1799287186: Access is denied.`
+（看着像 crwu 坏了）、钉钉 `acquiring file lock: …\.dws\.data.lock: Access is denied.`
+（看着像 dws 自己的 bug）。
+
+**根因（两条入口同一条边界）**：登录**必须写工作区之外的路径** ——
+
+| 入口 | 必须写的东西 |
+| --- | --- |
+| `crwu h3yun session login` | `$TMPDIR`/`%TEMP%` 下的临时浏览器 profile（`crwu-scan-*`），再经 CDP 读会话 |
+| `dws auth login`（含 `--device`） | `<HOME>/.dws/.data.lock`（拿登录态之前先抢文件锁） |
+| 两者收尾 | 操作系统凭据存储（钥匙串 / Credential Manager） |
+
+宿主按完全访问跑、操作系统的 ACL/受限令牌仍然拒绝时报的就是上面那两句；受限沙箱下浏览器即使
+起来了也会在几毫秒内 renderer 崩溃（CDP 只回 `close 1006` / `Target crashed`）。
+
+- **新增纯函数判据** `src/host/system/login-failure.ts`：`loginFailureAdvice()` / `describeLoginAdvice()`。
+  顺序是「结构化事实优先，文本最后」：① `runnerFailed` → ② 提权被降级（`requested !== resolved`）
+  → ③ `denied === true` 或实际跑在受限模式 → ④ **事实干净但原文点名了登录必须写的工作区外目标
+  且带拒绝字样**（Windows 实测就是这一形态）。
+- **第 ④ 条是 `sandboxDenialNote()` 的唯一例外**，判据本身变强了：目标不是"任意路径"，而是登录
+  流程必须写的那几个已知目标。**目标词与拒绝字样必须同时命中** —— 只命中一个不归因（否则
+  `secret not found in keyring` 这种"真没条目 / 钥匙串被锁"会被说成"去切完全权限"）。
+- **`dwsLogin` 以前完全不做归因**（只有 `runDws` 做），现在两条登录都返回 `sandboxBlocked` + `advice`，
+  并把「在输入框下方的访问模式里选「完全权限」再点一次」写进 `error`，**原始报错保留**在末尾。
+- **设备码不再是"退路"**：它同样要抢 `~/.dws` 的锁，所以按钮文案改回「设备码登录（无浏览器时）」，
+  归因文案里明说"在这个模式下也走不通"。
+- **界面**：「账号连接」页在登录按钮下方**先说前置条件**（`envLoginSandboxHint`）；
+  被归因时不再追加 stdout 尾巴（否则那句「正在打开浏览器窗口…」会把真正的动作挤掉）。
+
+**已证伪**：把第 ④ 条整段关掉 → 7 条变红；把「目标词」那一半去掉（只认拒绝字样）→
+误报用例变红。`cp` 还原后转绿。
+
+### ② 登录的临时目录由插件指定（不再依赖系统 TEMP）
+
+员工在 Windows 上用 0.0.15/0.0.16 再报一次，原文是**两条路径都被拒**：
+
+```
+create fallback browser profile directory: mkdir C:\Users\51019\AppData\Local\crwu: Access is denied.
+(system TEMP failed: mkdir C:\Users\51019\AppData\Local\Temp\crwu-scan-556823159: Access is denied.)
+```
+
+而同一时刻开发者诊断里 `h3yun.session.login` 是
+`req = res = ran = danger-full-access`、`denied=false`、`runnerFailed=false`、`started=true` ——
+**DSH 没有拦它**，`%TEMP%` 与用户缓存目录却都被这台机器拒绝。两处修正：
+
+1. **临时目录改由插件指定**（`src/host/system/auth-scratch.ts`）：登录命令先建
+   `<home>/.dsh/crwu-workbench/auth-tmp`，再把 `TMPDIR`/`TMP`/`TEMP` 指过去
+   （POSIX `mkdir -p … && TMPDIR=… <cmd>`；PowerShell `New-Item -Force …; $env:TMP=…; …; & <cmd>`）。
+   依据是**这台机器自己的事实**：系统 TEMP 与缓存目录都被拒，而插件状态目录（`<home>/.dsh/…`）
+   是它一直在写的地方。**不动 `LOCALAPPDATA`**（Chromium 自己的组件目录仍走系统默认）；
+   主目录未知时**原样返回命令**，不伪造一个没建出来的目录。
+   `runCrwu` 增加可选的 `scratchDir`（只有会就地起浏览器的那条命令用）。
+2. **归因分两支，不许合成一句**：`LoginAdvice.policyBlocked`。
+   - `true`（结构化事实：降级 / 拒绝 / 实际受限 / runner 挂）→「被文件策略挡在工作区之外」，
+     动作是切「完全权限」；
+   - `false`（事实干净、原文点名登录必须写的目标且带拒绝字样）→「**被这台机器拒绝**（不是 DSH 的
+     文件策略）」，明确写「切权限不会有用」，并给退路：氚云用 `crwu h3yun session bind --token`、
+     钉钉先试「设备码登录（无浏览器时）」。
+
+   上一版把两支合成了一句"请切完全权限"——员工按提示切了，而日志证明根本不是策略问题（**误导**）。
+
+**已证伪**：把两支合成策略支 → 5 条变红；把 scratch 的 env 前缀去掉（只建目录不指过去）→ 2 条变红。
+
+## package · 0.0.16 · 2026-09-29 · fix · Windows 氚云扫码临时目录回退
+
+- 随包 `crwu.exe` 的 `h3yun session login` 在系统 `%TEMP%` 被 Windows 安全策略拒绝时，
+  自动回退到 `%LOCALAPPDATA%\crwu\scan-tmp\crwu-scan-*`；登录结束仍清理临时 profile。
+- 回退只针对权限错误，且不改变 OS 凭据存储边界；若用户缓存目录也被拒绝，保留两段错误供
+  Defender/企业安全软件排查。
+
 ## package · 0.0.15 · 2026-09-28
 
 **协议 18：本机访问从「调用方声明提权」改成「具名操作 + 版本化授权收据」，

package/bin/manifest.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": "crwu.plugin-bin-manifest.v1",
-  "generatedAt": "2026-09-28T01:55:47.678Z",
+  "generatedAt": "2026-09-29T07:54:23.331Z",
   "platforms": [
     {
       "platform": "darwin-arm64",
@@ -12,9 +12,9 @@
           "source": "repo-build",
           "sourceVersion": "0.0.1",
           "target": "darwin/arm64",
-          "buildCommit": "d90d55efe18bd6ae01bd3102959ed7a62c4381c2",
+          "buildCommit": "6769a60cf2b4262793fc10492a7fa4ff2658fee7",
           "size": 7351330,
-          "sha256": "864496c621bcfaddd23a433ce4dcd36b32a882f5281e2ebc223bbdca57c64816"
+          "sha256": "4a406f33795444b2f2ae36c62efb3fce4b040f94458d01b6815b51122525a192"
         },
         {
           "tool": "ossutil",
@@ -50,9 +50,9 @@
           "source": "repo-build",
           "sourceVersion": "0.0.1",
           "target": "windows/amd64",
-          "buildCommit": "d90d55efe18bd6ae01bd3102959ed7a62c4381c2",
-          "size": 8122880,
-          "sha256": "ca0d055a2335bf0ddefaf3b448e59a3999ed328e88c868e47873e73b29fdadb3"
+          "buildCommit": "6769a60cf2b4262793fc10492a7fa4ff2658fee7",
+          "size": 8124928,
+          "sha256": "8142ef5bd35eddcdc43bcf0c3180a626494efc08a5517043724e97c965ecfa58"
         },
         {
           "tool": "ossutil",

package/lib/client.js

@@ -2519,6 +2519,12 @@ body[data-ds-dark-theme] .crwu-audit-root {
 			envOssReasonNoSecret: "凭据文件里没有 AccessKey Secret",
 			envOssOssutilMissing: "插件内置的 ossutil 不可用：这不是凭据问题，是插件包不完整 —— 需要重新安装插件",
 			envLoginH3yun: "扫码登录氚云",
+			/**
+			* 登录按钮的**前置条件**（2026-09-29 员工实测）：两条登录命令都要写工作区之外的路径 ——
+			* 临时浏览器 profile、`<HOME>/.dws` 的登录态、操作系统凭据存储。文件策略不给时一条都走不通，
+			* 而这一点在前端看不出来（表现只是"浏览器没起来"）。说在点之前，别让员工靠试错发现。
+			*/
+			envLoginSandboxHint: "登录要在工作区之外起临时浏览器 / 更新登录态文件。报「拒绝访问」时看面板那句话：说「被文件策略挡下」就把访问模式切到「完全权限」再点一次；说「被这台机器拒绝」就是本机安全软件或临时目录权限的问题，切权限没有用。",
 			envDetailsTitle: "排查详情（维护者看）",
 			envDetailsTools: "插件内置组件明细",
 			envDetailsRuntime: "DSH 脚本运行时明细",
@@ -3103,7 +3109,7 @@ body[data-ds-dark-theme] .crwu-audit-root {
 			runCardSummary: "中瑞世联工作台：环境自检 → 报告审核（单条）→ 自动上云 → 直接开云端审核意见。",
 			relogin: "氚云登录",
 			dwsLogin: "钉钉登录",
-			dwsLoginDevice: "设备码登录（浏览器打不开时）",
+			dwsLoginDevice: "设备码登录（无浏览器时）",
 			stopAudit: "停止这条审核",
 			stopPhaseRequested: "正在请求停止审核…",
 			stopPhaseAborting: "正在取消子会话…",
@@ -6094,6 +6100,10 @@ body[data-ds-dark-theme] .crwu-audit-root {
 						})]
 					})
 				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					className: WORKBENCH_CLASSES.muted,
+					children: zhCN.envLoginSandboxHint
+				}),
 				props.loginMessage === void 0 || props.loginMessage === "" ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 					className: WORKBENCH_CLASSES.itemFix,
 					style: { whiteSpace: "pre-wrap" },
@@ -11161,6 +11171,10 @@ body[data-ds-dark-theme] .crwu-audit-root {
 			* 这两条命令会开浏览器、等人扫码（宿主侧超时 5 分钟），所以：成功也要给一句话，
 			* 失败必须带原因，CLI 打到 stdout 的 URL / 设备码 / 提示原样带出来 —— 浏览器打不开时，
 			* 那串 URL 就是员工唯一能自己走下去的路。
+			*
+			* `sandboxBlocked` 是 **Host 的归因事实**（登录必须写工作区之外的路径）：为真时
+			* `error` 里已经是一句人话 + 下一步动作，这里不再追加 stdout 尾巴 —— 那只会是一句
+			* 「正在打开浏览器窗口…」，把真正的动作挤到看不见。
 			*/
 			const runLogin = react.useCallback(async (label, call) => {
 				setLoginMessage(`${label}：正在等待浏览器授权…（最多 5 分钟）`);
@@ -11171,8 +11185,10 @@ body[data-ds-dark-theme] .crwu-audit-root {
 					if (result.ok) lines.push(`${label}：命令已执行完成，请刷新查看结果。`);
 					else if (result.timedOut === true) lines.push(`${label}：等待超时（5 分钟）。若浏览器没有自动打开，请重试或改用设备码登录。`);
 					else lines.push(`${label}失败：${result.error || result.stderrTail || "未知原因"}`);
-					const detail = (result.stdoutTail ?? "").trim() || (result.stderrTail ?? "").trim();
-					if (detail !== "") lines.push(detail);
+					if (result.sandboxBlocked !== true) {
+						const detail = (result.stdoutTail ?? "").trim() || (result.stderrTail ?? "").trim();
+						if (detail !== "") lines.push(detail);
+					}
 					setLoginMessage(lines.join("\n"));
 				} catch (cause) {
 					if (mounted.current) setLoginMessage(`${label}失败：${describe(cause)}`);

package/lib/index.js

@@ -231,7 +231,7 @@ const PLUGIN_INJECT = [
 * 还会让打包器的 JSON 插件成为隐式依赖。代价是升版本时要同时改这里 ——
 * `tests/unit/host-package.test.mjs` 有一条断言盯着它必须等于 `package.json` 的 version。
 */
-const PLUGIN_VERSION = "0.0.15";
+const PLUGIN_VERSION = "0.0.17";
 /**
 * `ping` / `boot` 应答里的版本指纹，形如 `pkg-0.0.5`。
 *
@@ -3037,6 +3037,64 @@ function chmodCommand(mode, path, platform) {
 	return `chmod ${mode} ${shellQuote(path, platform)}`;
 }
 //#endregion
+//#region src/host/system/auth-scratch.ts
+/**
+* 登录命令的**私有 scratch 目录**（协议 19 · G 段，2026-09-29）。
+*
+* ## 为什么要由插件指定，而不是让 CLI 用系统 TEMP
+*
+* 扫码登录要就地起一个临时浏览器 profile，`crwu` 用 `os.MkdirTemp("", …)` 建它 ——
+* 也就是**系统 TEMP**。真实员工机器上实测（2026-09-29，Windows）：
+*
+* ```
+* create fallback browser profile directory: mkdir C:\Users\51019\AppData\Local\crwu: Access is denied.
+* (system TEMP failed: mkdir C:\Users\51019\AppData\Local\Temp\crwu-scan-556823159: Access is denied.)
+* ```
+*
+* 两条路径都在 `AppData\Local` 下、都被拒，而**插件的日志说明 DSH 没有拦它**
+* （`requested = resolved = ran = danger-full-access`、`denied=false`）—— 拒它的是这台机器
+* 自己（安全软件的按二进制规则 / 低完整性令牌 / 该目录的 ACL）。同一条命令在
+* `%USERPROFILE%` 下（例如 `~/.dws`）却是通的。
+*
+* 所以插件不再把"我自己的 scratch 放哪"交给系统 TEMP：给它一个**插件自己长期在写、
+* 已经确认可写**的位置 —— `<home>/.dsh/crwu-workbench/auth-tmp`（同目录下已经有
+* `ifind-credential.json`），并在**同一条命令**里先把目录建出来、再把 `TMPDIR`/`TMP`/`TEMP`
+* 指过去。这样 CLI 与它拉起的浏览器 profile 都落在同一条已知可写的路径上。
+*
+* ## 三条约束
+*
+* 1. **不改 `LOCALAPPDATA`**：Chromium 自己的组件目录仍按系统默认走，改它只会让浏览器行为
+*    更难解释；这里只动"临时文件"那三个变量。
+* 2. **目录必须是插件状态目录下的固定叶子**（不接受任何调用方/模型输入）：它与
+*    `state/persist.ts` 推导的状态文件同根，越界无从谈起。
+* 3. **不伪造成功**：设不上（`home` 为空）就原样返回命令 —— 由 CLI 自己报它的 TEMP 错误，
+*    而不是我们假装指到了某个目录。
+*/
+/** scratch 目录相对主目录的叶子路径（唯一推导点）。 */
+const AUTH_SCRATCH_LEAF = [
+	".dsh",
+	"crwu-workbench",
+	"auth-tmp"
+];
+/** 登录命令的 scratch 目录；主目录未知时返回空串（调用方据此走原命令）。 */
+function authScratchDir(home) {
+	if (home === "") return "";
+	return joinLocalPath(home, ...AUTH_SCRATCH_LEAF);
+}
+/**
+* 把一条已经拼好的命令包成"先建 scratch 目录、再把临时目录指向它"。
+*
+* 两种方言各用自己那条 `mkdir`（`mkdir -p` / `New-Item -Force`），都来自
+* `platform/shell.ts` 的同一个生成器 —— 这里不再手写第三条。
+*/
+function withAuthScratch(command, dir, platform) {
+	if (dir === "") return command;
+	const quoted = shellQuote(dir, platform);
+	const ensure = mkdirCommand(dir, platform);
+	if (shellDialect(platform) === "powershell") return `${ensure}; $env:TMP=${quoted}; $env:TEMP=${quoted}; $env:TMPDIR=${quoted}; ${command}`;
+	return `${ensure} && TMPDIR=${quoted} TMP=${quoted} TEMP=${quoted} ${command}`;
+}
+//#endregion
 //#region src/host/platform/command.ts
 /**
 * 把「按名字调用的自带命令」解析成**包内绝对路径**；解析不到就原样回退那个名字。
@@ -3168,12 +3226,12 @@ async function runCrwu(ctx, argv, options) {
 	const operation = crwuOperationOf(clean);
 	if (operation === null) return failed(`该 crwu 子命令还没有登记本机访问操作，拒绝执行：${describeCrwuCommand(clean)}`);
 	const platform = options.platform ?? "";
-	const resolved = await resolveBundledCommand(ctx, platform, "crwu");
+	const command = withAuthScratch(shellInvoke(await resolveBundledCommand(ctx, platform, "crwu"), clean.slice(1), platform), options.scratchDir ?? "", platform);
 	const result = await options.access.runShell({
 		operation,
 		source: options.source,
 		...options.workdir === void 0 ? {} : { workdir: options.workdir }
-	}, shellInvoke(resolved, clean.slice(1), platform), {
+	}, command, {
 		...options.workdir === void 0 ? {} : { workdir: options.workdir },
 		timeoutMs: options.timeoutMs ?? 6e4,
 		...options.stdoutMaxBytes === void 0 ? {} : { stdoutMaxBytes: options.stdoutMaxBytes },
@@ -12056,6 +12114,135 @@ function parseSessionOutput(stdout) {
 	return sessionView(doc);
 }
 //#endregion
+//#region src/host/system/login-failure.ts
+/** 完全访问模式的字面量；只在**结构化事实**里比较。 */
+const FULL_ACCESS = "danger-full-access";
+/**
+* 这一条命令**必须**能写的工作区外目标（大小写不敏感的子串）。
+*
+* 刻意保守：只登记登录流程真正会碰的东西。多写一个词就会把别的失败误判成沙箱问题。
+*/
+const LOGIN_TARGETS = {
+	h3yun: ["crwu-scan-", "crwu-scan"],
+	dws: [".dws", ".data.lock"]
+};
+/** 两个入口共有的目标：操作系统凭据存储。 */
+const CREDENTIAL_STORE_TARGETS = [
+	"keyring",
+	"credential store",
+	"credential-store",
+	"钥匙串",
+	"凭据存储"
+];
+/** 拒绝字样。命中它**且**命中目标词才算归因。 */
+const DENIED_MARKERS = [
+	"access is denied",
+	"access denied",
+	"permission denied",
+	"operation not permitted",
+	"eacces",
+	"eperm",
+	"拒绝访问",
+	"不允许",
+	"被拒绝"
+];
+const POLICY_ACTIONS = {
+	h3yun: "在输入框下方的访问模式里选「完全权限」（或输入 /permission danger-full-access），回到「账号连接」再点一次「扫码登录氚云」。",
+	dws: "在输入框下方的访问模式里选「完全权限」（或输入 /permission danger-full-access），回到「账号连接」再点一次「钉钉登录」。设备码登录同样要更新 <HOME>/.dws 的登录态，在这个模式下也走不通。"
+};
+/**
+* ② 策略允许、**这台机器**拒绝（2026-09-29 Windows 实测）：
+* `requested = resolved = ran = danger-full-access`、`denied=false`，照样 `Access is denied`。
+* 这种时候叫人去切权限是**误导** —— 切了也没用。
+*/
+const MACHINE_REASONS = {
+	h3yun: "氚云扫码登录要就地建一个临时浏览器配置目录（crwu-scan-*），而这台机器不让这条命令创建它",
+	dws: "钉钉登录要先更新 <HOME>/.dws 里的登录态，而这台机器不让这条命令写它"
+};
+const MACHINE_ACTIONS = {
+	h3yun: "这不是工作区权限问题：DSH 这次是以完全访问跑的（请求与实际都是 danger-full-access），切权限不会有用。请先看这台机器的安全软件（企业管控 / 杀软）是否拦了这条命令，以及临时目录的权限；确实起不了浏览器时，改用本机终端里的 `crwu h3yun session bind --token <JWT>` 绑定会话（令牌不要发到对话里）。",
+	dws: "这不是工作区权限问题：DSH 这次是以完全访问跑的（请求与实际都是 danger-full-access），切权限不会有用。请先看这台机器的安全软件是否拦了这条命令，以及 <HOME>/.dws 的权限；也可以先试「设备码登录（无浏览器时）」，它同样写 <HOME>/.dws，但不开浏览器。"
+};
+function textList(values) {
+	return values.map((value) => text(value)).filter((value) => value !== "").join("\n").toLowerCase();
+}
+/** 命中拒绝字样，且原文点名了该入口**必须写**的工作区外目标。 */
+function deniedOutsideWorkspace(kind, facts) {
+	const blob = textList([
+		facts.stderr,
+		facts.stdout,
+		facts.error
+	]);
+	if (blob === "") return false;
+	if (!DENIED_MARKERS.some((marker) => blob.includes(marker))) return false;
+	return [...LOGIN_TARGETS[kind], ...CREDENTIAL_STORE_TARGETS].some((target) => blob.includes(target));
+}
+/** 一条没有归因的结论（调用方据此原样回原始错误）。 */
+function none() {
+	return {
+		blocked: false,
+		policyBlocked: false,
+		reason: "",
+		action: ""
+	};
+}
+/**
+* 判据入口：给一次登录失败的事实，回答"是不是本机访问被挡在工作区之外"。
+*
+* 纯函数：没有 IO、没有时间、没有平台分支 —— 平台差异全部体现在传进来的事实里。
+*/
+function loginFailureAdvice(kind, facts) {
+	const sandbox = facts.sandbox;
+	const requested = text(sandbox?.requested);
+	const resolved = text(sandbox?.resolved);
+	const ran = text(sandbox?.ran);
+	const confined = (value) => value !== "" && value !== FULL_ACCESS;
+	if (sandbox?.runnerFailed === true) return {
+		blocked: true,
+		policyBlocked: true,
+		reason: "DSH 的沙箱 runner 在命令跑起来之前就失败了（不是命令本身的业务失败）",
+		action: POLICY_ACTIONS[kind]
+	};
+	if (requested !== "" && resolved !== "" && requested !== resolved) return {
+		blocked: true,
+		policyBlocked: true,
+		reason: `提权请求被降级：请求 ${requested}，执行器实际按 ${resolved} 跑`,
+		action: POLICY_ACTIONS[kind]
+	};
+	if (sandbox?.denied === true) return {
+		blocked: true,
+		policyBlocked: true,
+		reason: `DSH 沙箱拒绝了这次操作（${ran || resolved || requested || "当前模式"}）`,
+		action: POLICY_ACTIONS[kind]
+	};
+	if (confined(resolved) || confined(ran)) return {
+		blocked: true,
+		policyBlocked: true,
+		reason: `登录进程实际跑在 ${ran || resolved} 下，写不了工作区之外的登录目标`,
+		action: POLICY_ACTIONS[kind]
+	};
+	if (deniedOutsideWorkspace(kind, facts)) return {
+		blocked: true,
+		policyBlocked: false,
+		reason: MACHINE_REASONS[kind],
+		action: MACHINE_ACTIONS[kind]
+	};
+	return none();
+}
+/**
+* 把归因拼成一句给员工看的话（界面直接显示 `error`）。
+*
+* `original` 必须是**命令自己的原话**（stderr / 脱离沙箱前的错误），不是别的归因函数
+* 已经加工过的句子 —— 否则同一句"沙箱挡住了"会出现两次，员工会以为是两个故障。
+*/
+function describeLoginAdvice(kind, advice, original) {
+	if (!advice.blocked) return text(original);
+	const head = advice.policyBlocked ? `本机访问被文件策略挡在工作区之外：${advice.reason}。` : `本机访问被这台机器拒绝（不是 DSH 的文件策略）：${advice.reason}。`;
+	const body = text(original).trim();
+	const evidence = body === "" ? "" : `（原始报错：${body.slice(0, 300)}）`;
+	return `${head}${advice.action}${evidence}`;
+}
+//#endregion
 //#region src/host/system/ops.ts
 /**
 * 把文本写进系统剪贴板。
@@ -12130,30 +12317,43 @@ function tails(run) {
 	};
 }
 /** 钉钉登录。`--device` 走设备码流程（无浏览器时用）。 */
-async function dwsLogin(deps, args) {
+async function dwsLogin(deps, args, home) {
 	const argv = [
 		await resolveBundledCommand(deps.ctx, deps.platform, "dws"),
 		"auth",
 		"login"
 	];
 	if (args.device === true) argv.push("--device");
+	const command = withAuthScratch(shellInvoke(argv[0] ?? "", argv.slice(1), deps.platform), authScratchDir(home), deps.platform);
 	const run = await deps.access.runShell({
 		operation: "dws.auth.login",
 		source: "panel",
 		workdir: await deps.workdir()
-	}, shellInvoke(argv[0] ?? "", argv.slice(1), deps.platform), {
+	}, command, {
 		timeoutMs: 3e5,
 		summary: "dws auth login"
 	});
+	const advice = loginFailureAdvice("dws", {
+		error: run.error,
+		stdout: run.stdout,
+		stderr: run.stderr,
+		exitCode: run.exitCode,
+		timedOut: run.timedOut,
+		sandbox: run.sandbox
+	});
+	const raw = text(run.stderr).trim() || text(run.error).trim();
+	const error = run.ok ? "" : advice.blocked ? describeLoginAdvice("dws", advice, raw) : describeFailure(run);
 	return {
 		ok: run.ok,
-		error: run.error,
+		error,
 		timedOut: run.timedOut,
+		sandboxBlocked: advice.blocked,
+		advice: advice.blocked ? advice.action : "",
 		...tails(run)
 	};
 }
 /** 氚云重新登录（`crwu h3yun session login` 在提权白名单里）。 */
-async function relogin(deps) {
+async function relogin(deps, home) {
 	const run = await runCrwu(deps.ctx, [
 		"crwu",
 		"h3yun",
@@ -12164,12 +12364,24 @@ async function relogin(deps) {
 		timeoutMs: 3e5,
 		access: deps.access,
 		source: "panel",
-		platform: deps.platform
+		platform: deps.platform,
+		scratchDir: authScratchDir(home)
 	});
+	const advice = loginFailureAdvice("h3yun", {
+		error: run.error,
+		stdout: run.stdout,
+		stderr: run.stderr,
+		exitCode: run.exitCode,
+		timedOut: run.timedOut,
+		sandbox: run.sandbox
+	});
+	const error = run.ok ? "" : advice.blocked ? describeLoginAdvice("h3yun", advice, text(run.stderr)) : run.error;
 	return {
 		ok: run.ok,
-		error: run.error,
+		error,
 		timedOut: run.timedOut,
+		sandboxBlocked: advice.blocked,
+		advice: advice.blocked ? advice.action : "",
 		session: parseSessionOutput(run.stdout),
 		...tails(run)
 	};
@@ -14783,7 +14995,7 @@ function createCoreOperations(ctx, config, state, world, resolvers, extra = {})
 				access: resolvers.access,
 				platform: await world.platform(),
 				workdir: () => world.workdir()
-			});
+			}, await world.home());
 			gate.invalidate();
 			return result;
 		},
@@ -14824,7 +15036,7 @@ function createCoreOperations(ctx, config, state, world, resolvers, extra = {})
 				access: resolvers.access,
 				platform: await world.platform(),
 				workdir: () => world.workdir()
-			}, args);
+			}, args, await world.home());
 			gate.invalidate();
 			return result;
 		},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-crwu-workbench",
-  "version": "0.0.15",
+  "version": "0.0.17",
   "description": "中瑞世联工作台 / CRWU audit workbench for DeepSeek Harness: pick a pending audit report, dispatch one AI audit subagent, watch and stop/restart it, auto-upload deliverables to Aliyun OSS.",
   "keywords": [
     "deepseek-harness",