@perrylink/dsh-plugin-doctor 0.1.0

package/lib/framework.mjs

@@ -0,0 +1,71 @@
+// dsh-plugin-doctor 检测框架：零依赖，检查注册 / 运行 / 判定 / 渲染
+export class Doctor {
+  constructor() {
+    this.checks = []
+  }
+
+  add(group, name, fn, opts = {}) {
+    this.checks.push({ group, name, fn, opts })
+  }
+
+  async run(ctx, { groups } = {}) {
+    const results = []
+    for (const c of this.checks) {
+      if (groups && !groups.includes(c.group)) continue
+      let res
+      try {
+        res = await c.fn(ctx)
+        if (typeof res === 'string') res = { status: 'pass', message: res }
+        if (!res || typeof res !== 'object') res = { status: 'pass', message: String(res) }
+      } catch (err) {
+        res = { status: 'error', message: err && err.stack ? err.stack : String(err) }
+      }
+      res.group = c.group
+      res.name = c.name
+      res.critical = !!c.opts.critical
+      results.push(res)
+    }
+    return results
+  }
+}
+
+// 最坏状态排序：error/fail > warn > skip > pass
+export function verdict(results) {
+  let worst = 'pass'
+  for (const r of results) {
+    if (r.status === 'error' && worst !== 'error') worst = 'error'
+    else if (r.status === 'fail' && worst !== 'error') worst = 'fail'
+    else if (r.status === 'warn' && worst === 'pass') worst = 'warn'
+    else if (r.status === 'skip' && worst === 'pass') worst = 'skip'
+  }
+  const criticalFail = results.some((r) => r.critical && (r.status === 'fail' || r.status === 'error'))
+  return { worst, criticalFail, ok: worst === 'pass' }
+}
+
+const ICONS = { pass: '[PASS]', warn: '[WARN]', fail: '[FAIL]', error: '[ERROR]', skip: '[SKIP]' }
+
+export function render(results) {
+  const lines = []
+  let lastGroup = null
+  for (const r of results) {
+    if (r.group !== lastGroup) {
+      lines.push('', `== ${r.group} ==`)
+      lastGroup = r.group
+    }
+    const tag = r.critical ? ' [关键]' : ''
+    lines.push(`${ICONS[r.status] ?? '[?]'} ${r.name}${tag}`)
+    const msg = String(r.message ?? '').trim()
+    if (msg) {
+      for (const line of msg.split('\n')) lines.push(`    ${line}`)
+    }
+    if (r.evidence) lines.push(`    证据: ${r.evidence}`)
+  }
+  const v = verdict(results)
+  const counts = {}
+  for (const r of results) counts[r.status] = (counts[r.status] ?? 0) + 1
+  lines.push(
+    '',
+    `=== 汇总: ${Object.entries(counts).map(([k, n]) => `${k}=${n}`).join(' ')} | 总判定: ${v.worst.toUpperCase()}${v.criticalFail ? '（含关键项失败）' : ''} ===`,
+  )
+  return lines.join('\n')
+}

package/lib/util.mjs

@@ -0,0 +1,90 @@
+// 工具：临时 DSH_HOME 沙箱 + 子进程执行（输出落盘，规避管道捕获限制）
+import { spawnSync } from 'node:child_process'
+import {
+  mkdtempSync, mkdirSync, rmSync, openSync, closeSync, readFileSync, writeFileSync, existsSync, readdirSync,
+} from 'node:fs'
+import { tmpdir } from 'node:os'
+import path from 'node:path'
+
+// 沙箱目录一律建在 %TEMP%，绝不触碰真实 ~/.dsh（红线 3）
+export function makeSandbox(label) {
+  const root = mkdtempSync(path.join(tmpdir(), `dsh-doctor-${label}-`))
+  const home = path.join(root, 'home')
+  const logs = path.join(root, 'logs')
+  mkdirSync(home, { recursive: true })
+  mkdirSync(logs, { recursive: true })
+  return { root, home, logs }
+}
+
+export function cleanSandbox(sb) {
+  if (sb && sb.root) {
+    try { rmSync(sb.root, { recursive: true, force: true }) } catch {}
+  }
+}
+
+// 执行命令：stdout/stderr 分别写入日志文件（不建管道），返回退出码与全文
+export function runStep(label, cmd, args, { env = {}, timeout = 120_000, cwd, logDir, shell } = {}) {
+  const dir = logDir ?? process.cwd()
+  const outPath = path.join(dir, `${label}.out.log`)
+  const errPath = path.join(dir, `${label}.err.log`)
+  const fdOut = openSync(outPath, 'w')
+  const fdErr = openSync(errPath, 'w')
+  const res = spawnSync(cmd, args, {
+    cwd,
+    env: { ...process.env, ...env },
+    stdio: ['ignore', fdOut, fdErr],
+    timeout,
+    windowsHide: true,
+    // Windows 下解析 npm.cmd/pnpm.cmd 等 shim 需要 shell；直接调用 node.exe 等真实可执行文件时禁用
+    shell: shell ?? process.platform === 'win32',
+  })
+  closeSync(fdOut)
+  closeSync(fdErr)
+  const read = (p) => { try { return readFileSync(p, 'utf8') } catch { return '' } }
+  return {
+    code: res.status,
+    signal: res.signal,
+    spawnError: res.error ? String(res.error) : null,
+    out: read(outPath),
+    err: read(errPath),
+    outPath,
+    errPath,
+    ok: res.status === 0 && !res.error,
+  }
+}
+
+export function tail(text, n = 8) {
+  if (!text) return '(无输出)'
+  const lines = text.trim().split('\n')
+  return lines.slice(-n).join('\n')
+}
+
+export const pass = (message) => ({ status: 'pass', message })
+export const fail = (message) => ({ status: 'fail', message })
+export const warn = (message) => ({ status: 'warn', message })
+export const skip = (reason) => ({ status: 'skip', message: reason })
+
+export function readJson(p) {
+  return JSON.parse(readFileSync(p, 'utf8'))
+}
+
+export function exists(p) {
+  return existsSync(p)
+}
+
+export function writeJson(p, obj) {
+  writeFileSync(p, JSON.stringify(obj, null, 2) + '\n', 'utf8')
+}
+
+// 递归收集目录下匹配文件（跳过 node_modules/lib/dist 等构建产物）
+export function findFiles(dir, sub, re, out = []) {
+  const base = path.join(dir, sub)
+  if (!existsSync(base)) return out
+  for (const entry of readdirSync(base, { withFileTypes: true })) {
+    if (['node_modules', 'lib', 'dist', '.git'].includes(entry.name)) continue
+    const p = path.join(base, entry.name)
+    if (entry.isDirectory()) findFiles(dir, path.join(sub, entry.name), re, out)
+    else if (re.test(entry.name)) out.push(p)
+  }
+  return out
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@perrylink/dsh-plugin-doctor",
+  "version": "0.1.0",
+  "description": "Zero-dependency static + sandbox smoke detector for DeepSeek Harness (dsh) plugins: package-structure gates (R), cordis contract scans (K), keyless-headless sandbox smoke (D), and ecosystem-listing checks (CC).",
+  "type": "module",
+  "main": "doctor.mjs",
+  "bin": {
+    "dsh-plugin-doctor": "./doctor.mjs"
+  },
+  "files": [
+    "doctor.mjs",
+    "lib/",
+    "README.md",
+    "SURVEY.md"
+  ],
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "cordis",
+    "plugin",
+    "doctor",
+    "lint",
+    "smoke-test",
+    "verification"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PerryLink/dsh-plugin-doctor.git"
+  },
+  "scripts": {
+    "test": "node --check doctor.mjs && node --check lib/framework.mjs && node --check lib/util.mjs && node --check lib/checks-package.mjs && node --check lib/checks-cordis.mjs && node --check lib/checks-smoke.mjs && node --check lib/checks-collections.mjs"
+  }
+}