@miphamai/cli 0.48.0 → 0.50.0

package/skills/standard/web-access/scripts/check-deps.mjs

@@ -0,0 +1,187 @@
+#!/usr/bin/env node
+// 环境检查 + 确保 CDP Proxy 就绪（跨平台，替代 check-deps.sh）
+
+import { spawn } from 'node:child_process'
+import fs from 'node:fs'
+import net from 'node:net'
+import os from 'node:os'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+const PROXY_SCRIPT = path.join(ROOT, 'scripts', 'cdp-proxy.mjs')
+const PROXY_PORT = Number(process.env.CDP_PROXY_PORT || 3456)
+
+// --- Node.js 版本检查 ---
+
+function checkNode() {
+  const major = Number(process.versions.node.split('.')[0])
+  const version = `v${process.versions.node}`
+  if (major >= 22) {
+    console.log(`node: ok (${version})`)
+  } else {
+    console.log(`node: warn (${version}, 建议升级到 22+)`)
+  }
+}
+
+// --- TCP 端口探测 ---
+
+function checkPort(port, host = '127.0.0.1', timeoutMs = 2000) {
+  return new Promise((resolve) => {
+    const socket = net.createConnection(port, host)
+    const timer = setTimeout(() => {
+      socket.destroy()
+      resolve(false)
+    }, timeoutMs)
+    socket.once('connect', () => {
+      clearTimeout(timer)
+      socket.destroy()
+      resolve(true)
+    })
+    socket.once('error', () => {
+      clearTimeout(timer)
+      resolve(false)
+    })
+  })
+}
+
+// --- Chrome 调试端口检测（DevToolsActivePort 多路径 + 常见端口回退） ---
+
+function activePortFiles() {
+  const home = os.homedir()
+  const localAppData = process.env.LOCALAPPDATA || ''
+  switch (os.platform()) {
+    case 'darwin':
+      return [
+        path.join(home, 'Library/Application Support/Google/Chrome/DevToolsActivePort'),
+        path.join(home, 'Library/Application Support/Google/Chrome Canary/DevToolsActivePort'),
+        path.join(home, 'Library/Application Support/Chromium/DevToolsActivePort'),
+      ]
+    case 'linux':
+      return [
+        path.join(home, '.config/google-chrome/DevToolsActivePort'),
+        path.join(home, '.config/chromium/DevToolsActivePort'),
+      ]
+    case 'win32':
+      return [
+        path.join(localAppData, 'Google/Chrome/User Data/DevToolsActivePort'),
+        path.join(localAppData, 'Chromium/User Data/DevToolsActivePort'),
+      ]
+    default:
+      return []
+  }
+}
+
+async function detectChromePort() {
+  // 优先从 DevToolsActivePort 文件读取
+  for (const filePath of activePortFiles()) {
+    try {
+      const lines = fs.readFileSync(filePath, 'utf8').trim().split(/\r?\n/).filter(Boolean)
+      const port = parseInt(lines[0], 10)
+      if (port > 0 && port < 65536 && (await checkPort(port))) {
+        return port
+      }
+    } catch (_) {}
+  }
+  // 回退：探测常见端口
+  for (const port of [9222, 9229, 9333]) {
+    if (await checkPort(port)) {
+      return port
+    }
+  }
+  return null
+}
+
+// --- CDP Proxy 启动与等待 ---
+
+function httpGetJson(url, timeoutMs = 3000) {
+  return fetch(url, { signal: AbortSignal.timeout(timeoutMs) })
+    .then(async (res) => {
+      try {
+        return JSON.parse(await res.text())
+      } catch {
+        return null
+      }
+    })
+    .catch(() => null)
+}
+
+function startProxyDetached() {
+  const logFile = path.join(os.tmpdir(), 'cdp-proxy.log')
+  const logFd = fs.openSync(logFile, 'a')
+  const child = spawn(process.execPath, [PROXY_SCRIPT], {
+    detached: true,
+    stdio: ['ignore', logFd, logFd],
+    ...(os.platform() === 'win32' ? { windowsHide: true } : {}),
+  })
+  child.unref()
+  fs.closeSync(logFd)
+}
+
+async function ensureProxy() {
+  const targetsUrl = `http://127.0.0.1:${PROXY_PORT}/targets`
+
+  // /targets 返回 JSON 数组即 ready
+  const targets = await httpGetJson(targetsUrl)
+  if (Array.isArray(targets)) {
+    console.log('proxy: ready')
+    return true
+  }
+
+  // 未运行或未连接，启动并等待
+  console.log('proxy: connecting...')
+  startProxyDetached()
+
+  // 等 proxy 进程就绪
+  await new Promise((r) => setTimeout(r, 2000))
+
+  for (let i = 1; i <= 15; i++) {
+    const result = await httpGetJson(targetsUrl, 8000)
+    if (Array.isArray(result)) {
+      console.log('proxy: ready')
+      return true
+    }
+    if (i === 1) {
+      console.log('⚠️  Chrome 可能有授权弹窗，请点击「允许」后等待连接...')
+    }
+    await new Promise((r) => setTimeout(r, 1000))
+  }
+
+  console.log('❌ 连接超时，请检查 Chrome 调试设置')
+  console.log(`  日志：${path.join(os.tmpdir(), 'cdp-proxy.log')}`)
+  return false
+}
+
+// --- main ---
+
+async function main() {
+  checkNode()
+
+  const chromePort = await detectChromePort()
+  if (!chromePort) {
+    console.log(
+      'chrome: not connected — 请确保 Chrome 已打开，然后访问 chrome://inspect/#remote-debugging 并勾选 Allow remote debugging',
+    )
+    process.exit(1)
+  }
+  console.log(`chrome: ok (port ${chromePort})`)
+
+  const proxyOk = await ensureProxy()
+  if (!proxyOk) {
+    process.exit(1)
+  }
+
+  // 列出已有站点经验
+  const patternsDir = path.join(ROOT, 'references', 'site-patterns')
+  try {
+    const sites = fs
+      .readdirSync(patternsDir)
+      .filter((f) => f.endsWith('.md'))
+      .map((f) => f.replace(/\.md$/, ''))
+    if (sites.length) {
+      console.log(`\nsite-patterns: ${sites.join(', ')}`)
+    }
+  } catch {}
+}
+
+await main()

package/skills/standard/web-access/scripts/find-url.mjs

@@ -0,0 +1,271 @@
+#!/usr/bin/env node
+// find-url - 从本地 Chrome 书签/历史中检索 URL
+// 用于定位公网搜索覆盖不到的目标（组织内部系统、SSO 后台、内网域名等）。
+//
+// 用法：
+//   node find-url.mjs [关键词...] [--only bookmarks|history] [--limit N] [--since 1d|7h|YYYY-MM-DD]
+//
+//   <关键词>            空格分词、多词 AND，匹配 title + url；可省略
+//   --only <source>     限定数据源（bookmarks / history），默认两者都查
+//   --limit N           条数上限，默认 20；0 = 不限
+//   --since <window>    时间窗（仅作用于历史）。1d / 7h / 30m 或 YYYY-MM-DD
+//   --sort recent|visits  历史排序：按最近访问 / 按访问次数，默认 recent
+//
+// 示例：
+//   node find-url.mjs 财务小智
+//   node find-url.mjs agent skills
+//   node find-url.mjs github --since 7d --only history
+//   node find-url.mjs --since 7d --only history --sort visits   # 最近一周高频网站
+//   node find-url.mjs --since 2d --only history --limit 0
+
+import fs from 'node:fs'
+import path from 'node:path'
+import os from 'node:os'
+import { execFileSync } from 'node:child_process'
+
+// --- 参数解析 -----------------------------------------------------------
+function parseArgs(argv) {
+  const a = { keywords: [], only: null, limit: 20, since: null, sort: 'recent' }
+  for (let i = 0; i < argv.length; i++) {
+    const v = argv[i]
+    if (v === '--only') a.only = argv[++i]
+    else if (v === '--limit') a.limit = parseInt(argv[++i], 10)
+    else if (v === '--since') a.since = parseSince(argv[++i])
+    else if (v === '--sort') a.sort = argv[++i]
+    else if (v === '-h' || v === '--help') {
+      printUsage()
+      process.exit(0)
+    } else if (v.startsWith('--')) die(`未知参数: ${v}`)
+    else a.keywords.push(v)
+  }
+  if (a.only && !['bookmarks', 'history'].includes(a.only)) die(`--only 仅支持 bookmarks|history`)
+  if (!['recent', 'visits'].includes(a.sort)) die(`--sort 仅支持 recent|visits`)
+  if (Number.isNaN(a.limit) || a.limit < 0) die('--limit 需为非负整数')
+  return a
+}
+
+function parseSince(s) {
+  if (!s) die('--since 需要值')
+  const m = s.match(/^(\d+)([dhm])$/)
+  if (m) {
+    const n = parseInt(m[1], 10)
+    const ms = { d: 86400000, h: 3600000, m: 60000 }[m[2]]
+    return new Date(Date.now() - n * ms)
+  }
+  const d = new Date(s)
+  if (Number.isNaN(d.getTime())) die(`无效 --since 值: ${s}（用 1d / 7h / 30m / YYYY-MM-DD）`)
+  return d
+}
+
+function die(msg) {
+  console.error(msg)
+  process.exit(1)
+}
+function printUsage() {
+  console.error(
+    fs
+      .readFileSync(new URL(import.meta.url))
+      .toString()
+      .split('\n')
+      .slice(1, 19)
+      .map((l) => l.replace(/^\/\/ ?/, ''))
+      .join('\n'),
+  )
+}
+
+// --- Chrome 用户数据目录（跨平台） ---------------------------------------
+function getChromeDataDir() {
+  const home = os.homedir()
+  switch (os.platform()) {
+    case 'darwin':
+      return path.join(home, 'Library/Application Support/Google/Chrome')
+    case 'linux':
+      return path.join(home, '.config/google-chrome')
+    case 'win32':
+      return path.join(process.env.LOCALAPPDATA || '', 'Google/Chrome/User Data')
+    default:
+      return null
+  }
+}
+
+// --- Profile 枚举 -------------------------------------------------------
+function listProfiles(dataDir) {
+  try {
+    const state = JSON.parse(fs.readFileSync(path.join(dataDir, 'Local State'), 'utf-8'))
+    const info = state?.profile?.info_cache || {}
+    const list = Object.keys(info).map((dir) => ({ dir, name: info[dir].name || dir }))
+    if (list.length) return list
+  } catch {
+    /* 回退 */
+  }
+  return [{ dir: 'Default', name: 'Default' }]
+}
+
+// --- 书签检索 -----------------------------------------------------------
+function searchBookmarks(profileDir, profileName, keywords) {
+  const file = path.join(profileDir, 'Bookmarks')
+  if (!fs.existsSync(file)) return []
+  let data
+  try {
+    data = JSON.parse(fs.readFileSync(file, 'utf-8'))
+  } catch {
+    return []
+  }
+  if (!keywords.length) return [] // 书签无时间维度，无关键词不返回
+
+  const needles = keywords.map((k) => k.toLowerCase())
+  const out = []
+  function walk(node, trail) {
+    if (!node) return
+    if (node.type === 'url') {
+      const hay = `${node.name || ''} ${node.url || ''}`.toLowerCase()
+      if (needles.every((n) => hay.includes(n))) {
+        out.push({
+          profile: profileName,
+          name: node.name || '',
+          url: node.url || '',
+          folder: trail.join(' / '),
+        })
+      }
+    }
+    if (Array.isArray(node.children)) {
+      const sub = node.name ? [...trail, node.name] : trail
+      for (const c of node.children) walk(c, sub)
+    }
+  }
+  for (const root of Object.values(data.roots || {})) walk(root, [])
+  return out
+}
+
+// --- 历史检索（SQLite 运行时锁定，需 copy 到 tmp） ------------------------
+const WEBKIT_EPOCH_DIFF_US = 11644473600000000n // 1601→1970 微秒差
+
+function searchHistory(profileDir, profileName, keywords, since, limit, sort) {
+  const src = path.join(profileDir, 'History')
+  if (!fs.existsSync(src)) return []
+  const tmp = path.join(os.tmpdir(), `chrome-history-${process.pid}-${Date.now()}.sqlite`)
+  try {
+    fs.copyFileSync(src, tmp)
+    const conds = ['last_visit_time > 0']
+    for (const kw of keywords) {
+      const esc = kw.toLowerCase().replace(/'/g, "''")
+      conds.push(`LOWER(title || ' ' || url) LIKE '%${esc}%'`)
+    }
+    if (since) {
+      const webkitUs = BigInt(since.getTime()) * 1000n + WEBKIT_EPOCH_DIFF_US
+      conds.push(`last_visit_time >= ${webkitUs}`)
+    }
+    const limitClause = limit === 0 ? -1 : limit
+    const orderBy =
+      sort === 'visits' ? 'visit_count DESC, last_visit_time DESC' : 'last_visit_time DESC'
+    const sql = `SELECT title, url,
+      datetime((last_visit_time - 11644473600000000)/1000000, 'unixepoch', 'localtime') AS visit,
+      visit_count
+      FROM urls WHERE ${conds.join(' AND ')}
+      ORDER BY ${orderBy} LIMIT ${limitClause};`
+
+    const raw = execFileSync('sqlite3', ['-separator', '\t', tmp, sql], {
+      encoding: 'utf-8',
+      maxBuffer: 50 * 1024 * 1024,
+    })
+    return raw
+      .trim()
+      .split('\n')
+      .filter(Boolean)
+      .map((line) => {
+        const [title, url, visit, visit_count] = line.split('\t')
+        return { profile: profileName, title, url, visit, visit_count: parseInt(visit_count, 10) }
+      })
+  } catch (e) {
+    if (e.code === 'ENOENT')
+      die(
+        '未找到 sqlite3 命令。macOS/Linux 通常自带；Windows 可用 `winget install sqlite.sqlite` 或从 https://sqlite.org/download.html 下载后加入 PATH。',
+      )
+    return []
+  } finally {
+    try {
+      fs.unlinkSync(tmp)
+    } catch {}
+  }
+}
+
+// --- 输出格式化 ---------------------------------------------------------
+// 用 `|` 作字段分隔符；字段内含 `|` 的替换成 `│`（全宽竖线）避免歧义
+const clean = (s) =>
+  String(s ?? '')
+    .replaceAll('|', '│')
+    .trim()
+
+function printBookmarks(items, multiProfile) {
+  console.log(`[书签] ${items.length} 条`)
+  for (const b of items) {
+    const segs = [clean(b.name) || '(无标题)', clean(b.url)]
+    if (b.folder) segs.push(clean(b.folder))
+    if (multiProfile) segs.push('@' + clean(b.profile))
+    console.log('  ' + segs.join(' | '))
+  }
+}
+
+function printHistory(items, multiProfile, sortLabel) {
+  console.log(`[历史] ${items.length} 条（${sortLabel}）`)
+  for (const h of items) {
+    const segs = [clean(h.title) || '(无标题)', clean(h.url), h.visit]
+    if (h.visit_count > 1) segs.push(`visits=${h.visit_count}`)
+    if (multiProfile) segs.push('@' + clean(h.profile))
+    console.log('  ' + segs.join(' | '))
+  }
+}
+
+// --- main ---------------------------------------------------------------
+const args = parseArgs(process.argv.slice(2))
+
+const dataDir = getChromeDataDir()
+if (!dataDir || !fs.existsSync(dataDir)) die('未找到 Chrome 用户数据目录')
+
+const profiles = listProfiles(dataDir)
+const doBookmarks = args.only !== 'history'
+const doHistory = args.only !== 'bookmarks'
+
+const bookmarks = []
+const history = []
+for (const p of profiles) {
+  const pDir = path.join(dataDir, p.dir)
+  if (!fs.existsSync(pDir)) continue
+  if (doBookmarks) bookmarks.push(...searchBookmarks(pDir, p.name, args.keywords))
+  if (doHistory)
+    history.push(
+      ...searchHistory(
+        pDir,
+        p.name,
+        args.keywords,
+        args.since,
+        args.limit === 0 ? 0 : args.limit * 2,
+        args.sort,
+      ),
+    )
+}
+
+// 历史跨 profile 合并后按指定 sort 重排 + 切顶
+if (args.sort === 'visits') {
+  history.sort(
+    (a, b) =>
+      (b.visit_count || 0) - (a.visit_count || 0) || (b.visit || '').localeCompare(a.visit || ''),
+  )
+} else {
+  history.sort((a, b) => (b.visit || '').localeCompare(a.visit || ''))
+}
+const bookmarksOut = args.limit === 0 ? bookmarks : bookmarks.slice(0, args.limit)
+const historyOut = args.limit === 0 ? history : history.slice(0, args.limit)
+
+// 仅当结果真的横跨多个 profile 时，才输出 @profile 标注（空 profile 不算）
+const seenProfiles = new Set([...bookmarksOut, ...historyOut].map((x) => x.profile))
+const showProfile = seenProfiles.size > 1
+
+const sortLabel = args.sort === 'visits' ? '按访问次数' : '按最近访问'
+if (doBookmarks) printBookmarks(bookmarksOut, showProfile)
+if (doBookmarks && doHistory) console.log()
+if (doHistory) printHistory(historyOut, showProfile, sortLabel)
+
+if (!args.keywords.length && doBookmarks && !doHistory) {
+  console.error('\n提示：书签无时间维度，无关键词查询无意义。加关键词或切换 --only history。')
+}

package/skills/standard/web-access/scripts/match-site.mjs

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+// 根据用户输入匹配站点经验文件（跨平台，替代 match-site.sh）
+// 用法：node match-site.mjs "用户输入文本"
+// 输出：匹配到的站点经验内容，无匹配则静默
+
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+const PATTERNS_DIR = path.join(ROOT, 'references', 'site-patterns')
+const query = (process.argv[2] || '').trim()
+
+if (!query || !fs.existsSync(PATTERNS_DIR)) {
+  process.exit(0)
+}
+
+for (const entry of fs.readdirSync(PATTERNS_DIR, { withFileTypes: true })) {
+  if (!entry.isFile() || !entry.name.endsWith('.md')) continue
+
+  const domain = entry.name.replace(/\.md$/, '')
+  const raw = fs.readFileSync(path.join(PATTERNS_DIR, entry.name), 'utf8')
+
+  // 提取 aliases
+  const aliasesLine = raw.split(/\r?\n/).find((l) => l.startsWith('aliases:')) || ''
+  const aliases = aliasesLine
+    .replace(/^aliases:\s*/, '')
+    .replace(/^\[/, '')
+    .replace(/\]$/, '')
+    .split(',')
+    .map((v) => v.trim())
+    .filter(Boolean)
+
+  // 构建匹配模式
+  const escaped = (t) => t.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+  const pattern = [domain, ...aliases].map(escaped).join('|')
+  if (!new RegExp(pattern, 'i').test(query)) continue
+
+  // 跳过 frontmatter，输出正文
+  const fences = [...raw.matchAll(/^---\s*$/gm)]
+  const body =
+    fences.length >= 2
+      ? raw.slice(fences[1].index + fences[1][0].length).replace(/^\r?\n/, '')
+      : raw
+
+  process.stdout.write(`--- 站点经验: ${domain} ---\n`)
+  process.stdout.write(body.trimEnd() + '\n\n')
+}