@whyshu/argent 0.1.27 → 0.2.1

package/src/index.js

@@ -0,0 +1,239 @@
+/**
+ * @whyshu/argent —— **单插件**（dsh web / DSH Desktop 同一份，2026-11-07 合并）
+ *
+ * 形态：一个 bundle 一行 insert，内部自包含；不再区分 argent-web / argent-desktop。
+ * 两个宿主是同一个 web app（Electron 包着 dsh web），宿主注入均为 `webServer` ⇒ 一套代码适配两端：
+ *   ① 问述 provider（llm-whyshu，动态 import：宿主缺 @deepseek-ai/dsh-llm* 时只降级不炸 boot）
+ *   ② 一键登录端点（设备码，只写 credentials；含 refresh_token 自动续期）
+ *   ③ MCP 网关（engine.* / erp.* / ml.*）自注册，不需要 profile patch 再挂 mcp-argent-*
+ *   ④ ERP 机器通道（office-runtime）——受「先到先得」租约保护：抢到 poller 才轮询，否则纯 UI
+ *   ⑤ 桌宠/积分面板端点（/api/argent/account、/api/argent/health；客户端 bundle 5s 轮询）
+ *
+ * 数据目录：唯一判据在内核（core/lib/argent-datadir.mjs）；解析不到时回退 ARGENT_DATA_DIR / ~/.dsh/argent。
+ * 引擎目录：ARGENT_ENGINE_DIR → 内核 argent.json#engineDir → <dataDir>/engines/<ver>/engine → ~/.argent-dsh。
+ */
+import { existsSync, readdirSync, readFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { dirname, join } from 'node:path'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+import { createRequire } from 'node:module'
+
+import { resolveKernel } from './kernel.mjs'
+import { startOfficeRuntime } from './office-runtime.js'
+import { registerWhyshuAuth } from './whyshu-auth.mjs'
+import { acquireLease, heartbeatLease, releaseLease, leaseHolder } from './lease.mjs'
+import { resolveAccountToken } from './account-token.mjs'
+import { installMachineSessionReporter } from './machine-session.mjs'
+
+const PKG_ROOT = dirname(dirname(fileURLToPath(import.meta.url)))
+const PKG_VERSION = (() => {
+  try { return JSON.parse(readFileSync(join(PKG_ROOT, 'package.json'), 'utf8')).version || '' } catch { return '' }
+})()
+
+const API_BASE = (process.env.ARGENT_API_BASE || 'https://whyshu.com').replace(/\/+$/, '')
+const TENANT = process.env.ARGENT_TENANT || 'ly-0001'
+const HEARTBEAT_MS = 30_000
+
+/** 引擎目录探测（决定 MCP 网关是否挂 engine.* 上游）：找不到就只挂 erp.*，网关照常起。 */
+function detectEngineDir(dataDir, preferred = '') {
+  if (preferred) return preferred
+  if (process.env.ARGENT_ENGINE_DIR) return process.env.ARGENT_ENGINE_DIR
+  const cands = []
+  try {
+    for (const d of readdirSync(join(dataDir, 'engines'))) cands.push(join(dataDir, 'engines', d, 'engine'))
+  } catch { /* 没有 engines 目录 */ }
+  cands.push(join(homedir(), '.argent-dsh'))
+  for (const c of cands.reverse()) {
+    try { if (existsSync(join(c, 'core', 'mcp', 'server.mjs'))) return c } catch { /* next */ }
+  }
+  return ''
+}
+
+/** 宿主模块解析（bare → profile createRequire 回退；软链/复制安装都能用） */
+async function hostImport(name) {
+  let first = null
+  try { return await import(name) } catch (e) { first = e }
+  const home = process.env.DSH_HOME || join(homedir(), '.dsh')
+  for (const p of ['desktop', 'web', 'headless']) {
+    try {
+      const req = createRequire(pathToFileURL(join(home, 'profiles', p, 'package.json')).href)
+      return await import(pathToFileURL(req.resolve(name)).href)
+    } catch { /* next */ }
+  }
+  throw first || new Error(`host module not found: ${name}`)
+}
+
+/** 账号面板数据（伞伞积分卡）：/me + /tenants/:id/billing/summary；失败不影响其它功能。 */
+async function fetchAccount() {
+  const { token, source } = resolveAccountToken()
+  if (!token) return { ok: false, code: 'no_token', message: '未登录问述账号' }
+  const h = { 'x-api-key': token, accept: 'application/json' }
+  try {
+    const [me, bill] = await Promise.all([
+      fetch(`${API_BASE}/api/argent/v1/me`, { headers: h, signal: AbortSignal.timeout(8000) }).then((r) => r.json()),
+      fetch(`${API_BASE}/api/argent/v1/tenants/${encodeURIComponent(TENANT)}/billing/summary`, { headers: h, signal: AbortSignal.timeout(8000) }).then((r) => r.json()),
+    ])
+    const d = (bill && bill.data) || {}
+    const bal = d.balance || {}
+    const spent = d.spent || {}
+    return {
+      ok: true, source, tenant: TENANT,
+      walletMode: Boolean(d.walletMode),
+      user: (me && me.data && me.data.user) || null,
+      plan: (d.plan && d.plan.label) || ((me && me.data && me.data.user && me.data.user.plan) || ''),
+      points: bal.points ?? null,
+      spentPoints: spent.points ?? null,
+      spentYuan: spent.yuan ?? null,
+      calls: spent.calls ?? null,
+      period: d.period || null,
+    }
+  } catch (e) {
+    return { ok: false, code: 'network', message: String(e.message || e).slice(0, 120) }
+  }
+}
+
+export const name = 'argent'
+export const inject = ['webServer']
+
+/** 问述代理默认配置（宿主 settings 未覆盖时生效）。 */
+const WHYS_CFG = {
+  apiKeyEnv: 'WHYSHU_API_KEY',
+  baseURL: 'https://whyshu.com/api/argent/v1',
+  models: [
+    // dsh 的 catalogModelInfo 默认只给 ["text"] ⇒ 必须显式声明 image，否则 read_image 直接 UNSUPPORTED_CONTENT
+    { id: 'deepseek-flash', name: 'DeepSeek V4.1 Flash（问述代理）', contextWindow: 131072, maxTokens: 32768, inputModalities: ['text', 'image'] },
+    { id: 'deepseek-v4-pro', name: 'DeepSeek V4 Pro（问述代理）', contextWindow: 131072, maxTokens: 32768, inputModalities: ['text', 'image'] },
+  ],
+}
+
+const json = (res, code, body) => {
+  res.writeHead(code, { 'Content-Type': 'application/json; charset=utf-8', 'Cache-Control': 'no-store' })
+  res.end(JSON.stringify(body))
+}
+
+export function apply(ctx) {
+  // ⚠️ apply 必须**同步返回**（cordis 不认 async apply ⇒ 会判 entry 未激活 ⇒ 启动恢复可能重置 profile）。
+  let dataDir = process.env.ARGENT_DATA_DIR || join(homedir(), '.dsh', 'argent')
+  let engineDir = process.env.ARGENT_ENGINE_DIR || ''
+  let role = 'ui'
+  let holder = null
+
+  // ① 问述 provider（异步块：宿主没有 dsh-llm* 时只告警，不阻塞 apply）
+  void (async () => {
+    try {
+      const { load } = await import('./llm-whyshu.mjs')
+      ctx.plugin(await load(), WHYS_CFG)
+      console.log('[argent] 问述代理 provider 已注册（whyshu）')
+    } catch (e) {
+      console.error('[argent] 问述 provider 注册失败（不影响其它功能）:', e?.message || e)
+    }
+  })()
+
+  // ② 一键登录端点（设备码；含 refresh_token 槽位）
+  try { registerWhyshuAuth(ctx) } catch (e) {
+    console.error('[argent] 登录端点注册失败:', e?.message || e)
+  }
+
+  // ②.5 机器任务会话登记（计费互斥甲）：监听 session/title 命中「后台派发：」⇒ 登记 sessionId
+  try {
+    installMachineSessionReporter(ctx, { dataDir })
+  } catch (e) {
+    console.error('[argent] 机器任务会话登记安装失败（不影响其它功能）:', e?.message || e)
+  }
+
+  // ③ 账号面板端点（poller/ui 都注册：积分显示与轮询无关）
+  try {
+    ctx.webServer.register({
+      kind: 'prefix',
+      path: '/api/argent/account',
+      handler: async (req, res) => {
+        if ((req.method || 'GET') !== 'GET') return json(res, 405, { ok: false, error: 'method_not_allowed' })
+        const u = new URL(req.url || '/', 'http://localhost')
+        if (u.pathname !== '/api/argent/account') return json(res, 404, { ok: false, error: 'not_found' })
+        return json(res, 200, await fetchAccount())
+      },
+    })
+  } catch (e) {
+    console.error('[argent] 账号端点注册失败:', e?.message || e)
+  }
+
+  // ④ 健康/状态端点（单插件排障入口；poller/ui 都有）
+  try {
+    ctx.webServer.register({
+      kind: 'prefix',
+      path: '/api/argent/health',
+      handler: async (req, res) => {
+        if ((req.method || 'GET') !== 'GET') return json(res, 405, { ok: false, error: 'method_not_allowed' })
+        const u = new URL(req.url || '/', 'http://localhost')
+        if (u.pathname !== '/api/argent/health') return json(res, 404, { ok: false, error: 'not_found' })
+        return json(res, 200, {
+          ok: true, plugin: '@whyshu/argent', version: PKG_VERSION,
+          role, holder: holder || leaseHolder({ dataDir }),
+        })
+      },
+    })
+  } catch (e) {
+    console.error('[argent] 健康端点注册失败:', e?.message || e)
+  }
+
+  // ⑤ 内核解析 → 租约 → MCP 网关 → ERP 连接器（全部在异步块里，串行避免 dataDir 竞态）
+  void (async () => {
+    try {
+      const k = await resolveKernel().catch(() => null)
+      if (k?.mod?.resolveDataDir) {
+        const resolved = k.mod.resolveDataDir({ env: process.env }).dir
+        if (resolved) dataDir = resolved
+      }
+      if (!engineDir && k && k.dir) engineDir = k.dir
+    } catch { /* 内核不可用 ⇒ 用默认目录 */ }
+    engineDir = detectEngineDir(dataDir, engineDir)
+
+    try {
+      const r = acquireLease({ dataDir, host: 'web|desktop' })
+      role = r.role
+      holder = r.holder
+      if (role === 'poller') {
+        const t = setInterval(() => { try { heartbeatLease({ dataDir }) } catch { /* noop */ } }, HEARTBEAT_MS)
+        t.unref?.()
+        ctx.on?.('dispose', () => { clearInterval(t); try { releaseLease({ dataDir }) } catch { /* noop */ } })
+      }
+      console.log(`[argent] ERP 轮询角色：${role}${role === 'ui' ? `（已由 pid ${holder && holder.pid}@${(holder && holder.host) || '?'} 占用，本端只做 UI）` : ''}`)
+    } catch (e) {
+      console.error('[argent] 租约获取失败（降级 UI）:', e?.message || e)
+      role = 'ui'
+    }
+
+    // MCP 网关（engine.* / erp.* / ml.*）
+    try {
+      const mcpClient = await hostImport('@deepseek-ai/dsh-mcp-client')
+      await ctx.plugin(mcpClient, {
+        transport: 'stdio',
+        serverName: 'argent',
+        command: process.execPath,
+        args: [join(PKG_ROOT, 'mcp', 'gateway.mjs')],
+        cwd: PKG_ROOT,
+        env: {
+          ARGENT_DATA_DIR: dataDir,
+          ARGENT_TENANT: TENANT,
+          ARGENT_ENGINE_DIR: engineDir,
+          ARGENT_GATEWAY_ML: process.env.ARGENT_GATEWAY_ML || '',
+        },
+        toolCallTimeoutMs: 180000,
+        failOnStartupError: false,
+      })
+      console.log(`[argent] MCP 网关已注册（engineDir=${engineDir || '(无引擎)'}）`)
+    } catch (e) {
+      console.error('[argent] MCP 网关注册失败（其余功能不受影响）:', e?.message || e)
+    }
+
+    // ERP 连接器：只有 poller 才启动（UI 端不抢队列）
+    if (role === 'poller') {
+      try {
+        startOfficeRuntime(ctx, { dataDir })
+        console.log(`[argent] ERP 连接器已启动，数据目录: ${dataDir}`)
+      } catch (e) {
+        console.error('[argent] ERP 连接器启动失败（不影响 dsh）:', e?.message || e)
+      }
+    }
+  })()
+}

package/src/kernel.mjs

@@ -0,0 +1,111 @@
+/**
+ * kernel.mjs —— 宿主壳定位引擎的**唯一入口**（方案 C · P1）
+ *
+ * 为什么单独成文件：`index.js` 会 import 宿主包（`@deepseek-ai/dsh-llm*`），
+ * 在测试环境里加载不了；把"找引擎"这段逻辑抽出来，才能被真实单测覆盖。
+ *
+ * 优先级（⛔ 不要加第 4 条"再猜一个路径"）：
+ *   1) `ARGENT_ENGINE_DIR` —— probe / 排障显式指定
+ *   2) `<profile>/argent.json` —— 启动器 `buildProfile()` 写入的契约文件
+ *   3) 兼容期回退：旧候选路径（`console.warn` 点名 legacy；`ARGENT_LEGACY_KERNEL_LOOKUP=0` 可关）
+ *
+ * 契约存在但不匹配 / 指向的目录不可用 ⇒ 返回 null 并打印可执行修复命令，
+ * **不回退 legacy**（否则会掩盖"装错了"）。
+ */
+import { readFileSync, statSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+import { pathToFileURL } from 'node:url'
+
+/** 本壳要求的引擎契约版本（与 core/lib/contract.mjs 的 CONTRACT 对应） */
+export const REQUIRED_CONTRACT = 1
+
+/** 从 argv 里找 `<...>/profiles/<name>`（桌面 host 把 profile 目录作为参数传给 app） */
+export function findProfileDir({ env = process.env, argv = process.argv } = {}) {
+  const cands = []
+  if (env.ARGENT_PROFILE_DIR) cands.push(env.ARGENT_PROFILE_DIR)
+  for (const a of argv) {
+    if (typeof a === 'string' && /[\\/]profiles[\\/][^\\/]+$/.test(a)) cands.push(a)
+  }
+  for (const d of cands) {
+    try { if (statSync(d).isDirectory()) return d } catch { /* 下一个 */ }
+  }
+  return ''
+}
+
+/** 找 `<profile>/argent.json`；找不到返回 '' */
+export function findContractFile(opts = {}) {
+  const dir = findProfileDir(opts)
+  if (!dir) return ''
+  try { return statSync(join(dir, 'argent.json')).isFile() ? join(dir, 'argent.json') : '' } catch { return '' }
+}
+
+const loadDatadir = async (dir) => {
+  if (!dir) return null
+  try {
+    return await import(pathToFileURL(join(dir, 'core', 'lib', 'argent-datadir.mjs')).href)
+  } catch {
+    return null
+  }
+}
+
+/**
+ * @returns {Promise<{mod:any, dir:string, source:'env'|'contract'|'legacy'}|null>}
+ */
+export async function resolveKernel({ env = process.env, argv = process.argv, log = console } = {}) {
+  // ① 显式指定
+  const explicit = await loadDatadir(env.ARGENT_ENGINE_DIR)
+  if (explicit) return { mod: explicit, dir: env.ARGENT_ENGINE_DIR, source: 'env' }
+
+  // ② 契约文件
+  const file = findContractFile({ env, argv })
+  if (file) {
+    let contract = null
+    try { contract = JSON.parse(readFileSync(file, 'utf8')) } catch { /* 坏文件当没有 */ }
+    if (contract) {
+      if (contract.contract !== REQUIRED_CONTRACT) {
+        log.error(`[argent] 引擎契约不符：本插件要求 ${REQUIRED_CONTRACT}，`
+          + `${file} 写的是 ${contract.contract} ⇒ ERP 连接器停用（fail-closed）。`)
+        log.error('[argent] 修复：在 DSH 插件面板卸载并重装 @whyshu/argent（或联系管理员更新 profile）')
+        return null
+      }
+      const mod = await loadDatadir(contract.engineDir)
+      if (mod) return { mod, dir: contract.engineDir, source: 'contract' }
+      log.error(`[argent] argent.json 指向的 engineDir 不可用：${contract.engineDir || '(空)'} ⇒ ERP 连接器停用。`)
+      log.error('[argent] 修复：在 DSH 插件面板重装 @whyshu/argent（会重写 argent.json），或让管理员运行 dsh plugin 安装')
+      return null
+    }
+  }
+
+  // ③ 兼容期回退
+  if (env.ARGENT_LEGACY_KERNEL_LOOKUP === '0') return null
+  const legacy = [new URL('../../../core/lib/argent-datadir.mjs', import.meta.url).href]
+  for (const root of [env.ARGENT_DSH_REPO, env.ARGENT_DISH_HOME, join(homedir(), '.argent-dsh'), join(homedir(), 'Code', 'argent-dsh')]) {
+    if (root) legacy.push(pathToFileURL(join(root, 'core', 'lib', 'argent-datadir.mjs')).href)
+  }
+  for (const u of legacy) {
+    try {
+      const mod = await import(u)
+      log.warn(`[argent] 未找到 argent.json，回退 legacy 路径（契约未生效）：${u}`)
+      return { mod, dir: '', source: 'legacy' }
+    } catch { /* 下一个候选 */ }
+  }
+  return null
+}
+
+/**
+ * 引擎目录（同步版，供仍走 spawn 的执行路径用）：
+ *   `ARGENT_ENGINE_DIR` → `<profile>/argent.json#engineDir`。
+ * ⛔ 不再"猜候选路径"——拿不到就返回 ''，由调用方明确报错。
+ */
+export function engineDirSync(opts = {}) {
+  if (opts.env?.ARGENT_ENGINE_DIR || process.env.ARGENT_ENGINE_DIR) return (opts.env || process.env).ARGENT_ENGINE_DIR
+  const file = findContractFile(opts)
+  if (!file) return ''
+  try {
+    const c = JSON.parse(readFileSync(file, 'utf8'))
+    return c.contract === REQUIRED_CONTRACT && c.engineDir ? c.engineDir : ''
+  } catch {
+    return ''
+  }
+}

package/src/lease.mjs

@@ -0,0 +1,90 @@
+/**
+ * lease.mjs —— ERP 轮询"先到先得"租约（2026-11-05）
+ *
+ * 问题：桌面端与 web 端是**两个 dsh 宿主**，都能跑 office-runtime（ERP 机器轮询）。
+ * 同一台机器同时跑 = 两个 poller 抢同一队列（重复回执；将来写路径会重复扣费）。
+ *
+ * 规则（用户拍板）：**谁先启动谁持有，后启动的自动降级为纯 UI**，不打断在用的一方。
+ *   · 租约文件 `<dataDir>/office-runtime.lease.json`：{pid, host, startedAt, heartbeatAt}
+ *   · 持有者每 30s 心跳；超过 TTL（默认 90s）没心跳 = 已死 ⇒ 后来者可接管
+ *   · 释放（正常退出）立即让位
+ *   · 判定"同一持有者"看 pid：同 pid 重复 acquire 幂等（热重载/重复调用安全）
+ *
+ * ⛔ 不做网络/分布式锁：同一台机器用文件 + pid 足够；跨机器本就该不同 machineId。
+ */
+import { existsSync, mkdirSync, openSync, readFileSync, renameSync, unlinkSync, writeFileSync, closeSync, chmodSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+
+export const DEFAULT_TTL_MS = 90_000
+
+const fileOf = (dataDir) => join(dataDir, 'office-runtime.lease.json')
+
+function readLease(file) {
+  try { return JSON.parse(readFileSync(file, 'utf8')) } catch { return null }
+}
+
+function writeLease(file, lease) {
+  mkdirSync(dirname(file), { recursive: true })
+  const tmp = `${file}.tmp.${process.pid}`
+  writeFileSync(tmp, JSON.stringify(lease) + '\n')
+  renameSync(tmp, file)                                  // 原子替换，避免读到半截 JSON
+  try { chmodSync(file, 0o644) } catch { /* noop */ }
+}
+
+function pidAlive(pid) {
+  if (!pid) return false
+  try { process.kill(pid, 0); return true } catch { return false }
+}
+
+/**
+ * 申请租约。
+ * @returns {{role:'poller'|'ui', holder?:{pid:number,host:string,startedAt:string,heartbeatAt:string}}}
+ */
+export function acquireLease({ dataDir, host = 'unknown', pid = process.pid, now = Date.now(), ttlMs = DEFAULT_TTL_MS, alive = pidAlive } = {}) {
+  const file = fileOf(dataDir)
+  const cur = existsSync(file) ? readLease(file) : null
+
+  if (cur) {
+    const fresh = now - Date.parse(cur.heartbeatAt || 0) < ttlMs
+    const mine = Number(cur.pid) === Number(pid)
+    const holderAlive = alive(Number(cur.pid))
+    if (fresh && holderAlive && !mine) return { role: 'ui', holder: cur }   // 别人在跑 ⇒ 降级 UI
+    // 同 pid（热重载）或已死/超时 ⇒ 接管
+  }
+
+  const lease = {
+    pid: Number(pid), host,
+    startedAt: cur && Number(cur.pid) === Number(pid) ? cur.startedAt : new Date(now).toISOString(),
+    heartbeatAt: new Date(now).toISOString(),
+  }
+  writeLease(file, lease)
+  return { role: 'poller', holder: lease }
+}
+
+/** 心跳（只有持有者需要调；非持有者调用不会抢） */
+export function heartbeatLease({ dataDir, pid = process.pid, now = Date.now() } = {}) {
+  const file = fileOf(dataDir)
+  const cur = readLease(file)
+  if (!cur || Number(cur.pid) !== Number(pid)) return false
+  writeLease(file, { ...cur, heartbeatAt: new Date(now).toISOString() })
+  return true
+}
+
+/** 释放（正常退出时调；非持有者调用无副作用） */
+export function releaseLease({ dataDir, pid = process.pid } = {}) {
+  const file = fileOf(dataDir)
+  const cur = readLease(file)
+  if (!cur || Number(cur.pid) !== Number(pid)) return false
+  try { unlinkSync(file) } catch { /* noop */ }
+  return true
+}
+
+/** 当前持有者（只读，给状态页/日志用） */
+export function leaseHolder({ dataDir, alive = pidAlive } = {}) {
+  const file = fileOf(dataDir)
+  if (!existsSync(file)) return null
+  const cur = readLease(file)
+  if (!cur) return null
+  const fresh = Date.now() - Date.parse(cur.heartbeatAt || 0) < DEFAULT_TTL_MS
+  return { ...cur, fresh, alive: alive(Number(cur.pid)) }
+}

package/src/llm-whyshu.mjs

@@ -0,0 +1,155 @@
+/**
+ * argent/llm-whyshu —— **问述代理 provider**（Argent 0.3，2026-09-30）
+ *
+ * ## 为什么放在 argent 里（而不是独立包）
+ * 桌宠只保留一个 L2 bundle；provider 作为可选子模块由 host 插件的 apply 里
+ * `ctx.plugin(llmWhyshu, config)` 加载 ⇒ 不新增 profile 层。未登录时也能在模型选择器看到
+ * 「问述代理」，调用时才要求 credentials 里的 `WHYSHU_API_KEY`；登录后无需重启即可生效。
+ *
+ * ## 为什么需要它（用户纠正的设计）
+ * 此前 `provider-switch.sh` 直接把 `llm-deepseek` 的 `baseURL` 改写成 `https://whyshu.com/api/argent/v1`
+ * ⇒ **劫持了官方直连 provider**：「官方直连」不再是真正的官方，用户无法在两者间自由选择。
+ * 正确形态：**官方 `deepseek-official` 保持原样**，问述代理作为**独立 provider（id=`whyshu`）**并存，
+ * 用户在模型/Provider 选择处自行挑选。
+ *
+ * ## 实现方式：复用官方代码路径，只换 provider id
+ * 官方 `dsh-llm-deepseek-api-key` 把 `PROVIDER` 写死为 `deepseek-official`（双实例会撞 id），
+ * 因此本插件照抄它的 apply（同样的鉴权解析、配置 schema、模型目录），仅把 provider 换成 `whyshu`，
+ * 显示名换成「问述代理」。**不复制任何协议/请求逻辑** —— 全部复用官方导出。
+ *
+ * 配置（settings.yaml 顶层，键 = 本实例 id）：
+ *   llm-whyshu:
+ *     baseURL: https://whyshu.com/api/argent/v1
+ *     apiKeyEnv: WHYSHU_API_KEY
+ *     models: [...]
+ */
+import { createRequire } from 'node:module'
+import { existsSync, readFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+import { pathToFileURL } from 'node:url'
+
+/**
+ * 宿主模块解析（2026-11-05）：
+ * 插件被软链到 profile 时，bare import `@deepseek-ai/*` 会从**仓库路径**解析 ⇒ 找不到
+ * （实测 ERR_MODULE_NOT_FOUND）。dsh 宿主内可能自带解析，但我们不能赌：
+ * 先试 bare，再依次用 profile 的 package.json 作基准 createRequire 解析。
+ */
+const HOST_MODULES = [
+  '@deepseek-ai/dsh-llm',
+  '@deepseek-ai/dsh-llm-deepseek',
+  '@deepseek-ai/dsh-llm-deepseek-api-key',
+  '@deepseek-ai/dsh-launch-environment',
+]
+
+function resolveBases() {
+  const home = process.env.DSH_HOME || join(homedir(), '.dsh')
+  return ['web', 'desktop', 'headless'].map((p) => pathToFileURL(join(home, 'profiles', p, 'package.json')).href)
+}
+
+async function hostImport(name) {
+  let firstErr = null
+  try { return await import(name) } catch (e) { firstErr = e }
+  for (const base of resolveBases()) {
+    try {
+      const req = createRequire(base)
+      return await import(pathToFileURL(req.resolve(name)).href)
+    } catch { /* 下一个基准 */ }
+  }
+  throw firstErr || new Error(`host module not found: ${name}`)
+}
+
+const name = 'argent-llm-whyshu'
+const inject = ['llm']
+/** 独立 provider id —— 与官方 `deepseek-official` 并存，用户在模型选择处可见「问述代理」。 */
+const PROVIDER = 'whyshu'
+const DISPLAY_NAME = '问述代理（Argent）'
+
+/**
+ * 机器任务标记（2026-11-06，计费互斥甲）：
+ * 客户机以「任务执行器」身份跑 dsh 时（profile/env 设 ARGENT_MACHINE_TASK=1），
+ * 代理请求带 x-argent-source=machine-task + x-argent-machine-id，服务端据此只记成本审计（0 积分），
+ * 不按 token 二次扣费（结果计费已按 SKU 收费）。
+ */
+const MACHINE_ID_CACHE = new Map() // dataDir -> { at, id }
+function readMachineIdFromAgentReport(env = process.env) {
+  try {
+    const dataDir = env.ARGENT_DATA_DIR || join(homedir(), '.dsh', 'argent')
+    const now = Date.now()
+    const hit = MACHINE_ID_CACHE.get(dataDir)
+    if (hit && now - hit.at < 60_000) return hit.id
+    const file = join(dataDir, 'agent-report.json')
+    if (!existsSync(file)) return ''
+    const raw = JSON.parse(readFileSync(file, 'utf8'))
+    const id = String(raw && raw.machineId || '').trim()
+    MACHINE_ID_CACHE.set(dataDir, { at: now, id })
+    return id
+  } catch {
+    return ''
+  }
+}
+
+/** 任务执行器进程才带标记；人工使用（ARGENT_MACHINE_TASK 未设）不带 ⇒ 正常按 token 扣企业钱包 */
+export function machineTaskHeaders(env = process.env) {
+  if (String(env.ARGENT_MACHINE_TASK || '') !== '1') return {}
+  const machineId = String(env.ARGENT_MACHINE_ID || '').trim() || readMachineIdFromAgentReport(env)
+  if (!machineId) return {}
+  return { 'x-argent-source': 'machine-task', 'x-argent-machine-id': machineId }
+}
+
+function makeApply({ LlmError, assertUsableApiKey, catalogModelInfo, registerDeepSeekProvider, plainOptions, resolveAdapterOptions, launchEnvironmentOf }) {
+  return function apply(ctx, config) {
+  const options = () => resolveAdapterOptions(plainOptions(config), launchEnvironmentOf(ctx))
+  options()
+
+  const resolveApiKey = async (connection) => {
+    const ref = connection.apiKeyEnv
+    const credentials = ctx.get('credentials')
+    if (credentials !== undefined) {
+      const hit = await credentials.resolve(ref)
+      if (hit !== undefined) return assertUsableApiKey(hit.value, 'whyshu', ref)
+    } else {
+      const ambient = launchEnvironmentOf(ctx).get(ref)
+      if (ambient !== undefined && ambient.value.length > 0) return assertUsableApiKey(ambient.value, 'whyshu', ref)
+    }
+    throw new LlmError(
+      `whyshu: no API key for provider route "${PROVIDER}"; store ${ref} through the credentials service`,
+    )
+  }
+
+  ctx.llm.registerConfigurableProviders([{
+    provider: PROVIDER,
+    displayName: DISPLAY_NAME,
+    settingsNs: ctx.fiber.entry?.options.id ?? name,
+    settingsPath: [],
+  }])
+
+  registerDeepSeekProvider(ctx, PROVIDER, {
+    options,
+    providerName: DISPLAY_NAME,
+    resolveAuth: async (connection) => ({
+      headers: { 'x-api-key': await resolveApiKey(connection), ...machineTaskHeaders() },
+    }),
+    discoverModels: (provider) => {
+      const connection = options()
+      return Promise.resolve(connection.models.map((model) => catalogModelInfo(provider, model)))
+    },
+  })
+  }
+}
+
+/**
+ * 懒加载入口：解析宿主模块后返回可 `ctx.plugin()` 的模块对象。
+ * ⛔ 顶层不做任何宿主 import —— 缺依赖时只让 provider 缺席，不影响 dsh 启动。
+ */
+export async function load() {
+  const [llm, ds, api, launch] = await Promise.all(HOST_MODULES.map(hostImport))
+  const { LlmError, assertUsableApiKey } = llm
+  const { catalogModelInfo, registerDeepSeekProvider } = ds
+  const { Config, plainOptions, resolveAdapterOptions } = api
+  const { launchEnvironmentOf } = launch
+  const apply = makeApply({ LlmError, assertUsableApiKey, catalogModelInfo, registerDeepSeekProvider, plainOptions, resolveAdapterOptions, launchEnvironmentOf })
+  return { name, inject, apply, Config }
+}
+
+export { inject, name }