@whyshu/argent-engine 0.0.0-stage → 0.6.0

package/engine/scripts/dsh-url.sh

@@ -0,0 +1,86 @@
+#!/bin/bash
+# dsh-url.sh — 查看当前 dsh web 的访问地址（带 token；只读，不重启服务）
+#
+# 用途：dsh 是开机自启动的，想知道"现在的带 token URL"跑这个脚本即可。
+# 原理：dsh 每次启动会把带 token 的 URL 打印到日志（取最后一条 = 当前进程的）。
+# 注意：token 每次重启变化；已用 URL 换过 cookie 的设备（30 天有效）无需再带 token。
+#
+# ⑩c（2026-10-08）：日志落点**不再写死 `/tmp/dsh-web.log`** —— 候选顺序的唯一真源是
+#   `scripts/lib/wake-auth.mjs#logPaths()`（`node scripts/lib/wake-auth.mjs --log-paths` 可取到）：
+#     DSH_WEB_LOG → plist 的 StandardOutPath → $DSH_HOME/dsh-web.log → ~/Library/Logs/dsh-web.log
+#     → /tmp/dsh-web.log（历史兜底，排最后）
+#   逐项试、**命中即停** ⇒ "设了 DSH_WEB_LOG 就绝不碰 /tmp"是同一个循环的自然结果，不是第二份判据。
+#   全部落空 ⇒ **响亮失败**（非零退出 + 点名每个落点 + 修法），⛔ 不再打印占位提示（半静默）。
+set -u
+
+SELF="${BASH_SOURCE[0]}"
+. "$(dirname "${SELF}")/lib/repo-root.sh"
+REPO="$(argent_repo_root "${SELF}")"
+WAKE_AUTH="${REPO}/scripts/lib/wake-auth.mjs"
+
+if ! lsof -nP -iTCP:3080 -sTCP:LISTEN 2>/dev/null | grep -q node; then
+  echo "❌ dsh web 未在运行（3080 无 node 监听）"
+  echo "   拉起服务：bash ~/Code/argent-dsh/scripts/dsh-restart.sh"
+  exit 1
+fi
+
+# ── 候选落点：唯一真源（wake-auth#logPaths），逐项试、命中即停 ────────────────────
+CANDS="$(node "${WAKE_AUTH}" --log-paths 2>&1)"
+NODE_RC=$?
+if [ "${NODE_RC}" -ne 0 ] || [ -z "${CANDS}" ]; then
+  {
+    echo "❌ 取不到日志候选落点（node ${WAKE_AUTH} --log-paths 失败，exit=${NODE_RC}）："
+    printf '%s\n' "${CANDS}" | sed 's/^/    /'
+    echo "   修法：确认 node 可用，且 ${REPO} 是完整的 argent-dsh 树（scripts/lib/wake-auth.mjs 在位）"
+  } >&2
+  exit 1
+fi
+
+LOG=""
+TRIED=""
+while IFS= read -r p; do
+  [ -n "${p}" ] || continue
+  if [ ! -f "${p}" ]; then
+    TRIED="${TRIED}  ❌ ${p}：文件不存在（日志被系统清理或被运维挪走）"$'\n'
+    continue
+  fi
+  if grep -q "dsh web: http" "${p}" 2>/dev/null; then LOG="${p}"; break; fi
+  TRIED="${TRIED}  ❌ ${p}：有文件，但没有「dsh web: http」那一行（多半是别的进程/旧日志）"$'\n'
+done <<< "${CANDS}"
+
+if [ -z "${LOG}" ]; then
+  {
+    echo "❌ 取不到 dsh web 的启动地址：候选日志**全部不可用**（token 只在启动那一行里，日志没了就取不到）"
+    printf '%s' "${TRIED}"
+    echo "   修法（按代价从低到高）："
+    echo "     · 日志若被挪走，本链会自动跟随 plist 的声明：plutil -p ~/Library/LaunchAgents/com.whyshu.dsh-web.plist | grep -i path"
+    echo "     · 重启并打印落点：bash ~/Code/argent-dsh/scripts/dsh-restart.sh"
+    echo "     · 或显式指定落点（\":\" 分隔可给多个）：export DSH_WEB_LOG=<日志路径> ／ export ARGENT_WAKE_LOG_PATHS=<路径1>:<路径2>"
+    echo "     · 候选表由 scripts/lib/wake-auth.mjs#logPaths() 给出：node scripts/lib/wake-auth.mjs --log-paths"
+  } >&2
+  exit 1
+fi
+
+URL=$(grep "dsh web: http" "${LOG}" | tail -1 | sed 's/^.*dsh web: //')
+if [ -z "${URL}" ]; then
+  echo "❌ 从日志里取不到 URL（文件 ${LOG} 命中了关键字、但解析为空）" >&2
+  exit 1
+fi
+
+echo "✅ dsh web 运行中"
+echo "   日志落点：${LOG}"
+echo
+echo "本机访问:"
+echo "  ${URL}"
+echo
+# 组网（手机/其他设备）访问：同一 token 配 EasyTier IP
+TOKEN=$(echo "${URL}" | sed 's/.*?token=//')
+IP=$(ifconfig 2>/dev/null | grep -oE '10\.126\.126\.[0-9]+' | head -1)
+if [ -n "${IP}" ] && [ -n "${TOKEN}" ]; then
+  echo "组网访问（手机等，需已连 EasyTier）:"
+  echo "  http://${IP}:3080/?token=${TOKEN}"
+  echo
+fi
+echo "提示：token 每次服务重启会变；已用上述 URL 换过 cookie 的设备（30 天有效）"
+echo "      之后直接访问 http://127.0.0.1:3080/（或组网 IP）即可，无需再带 token。"
+echo "      当前有 cookie 的老设备不受重启影响（browser-session 授权已持久化）。"

package/engine/scripts/dsh-web-launch.mjs

@@ -0,0 +1,155 @@
+#!/usr/bin/env node
+/**
+ * dsh-web-launch —— 服务默认入口的**稳定包装脚本**（P5，2026-09-29，B 方案）
+ *
+ * LaunchAgent 不再直接调 `dsh`（那个链接会被升级重建、跟着坏版本走），而是调本脚本：
+ *   ① 读指针 `<DSH_HOME>/argent/base/current-scope` → 拿到当前该跑哪棵树；
+ *   ② exec `<tree>/dsh/lib/bin.js web …`（参数原样透传）；
+ *   ③ 启动失败（或起后 `--min-uptime` 秒内退出）⇒ 记事件；
+ *      **连续 3 次**失败 ⇒ 把指针切回上一棵 known-good 树并**重启一次**；
+ *      回退目标也失败 ⇒ 停下并打印人工指引（不无限重启 —— 这正是历史上踩过的循环）。
+ *
+ * 为什么熔断放在这里而不是 launchd：KeepAlive 只知道"进程退了就再起"，它不会判断
+ * "连起三次都秒退"这件事；熔断必须在**入口**这一层。
+ *
+ * 用法（LaunchAgent 用；人工排障也可直接跑）：
+ *   node scripts/dsh-web-launch.mjs [--dry-run] [--min-uptime 30] [--max-failures 3] [--] <dsh web 的参数…>
+ * 退出码：透传 dsh 的退出码；熔断放弃时 78（配置错误，规范用法）。
+ */
+import { spawn } from 'node:child_process'
+import { existsSync } from 'node:fs'
+import { join } from 'node:path'
+import {
+  clearFused, consecutiveFailures, looksLikeScope, previousScope, readFused, readPointer,
+  recordFailure, writePointer, writeFused,
+} from './lib/scope-pointer.mjs'
+
+const argv = process.argv.slice(2)
+const flag = (name, dflt) => {
+  const i = argv.indexOf(name)
+  return i > -1 ? argv[i + 1] ?? dflt : dflt
+}
+const DRY = argv.includes('--dry-run')
+const MIN_UPTIME_MS = Number(flag('--min-uptime', 30)) * 1000
+const MAX_FAILURES = Number(flag('--max-failures', 3))
+const NO_BOOTOUT = argv.includes('--no-bootout')      // 保险丝：不动 launchd（测试/人工排障用）
+const RESET_FUSE = argv.includes('--reset-fuse')      // 人工确认修好后解除熔断
+const LABEL = flag('--label', process.env.DSH_WEB_LABEL || 'com.whyshu.dsh-web')
+const sepIdx = argv.indexOf('--')
+// 只剥离 launcher 自身的参数（--dry-run / --min-uptime N / --max-failures N）；
+// 其余参数（含 --no-open、--trusted-host X 等 dsh 自身选项）**原样透传**。
+// 2026-09-29 修复（真实事故）：旧实现把全部 `--` 开头项删掉、只留下它们的值
+// ⇒ dsh 收到裸的 `10.126.126.2:3080 10.126.126.1:3080` 报
+//   "too many arguments. Expected 0 arguments but got 2" ⇒ 服务秒退 ⇒ KeepAlive 无限重启循环。
+const passthrough = (sepIdx > -1 ? argv.slice(sepIdx + 1) : (() => {
+  const out = []
+  for (let i = 0; i < argv.length; i += 1) {
+    const a = argv[i]
+    if (a === '--dry-run') continue
+    if (a === '--min-uptime' || a === '--max-failures' || a === '--label') { i += 1; continue }
+    out.push(a)
+  }
+  return out
+})())
+
+const log = (msg) => console.log(`[dsh-web-launch] ${msg}`)
+const recoveryHint = () => `  修好后解除熔断：node scripts/dsh-web-launch.mjs --reset-fuse\n` +
+  `  再重载服务：bash scripts/dsh-restart.sh（或 launchctl bootstrap gui/$(id -u)/${LABEL} ~/Library/LaunchAgents/${LABEL}.plist）`
+
+if (RESET_FUSE) {
+  const had = clearFused()
+  log(had ? '✅ 已解除熔断标记（下次启动会正常执行）' : '（本来就没有熔断标记）')
+  console.log(recoveryHint())
+  process.exit(0)
+}
+// 已熔断：拒绝启动，避免"回退目标也起不来"的坏状态被 launchd 无限重演
+{
+  const fused = readFused()
+  if (fused) {
+    console.error(`[dsh-web-launch] ⛔ 处于熔断状态（${fused.at || '?'}）：${fused.why || '回退目标也启动失败'}\n` +
+      `  当时失败的树：${fused.scope || '?'}\n` + recoveryHint())
+    process.exit(78)
+  }
+}
+
+function binOf(scope) {
+  return join(scope, 'dsh', 'lib', 'bin.js')
+}
+
+/** 跑一次 dsh，返回 {code, uptimeMs}；用 spawn（不 shell）以免参数被二次解释。 */
+function runOnce(scope, args) {
+  return new Promise((resolve) => {
+    const started = Date.now()
+    const child = spawn(process.execPath, [binOf(scope), ...args], { stdio: 'inherit' })
+    const done = (code, signal) => resolve({ code: code ?? (signal ? 1 : 0), uptimeMs: Date.now() - started })
+    child.on('error', (e) => { log(`启动失败：${e.message}`); done(127) })
+    child.on('exit', (code, signal) => {
+      const up = Date.now() - started
+      log(`dsh 退出：code=${code} signal=${signal || '-'} 存活 ${Math.round(up / 1000)}s`)
+      done(code, signal)
+    })
+    if (DRY) { child.kill('SIGTERM') }
+  })
+}
+
+const pointer = readPointer()
+log(`指针：${pointer || '(未设置)'}${DRY ? '（dry-run）' : ''}`)
+if (!pointer || !looksLikeScope(pointer)) {
+  console.error(`[dsh-web-launch] ✗ 指针缺失或指向的不是 dsh 安装树：${pointer}\n` +
+    '  修：bash scripts/dsh-restore.sh --list   # 看历史与可用树\n' +
+    '      bash scripts/dsh-restore.sh --to <树目录>')
+  process.exit(78)
+}
+
+const first = await runOnce(pointer, passthrough)
+const failedFast = first.code !== 0 || first.uptimeMs < MIN_UPTIME_MS
+if (!failedFast) process.exit(first.code)
+
+if (!DRY) recordFailure(process.env, { ok: false, scope: pointer, code: first.code, uptimeMs: first.uptimeMs })
+const { count } = consecutiveFailures(process.env)
+log(`连续失败 ${count}/${MAX_FAILURES} 次`)
+
+if (count < MAX_FAILURES) {
+  process.exit(first.code)      // 还没到阈值：交给 KeepAlive 再试，别急着回退
+}
+
+// ── 熔断：切回上一棵 known-good 树并重启一次 ──────────────────────
+const prev = previousScope(process.env, pointer)
+if (!prev) {
+  console.error(`[dsh-web-launch] ✗ 连续 ${count} 次失败，但审计里找不到可回退的树。\n` +
+    '  人工：bash scripts/dsh-restore.sh --to <树目录>（或从整树备份恢复）')
+  process.exit(78)
+}
+log(`⛔ 熔断：连续 ${count} 次失败 ⇒ 回退到上一棵 known-good 树：${prev}`)
+if (DRY) { log('（dry-run：不实际切换、不重启）'); process.exit(first.code) }
+writePointer(prev, { reason: `fuse: ${count} consecutive failures on ${pointer}`, previous: pointer })
+
+const second = await runOnce(prev, passthrough)
+if (second.code === 0 || second.uptimeMs >= MIN_UPTIME_MS) {
+  recordFailure(process.env, { ok: true, scope: prev, note: 'fuse rollback succeeded', uptimeMs: second.uptimeMs })
+  process.exit(second.code)
+}
+recordFailure(process.env, { ok: false, scope: prev, code: second.code, note: 'rollback target also failed' })
+// 真正"停下来"：写熔断标记（防再次被拉起）+ bootout 掉 job（让 KeepAlive 不再拉起）
+const marker = DRY ? null : writeFused(process.env, {
+  why: `连续 ${count} 次失败，且回退目标 ${prev} 也起不来`, scope: pointer, rollbackTarget: prev, label: LABEL,
+})
+if (marker) log(`已落熔断标记：${marker}`)
+let booted = false
+if (DRY || NO_BOOTOUT) {
+  log(DRY ? '（dry-run：不 bootout）' : '（--no-bootout：不动 launchd）')
+} else {
+  try {
+    const { execFileSync } = await import('node:child_process')
+    execFileSync('launchctl', ['bootout', `gui/${process.getuid()}/${LABEL}`], { stdio: 'inherit' })
+    booted = true
+    log(`已 bootout ${LABEL} —— launchd 不会再拉起（避免无限重启循环）`)
+  } catch (e) {
+    // bootout 失败不算致命：标记仍在，下次被拉起时会拒绝启动
+    log(`bootout 未成功（${String(e.message || e).slice(0, 80)}）—— 标记仍在，下次启动会拒绝执行`)
+  }
+}
+console.error(`[dsh-web-launch] ✗ 回退目标也起不来 ⇒ 已停止自动重试${booted ? '（job 已卸载）' : ''}。\n` +
+  '  人工：bash scripts/dsh-restore.sh --list ；必要时用整树备份恢复后 --to <树>\n' +
+  `  然后解除熔断：node scripts/dsh-web-launch.mjs --reset-fuse`)
+process.exit(78)