dsh-crwu-workbench 0.0.15 → 0.0.16

package/CHANGELOG.md

@@ -7,6 +7,13 @@
 `cordis_define` + `cordis_run` 装配，版本号用 DSH 的 `pkg-N`）；它已在本仓收尾时删除
 （见 `0.0.1` 一节），下面 `legacy · pkg-43` 及更早的记录是它的历史。
 
+## 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：本机访问从「调用方声明提权」改成「具名操作 + 版本化授权收据」，
@@ -213,6 +220,41 @@
   ② `crwu_audit_case_bootstrap` 的 `caseDir` 虽被钉在本轮案例目录，但 `objectId` 仍是提交进来的 ——
   子会话可以用**别的** objectId 把别人的记录取进自己的案例目录；现在审核子会话调用它一律拒绝。
 
+### G 段：登录失败归因 ——「登录必须写工作区之外」不再是原文（2026-09-29）
+
+**症状**：员工第一次用（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` 还原后转绿。
+
 ### 测试
 
 新增/扩写的测试文件：`host-access-consent` / `host-access-broker` / `host-access-classify` /

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.16";
 /**
 * `ping` / `boot` 应答里的版本指纹，形如 `pkg-0.0.5`。
 *
@@ -12056,6 +12056,120 @@ 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 REASONS = {
+	h3yun: "氚云扫码登录要在工作区之外起一个临时浏览器配置目录（crwu-scan-*），当前文件策略把它挡下了",
+	dws: "钉钉登录要先更新 <HOME>/.dws 里的登录态，当前文件策略把它挡下了"
+};
+const ACTIONS = {
+	h3yun: "在输入框下方的访问模式里选「完全权限」（或输入 /permission danger-full-access），回到「账号连接」再点一次「扫码登录氚云」。",
+	dws: "在输入框下方的访问模式里选「完全权限」（或输入 /permission danger-full-access），回到「账号连接」再点一次「钉钉登录」。设备码登录同样要更新 <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,
+		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,
+		reason: "DSH 的沙箱 runner 在命令跑起来之前就失败了（不是命令本身的业务失败）",
+		action: ACTIONS[kind]
+	};
+	if (requested !== "" && resolved !== "" && requested !== resolved) return {
+		blocked: true,
+		reason: `提权请求被降级：请求 ${requested}，执行器实际按 ${resolved} 跑`,
+		action: ACTIONS[kind]
+	};
+	if (sandbox?.denied === true) return {
+		blocked: true,
+		reason: `DSH 沙箱拒绝了这次操作（${ran || resolved || requested || "当前模式"}）`,
+		action: ACTIONS[kind]
+	};
+	if (confined(resolved) || confined(ran)) return {
+		blocked: true,
+		reason: `登录进程实际跑在 ${ran || resolved} 下，写不了工作区之外的登录目标`,
+		action: ACTIONS[kind]
+	};
+	if (deniedOutsideWorkspace(kind, facts)) return {
+		blocked: true,
+		reason: REASONS[kind],
+		action: ACTIONS[kind]
+	};
+	return none();
+}
+/**
+* 把归因拼成一句给员工看的话（界面直接显示 `error`）。
+*
+* `original` 必须是**命令自己的原话**（stderr / 脱离沙箱前的错误），不是别的归因函数
+* 已经加工过的句子 —— 否则同一句"沙箱挡住了"会出现两次，员工会以为是两个故障。
+*/
+function describeLoginAdvice(kind, advice, original) {
+	if (!advice.blocked) return text(original);
+	const head = `本机访问被挡在工作区之外：${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
 /**
 * 把文本写进系统剪贴板。
@@ -12145,10 +12259,22 @@ async function dwsLogin(deps, args) {
 		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)
 	};
 }
@@ -12166,10 +12292,21 @@ async function relogin(deps) {
 		source: "panel",
 		platform: deps.platform
 	});
+	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)
 	};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-crwu-workbench",
-  "version": "0.0.15",
+  "version": "0.0.16",
   "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",