dsh-remote-agent 0.4.0 → 0.4.1

package/README.en.md

@@ -59,7 +59,7 @@ leads to the same endpoint**:
 
 | Route | Hub | Worker | For |
 |---|---|---|---|
-| **① Zero terminal**（Windows） | Double-click `bin/双击运行-配置向导.cmd` → Enter → Web panel "副机接入" copies the pairing code | Double-click the same file → paste the pairing code → Enter writes config | Anyone who flinches at a black window |
+| **① Zero terminal**（Windows） | Double-click `bin/setup.cmd` → Enter → Web panel "副机接入" copies the pairing code | Double-click the same file → paste the pairing code → Enter writes config | Anyone who flinches at a black window |
 | **② Wizard**（recommended） | Run the wizard in a terminal → Enter to confirm | Same, paste the pairing code | You can open a terminal |
 | **③ Manual** | Hand-write config per the section below | Hand-write (`inject: []` is mandatory) | You want full control |
 
@@ -72,7 +72,7 @@ node bin/dsh-remote-setup.js
 ```
 
 > **Windows, no terminal?** In the plugin's `bin/` directory **double-click
-> `双击运行-配置向导.cmd`** —— then just keep pressing Enter in the window
+> `setup.cmd`** —— then just keep pressing Enter in the window
 > that opens.
 > The plugin lives at `%USERPROFILE%\.dsh\dsh_orb\dsh-plugin\dsh-remote-agent\bin\`.
 

package/README.md

@@ -55,7 +55,7 @@
 
 | 路线 | 主机 | 副机 | 适合 |
 |---|---|---|---|
-| **① 零终端**（Windows） | 双击 `bin/双击运行-配置向导.cmd` → 回车 → Web 面板「副机接入」复制配对码 | 双击同一文件 → 粘配对码 → 回车自动写盘 | 见到黑窗口就慌 |
+| **① 零终端**（Windows） | 双击 `bin/setup.cmd` → 回车 → Web 面板「副机接入」复制配对码 | 双击同一文件 → 粘配对码 → 回车自动写盘 | 见到黑窗口就慌 |
 | **② 向导**（推荐） | 终端跑向导 → 回车确认写盘 | 同左，粘配对码 | 会开终端 |
 | **③ 手动** | 参照下文配置节手写 | 手写（`inject: []` 必加） | 想完全掌控每行 |
 
@@ -67,7 +67,7 @@ node bin/dsh-remote-setup.js
 ```
 
 > **Windows 不想开终端？** 在插件的 `bin/` 目录里**双击
-> `双击运行-配置向导.cmd`** —— 打开的窗口里全程回车即可。
+> `setup.cmd`** —— 打开的窗口里全程回车即可。
 > 插件装在 `%USERPROFILE%\.dsh\dsh_orb\dsh-plugin\dsh-remote-agent\bin\`。
 
 1. **主机上跑**：选「1=主机」→ 向导自动找本机局域网 IP、生成 `nt_` 强随机

package/bin/{/345/217/214/345/207/273/350/277/220/350/241/214-/351/205/215/347/275/256/345/220/221/345/257/274.cmd → setup.cmd}

@@ -3,8 +3,10 @@ rem ============================================================
 rem  dsh-remote-agent setup launcher (double-click entry)
 rem  Content is ASCII-only on purpose: cmd.exe parses batch files
 rem  in the OEM codepage, non-ASCII text here WILL be garbled.
-rem  The Chinese file name is fine (NTFS is Unicode); keep the
-rem  file CONTENT ASCII.
+rem  The FILE NAME is ASCII too: npm packs into a tar archive, and a
+rem  non-ASCII name comes out as mojibake on extract (verified: the
+rem  0.4.0 tarball shipped a mojibake name). NTFS itself is fine;
+rem  the tar layer is not. Keep both name and content ASCII.
 rem ============================================================
 setlocal
 cd /d "%~dp0.."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-remote-agent",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "type": "module",
   "description": "把另一台电脑变成你 DSH 的远程 Agent 同事：副机本地持久跑任务、独立 Agent 循环，只回传 handoff 摘要与产物清单，成品按需拉取。",
   "license": "MIT",
@@ -44,8 +44,8 @@
   },
   "main": "./lib/index.js",
   "bin": {
-    "dsh-remote-relay": "./bin/dsh-remote-relay.js",
-    "dsh-remote-setup": "./bin/dsh-remote-setup.js"
+    "dsh-remote-relay": "bin/dsh-remote-relay.js",
+    "dsh-remote-setup": "bin/dsh-remote-setup.js"
   },
   "files": [
     "lib",

package/scripts/check-doc-drift.mjs

@@ -484,23 +484,40 @@ for (const [i, [file, why]] of MAINT_FILES.entries()) {
 
 /* ── 48. Windows 双击入口 ──
  *
- * 零终端用户的第一道墙是"开终端"。启动器文件有两条硬规矩：
+ * 零终端用户的第一道墙是"开终端"。启动器文件有**三条**硬规矩：
  *   内容必须 ASCII（cmd.exe 按 OEM 码页解析批处理，非 ASCII 必乱码），
- *   行尾必须 CRLF（LF-only 的批处理有解析边缘案例）。
- * 文件名可以是中文（NTFS 是 Unicode），用字节级断言钉住这两条。
+ *   行尾必须 CRLF（LF-only 的批处理有解析边缘案例），
+ *   **文件名也必须 ASCII**（见下）。
+ *
+ * ── 文件名为什么也必须 ASCII（2026-10-16 实测翻车）──────────────────────
+ *
+ * 这条断言原本的注释写的是"文件名可以是中文（NTFS 是 Unicode）"。
+ * **在本地是对的，发布出去是错的。** 0.4.0 的 npm tarball 里实际躺着：
+ *
+ *     package/bin/˫������-������.cmd
+ *
+ * 原名 `双击运行-配置向导.cmd`（8 个中文字符）。npm 打成 **tar 归档**，
+ * tar 层的文件名编码不可靠 —— NTFS 的 Unicode 文件名在这里丢了，
+ * 解压出来是乱码。Windows 用户看到的就是一个打不开的怪文件，
+ * 双击入口等于不存在。
+ *
+ * 所以现在改名 `setup.cmd`，并且这条断言用**字节级**检查两件事：
+ * 文件名全 ASCII、文件内容全 ASCII + CRLF。
  */
 {
-  const cmdPath = path.join(ROOT, 'bin', '双击运行-配置向导.cmd')
+  const cmdName = 'setup.cmd'
+  const cmdPath = path.join(ROOT, 'bin', cmdName)
   const ok48 = (() => {
     if (!fs.existsSync(cmdPath)) return false
+    if (!/^[\x20-\x7E]+$/.test(cmdName)) return false // 文件名 ASCII（tar 安全）
     const buf = fs.readFileSync(cmdPath)
     if (buf.some((b) => b > 127)) return false // 内容 ASCII
     if (!buf.includes(Buffer.from('@echo off\r\n'))) return false // CRLF
     return buf.includes(Buffer.from('dsh-remote-setup.js')) // 确实启动向导
   })()
-  check('48', 'Windows 双击入口存在且 ASCII/CRLF 规范，README 有双击路径',
-    ok48 && /双击/.test(read('README.md')),
-    'bin/双击运行-配置向导.cmd + README.md')
+  check('48', 'Windows 双击入口存在且**文件名与内容**都 ASCII/CRLF，README 有双击路径',
+    ok48 && /双击/.test(read('README.md')) && read('README.md').includes(cmdName),
+    `bin/${cmdName} + README.md`)
 }
 
 /* ── 49. 真实运行时自检工具与 KNOWN-ISSUES 验证记录 ──

package/scripts/check-packaging.mjs

@@ -72,6 +72,53 @@ for (const [name, target] of Object.entries(pkg.bin ?? {})) {
   if (!exists(target)) problems.push(`bin["${name}"] 指向不存在的路径: ${target}`)
 }
 
+// ── 3b) 发布清单里的文件名必须全是 ASCII ─────────────────────────────────────
+//
+// npm 打包成 **tar 归档**，而 tar 层的文件名编码不可靠：非 ASCII 名字解压后
+// 会变成乱码。这不是理论问题 —— 0.4.0 实际发布出去的 tarball 里躺着
+//
+//     package/bin/˫������-������.cmd
+//
+// 原名是 `双击运行-配置向导.cmd`（NTFS 上完全正常，问题只在 tar 层）。
+// 结果：Windows 用户解压后看到一个乱码文件，双击入口等于不存在。
+//
+// 所以这里扫一遍 `files` 列出的每个目录，任何非 ASCII 文件名都算问题。
+{
+  const ascii = /^[\x20-\x7E]+$/
+  const scan = (relDir, out = []) => {
+    const abs = path.join(ROOT, relDir)
+    if (!fs.existsSync(abs)) return out
+    let entries
+    try {
+      entries = fs.readdirSync(abs, { withFileTypes: true })
+    } catch {
+      return out
+    }
+    for (const e of entries) {
+      if (e.name === 'node_modules' || e.name === '.git') continue
+      const rel = path.posix.join(relDir.replace(/\\/g, '/'), e.name)
+      if (!ascii.test(e.name)) out.push(rel)
+      if (e.isDirectory()) scan(rel, out)
+    }
+    return out
+  }
+  const bad = []
+  for (const entry of Array.isArray(pkg.files) ? pkg.files : []) {
+    const abs = path.join(ROOT, entry)
+    if (!fs.existsSync(abs)) continue
+    if (fs.statSync(abs).isDirectory()) scan(entry, bad)
+    else if (!ascii.test(path.basename(entry))) bad.push(entry)
+  }
+  if (bad.length > 0) {
+    problems.push(
+      `发布清单里有 ${bad.length} 个非 ASCII 文件名（npm 打成 tar 后必然乱码）：\n`
+      + bad.map((b) => `      ${b}`).join('\n'),
+    )
+  } else {
+    notes.push('files 清单里的文件名全是 ASCII（tar 编码安全）')
+  }
+}
+
 // ── 4) dsh.bundle.patch（DSH 专用：loader 靠它插入插件行）────────────────────
 const patch = pkg.dsh?.bundle?.patch
 if (typeof patch !== 'string') {