@perrylink/dsh-plugin-doctor 0.1.2 → 0.1.4

package/README.md

@@ -63,5 +63,11 @@ SURVEY.md                全渠道检测方法梳理 + 判据出处
 
 ## 状态
 
-WIP 工作夹（非 git 仓，同 `dsh-ticktick-handoff` 口径）。检测器本体零依赖、可独立运行；
-后续如需发布，可参照工作区发布流程另立仓库。
+正式仓库：GitHub `PerryLink/dsh-plugin-doctor`（MIT 外 Apache-2.0），npm `@perrylink/dsh-plugin-doctor`
+（latest=0.1.3，2026-09-07）。CI 用法：
+
+```powershell
+npx --yes @perrylink/dsh-plugin-doctor@0.1.3 --repo . --no-smoke --only "静态·包结构,静态·cordis 契约扫描"
+```
+
+35 个插件仓已内置 `.github/workflows/plugin-doctor.yml`（install→build→npx 静态 R/K 门禁）。

package/lib/checks-cordis.mjs

@@ -65,6 +65,8 @@ export function addChecks(doctor, ctx) {
     }
     const candidates = new Map()
     for (const { f, text } of all) {
+      // 局部类型参数（如 createState(ctx: { credentials: ... })，非 cordis Context）——跳过该文件
+      if (/ctx\s*:\s*\{/.test(text)) continue
       for (const m of text.matchAll(/ctx\.([A-Za-z_$][\w$]*)/g)) {
         const name = m[1]
         if (CTX_INTRINSIC.has(name) || injectList.has(name)) continue
@@ -100,8 +102,20 @@ export function addChecks(doctor, ctx) {
       for (let i = 0; i < lines.length; i++) {
         const line = lines[i]
         if (!/(setInterval|setTimeout|setImmediate|process\.on|addEventListener\()/.test(line)) continue
+        // 变量级清理检测：同文件存在 clearTimeout/clearInterval/unref/removeEventListener 对应清理 → 自清理，跳过
+        // （变量声明可能在上一行，如三元表达式换行的 `const timer = cond\n  ? setInterval(...)`）
+        let varMatch = line.match(/(?:const|let)\s+([A-Za-z_$][\w$]*)\s*=/)
+        if (!varMatch && i > 0) varMatch = lines[i - 1].match(/(?:const|let)\s+([A-Za-z_$][\w$]*)\s*=/)
+        const listenerCleaned = line.includes('addEventListener') && /removeEventListener\(/.test(text)
+        if (varMatch) {
+          const name = varMatch[1]
+          const timerCleaned = new RegExp(`clear(?:Timeout|Interval)\\(\\s*${name}\\b|${name}\\??\\.\\s*unref\\s*\\(`).test(text)
+          if (timerCleaned || listenerCleaned) continue
+        } else if (listenerCleaned) {
+          continue
+        }
         const before = lines.slice(Math.max(0, i - 3), i).join('\n')
-        if (!/ctx\.effect|ctx\.scope|ctx\.on\b/.test(before) && !/return\s*\(\)\s*=>/.test(before + line)) {
+        if (!/ctx\.effect|ctx\.on\b/.test(before) && !/return\s*\(\)\s*=>/.test(before + line)) {
           hits.push(`${short(f)}:${i + 1} ${line.trim()}`)
         }
       }

package/lib/checks-package.mjs

@@ -67,11 +67,13 @@ export function addChecks(doctor, ctx) {
     const p = path.resolve(repoPath, patch)
     if (!existsSync(p)) return fail(`patch 文件不存在: ${patch}`)
     const text = readFileSync(p, 'utf8')
+    // YAML 注释行剔除后再做启发式（示例配置注释里常出现 name: xxx）
+    const active = text.split(/\r?\n/).filter((l) => !/^\s*#/.test(l)).join('\n')
     const problems = []
-    if (!/-\s+insert\s*:/.test(text)) problems.push('未找到 "- insert:" 结构')
-    const ids = [...text.matchAll(/(?:^|\n)\s*-?\s*id:\s*["']?([^"'\s]+)/g)].map((m) => m[1])
+    if (!/-\s+insert\s*:/.test(active)) problems.push('未找到 "- insert:" 结构')
+    const ids = [...active.matchAll(/(?:^|\n)\s*-?\s*id:\s*["']?([^"'\s]+)/g)].map((m) => m[1])
     if (!ids.length) problems.push('未找到 id 行（行 id 必须存在，供上层整行替换定位）')
-    const names = [...text.matchAll(/(?:^|\n)\s*name:\s*["']?([^"'\s,]+)|[,\s]name:\s*["']?([^"'\s,]+)/g)]
+    const names = [...active.matchAll(/(?:^|\n)\s*name:\s*["']?([^"'\s,]+)|[,\s]name:\s*["']?([^"'\s,]+)/g)]
       .map((m) => m[1] ?? m[2]).filter(Boolean)
     const badNames = names.filter((n) => n !== pkgName && !n.startsWith(`${pkgName}/`))
     if (names.length && badNames.length) problems.push(`行 name 与包名不一致: ${[...new Set(badNames)].join(', ')}（name 必须经 profile node_modules 解析，应为包名）`)
@@ -121,7 +123,7 @@ export function addChecks(doctor, ctx) {
     const importsCordis = srcFiles.some((f) => { try { return /from\s+['"]@deepseek-ai\/cordis['"]|require\(['"]@deepseek-ai\/cordis['"]\)/.test(readFileSync(f, 'utf8')) } catch { return false } })
     if (!peer && !dep) {
       if (importsCordis) problems.push('源码 import @deepseek-ai/cordis 但未声明任何依赖')
-      else problems.push('未声明 @deepseek-ai/cordis（若源码不 import 可忽略）')
+      else return pass('未声明 @deepseek-ai/cordis 且源码无 import（纯 JS 仓可无 cordis 运行时依赖）')
     } else if (!peer) {
       problems.push('@deepseek-ai/cordis 只在 dependencies（官方口径：peerDependencies + devDependencies 同时声明）')
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@perrylink/dsh-plugin-doctor",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "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",