dsh-browser-playwright-codex 0.5.1

package/scripts/analysis/needs-human-probe.mjs

@@ -0,0 +1,83 @@
+/**
+ * Headless-mode capability probe, aimed at the three "needs a human" cases:
+ *
+ *  1. Does the window-state CDP call used by the minimize gate even work headless?
+ *     (If it throws, our gate returns "minimized" and silently disables the
+ *      login-state export in headless — i.e. session cookies would never be saved.)
+ *  2. Do page-level native dialogs (alert/confirm/prompt) park and answer headless?
+ *  3. Does a file input accept setInputFiles headless, i.e. no OS picker needed?
+ */
+import { createRequire } from 'node:module'
+import path from 'node:path'
+import fs from 'node:fs'
+import os from 'node:os'
+
+const require = createRequire(import.meta.url)
+const { chromium } = require(process.env.PW_CORE_PATH ?? 'playwright-core')
+
+const headless = (process.env.MODE ?? 'headless') === 'headless'
+const profile = fs.mkdtempSync(path.join(os.tmpdir(), 'pw-needsprobe-'))
+const context = await chromium.launchPersistentContext(profile, {
+  headless,
+  channel: process.env.CHANNEL || undefined,
+  ...(headless ? { viewport: { width: 1280, height: 800 } } : { viewport: null }),
+  ignoreDefaultArgs: ['--enable-automation'],
+  args: ['--no-first-run', '--no-default-browser-check', '--disable-blink-features=AutomationControlled'],
+})
+const page = context.pages()[0] ?? (await context.newPage())
+const out = { mode: headless ? 'headless' : 'headful' }
+
+// --- 1. the window-state probe the plugin's gate relies on -------------------
+try {
+  const s = await context.newCDPSession(page)
+  const { windowId } = await s.send('Browser.getWindowForTarget')
+  const { bounds } = await s.send('Browser.getWindowBounds', { windowId })
+  out.windowStateProbe = { ok: true, windowId, windowState: bounds.windowState, bounds }
+  out.gateWouldReturn = bounds.windowState === 'minimized'
+  await s.detach()
+} catch (e) {
+  out.windowStateProbe = { ok: false, error: String(e?.message ?? e).split('\n')[0] }
+  // The plugin's catch returns true == "treat as minimized".
+  out.gateWouldReturn = true
+}
+
+// --- 2. native dialog without a window --------------------------------------
+const dialogLog = []
+page.on('dialog', async (d) => {
+  dialogLog.push({ type: d.type(), message: d.message() })
+  await d.accept('typed-by-test').catch(async () => {
+    await d.dismiss().catch(() => {})
+  })
+})
+
+async function dialogRoundTrip() {
+  await page.setContent('<html><body><button id=b>go</button></body></html>')
+  const result = await page.evaluate(() => {
+    const answer = prompt('probe-prompt', 'default')
+    return 'prompt-returned:' + String(answer)
+  })
+  return result
+}
+try {
+  out.dialog = { evaluateResult: await dialogRoundTrip(), events: dialogLog }
+} catch (e) {
+  out.dialog = { error: String(e?.message ?? e).split('\n')[0], events: dialogLog }
+}
+
+// --- 3. file input without an OS picker ------------------------------------
+try {
+  const tmpFile = path.join(os.tmpdir(), 'pw-upload-probe.txt')
+  fs.writeFileSync(tmpFile, 'upload-probe')
+  await page.setContent('<html><body><input id=f type=file></body></html>')
+  await page.setInputFiles('#f', tmpFile)
+  out.fileInput = {
+    ok: true,
+    files: await page.evaluate(() => Array.from(document.querySelector('#f').files).map((f) => f.name)),
+  }
+} catch (e) {
+  out.fileInput = { ok: false, error: String(e?.message ?? e).split('\n')[0] }
+}
+
+console.log(JSON.stringify(out, null, 2))
+await context.close()
+fs.rmSync(profile, { recursive: true, force: true })

package/scripts/analysis/repro-minimize.mjs

@@ -0,0 +1,112 @@
+/**
+ * Minimal, plugin-free reproduction of "automation raises a minimized window".
+ *
+ * Two modes, matching the two ways dsh-browser-playwright can own a window:
+ *   PW_MODE=launch      -> chromium.launch() + browser.newContext()   (upstream 0.1.x default shape)
+ *   PW_MODE=persistent  -> chromium.launchPersistentContext()         (persistent-profile forks)
+ *
+ * The OS window state is read back through CDP (Browser.getWindowBounds) and the
+ * window is minimized through CDP too, so the verdict does not depend on anyone
+ * watching the screen.
+ *
+ * Usage (Windows, using an installed Chrome):
+ *   set PW_MODE=launch
+ *   set PW_CHANNEL=chrome
+ *   set PW_CORE_PATH=D:\path\to\node_modules\playwright-core
+ *   node repro-minimize.mjs
+ */
+import { createRequire } from 'node:module'
+import os from 'node:os'
+import path from 'node:path'
+import fs from 'node:fs'
+
+const require = createRequire(import.meta.url)
+const corePath = process.env.PW_CORE_PATH ?? 'playwright-core'
+const { chromium } = require(corePath)
+let coreVersion = 'unknown'
+try {
+  coreVersion = require(path.join(corePath, 'package.json')).version
+} catch {}
+
+const MODE = process.env.PW_MODE ?? 'launch'
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms))
+const launchOptions = {
+  headless: false,
+  channel: process.env.PW_CHANNEL || undefined, // e.g. 'chrome' to use the local Chrome
+  args: ['--no-first-run', '--no-default-browser-check'],
+}
+
+let browser
+let context
+let profile
+if (MODE === 'persistent') {
+  profile = fs.mkdtempSync(path.join(os.tmpdir(), 'pw-focus-repro-'))
+  context = await chromium.launchPersistentContext(profile, { ...launchOptions, viewport: null })
+} else {
+  browser = await chromium.launch(launchOptions)
+  context = await browser.newContext({ viewport: null })
+}
+
+const anchor = context.pages()[0] ?? (await context.newPage())
+// Real content matters: an empty about:blank window can behave differently.
+await anchor.goto('https://example.com', { waitUntil: 'domcontentloaded' }).catch(() => {})
+await sleep(500)
+
+const cdp = await context.newCDPSession(anchor)
+const windowId = async () => (await cdp.send('Browser.getWindowForTarget')).windowId
+const state = async () => (await cdp.send('Browser.getWindowBounds', { windowId: await windowId() })).bounds.windowState
+const setState = async (windowState) => {
+  const id = await windowId()
+  return cdp.send('Browser.setWindowBounds', { windowId: id, bounds: { windowState } })
+}
+
+const results = []
+async function probe(name, fn) {
+  await setState('normal')
+  await sleep(400)
+  await setState('minimized')
+  await sleep(900)
+  const before = await state()
+  let err = ''
+  try {
+    await fn()
+  } catch (e) {
+    err = ' [' + (e?.message ?? e) + ']'
+  }
+  await sleep(1400)
+  const after = await state()
+  const raised = before === 'minimized' && after !== 'minimized'
+  results.push({ name, before, after, raised })
+  console.log(`${raised ? 'RAISES  ' : 'safe    '} ${name.padEnd(46)} before=${before} after=${after}${err}`)
+}
+
+console.log(`mode=${MODE}  playwright-core ${coreVersion}  node ${process.version}`)
+console.log(`channel=${process.env.PW_CHANNEL || '(bundled chromium)'}\n`)
+
+await probe('baseline: sleep only (3s)', () => sleep(3000))
+await probe('context.newPage()', async () => {
+  const p = await context.newPage()
+  await p.goto('about:blank')
+  await p.close()
+})
+await probe('CDP Target.createTarget({background:true})', async () => {
+  await cdp.send('Target.createTarget', { url: 'about:blank', background: true })
+})
+await probe('page.bringToFront()', () => anchor.bringToFront())
+await probe('context.newCDPSession(anchor)', async () => {
+  const s = await context.newCDPSession(anchor)
+  await s.detach()
+})
+await probe('context.storageState()', () => context.storageState())
+await probe('anchor.goto() (same tab)', () =>
+  anchor.goto('https://example.com/?x=1', { waitUntil: 'domcontentloaded' }),
+)
+await probe('anchor.screenshot()', () => anchor.screenshot({ path: path.join(os.tmpdir(), 'pw-repro.png') }))
+
+console.log('\n--- summary ---')
+for (const r of results) console.log(`${r.raised ? 'RAISES' : 'safe  '}  ${r.name}`)
+
+await setState('normal').catch(() => {})
+await context.close().catch(() => {})
+await browser?.close().catch(() => {})
+if (profile) fs.rmSync(profile, { recursive: true, force: true })

package/scripts/autocommit.ps1

@@ -0,0 +1,23 @@
+# autocommit.ps1 —— 每日自动存档：有改动就提交一条带时间戳的 commit。
+#
+# 用法:
+#   powershell -ExecutionPolicy Bypass -File D:\dsh-plugins\dsh-browser-playwright-codex\scripts\autocommit.ps1
+#
+# 注册成每天 23:55 的计划任务（一次即可，用户级，不需要管理员）:
+#   schtasks /create /tn "dsh-browser-playwright autocommit" /sc daily /st 23:55 ^
+#     /tr "powershell -ExecutionPolicy Bypass -File D:\dsh-plugins\dsh-browser-playwright-codex\scripts\autocommit.ps1"
+#
+# 说明：这是"存档"，不是"分支管理"。它只提交，从不 push、reset 或丢弃改动，
+# 所以最坏情况也只是历史里多一条记录。
+$ErrorActionPreference = 'Stop'
+$repo = Split-Path -Parent $PSScriptRoot
+Set-Location $repo
+
+if (-not (Test-Path (Join-Path $repo '.git'))) { Write-Output "not a git repo: $repo"; exit 0 }
+
+$changes = git status --porcelain
+if (-not $changes) { Write-Output '没有改动，跳过'; exit 0 }
+
+git add -A
+git commit -q -m ("auto: " + (Get-Date -Format 'yyyy-MM-dd HH:mm'))
+Write-Output ("已存档: " + (Get-Date -Format 'yyyy-MM-dd HH:mm'))

package/scripts/check-doc-links.py

@@ -0,0 +1,112 @@
+"""校验仓库里所有 markdown 链接：文件路径要存在，锚点要能在目标文档里找到。
+
+为什么需要：
+ 1. 那几篇文档原来放在 GitHub 的 docs/ 下，链接写的是 ../xxx；搬进本仓库根目录后
+    ../ 就指到仓库外了。靠肉眼容易漏，脚本一跑就知道。
+ 2. 锚点也会坏：曾经有过 `[help wanted #2](README.md#help-wanted--求助)`，
+    而 README 里根本没有那一节 —— 文件在、锚点不在，照样是死链。
+
+跑法（无需依赖，Python 3.8+）：
+    python scripts/check-doc-links.py
+退出码 0 = 全部有效；1 = 有坏链（逐条列出，标明是文件缺失还是锚点缺失）。
+"""
+import os
+import re
+import sys
+
+# 以本文件位置为准：scripts/ 的上一级就是仓库根，换机器也不用改路径
+REPO = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+LINK = re.compile(r"\]\(([^)\s]+)\)")
+HEADING = re.compile(r"^#{1,6}\s+(.*?)\s*$")
+FENCE = re.compile(r"^\s*(```|~~~)")
+
+
+def slug(heading: str) -> str:
+    """GitHub 的标题锚点规则（近似实现）：小写；去掉非字母数字/连字符/下划线；
+    空格转连字符。中文是字母数字（str.isalnum() 为真）所以保留，与 GitHub 一致。"""
+    out = []
+    for ch in heading.strip().lower():
+        if ch.isalnum() or ch in "-_":
+            out.append(ch)
+        elif ch == " ":
+            out.append("-")
+    return "".join(out)
+
+
+def anchors_of(path: str) -> set:
+    """该文档所有标题的锚点。代码块内的 # 行不算标题。"""
+    found = set()
+    in_fence = False
+    with open(path, "r", encoding="utf-8", errors="replace") as f:
+        for line in f:
+            if FENCE.match(line):
+                in_fence = not in_fence
+                continue
+            if in_fence:
+                continue
+            m = HEADING.match(line)
+            if m:
+                found.add(slug(m.group(1)))
+    return found
+
+
+def main() -> int:
+    bad = []
+    checked_files = 0
+    checked_anchors = 0
+    anchor_cache = {}
+
+    for root, dirs, files in os.walk(REPO):
+        dirs[:] = [d for d in dirs if d not in (".git", "node_modules", "lib")]
+        for name in files:
+            if not name.endswith(".md"):
+                continue
+            path = os.path.join(root, name)
+            rel = os.path.relpath(path, REPO)
+            with open(path, "r", encoding="utf-8", errors="replace") as f:
+                text = f.read()
+
+            for target in LINK.findall(text):
+                if target.startswith(("http://", "https://", "mailto:")):
+                    continue
+                file_part, _, anchor = target.partition("#")
+                file_part = file_part.split("?", 1)[0]
+
+                if file_part == "":
+                    # 同文档锚点：指向"更靠下的小节标题"是常见写法，这里只校验它存在
+                    target_path = path
+                else:
+                    target_path = os.path.normpath(
+                        os.path.join(os.path.dirname(path), file_part.replace("/", os.sep))
+                    )
+                    checked_files += 1
+                    if not os.path.exists(target_path):
+                        bad.append((rel, target, "文件不存在: " + os.path.relpath(target_path, REPO)))
+                        continue
+
+                if anchor == "":
+                    continue
+                if not target_path.endswith(".md"):
+                    continue
+                checked_anchors += 1
+                if target_path not in anchor_cache:
+                    anchor_cache[target_path] = anchors_of(target_path)
+                if anchor not in anchor_cache[target_path]:
+                    bad.append(
+                        (
+                            rel,
+                            target,
+                            "锚点不存在: #" + anchor + "  (该文档有 "
+                            + str(len(anchor_cache[target_path]))
+                            + " 个标题锚点)",
+                        )
+                    )
+
+    print(f"检查了 {checked_files} 个文件链接、{checked_anchors} 个锚点，坏链 {len(bad)} 个")
+    for src, target, why in bad:
+        print(f"  BAD  {src}  ->  {target}   ({why})")
+    return 1 if bad else 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/scripts/doctor.mjs

@@ -0,0 +1,144 @@
+#!/usr/bin/env node
+/**
+ * doctor —— 一句话回答「DSH 又发版了，这个插件还能不能跑」。
+ *
+ * 逐个 import 这个插件依赖的 @deepseek-ai/* 包，检查源码真正用到的具名导出是否
+ * 还在，并打印每个包实际装的版本。类型层面的兼容性由 tsc 回答（npm run build）。
+ *
+ * 用法:  node scripts/doctor.mjs
+ * 退出码 0 = 全部可用；1 = 至少一个包需要处理。
+ *
+ * 出现 ❌ 时按这个顺序处理：
+ *   1. 只是导出改名 → 把引用搬进 src/compat.ts（那里是唯一的边界适配层）；
+ *   2. 是插件真用到的运行时 API 没了 → 适配代码，别去改 peer 范围；
+ *   3. 装错版本 → 在 profile 里对齐版本，而不是把本目录钉成旧版。
+ */
+import { readFileSync, readdirSync } from 'node:fs'
+import { createRequire } from 'node:module'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+/** 运行时真正 import 的名字；缺一个就是载荷失败。 */
+const REQUIRED = {
+  '@deepseek-ai/cordis': ['Service'],
+  '@deepseek-ai/schemastery': ['default'],
+  '@deepseek-ai/dsh-tools': ['default', 'defineTool'],
+  '@deepseek-ai/dsh-llm': ['BlockAssembler', 'createUserMessage'],
+  // The only runtime dependency that is not the harness: without it the whole
+  // browser entry fails to load, before any DSH API question even matters.
+  'playwright-core': ['chromium'],
+}
+
+/** 只有测试 / 开发路径用到的包；缺了只提醒，不算失败。 */
+const OPTIONAL = {
+  '@deepseek-ai/dsh-system-prompt': ['default'],
+  '@deepseek-ai/dsh-session': [],
+  '@deepseek-ai/dsh-attachment': [],
+  '@deepseek-ai/dsh-agent': [],
+}
+
+const require = createRequire(import.meta.url)
+
+/** Installed version of one package, or a marker when it is absent. */
+function versionOf(pkg) {
+  try {
+    return JSON.parse(readFileSync(require.resolve(pkg + '/package.json'), 'utf8')).version
+  } catch {
+    return '(未安装)'
+  }
+}
+
+/** Probe one package and return the missing export names. */
+async function probe(pkg, names) {
+  let mod
+  try {
+    mod = await import(pkg)
+  } catch (error) {
+    return { missing: names, module: undefined, fatal: String(error.message ?? error) }
+  }
+  return { missing: names.filter((name) => !(name in mod)), module: mod, fatal: undefined }
+}
+
+let failed = 0
+console.log('依赖体检（运行时导出）')
+console.log('')
+
+for (const [pkg, names] of Object.entries(REQUIRED)) {
+  const { missing, fatal } = await probe(pkg, names)
+  const version = versionOf(pkg)
+  if (fatal !== undefined) {
+    failed += 1
+    console.log('❌ ' + pkg + ' ' + version)
+    console.log('   导入失败: ' + fatal)
+    continue
+  }
+  if (missing.length > 0) {
+    failed += 1
+    console.log('❌ ' + pkg + ' ' + version + ' —— 缺少导出: ' + missing.join(', '))
+    console.log('   ' + (names.length > 0 ? '需要: ' + names.join(', ') : ''))
+    continue
+  }
+  console.log('✅ ' + pkg + ' ' + version + (names.length > 0 ? '  (' + names.join(', ') + ')' : ''))
+}
+
+console.log('')
+console.log('可选依赖（测试 / 开发路径）')
+for (const [pkg, names] of Object.entries(OPTIONAL)) {
+  const { missing, fatal } = await probe(pkg, names)
+  const version = versionOf(pkg)
+  if (fatal !== undefined || missing.length > 0) {
+    console.log(
+      '⚠️  ' + pkg + ' ' + version + (fatal !== undefined ? ' —— 导入失败' : ' —— 缺少: ' + missing.join(', ')),
+    )
+    continue
+  }
+  console.log('✅ ' + pkg + ' ' + version)
+}
+
+console.log('')
+console.log('部署侧解析（profile 用 junction 挂这个插件，运行时到底从哪里取 playwright-core）')
+const pluginDir = fileURLToPath(new URL('..', import.meta.url))
+const profilesRoot = join(homedir(), '.dsh', 'profiles')
+/** Resolve one package from one directory, the way Node would at load time. */
+function resolveFrom(pkg, dir) {
+  try {
+    const resolved = createRequire(join(dir, 'package.json')).resolve(pkg + '/package.json')
+    return { path: resolved, version: JSON.parse(readFileSync(resolved, 'utf8')).version }
+  } catch {
+    return undefined
+  }
+}
+const anchors = [{ label: '插件目录', dir: pluginDir }]
+try {
+  for (const name of readdirSync(profilesRoot)) {
+    if (name === 'node_modules') continue
+    anchors.push({ label: 'profile ' + name, dir: join(profilesRoot, name) })
+  }
+} catch {
+  console.log('ℹ️  没有 ' + profilesRoot + '：只检查插件自身')
+}
+let resolvedAnywhere = 0
+for (const { label, dir } of anchors) {
+  const found = resolveFrom('playwright-core', dir)
+  if (found === undefined) {
+    // Junction 挂载时 Node 按插件真实路径解析，profile 目录里没有这个包是正常的；
+    // 只有"哪里都解析不到"才是部署级失败（下面的 resolvedAnywhere 判定）。
+    console.log('ℹ️  ' + label + ' 本目录没有 playwright-core（junction 会落到插件真实路径）—— ' + dir)
+    continue
+  }
+  resolvedAnywhere += 1
+  console.log('✅ ' + label + ' → playwright-core ' + found.version + '  ' + found.path)
+}
+if (resolvedAnywhere === 0) {
+  failed += 1
+  console.log('❌ 没有任何位置能解析 playwright-core：部署侧 browser entry 会在加载期直接失败')
+}
+
+console.log('')
+if (failed === 0) {
+  console.log('全部可用。接着跑 `npm test` 与 `npm run verify` 确认行为没变。')
+  process.exit(0)
+}
+console.log(failed + ' 个包需要处理：优先把改名搬进 src/compat.ts，别去钉版本。')
+process.exit(1)