@hupan56/wlkj 3.0.0 → 3.1.2

package/templates/qoder/scripts/protocol/browser/scripts/check-deps.mjs

@@ -0,0 +1,206 @@
+#!/usr/bin/env node
+// 环境检查 + 确保 CDP Proxy 就绪
+//
+// 用法：
+//   node check-deps.mjs                  默认行为：读 config.env 偏好
+//   node check-deps.mjs --browser edge   本次临时指定浏览器（不写 config.env）
+//
+// 持久偏好 → config.env (skill 根目录, gitignored)
+// 单次覆盖 → --browser 命令行参数（全链路 argv，不碰 process.env）
+
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { selectBrowser, knownBrowsers, findFallbackPort } from './browser-discovery.mjs';
+
+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);
+const CONFIG_PATH = path.join(ROOT, 'config.env');
+const CONFIG_TEMPLATE = path.join(ROOT, 'templates', 'config.env.template');
+
+// --- 参数解析 ---
+
+function parseArgs(argv) {
+  const opts = { browser: null };
+  for (let i = 0; i < argv.length; i++) {
+    if (argv[i] === '--browser' && argv[i + 1]) { opts.browser = argv[i + 1]; i++; }
+    else if (argv[i].startsWith('--browser=')) { opts.browser = argv[i].slice('--browser='.length); }
+  }
+  return opts;
+}
+
+// --- 首次安装：从模板创建 config.env ---
+
+function ensureConfigExists() {
+  if (fs.existsSync(CONFIG_PATH)) return;
+  try {
+    fs.copyFileSync(CONFIG_TEMPLATE, CONFIG_PATH);
+    console.log(`config: 已从模板创建 ${CONFIG_PATH}`);
+  } catch {
+    // 模板不存在或拷贝失败 —— 不阻塞，readConfig 会兜底
+  }
+}
+
+// --- 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+)`);
+}
+
+// --- 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(browserOverride) {
+  const logFile = path.join(os.tmpdir(), 'cdp-proxy.log');
+  const logFd = fs.openSync(logFile, 'a');
+  const args = [PROXY_SCRIPT];
+  if (browserOverride) args.push('--browser', browserOverride);
+  const child = spawn(process.execPath, args, {
+    detached: true,
+    stdio: ['ignore', logFd, logFd],
+    ...(os.platform() === 'win32' ? { windowsHide: true } : {}),
+  });
+  child.unref();
+  fs.closeSync(logFd);
+}
+
+async function ensureProxy(expectedBrowserId, browserOverride) {
+  const healthUrl = `http://127.0.0.1:${PROXY_PORT}/health`;
+  const targetsUrl = `http://127.0.0.1:${PROXY_PORT}/targets`;
+
+  // 复用：proxy 已运行 + 已连接浏览器 → 校验 expected vs actual
+  const health = await httpGetJson(healthUrl);
+  if (health?.status === 'ok' && health.connected) {
+    const runningId = health.browser?.id;
+    const runningLabel = health.browser?.label || runningId || 'unknown';
+    if (expectedBrowserId && runningId && runningId !== 'unknown' && runningId !== expectedBrowserId) {
+      console.log(`proxy: 浏览器不一致 — 当前已连着 ${runningLabel}，但本次需要 ${expectedBrowserId}`);
+      console.log('  请在终端运行 pkill -f cdp-proxy.mjs 重置后再试');
+      return false;
+    }
+    console.log(`proxy: ready (${runningLabel})`);
+    return true;
+  }
+
+  console.log('proxy: connecting...');
+  startProxyDetached(browserOverride);
+
+  await new Promise((r) => setTimeout(r, 2000));
+
+  for (let i = 1; i <= 15; i++) {
+    const result = await httpGetJson(targetsUrl, 8000);
+    if (Array.isArray(result)) {
+      const newHealth = await httpGetJson(healthUrl);
+      const label = newHealth?.browser?.label || 'unknown';
+      console.log(`proxy: ready (${label})`);
+      return true;
+    }
+    if (i === 1) {
+      console.log('⚠️  浏览器可能有授权弹窗，请点击「允许」后等待连接...');
+    }
+    await new Promise((r) => setTimeout(r, 1000));
+  }
+
+  console.log('❌ 连接超时，请检查浏览器调试设置');
+  console.log(`  日志：${path.join(os.tmpdir(), 'cdp-proxy.log')}`);
+  return false;
+}
+
+// --- 输出浏览器选择结果，返回是否可以继续启动 proxy ---
+
+function printAvailableHint(detected) {
+  const detectedIds = new Set(detected.map(b => b.id));
+  const configurable = knownBrowsers().filter(b => !detectedIds.has(b.id));
+  if (detected.length) {
+    console.log(`  已开启远程调试：${detected.map(b => `${b.label} (${b.id}, port ${b.port})`).join('、')}`);
+  }
+  if (configurable.length) {
+    console.log(`  其他可配置：${configurable.map(b => `${b.label} (${b.id})`).join('、')}`);
+  }
+}
+
+async function resolveAndReport(override) {
+  const result = await selectBrowser(override);
+
+  switch (result.kind) {
+    case 'ok': {
+      const sourceTag = result.source === 'override' ? '[--browser 指定]' : '[config.env 偏好]';
+      console.log(`browser: ok (${result.browser.label}, port ${result.browser.port}) ${sourceTag}`);
+      return { proceed: true, browserId: result.browser.id };
+    }
+
+    case 'ambiguous': {
+      console.log('browser: needs decision — 用户尚未在 config.env 设置偏好');
+      printAvailableHint(result.detected);
+      console.log('  请询问用户：哪个浏览器作为 Agent 的默认？（写入 config.env 的 WEB_ACCESS_BROWSER）');
+      console.log('  若仅本次使用，可重跑：node check-deps.mjs --browser <id>');
+      return { proceed: false, exitCode: 2 };
+    }
+
+    case 'mismatch': {
+      const expected = result.override || result.configured;
+      const expectedLabel = knownBrowsers().find(b => b.id === expected)?.label || expected;
+      const sourceDesc = result.source === 'override' ? '本次指定' : '默认偏好';
+      console.log(`browser: error — ${sourceDesc}的浏览器是 "${expected}" (${expectedLabel})，但没连上`);
+      console.log(`  Agent 处理顺序：`);
+      console.log(`    1. 先用系统命令打开 ${expectedLabel}（按你所在平台自行选择，如 macOS 的 open -a），再重新运行 node check-deps.mjs`);
+      console.log(`    2. 若仍报相同错误，可能是因为远程调试开关没启用 —— 告诉用户：在 ${expectedLabel} 的地址栏访问 ${expected}://inspect/#remote-debugging，勾选 "Allow remote debugging for this browser instance"`);
+      printAvailableHint(result.detected);
+      if (result.source === 'preference') {
+        console.log(`  也可以编辑 config.env 改默认偏好，或本次临时换浏览器：node check-deps.mjs --browser <id>`);
+      }
+      return { proceed: false, exitCode: 1 };
+    }
+
+    case 'empty': {
+      // 末路兜底：尝试常见固定端口（用户手动 --remote-debugging-port=9222 启动的场景）
+      const fallbackPort = await findFallbackPort();
+      if (fallbackPort) {
+        console.log(`browser: ok (port ${fallbackPort}) [通过手动调试端口连接]`);
+        return { proceed: true };
+      }
+      console.log('browser: 未连接 — 没有任何浏览器打开远程调试开关');
+      console.log(`  支持的浏览器：${knownBrowsers().map(b => b.label).join('、')}`);
+      console.log('  在你想用的浏览器地址栏打开 chrome://inspect/#remote-debugging 或 edge://inspect/#remote-debugging，勾选 "Allow remote debugging for this browser instance"');
+      return { proceed: false, exitCode: 1 };
+    }
+  }
+}
+
+// --- main ---
+
+async function main() {
+  const opts = parseArgs(process.argv.slice(2));
+  ensureConfigExists();
+  checkNode();
+
+  const { proceed, exitCode, browserId } = await resolveAndReport(opts.browser);
+  if (!proceed) process.exit(exitCode);
+
+  const proxyOk = await ensureProxy(browserId, opts.browser);
+  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/templates/qoder/scripts/protocol/browser/scripts/find-url.mjs

@@ -0,0 +1,253 @@
+#!/usr/bin/env node
+// find-url - 从本地 Chromium 系浏览器（Chrome / Edge）书签/历史中检索 URL
+// 用于定位公网搜索覆盖不到的目标（组织内部系统、SSO 后台、内网域名等）。
+//
+// 用法：
+//   node find-url.mjs [关键词...] [--only bookmarks|history] [--limit N] [--since 1d|7h|YYYY-MM-DD]
+//
+//   <关键词>             空格分词、多词 AND，匹配 title + url；可省略
+//   --only <source>      限定数据源（bookmarks / history），默认两者都查
+//   --browser <id>       限定浏览器（chrome / edge），默认遍历所有已安装的
+//   --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
+//   node find-url.mjs github --browser edge                     # 只查 Edge
+
+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, browser: 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 === '--browser') a.browser = 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, 21).map(l => l.replace(/^\/\/ ?/, '')).join('\n')); }
+
+// --- 浏览器用户数据目录（跨平台 + 多浏览器） -----------------------------
+// 加新浏览器：只改这里
+function knownBrowserDataDirs() {
+  const home = os.homedir();
+  const localAppData = process.env.LOCALAPPDATA || '';
+  switch (os.platform()) {
+    case 'darwin':
+      return [
+        { id: 'chrome', label: 'Chrome', dir: path.join(home, 'Library/Application Support/Google/Chrome') },
+        { id: 'edge',   label: 'Edge',   dir: path.join(home, 'Library/Application Support/Microsoft Edge') },
+      ];
+    case 'linux':
+      return [
+        { id: 'chrome', label: 'Chrome', dir: path.join(home, '.config/google-chrome') },
+        { id: 'edge',   label: 'Edge',   dir: path.join(home, '.config/microsoft-edge') },
+      ];
+    case 'win32':
+      return [
+        { id: 'chrome', label: 'Chrome', dir: path.join(localAppData, 'Google/Chrome/User Data') },
+        { id: 'edge',   label: 'Edge',   dir: path.join(localAppData, 'Microsoft/Edge/User Data') },
+      ];
+    default:
+      return [];
+  }
+}
+
+// --- 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, browserLabel, 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({ browser: browserLabel, 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, browserLabel, keywords, since, limit, sort) {
+  const src = path.join(profileDir, 'History');
+  if (!fs.existsSync(src)) return [];
+  const tmp = path.join(os.tmpdir(), `browser-history-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}.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 { browser: browserLabel, 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 originTag(item, showBrowser, showProfile) {
+  if (showBrowser && showProfile) return '@' + clean(item.browser) + '-' + clean(item.profile);
+  if (showBrowser) return '@' + clean(item.browser);
+  if (showProfile) return '@' + clean(item.profile);
+  return null;
+}
+
+function printBookmarks(items, showBrowser, showProfile) {
+  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));
+    const tag = originTag(b, showBrowser, showProfile);
+    if (tag) segs.push(tag);
+    console.log('  ' + segs.join(' | '));
+  }
+}
+
+function printHistory(items, showBrowser, showProfile, 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}`);
+    const tag = originTag(h, showBrowser, showProfile);
+    if (tag) segs.push(tag);
+    console.log('  ' + segs.join(' | '));
+  }
+}
+
+// --- main ---------------------------------------------------------------
+const args = parseArgs(process.argv.slice(2));
+
+let browsers = knownBrowserDataDirs().filter(b => fs.existsSync(b.dir));
+if (args.browser) {
+  const filtered = browsers.filter(b => b.id === args.browser);
+  if (!filtered.length) {
+    const available = browsers.map(b => b.id).join('、') || '无';
+    die(`未找到浏览器 ${args.browser} 的用户数据目录（已检测到：${available}）`);
+  }
+  browsers = filtered;
+}
+if (!browsers.length) die('未找到任何浏览器（Chrome / Edge）的用户数据目录');
+
+const doBookmarks = args.only !== 'history';
+const doHistory   = args.only !== 'bookmarks';
+
+const bookmarks = [];
+const history = [];
+for (const browser of browsers) {
+  const profiles = listProfiles(browser.dir);
+  for (const p of profiles) {
+    const pDir = path.join(browser.dir, p.dir);
+    if (!fs.existsSync(pDir)) continue;
+    if (doBookmarks) bookmarks.push(...searchBookmarks(pDir, p.name, browser.label, args.keywords));
+    if (doHistory)   history.push(...searchHistory(pDir, p.name, browser.label, 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);
+
+// 仅当结果真的横跨多个 browser/profile 时才输出 @ 标注（避免单源场景噪音）
+const seenBrowsers = new Set([...bookmarksOut, ...historyOut].map(x => x.browser));
+const seenProfiles = new Set([...bookmarksOut, ...historyOut].map(x => x.profile));
+const showBrowser = seenBrowsers.size > 1;
+const showProfile = seenProfiles.size > 1;
+
+const sortLabel = args.sort === 'visits' ? '按访问次数' : '按最近访问';
+if (doBookmarks) printBookmarks(bookmarksOut, showBrowser, showProfile);
+if (doBookmarks && doHistory) console.log();
+if (doHistory)   printHistory(historyOut, showBrowser, showProfile, sortLabel);
+
+if (!args.keywords.length && doBookmarks && !doHistory) {
+  console.error('\n提示：书签无时间维度，无关键词查询无意义。加关键词或切换 --only history。');
+}

package/templates/qoder/scripts/protocol/browser/scripts/match-site.mjs

@@ -0,0 +1,46 @@
+#!/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');
+}

package/templates/qoder/scripts/protocol/browser/templates/config.env.template

@@ -0,0 +1,9 @@
+# web-access skill 用户偏好配置
+# 此文件是模板。首次运行 check-deps.mjs 时会自动复制为 config.env（git ignored）。
+#
+# 用户长期偏好的默认 Agent 浏览器
+# - 留空：每次启动都问用户偏好哪个
+# - 设值：固定使用该浏览器；若未检测到对应 toggle 则硬错（不擅自降级）
+#
+# 合法值：chrome / edge
+WEB_ACCESS_BROWSER=

package/templates/qoder/scripts/protocol/mcp/__init__.py

@@ -0,0 +1,11 @@
+# 子包初始化: 注入 scripts/根 + 所有子包到 sys.path
+# 让跨包 import (旧式不带前缀) 仍可用, 兼容现有代码
+import os as _os, sys as _sys
+_root = _os.path.dirname(_os.path.dirname(_os.path.abspath(__file__)))
+if _root not in _sys.path:
+    _sys.path.insert(0, _root)
+# 注入所有子包目录 (兼容旧式 import xxx)
+for _sub in ('kg', 'build', 'test', 'setup', 'io'):
+    _subdir = _os.path.join(_root, _sub)
+    if _os.path.isdir(_subdir) and _subdir not in _sys.path:
+        _sys.path.insert(0, _subdir)