@whyshu/argent 0.2.7 → 0.2.9

package/mcp/gateway.mjs

@@ -32,6 +32,16 @@ import { fileURLToPath } from 'node:url'
 
 const HERE = dirname(fileURLToPath(import.meta.url))
 const PKG_ROOT = resolve(HERE, '..')
+/**
+ * 引擎根（**可选**）：只认宿主显式传入的 `ARGENT_ENGINE_DIR`（`@whyshu/argent` 注册时会给），
+ * ⛔ 不按仓库相对路径猜 —— 插件安装后没有"仓库根"，这条口径由
+ * `scripts/tests/argent-mcp-vendor-sync.test.mjs` 钉住。
+ * 2026-11-08 修：本文件从 `core/mcp/gateway.mjs` 抄来时把原来的 `REPO` 丢了、只剩 `PKG_ROOT`，
+ * 而 ml 分支还在用 `REPO`（`tools/agentic/mcp_server.py` / `scripts`）⇒ 只要
+ * `ARGENT_GATEWAY_ML=1` 就抛 `ReferenceError: REPO is not defined`，**而且死在装 stdio 前端之前**
+ * ⇒ 宿主侧 `dsh-mcp-client` 永远等不到 initialize 响应（表现为"MCP 网关握手挂起"）。
+ */
+const ENGINE_DIR = process.env.ARGENT_ENGINE_DIR || ''
 const DATA_DIR = process.env.ARGENT_DATA_DIR || join(homedir(), '.dsh', 'argent')
 const GATEWAY_DIR = join(DATA_DIR, 'gateway')
 const NO_PREFIX = process.env.ARGENT_GATEWAY_NOPREFIX === '1'
@@ -147,15 +157,16 @@ export class Gateway {
 
   static defaultUpstreams() {
     // 引擎上游可选：插件独立安装（没有 engine 包）时只挂 erp.*，不因缺引擎而整个网关启动失败
-    const engineDir = process.env.ARGENT_ENGINE_DIR || ''
+    const engineDir = ENGINE_DIR
     const engineServer = engineDir ? join(engineDir, 'core', 'mcp', 'server.mjs') : ''
     const ups = []
     if (engineServer && existsSync(engineServer)) ups.push(new Upstream('engine', process.execPath, [engineServer]))
     ups.push(new Upstream('erp', process.execPath, [join(HERE, 'erp-server.mjs')]))
     if (process.env.ARGENT_GATEWAY_ML === '1') {
+      // ml 上游在**引擎根**下面（tools/agentic/mcp_server.py + scripts）；没有引擎根就跳过，⛔ 不猜路径
       const py = process.env.ARGENT_ENGINE_PY || join(DATA_DIR, 'venv', 'bin', 'python3')
-      const srv = join(REPO, 'tools', 'agentic', 'mcp_server.py')
-      if (existsSync(py) && existsSync(srv)) ups.push(new Upstream('ml', py, [srv], { PYTHONPATH: join(REPO, 'scripts') }))
+      const srv = engineDir ? join(engineDir, 'tools', 'agentic', 'mcp_server.py') : ''
+      if (py && srv && existsSync(py) && existsSync(srv)) ups.push(new Upstream('ml', py, [srv], { PYTHONPATH: join(engineDir, 'scripts') }))
     }
     return ups
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@whyshu/argent",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "type": "module",
   "description": "Argent 单 bundle（dsh web / DSH Desktop 同一插件）：ERP 连接器 + 问述代理 + 登录/续期 + MCP 网关 + 伞伞桌宠（含积分）",
   "main": "src/index.js",

package/src/index.js

@@ -227,8 +227,13 @@ export function apply(ctx) {
       }
     }
 
-    // ⛔ 2026-11-07 实测：启动阶段 ctx.plugin(dsh-mcp-client) 会挂起 dsh 启动（端口 bound 但 HTTP 不响应），
-    //    用户侧表现为「dsh 启动失败」；只有删插件才能启动。故：默认延后注册，且可用 ARGENT_MCP_DISABLE=1 关闭。
+    // 真根因（2026-11-08 用 V8 inspector 抓栈确诊）：**不是** dsh-mcp-client/网关握手挂起，而是
+    //   MCP 工具在 boot 之后才注册 ⇒ 触发 `@whyshu/argent-erp` 的 office-guard 在
+    //   「dispose 旧 mask → restrict 新 mask」过程中的**同步重入风暴**（主线程 100% CPU + 堆 OOM，
+    //   端口 bound 但 HTTP 不响应）。已在 office-guard 加 reconcile 重入闸修好；见
+    //   scripts/tests/argent-office-guard-reentrancy.test.mjs。
+    //   这里仍保留「延后注册 + ARGENT_MCP_DISABLE + 握手 20s 上限」作为兜底：宿主侧第三方 listeners
+    //   若还有同类重入，最多拖慢 MCP 自身，不把 boot 与 HTTP 服务拖下水。
     if (process.env.ARGENT_MCP_DISABLE === '1') {
       console.log('[argent] MCP 网关已禁用（ARGENT_MCP_DISABLE=1）')
     } else setTimeout(() => { void (async () => {

package/src/tunnel.mjs

@@ -530,18 +530,33 @@ export function startTunnel(options = {}) {
   }
 
   // ── dsh 准入 cookie（仅内存；401/403 重换一次）──────────────────────────
+  // dsh 准入 token 的三条来源（优先级：env → 启动脚本写出的 token 文件 → 本机 /api/argent-state/access）
+  // 为什么需要文件来源：`/api/argent-state/access` 由 argent-core 插件提供；单插件（@whyshu/argent）装配下
+  // 该端点 401 ⇒ 隧道拿不到 token ⇒ App 侧表现为 access-unavailable（2026-11-07 实测）。
+  const readTokenFile = () => {
+    try {
+      const t = readFileSync(join(String(options.dataDir || ''), 'dsh-web.token'), 'utf8').trim()
+      return t || ''
+    } catch { return '' }
+  }
   const acquireCookie = async ({ refresh = false } = {}) => {
     if (!refresh && dsh.cookie) return dsh.cookie
-    let access
-    try {
-      access = await fetchImpl(`${dshBase}${DSH_ACCESS_PATH}`, {
-        headers: { accept: 'application/json' },
-        signal: AbortSignal.timeout(5000),
-      })
-    } catch { throw err('access-unreachable') }
     let body = null
-    try { body = await access.json() } catch { body = null }
-    if (!access.ok || !body || body.ok !== true || !body.token) throw err('access-unavailable', `HTTP ${access.status}`)
+    const envToken = String(env.ARGENT_DSH_TOKEN || '').trim()
+    const fileToken = envToken ? '' : readTokenFile()
+    if (envToken || fileToken) {
+      body = { ok: true, token: envToken || fileToken }
+    } else {
+      let access
+      try {
+        access = await fetchImpl(`${dshBase}${DSH_ACCESS_PATH}`, {
+          headers: { accept: 'application/json' },
+          signal: AbortSignal.timeout(5000),
+        })
+      } catch { throw err('access-unreachable') }
+      try { body = await access.json() } catch { body = null }
+      if (!access.ok || !body || body.ok !== true || !body.token) throw err('access-unavailable', `HTTP ${access.status}`)
+    }
     let res
     try {
       res = await fetchImpl(`${dshBase}/?token=${encodeURIComponent(String(body.token))}`, {