@agentguardx/helper 0.3.89 → 0.3.91

package/lib/wizard.cjs

@@ -45,6 +45,9 @@ async function question(ask, label, masked = false) {
 }
 async function choose(ask, label, options, multiple = false) {
   let cursor = 0, selected = new Set();
+  // 上一步输入残留的回车（例如粘贴地址时末尾带的换行）会在菜单刚出现时立刻到达，
+  // 不能把它当成对默认项的选择；菜单显示后短时间内的回车一律忽略。
+  const shownAt = Date.now();
   const render = first => {
     if (!first) process.stdout.write(`\x1b[${options.length}A`);
     options.forEach((option, index) => process.stdout.write(`\x1b[2K\r${cursor === index ? '›' : ' '} ${multiple ? `[${selected.has(index) ? '✓' : ' '}] ` : ''}${option.label}\n`));
@@ -53,6 +56,7 @@ async function choose(ask, label, options, multiple = false) {
     if (key.name === 'up') cursor = (cursor + options.length - 1) % options.length;
     else if (key.name === 'down') cursor = (cursor + 1) % options.length;
     else if (multiple && key.name === 'space') selected.has(cursor) ? selected.delete(cursor) : selected.add(cursor);
+    else if ((key.name === 'return' || key.name === 'enter') && Date.now() - shownAt < 300) return;
     else if (key.name === 'return' || key.name === 'enter') { done(multiple ? [...selected].sort().map(i => options[i].value) : options[cursor].value); return; }
     render(false);
   });
@@ -87,19 +91,22 @@ function config(server) {
     request.on('timeout', () => request.destroy()); request.on('error', () => reject(new Error('server_config_unavailable')));
   });
 }
-function detectedTools() {
+function supportedTools() {
   const home = os.homedir(), windows = process.platform === 'win32';
   const command = name => (process.env.PATH || '').split(path.delimiter).some(dir => (windows ? ['', '.exe', '.cmd', '.bat'] : ['']).some(ext => {
     try { const file = path.join(dir, name + ext); return fs.statSync(file).isFile() && (windows || (fs.accessSync(file, fs.constants.X_OK), true)); } catch { return false; }
   }));
   const apps = (mac, win) => process.platform === 'darwin' ? ['/Applications', path.join(home, 'Applications')].some(dir => fs.existsSync(path.join(dir, mac))) : windows && !!process.env.LOCALAPPDATA && fs.existsSync(path.join(process.env.LOCALAPPDATA, win));
   return [
-    { label: 'OpenCode（模型与远程 MCP）', value: 'opencode', present: command('opencode') },
-    { label: 'OpenClaw（模型）', value: 'openclaw', present: command('openclaw') },
-    { label: 'Cursor（远程 MCP）', value: 'cursor', present: command('cursor') || apps('Cursor.app', 'Programs/Cursor/Cursor.exe') },
-    { label: 'Claude Desktop（MCP 桥接）', value: 'claude-desktop', present: command('claude-desktop') || apps('Claude.app', 'AnthropicClaude/Claude.exe') },
-    { label: 'Cherry Studio（手动填写说明）', value: 'cherry-studio', present: apps('Cherry Studio.app', 'Programs/Cherry Studio/Cherry Studio.exe') },
-  ].filter(item => item.present);
+    { label: 'OpenCode（模型与远程 MCP）', value: 'opencode', present: command('opencode'), install: 'npm i -g opencode-ai' },
+    { label: 'OpenClaw（模型）', value: 'openclaw', present: command('openclaw'), install: '按 OpenClaw 官方说明安装' },
+    { label: 'Cursor（远程 MCP）', value: 'cursor', present: command('cursor') || apps('Cursor.app', 'Programs/Cursor/Cursor.exe'), install: '从 cursor.com 下载安装' },
+    { label: 'Claude Desktop（MCP 桥接）', value: 'claude-desktop', present: command('claude-desktop') || apps('Claude.app', 'AnthropicClaude/Claude.exe'), install: '从 claude.ai/download 下载安装' },
+    { label: 'Cherry Studio（手动填写说明）', value: 'cherry-studio', present: apps('Cherry Studio.app', 'Programs/Cherry Studio/Cherry Studio.exe'), install: '从 cherry-ai.com 下载安装' },
+  ];
+}
+function detectedTools() {
+  return supportedTools().filter(item => item.present);
 }
 async function currentServer(runtime, prefix, flagServer) {
   // Priority --server > AGENTGUARD_SERVER > saved configuration is resolved by the Go core.
@@ -142,7 +149,10 @@ async function init(runtime, args) {
   const choices = [{ label: '浏览器网页授权登录（以控制台当前登录的人授权）', value: 'browser' }, { label: '粘贴个人访问令牌', value: 'token' }];
   let httpFlags = [];
   if (new URL(server).protocol === 'http:') {
-    const consent = await queryConsent(runtime, server, prefix);
+    const loopback = ['127.0.0.1', 'localhost', '[::1]'].includes(new URL(server).hostname);
+    const consent = loopback ? { acknowledged: true } : await queryConsent(runtime, server, prefix);
+    // 本机回环地址不经过网络，没有中间人可读取，不再询问明文风险。
+    if (loopback) process.stdout.write('本机地址，不经过网络传输，无需明文风险确认。\n');
     if (!consent.acknowledged) {
       const answer = await choose(ask, 'HTTP 会以明文传输登录信息、个人令牌和业务内容，网络中间人可能读取或篡改。是否确认对该服务器继续？', [
         { label: '取消，不发送登录信息或令牌', value: false },
@@ -187,7 +197,12 @@ async function init(runtime, args) {
   } else code = await run(runtime, [...prefix, 'login', '--server', server, ...httpFlags, '--defer-notice'], '');
   if (code) { process.exitCode = code; return; }
   const tools = detectedTools();
-  if (!tools.length) process.stdout.write('未检测到本批支持的工具；安装工具后可运行 agentguard connect <工具名>。\n');
+  const missing = supportedTools().filter(item => !item.present);
+  if (missing.length) {
+    process.stdout.write('以下支持的工具在本机未检测到，安装后运行 npx @agentguardx/helper connect <工具名> 接入：\n');
+    for (const item of missing) process.stdout.write(`  - ${item.label}：${item.install}（工具名 ${item.value}）\n`);
+  }
+  if (!tools.length) process.stdout.write('本机暂未检测到支持的工具。\n');
   else {
     const selected = await choose(ask, '选择要接入的已检测工具', tools, true);
     for (const tool of selected) { code = await run(runtime, [...prefix, 'connect', tool], ''); if (code) { process.exitCode = code; return; } }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentguardx/helper",
-  "version": "0.3.89",
+  "version": "0.3.91",
   "description": "AgentGuard \u5458\u5de5\u63a5\u5165\u52a9\u624b",
   "license": "UNLICENSED",
   "engines": {
@@ -19,12 +19,12 @@
     "preuninstall": "node lib/preuninstall.cjs"
   },
   "optionalDependencies": {
-    "@agentguardx/helper-darwin-x64": "0.3.89",
-    "@agentguardx/helper-darwin-arm64": "0.3.89",
-    "@agentguardx/helper-linux-x64": "0.3.89",
-    "@agentguardx/helper-linux-arm64": "0.3.89",
-    "@agentguardx/helper-win32-x64": "0.3.89",
-    "@agentguardx/helper-win32-arm64": "0.3.89"
+    "@agentguardx/helper-darwin-x64": "0.3.91",
+    "@agentguardx/helper-darwin-arm64": "0.3.91",
+    "@agentguardx/helper-linux-x64": "0.3.91",
+    "@agentguardx/helper-linux-arm64": "0.3.91",
+    "@agentguardx/helper-win32-x64": "0.3.91",
+    "@agentguardx/helper-win32-arm64": "0.3.91"
   },
   "publishConfig": {
     "access": "public"