DeepSeek Harness 插件 failed to import 真凶：process/ 拿到 null

TypeError: createRequire.resolve.paths is not a function or its return value is not iterable
    at ResolutionRouter.routeScoped (…/@deepseek-ai/dsh-app-boot/lib/index.js:1422:58)

dsh: warning: 1 entry did not activate
whale_craft (whale_craft): failed to import

// profile/node_modules/<probe>/index.js
import { appendFileSync } from 'node:fs'

const OUT = '<某处>/probe-result.txt'
const log = (s) => { try { appendFileSync(OUT, s + '\n') } catch {} }

for (const spec of [
  '@deepseek-ai/schemastery',
  '@deepseek-ai/dsh-tools',
  '@deepseek-ai/dsh-llm',
  'mineflayer',
  'whale_craft',
]) {
  try {
    await import(spec)
    log(`OK   ${spec}`)
  } catch (error) {
    log(`FAIL ${spec}`)
    log(String((error && (error.stack || error.message)) || error))
  }
}

export const name = 'probe'
export function apply() {}

const { createRequire } = require('node:module')
const req = createRequire('C:/any/dir/parent.js')

console.log(req.resolve.paths('process'))    // null        ← 内置名
console.log(req.resolve.paths('process/'))   // 18 条搜索链  ← 加斜杠就绕开内置判定
console.log(req.resolve('process/'))         // …/node_modules/process/index.js

for (const searchPath of createRequire(parent).resolve.paths(name)) {   // ← 崩在这

readable-stream@4.7.0  lib/internal/streams/end-of-stream.js:8
    const process = require('process/')      ← 尾斜杠；该包 dependencies 里确实有 process
        │
        ├─ isBuiltin('process/') === false   → 不被当内置模块拦下，正常进入解析路由
        │
        └─ barePackageName('process/') === 'process'   → 剥成裸包名
                │
                └─ resolve.paths('process') === null   → 命中「核心模块」分支
                        │
                        └─ for (… of null)  → TypeError

TypeError: createRequire.resolve.paths is not a function or its return value is not iterable

// 只加 ?? [] 之后
Error: Cannot find module 'process/'

const paths = resolve.paths(name) ?? resolve.paths(name + "/")

const paths = resolve.paths(name) ?? Module._nodeModulePaths(dirname(parent))

/**
 * 守卫 require.resolve.paths 的两种失败：
 *   1) 函数不存在 → 返回 fallback
 *   2) 返回 null（核心模块名）→ 加斜杠重试绕开内置判定
 * 注意：不能只 `?? []`，否则同一条 require 会前进成 Cannot find module。
 * 参照 jestjs/jest#16052 的守卫写法。
 */
function dshResolvePaths(req, name) {
  try {
    const resolvePaths = req && req.resolve && req.resolve.paths
    if (typeof resolvePaths === 'function') {
      const value = resolvePaths.call(req.resolve, name)
      if (Array.isArray(value)) return value
      const retry = resolvePaths.call(req.resolve, name + '/')   // ← 绕开内置判定
      if (Array.isArray(retry)) return retry
    }
  } catch {
    /* 拿不到就让调用方回退到原生解析 */
  }
  return []
}

// Node ≥22.15 / 24 稳定
import { registerHooks } from 'node:module'
registerHooks({ resolve(/* … */) { /* … */ } })

#!/usr/bin/env node
import { createRequire, _nodeModulePaths } from 'node:module'
import { dirname } from 'node:path'
import { fileURLToPath } from 'node:url'

const argv = process.argv.slice(2)
const parentArg = argv.indexOf('--parent')
const parent = parentArg >= 0 && argv[parentArg + 1] ? argv[parentArg + 1] : fileURLToPath(import.meta.url)

const req = createRequire(parent)
const line = (label, value) => console.log(`  ${label.padEnd(34)} → ${value}`)

console.log('① 关键数据（这就是根因）')
for (const name of ['process', 'process/', 'fs', 'fs/']) {
  const value = req.resolve.paths(name)
  line(`resolve.paths(${JSON.stringify(name)})`,
    Array.isArray(value) ? `${value.length} 条搜索链` : String(value))
}

console.log('\n② 原生解析本身是好的（说明不是依赖缺失）')
try { line("resolve('process/')", req.resolve('process/')) }
catch (error) { line("resolve('process/')", `${error.code ?? error.name}: 本机没装 process 包（不影响结论）`) }

console.log('\n③ 复刻 DSH 的写法：把请求剥成裸包名后直接 for...of')
const bare = 'process'   // barePackageName('process/')
try {
  for (const searchPath of req.resolve.paths(bare)) void searchPath
  console.log('  …没崩（本机环境与报告环境不同）')
} catch (error) {
  line('for (… of resolve.paths(bare))', `${error.constructor.name}: ${error.message}`)
}

console.log('\n④ 两种建议修法（都能拿到可迭代的搜索链）')
const fixedA = req.resolve.paths(bare) ?? req.resolve.paths(`${bare}/`)
line('A. paths ?? resolve.paths(name + "/")', Array.isArray(fixedA) ? `${fixedA.length} 条搜索链 ✅` : String(fixedA))
const fixedB = req.resolve.paths(bare) ?? _nodeModulePaths(dirname(parent))
line('B. paths ?? _nodeModulePaths(dirname)', Array.isArray(fixedB) ? `${fixedB.length} 条搜索链 ✅` : String(fixedB))

console.log('\n⑤ 反例：只加 `?? []` 是不够的')
const empty = req.resolve.paths(bare) ?? []
line('paths ?? [] 得到的搜索链长度', `${empty.length}  ← 搜索链为空时，同一条 require 会变成 Cannot find module`)

node repro-resolve-paths.mjs --parent ".../node_modules/readable-stream/lib/internal/streams/end-of-stream.js"

① 关键数据（这就是根因）
  resolve.paths("process")           → null
  resolve.paths("process/")          → 18 条搜索链
  resolve.paths("fs")                → null
  resolve.paths("fs/")               → 18 条搜索链
③ 复刻 DSH 的写法：把请求剥成裸包名后直接 for...of
  for (… of resolve.paths(bare))     → TypeError: req.resolve.paths is not a function or its return value is not iterable
⑤ 反例：只加 `?? []` 是不够的
  paths ?? [] 得到的搜索链长度         → 0  ← 搜索链为空时，同一条 require 会变成 Cannot find module

{
  "name": "dsh-profile-web",
  "private": true,
  "dependencies": {
    "readable-stream": "4.7.0",
    "cjs-probe": "file:plugins/cjs-probe"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "cjs-probe"
      ]
    }
  }
}

{
  "name": "cjs-probe",
  "version": "0.0.1",
  "private": true,
  "type": "module",
  "main": "index.js",
  "dsh": { "bundle": { "patch": "./cordis.patch.yml" } }
}

# cordis.patch.yml
- insert:
    - id: cjs-probe
      name: cjs-probe

// index.js
import { appendFileSync } from 'node:fs'
import { createRequire } from 'node:module'

const OUT = '<某处>/minimal-result.txt'
const log = (s) => { try { appendFileSync(OUT, s + '\n') } catch {} }
log(`===== cjs-probe @ ${new Date().toISOString()} =====`)

const req = createRequire(import.meta.url)
try {
  const rs = req('readable-stream')
  log('OK   require("readable-stream") 成功  version=' + (rs && rs.Writable ? 'has Writable' : '?'))
} catch (e) {
  log('FAIL require("readable-stream")')
  log(String((e && (e.stack || e.message)) || e))
}

export const name = 'cjs-probe'
export function apply() {}

pnpm install --dir <home>/profiles/web --node-linker=hoisted      # store 指向你自己的
DSH_HOME=<home> node <dsh>/lib/bin.js --profile web --port 3399

TypeError: createRequire.resolve.paths is not a function or its return value is not iterable
    at ResolutionRouter.routeScoped (…/@deepseek-ai/dsh-app-boot/lib/index.js:1423:58)   # 0.1.7 是 1422