dsh-remote-agent 0.8.1 → 0.9.0

package/lib/client.js

@@ -310,6 +310,198 @@ window.__ModuleLoader__.load({
      *   我是副机 → 填主机地址（或粘配对码）+ 工作区，写 `role: worker`
      *   同机自测 → 写 `role: both`（单机验证用）
      */
+
+    /**
+     * 工作区共享面板（2026-10-17）。
+     *
+     * ═══════════════════════════════════════════════════════════════════════
+     * 这是什么
+     * ═══════════════════════════════════════════════════════════════════════
+     *
+     * 把副机的一个工作区目录通过 SMB 共享出去，主机 `net use X: \\副机\dsh-work`
+     * 映射成盘符 —— 这样可以用本地 IDE 直接打开副机的项目。
+     *
+     * ═══════════════════════════════════════════════════════════════════════
+     * ⚠ 为什么这个面板的 UI 必须"啰嗦"
+     * ═══════════════════════════════════════════════════════════════════════
+     *
+     * 这是本插件**唯一主动放宽安全边界**的功能。开启后：
+     *   · roots / denyPaths 全部失效（Windows 内核直读，插件拦不住）
+     *   · 「清单先于字节」失效（.env / .git 密钥 / 中间产物全部对主机可见）
+     *   · 新增凭证面（主机需要副机 Windows 账号）
+     *
+     * 所以按用户要求做**二次确认**：
+     *   1. 点「共享工作区」→ 先展示风险说明 + 只读/读写选择
+     *   2. 必须勾选「我知道风险」才能点「生成共享命令」
+     *   3. 生成后给**可复制的命令**（需要管理员，本插件不代执行）
+     *
+     * 写权限（read/write）默认 read，选 write 要再确认一次 —— 最小权限原则。
+     */
+    function SharePanel(props) {
+      const nodes = (props.nodes || []).filter(function (n) { return n.online })
+      const nodeS = React.useState(nodes.length > 0 ? nodes[0].nodeId : '')
+      const nodeId = nodeS[0]
+      const setNodeId = nodeS[1]
+      const accessS = React.useState('read')
+      const access = accessS[0]
+      const setAccess = accessS[1]
+      const ackS = React.useState(false)
+      const ack = ackS[0]
+      const setAck = ackS[1]
+      const busyS = React.useState(false)
+      const busy = busyS[0]
+      const setBusy = busyS[1]
+      const noteS = React.useState('')
+      const note = noteS[0]
+      const setNote = noteS[1]
+      const planS = React.useState(null)
+      const plan = planS[0]
+      const setPlan = planS[1]
+      const probeS = React.useState(null)
+      const probe = probeS[0]
+      const setProbe = probeS[1]
+
+      function doProbe() {
+        if (nodeId === '') return
+        apiGet('/share?node=' + encodeURIComponent(nodeId))
+          .then(function (r) { setProbe(r || null) })
+          .catch(function (e) { setNote('探测失败：' + ((e && e.message) || e)) })
+      }
+
+      function doPlan() {
+        if (nodeId === '' || !ack) return
+        setBusy(true)
+        setNote('')
+        apiPost('/share', {
+          action: 'plan',
+          node: nodeId,
+          dir: '',
+          access: access,
+          confirm: 'yes',
+        })
+          .then(function (r) {
+            if (r && r.ok) { setPlan(r); setNote('') } else { setNote((r && r.message) || '生成失败') }
+          })
+          .catch(function (e) { setNote('生成失败：' + ((e && e.message) || e)) })
+          .then(function () { setBusy(false) })
+      }
+
+      const warnBox = h('div', { className: 'dra-err', style: { marginBottom: '8px' } },
+        h('div', { style: { fontWeight: '600', marginBottom: '4px' } },
+          '⚠ 开启共享会绕过本插件的安全边界'),
+        h('div', null, '共享出去的文件由 Windows 内核直接读写，本插件**无法**再拦：'),
+        h('div', { className: 'dra-dim', style: { marginLeft: '12px' } },
+          '· roots / denyPaths 全部失效'),
+        h('div', { className: 'dra-dim', style: { marginLeft: '12px' } },
+          '· 中间产物、日志、.env、.git 里的密钥全部对主机可见'),
+        h('div', { className: 'dra-dim', style: { marginLeft: '12px' } },
+          '· 主机需要副机的 Windows 账号（新增凭证面）'),
+        h('div', { style: { marginTop: '4px' } },
+          '只共享工作区目录，别共享整个盘。'),
+      )
+
+      if (nodes.length === 0) {
+        return h('div', null,
+          h('div', { className: 'dra-sec' }, '工作区共享（SMB）'),
+          h('div', { className: 'dra-empty' }, '没有在线副机 —— 共享需要在副机上开启。'),
+        )
+      }
+
+      return h('div', null,
+        h('div', { className: 'dra-sec' }, '工作区共享（SMB）'),
+        h('div', { className: 'dra-dim', style: { marginBottom: '8px' } },
+          '把副机的工作区映射成本地盘（net use X: \\\\副机\\...），可以用本地 IDE 直接打开。'),
+        warnBox,
+
+        h('div', { className: 'dra-row' },
+          h('span', { className: 'dra-k' }, '副机'),
+          h('select', {
+            className: 'dra-in',
+            value: nodeId,
+            onChange: function (e) { setNodeId(e.target.value); setPlan(null); setProbe(null) },
+          }, nodes.map(function (n) {
+            return h('option', { key: n.nodeId, value: n.nodeId }, n.nodeId)
+          })),
+          h('button', { className: 'dra-btn', disabled: busy, onClick: doProbe }, '探测当前状态'),
+        ),
+
+        probe
+          ? h('div', { className: 'dra-dim', style: { marginLeft: '20px' } },
+            probe.ok === false
+              ? ('探测失败：' + (probe.message || ''))
+              : ('管理员：' + (probe.admin ? '是' : '否（生成命令后需用管理员 PowerShell 执行）')
+                + ' ｜ 已有 dsh-work 共享：' + ((probe.shares || []).length || 0) + ' 个'))
+          : null,
+
+        h('div', { className: 'dra-row' },
+          h('span', { className: 'dra-k' }, '权限'),
+          h('select', {
+            className: 'dra-in',
+            value: access,
+            onChange: function (e) { setAccess(e.target.value); setPlan(null) },
+          },
+            h('option', { value: 'read' }, '只读（主机能看、不能改）—— 推荐'),
+            h('option', { value: 'write' }, '读写（主机能看能改）'),
+          ),
+        ),
+        access === 'write'
+          ? h('div', { className: 'dra-dim', style: { marginLeft: '20px', color: 'var(--dsw-alias-state-error-primary, currentColor)' } },
+            '⚠ 读写模式下主机可以修改/删除副机的文件。')
+          : null,
+
+        h('div', { className: 'dra-row', style: { marginTop: '8px' } },
+          h('input', {
+            type: 'checkbox',
+            checked: ack,
+            onChange: function (e) { setAck(e.target.checked) },
+          }),
+          h('span', { className: 'dra-dim' }, '我知道上面的风险，确认开启共享'),
+        ),
+        h('div', { className: 'dra-actions' },
+          h('button', {
+            className: 'dra-btn',
+            disabled: busy || !ack || nodeId === '',
+            onClick: doPlan,
+          }, busy ? '生成中…' : '生成共享命令'),
+          note ? h('span', { className: 'dra-dim' }, note) : null,
+        ),
+
+        plan && plan.ok
+          ? h('div', { style: { marginTop: '8px' } },
+            h('div', { className: 'dra-sec' }, '① 在副机上执行（需要管理员 PowerShell）'),
+            h('pre', {
+              className: 'dra-mono',
+              style: {
+                background: 'var(--dsw-alias-bg-layer-2)',
+                padding: '8px',
+                borderRadius: '6px',
+                whiteSpace: 'pre-wrap',
+                wordBreak: 'break-all',
+                userSelect: 'all',
+              },
+            }, plan.shareCommand),
+            h('div', { className: 'dra-dim' }, '共享名：' + plan.shareName
+              + ' ｜ 目录：' + plan.dir + ' ｜ 权限：' + (plan.access === 'write' ? '读写' : '只读')),
+
+            h('div', { className: 'dra-sec' }, '② 在主机上映射（普通 PowerShell 即可）'),
+            h('pre', {
+              className: 'dra-mono',
+              style: {
+                background: 'var(--dsw-alias-bg-layer-2)',
+                padding: '8px',
+                borderRadius: '6px',
+                whiteSpace: 'pre-wrap',
+                wordBreak: 'break-all',
+                userSelect: 'all',
+              },
+            }, plan.mountCommand),
+            h('div', { className: 'dra-dim' },
+              '执行后主机上会出现 X: 盘，就是副机的 ' + plan.dir + '。'),
+          )
+          : null,
+      )
+    }
+
     function SetupView(props) {
       const cur = (props.setup && props.setup.current) || {}
       const patchFile = (props.setup && props.setup.patchFile) || ''
@@ -327,13 +519,19 @@ window.__ModuleLoader__.load({
         hubUrl: cur.hubUrl || '',
         relayUrl: cur.relayUrl || '',
         nodeId: cur.nodeId || '',
-        roots: (cur.roots && cur.roots.length ? cur.roots.join(', ') : ''),
+        roots: (cur.roots && cur.roots.length ? cur.roots.join(', ') : defaultRootsHint()),
         transportMode: cur.transportMode === 'relay' ? 'relay' : 'direct',
         pair: '',
       })
       const f = f1[0]
       const setF = f1[1]
 
+      // 高级选项折叠（2026-10-17，开箱即用）：节点 ID 默认取主机名，
+      // 90% 的用户不需要改它。折叠起来少一个"必须理解"的字段。
+      const advS = React.useState(false)
+      const showAdv = advS[0]
+      const setShowAdv = advS[1]
+
       const b1 = React.useState(false)
       const busy = b1[0]
       const setBusy = b1[1]
@@ -357,6 +555,34 @@ window.__ModuleLoader__.load({
         setF(function (prev) { const n = Object.assign({}, prev); n[k] = v; return n })
       }
 
+      // ── 工作区默认值（2026-10-17，开箱即用）──────────────────────────
+      //
+      // 此前工作区是**空**的，必须用户自己填一个绝对路径。小白不知道填什么：
+      // 填相对路径会被拒（roots 必须是绝对路径）、填 `C:\` 太宽（安全边界）、
+      // 填一个不存在的目录任务会全报 workspace-denied。
+      //
+      // 现在给一个**安全且大概率可用**的默认值：
+      //   · Windows → `D:\work`（有 D 盘用 D，没有用 C:\Users\<name>\work）
+      //   · 其他    → `~/work`
+      //
+      // 这只是**表单预填**，真正的目录创建由服务端在写入配置时做（见
+      // setup-routes 的 ensureRoots）—— 面板不该直接碰文件系统。
+      //
+      // 注意：不能写 `C:\` 或 `~` 这种"整盘/整家目录"的默认值 ——
+      // roots 是安全边界，默认值必须是个**具体子目录**。
+      function defaultRootsHint() {
+        // 面板跑在浏览器里，拿不到服务端的 os.homedir()。
+        // 用 userAgent 判平台足够（这是预填提示，不是安全判定）。
+        try {
+          const ua = (navigator && navigator.userAgent) || ''
+          if (/Windows/i.test(ua)) return 'D:\\work'
+          if (/Mac/i.test(ua)) return '~/work'
+          return '~/work'
+        } catch {
+          return ''
+        }
+      }
+
       // 粘贴配对码时自动解出 hubUrl / relayUrl / nodeId
       // 码的格式见 lib/pairing.js（dshra1:// + base64url(JSON)）。
       function applyPair(code) {
@@ -573,18 +799,36 @@ window.__ModuleLoader__.load({
             }),
           ),
 
-          h('div', { className: 'dra-sec' }, '② 本机标识（可留空，默认取主机名）'),
-          h('div', { className: 'dra-row' },
-            h('span', { className: 'dra-k' }, '节点 ID'),
-            h('input', {
-              className: 'dra-input',
-              placeholder: '例如 slave-pc',
-              value: f.nodeId,
-              onChange: function (e) { set('nodeId', e.target.value) },
-            }),
+          // ── ② 本机标识：折叠为高级选项（2026-10-17，开箱即用）──────────
+          //
+          // 节点 ID 默认取主机名（lib/node/index.js 的 sanitizeNodeId），
+          // 90% 的用户不需要改。此前它是**平铺的必看字段**，小白会卡在
+          // "节点 ID 是什么？我要填什么？"。
+          //
+          // 折叠后：不展开就完全不用理解它；要改的人点一下就能改。
+          h('div', { className: 'dra-sec' },
+            h('span', null, '② 本机标识'),
+            h('span', {
+              className: 'dra-dim',
+              style: { marginLeft: '8px', cursor: 'pointer', textDecoration: 'underline' },
+              onClick: function () { setShowAdv(!showAdv) },
+            }, showAdv ? '收起' : '默认用主机名（点此自定义）'),
           ),
+          showAdv
+            ? h('div', null,
+              h('div', { className: 'dra-row' },
+                h('span', { className: 'dra-k' }, '节点 ID'),
+                h('input', {
+                  className: 'dra-input',
+                  placeholder: '留空 = 自动用本机主机名',
+                  value: f.nodeId,
+                  onChange: function (e) { set('nodeId', e.target.value) },
+                }),
+              ),
+            )
+            : null,
 
-          h('div', { className: 'dra-sec' }, '③ 允许任务在哪些目录干活（必填，逗号分隔）'),
+          h('div', { className: 'dra-sec' }, '③ 允许任务在哪些目录干活（已预填，一般不用改）'),
           h('div', { className: 'dra-row' },
             h('span', { className: 'dra-k' }, '工作区'),
             h('input', {
@@ -594,7 +838,9 @@ window.__ModuleLoader__.load({
               onChange: function (e) { set('roots', e.target.value) },
             }),
           ),
-          h('div', { className: 'dra-dim' }, '任务只能在这些目录内动作 —— 这是安全边界，别填整个盘。'),
+          h('div', { className: 'dra-dim' },
+            '任务只能在这些目录内动作 —— 这是安全边界，别填整个盘。'
+            + '目录不存在时写入配置会自动创建。'),
 
           // ⚠ 提示必须放在**按钮上方**。
           //
@@ -680,6 +926,42 @@ window.__ModuleLoader__.load({
       const showCfg = showCfgS[0]
       const setShowCfg = showCfgS[1]
 
+      // ── 环境体检（2026-10-17）───────────────────────────────────────────
+      //
+      // 与命令行 `dsh-remote-setup --doctor` 共用 lib/env-check.js 的同一份逻辑。
+      //
+      // 为什么面板上必须有：这个插件最贵的失败全是**静默**的 —— 绑 loopback
+      // 导致副机永远连不上、inject 缺服务导致 hub 半死、roots 不存在导致任务
+      // 全被拒。这些在主机侧都"看起来正常"，用户只能猜。
+      //
+      // 三档处置（产品决策）：能自动修的标「可自动修」；需要装东西的只给
+      // 命令/链接（**不代下载**）；需要人判断的只报清楚。
+      //
+      // ⚠ 顺序是硬要求：state 与 runEnvCheck 都必须定义在**按钮之前** ——
+      // `const` 有 TDZ，反过来会在渲染时 ReferenceError（第一版就是这样，
+      // 靠人工核对行号才发现）。所以 state → 函数 → 按钮 → 渲染区，不能乱。
+      //
+      // 只在点「体检」时拉一次，不进 4 秒轮询：体检含系统探测，没必要反复跑。
+      const envS = React.useState(null)
+      const envCheck = envS[0]
+      const setEnvCheck = envS[1]
+      const envBusyS = React.useState(false)
+      const envBusy = envBusyS[0]
+      const setEnvBusy = envBusyS[1]
+
+      const runEnvCheck = function () {
+        if (envBusy) return
+        setEnvBusy(true)
+        apiGet('/env-check')
+          .then(function (r) { setEnvCheck(r || null) })
+          .catch(function (err) { setNote('体检失败：' + (err.message || err)) })
+          .then(function () { setEnvBusy(false) })
+      }
+
+      // 首次自动体检的闸门。用 ref（不是 state）—— 它只控制"要不要跑一次"，
+      // 改了不需要重渲染。
+      const autoChecked = React.useRef(false)
+
       // 副机接入卡片（生成配对码）
       const pairS = React.useState(null)
       const pair = pairS[0]
@@ -970,6 +1252,19 @@ window.__ModuleLoader__.load({
                   tasks: tk.tasks || [],
                 })
               })
+              // ── 首次自动体检（2026-10-17，开箱即用）──────────────────
+              //
+              // 此前体检要用户主动点「体检」按钮 —— 但小白不知道要点。
+              // 而这个插件最贵的失败全是静默的（绑 loopback 副机连不上、
+              // inject 缺服务 hub 半死、roots 不存在任务全被拒），不主动
+              // 检查就等于"永远不知道哪里错了"。
+              //
+              // 只在**第一次**成功加载时自动跑一次（autoChecked 是 ref，
+              // 不触发重渲染）。之后 4 秒轮询不会重复体检（体检含系统探测）。
+              if (!autoChecked.current) {
+                autoChecked.current = true
+                runEnvCheck()
+              }
             })
             .catch(function (err) {
               if (disposed) return
@@ -1161,6 +1456,16 @@ window.__ModuleLoader__.load({
           },
         }, showPair ? '收起接入' : '副机接入'),
         h('button', { className: 'dra-btn', onClick: refresh }, '刷新'),
+        // ── 环境体检 ─────────────────────────────────────────────────
+        //
+        // 这个插件的失败大多是**静默**的（绑 loopback 副机连不上、inject 缺
+        // 服务 hub 半死、roots 不存在任务全被拒），主机侧都"看起来正常"。
+        // 体检把这些问题逐条列出来，每条带修法 —— 能自动修的标出来。
+        h('button', {
+          className: 'dra-btn',
+          disabled: envBusy,
+          onClick: runEnvCheck,
+        }, envBusy ? '体检中…' : '体检'),
         // ── 清理任务视图 ─────────────────────────────────────────────
         //
         // 为什么面板上需要这个按钮：hub 侧任务视图会累积（副机的任务记录
@@ -1294,10 +1599,71 @@ window.__ModuleLoader__.load({
           ),
       )
 
+      const envSection = envCheck === null
+        ? null
+        : h('div', null,
+          h('div', { className: 'dra-sec' }, '环境体检'),
+          h('div', { className: 'dra-dim', style: { marginBottom: '6px' } },
+            (envCheck.failed === 0
+              ? '核心项全部通过'
+              : '共 ' + envCheck.failed + ' 项需要处理')
+            + (envCheck.autoFixable > 0 ? '（其中 ' + envCheck.autoFixable + ' 项可自动修）' : '')),
+          (envCheck.items || []).map(function (it) {
+            const mark = it.ok ? '✓' : (it.severity === 'warn' ? '⚠' : '✗')
+            return h('div', { key: it.id, className: 'dra-env-item' },
+              h('div', { className: 'dra-row', style: { alignItems: 'baseline' } },
+                h('span', {
+                  className: 'dra-mono',
+                  style: { color: it.ok ? 'var(--dsw-alias-state-success-primary, currentColor)' : 'var(--dsw-alias-state-error-primary, currentColor)' },
+                }, mark),
+                h('span', { style: { flex: '1' } }, it.label),
+                it.autoFix ? h('span', { className: 'dra-badge' }, '可自动修') : null,
+              ),
+              it.detail
+                ? h('div', { className: 'dra-dim', style: { paddingLeft: '20px' } }, it.detail)
+                : null,
+              !it.ok && it.fix
+                ? h('div', { className: 'dra-dim', style: { paddingLeft: '20px', marginTop: '2px' } },
+                  '↳ 怎么修：' + it.fix)
+                : null,
+            )
+          }),
+        )
+
       const errBox = state.error
         ? h('div', { className: 'dra-err' }, '读取失败：' + state.error)
         : null
 
+      // ── 可达性横幅（2026-10-17）─────────────────────────────────────────
+      //
+      // 这是本插件**最贵的一个静默失败**：DSH 的 webserver 默认绑 127.0.0.1
+      // （它面向"本机浏览器访问自己"），而本插件的用法是跨机 —— 副机拿
+      // `ws://<主机IP>:19387/...` 拨入。绑 loopback 时：
+      //
+      //   · hub 自己一切正常（healthz 200、面板能开、工具都在）
+      //   · 副机**永远连不上**（ECONNREFUSED / connect timeout）
+      //   · 主机侧没有任何异常 → 用户只能猜"地址错了？token 错了？防火墙？"
+      //
+      // 实测三种用户会踩：全新安装（绝大多数）、装过改 lanBind 的插件又卸载
+      // （托管块残留）、自己改错。
+      //
+      // 所以这里渲染成**红色横幅 + 具体修法**。日志用户不会看，面板会看。
+      const reach = caps && caps.reachability ? caps.reachability : null
+      const reachBox = reach && reach.loopback === true
+        ? h('div', { className: 'dra-err', style: { marginBottom: '10px' } },
+          h('div', { style: { fontWeight: '600', marginBottom: '4px' } },
+            '⚠ 副机连不上：本机 Web 服务只监听 ' + (reach.bound || '127.0.0.1')),
+          h('div', null, '现在监听在 ', h('code', null, reach.origin || ''),
+            '，只有本机能访问。副机用任何地址都连不上。'),
+          h('div', { style: { marginTop: '6px' } }, '修法：在 profile 的 ',
+            h('code', null, 'cordis.patch.yml'), ' 里给 ', h('code', null, 'webserver'),
+            ' 行加 ', h('code', null, "host: '0.0.0.0'"), '（保留 port），然后重启 DSH。'),
+          reach.hint
+            ? h('div', { className: 'dra-dim', style: { marginTop: '4px' } }, reach.hint)
+            : null,
+        )
+        : null
+
       const cards = h('div', { className: 'dra-cards' },
         h('div', { className: 'dra-card' },
           h('div', { className: 'dra-card-n' }, String(counts.online || 0)),
@@ -1723,7 +2089,20 @@ window.__ModuleLoader__.load({
       return h('div', { className: 'dra-root' },
         h(StyleTag),
         head,
-        h('div', { className: 'dra-body' }, errBox, cfgSection, pairSection, cards, nodeSection, dispatchForm, taskSection),
+        h('div', { className: 'dra-body' },
+          errBox,
+          reachBox,
+          cfgSection,
+          envSection,
+          pairSection,
+          cards,
+          nodeSection,
+          // 工作区共享（2026-10-17）：**放在派发表单之前** —— 它是"配好之后
+          // 想用本地 IDE 打开副机文件"的进阶需求，不该抢首屏位置，但也不该
+          // 埋在任务列表下面。二次确认在组件内部。
+          h(SharePanel, { nodes: state.nodes }),
+          dispatchForm,
+          taskSection),
       )
     }