ai-helper-agent 2.1.0 → 2.2.0

package/dist/options.html

@@ -4,8 +4,8 @@
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title data-i18n="settings.docTitle">AI Helper - 配置</title>
-  <script type="module" crossorigin src="/assets/i18n-CAh-vB_T.js"></script>
-  <script type="module" crossorigin src="/assets/model-profiles-CGxULM3O.js"></script>
+  <script type="module" crossorigin src="/assets/i18n-MmYITlVj.js"></script>
+  <script type="module" crossorigin src="/assets/model-profiles-CV_sUuPf.js"></script>
   <script type="module" crossorigin src="/assets/options.js"></script>
   <script type="module" crossorigin src="/assets/modulepreload-polyfill-P2Xu9kJm.js"></script>
   <link rel="stylesheet" crossorigin href="/assets/options-Df_1Dtn8.css">
@@ -440,14 +440,6 @@
             <span class="reflection-toggle-slider"></span>
           </label>
         </div>
-        <div class="reflection-toggle-row" id="toolReflectionSection">
-          <span class="reflection-row-icon">🔧</span>
-          <span class="reflection-row-text"><span data-i18n="reflection.toolReflection">工具级反思</span><span class="reflection-row-hint" data-i18n="reflection.toolReflectionHint">（工具执行后评估结果）</span></span>
-          <label class="reflection-toggle-switch">
-            <input type="checkbox" id="toolReflectionEnabled" checked>
-            <span class="reflection-toggle-slider"></span>
-          </label>
-        </div>
         <div class="reflection-toggle-row" id="subtaskReflectionSection">
           <span class="reflection-row-icon">📋</span>
           <span class="reflection-row-text"><span data-i18n="reflection.subtaskReflection">子任务反思</span><span class="reflection-row-hint" data-i18n="reflection.subtaskReflectionHint">（高级功能，默认关闭）</span></span>
@@ -462,7 +454,6 @@
         <h3 data-i18n="reflection.configGuide">💡 反思配置说明</h3>
         <p>
           <strong data-i18n="reflection.guidePostReflection">后置反思</strong><span data-i18n="reflection.guidePostReflectionDesc">：在推理循环结束后，AI 会对最终结果进行自我评估。如果评分低于阈值，会自动修订或重新执行。</span><br>
-          <strong data-i18n="reflection.guideToolReflection">工具级反思</strong><span data-i18n="reflection.guideToolReflectionDesc">：在每次工具调用后，AI 会自动检查执行结果是否符合预期，遇到错误或异常时调整策略。</span><br>
           <strong data-i18n="reflection.guideSubtaskReflection">子任务反思</strong><span data-i18n="reflection.guideSubtaskReflectionDesc">：对于复杂任务拆解后的子任务进行单独评估，默认关闭（高级功能）。</span><br>
           <span data-i18n="reflection.guideTip">• 启用反思会增加 API 调用次数，建议根据需求权衡</span>
         </p>

package/dist/side_panel.html

@@ -5,10 +5,10 @@
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title data-i18n="header.docTitle">AI Helper - 模型问答</title>
   <script type="module" crossorigin src="/assets/rolldown-runtime-C0FnF6B9.js"></script>
-  <script type="module" crossorigin src="/assets/i18n-CAh-vB_T.js"></script>
-  <script type="module" crossorigin src="/assets/model-profiles-CGxULM3O.js"></script>
-  <script type="module" crossorigin src="/assets/session-store-uZ_LNasH.js"></script>
-  <script type="module" crossorigin src="/assets/agent-store-C4hZkQT5.js"></script>
+  <script type="module" crossorigin src="/assets/i18n-MmYITlVj.js"></script>
+  <script type="module" crossorigin src="/assets/model-profiles-CV_sUuPf.js"></script>
+  <script type="module" crossorigin src="/assets/session-store-B0ZPGm7d.js"></script>
+  <script type="module" crossorigin src="/assets/agent-store-DOyMdB_7.js"></script>
   <script type="module" crossorigin src="/assets/side_panel.js"></script>
   <script type="module" crossorigin src="/assets/modulepreload-polyfill-P2Xu9kJm.js"></script>
   <link rel="stylesheet" crossorigin href="/assets/side_panel.css">
@@ -695,7 +695,7 @@
           <button class="prompt-tab" data-tab="proxies" data-i18n="promptSelector.proxies">代理</button>
           <div class="prompt-merged-title" id="agentAtMergedTitle" data-i18n="promptSelector.mergedTitle">聚合搜索</div>
         </div>
-        <div class="prompt-dropdown-header"><span data-i18n="promptSelector.switchHintSelect">方向键切换 · Enter选择 · Ctrl+Enter选中并关闭 · Esc取消</span><span class="agent-add-btn" id="agentAddBtn" data-i18n-title="header.addEditAssistant" title="新增/编辑助手">✚</span><span class="agent-add-btn" id="proxyAddBtn" data-i18n-title="header.addEditAgent" title="新增/编辑代理" style="display:none;">✚</span><span class="agent-add-btn" id="knowledgeAddBtn" data-i18n-title="header.manageKnowledge" title="管理知识库" style="display:none;">✚</span></div>
+        <div class="prompt-dropdown-header"><span data-i18n="promptSelector.switchHintSelect">方向键切换 · Enter选择 · Ctrl+Enter选中并关闭 · Esc取消</span><span class="agent-add-btn" id="agentAddBtn" data-i18n-title="header.addEditAssistant" title="新增/编辑助手">✚</span><span class="agent-add-btn" id="proxyAddBtn" data-i18n-title="header.addEditAgent" title="新增/编辑代理" style="display:none;">✚</span><span class="agent-add-btn" id="knowledgeAddBtn" data-i18n-title="header.manageKnowledge" title="管理知识库" style="display:none;">✚</span><span class="agent-add-btn" id="pageAddBtn" data-i18n-title="pageSelector.openNewTab" title="新建标签页" style="display:none;">✚</span></div>
         <div id="agentAtList"></div>
         <div id="agentPageList" style="display: none;"></div>
         <div id="agentProxyList" style="display: none;"></div>
@@ -709,7 +709,7 @@
           <span class="file-at-title-label" data-i18n="fileSelector.workspaceTitle">工作目录</span>
           <span class="file-at-title-path" id="fileAtTitlePath"></span>
         </div>
-        <div class="prompt-dropdown-header"><span class="prompt-dropdown-header-text" data-i18n="fileSelector.switchHint">方向键切换 · Enter添加到文件问答 · Esc取消</span></div>
+        <div class="prompt-dropdown-header"><span class="prompt-dropdown-header-text" data-i18n="fileSelector.switchHint">方向键切换 · Enter添加到文件问答 · Esc取消</span><span class="agent-add-btn" id="fileAtWorkspaceOpenBtn" data-i18n-title="workspace.openPanel" title="打开工作目录面板">✚</span></div>
         <div id="fileAtList"></div>
       </div>
     </div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-helper-agent",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "AI Helper Agent - Local file access and system command execution proxy for Chrome extension / AI Helper 代理服务，为 Chrome 扩展提供本地文件读写和系统命令执行",
   "type": "module",
   "main": "./src/server.js",

package/src/install-mode.js

@@ -0,0 +1,128 @@
+// agent/src/install-mode.js - 安装模式检测与内嵌运行时工具函数
+//
+// 支持两种运行模式，所有功能模块通过本模块获取路径/配置，无需感知具体模式：
+//   1. 内嵌模式：由 install.sh / install.ps1 安装，runtime + app 均在 ~/.ai-helper-agent/ 下
+//   2. npm 全局模式：由 npm install -g ai-helper-agent 安装（传统路径）
+//
+// 判断依据：agent 包入口 (bin/agent.js) 所在路径是否在 ~/.ai-helper-agent/app/ 下。
+// 设计原则：所有改动向后兼容——npm -g 用户 isEmbedded()=false，走原逻辑。
+
+import { homedir } from 'os';
+import { join, dirname, resolve } from 'path';
+import { readFileSync, existsSync } from 'fs';
+import { fileURLToPath } from 'url';
+
+const EMBEDDED_ROOT = join(homedir(), '.ai-helper-agent');
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// 本模块位于 <agent-package>/src/，向上两级到包根
+const PACKAGE_ROOT = resolve(__dirname, '..');
+
+/**
+ * 是否运行在内嵌模式（由 install.sh 安装的自管理环境）
+ */
+export function isEmbedded() {
+  return PACKAGE_ROOT.startsWith(EMBEDDED_ROOT);
+}
+
+/**
+ * 内嵌模式的根目录（~/.ai-helper-agent/），非内嵌模式返回 null
+ */
+export function getEmbeddedRoot() {
+  return isEmbedded() ? EMBEDDED_ROOT : null;
+}
+
+/**
+ * 获取 Node 可执行文件路径
+ * - 内嵌模式：~/.ai-helper-agent/runtime/bin/node
+ * - 全局模式：process.execPath（当前正在运行的 node）
+ */
+export function getNodePath() {
+  if (!isEmbedded()) return process.execPath;
+  const candidate = join(EMBEDDED_ROOT, 'runtime', 'bin', 'node');
+  return existsSync(candidate) ? candidate : process.execPath;
+}
+
+/**
+ * 获取 npm 可执行文件路径
+ * - 内嵌模式：~/.ai-helper-agent/runtime/bin/npm
+ * - 全局模式：'npm'（系统 PATH 中的）
+ */
+export function getNpmPath() {
+  if (!isEmbedded()) return 'npm';
+  const isWin = process.platform === 'win32';
+  const candidate = isWin
+    ? join(EMBEDDED_ROOT, 'runtime', 'npm.cmd')
+    : join(EMBEDDED_ROOT, 'runtime', 'bin', 'npm');
+  return existsSync(candidate) ? candidate : 'npm';
+}
+
+/**
+ * 读取镜像探测结果（~/.ai-helper-agent/mirrors.json）
+ * 文件不存在时返回 null（npm -g 用户通常没有此文件）
+ * @returns {{ registry?: string, node?: string, huggingface?: string, detectedAt?: string } | null}
+ */
+export function readMirrors() {
+  try {
+    const mirrorsFile = join(EMBEDDED_ROOT, 'mirrors.json');
+    if (!existsSync(mirrorsFile)) return null;
+    // 剥 BOM：Windows PowerShell 5.1 的 Set-Content -Encoding UTF8 会写入 BOM，导致 JSON.parse 抛错
+    const text = readFileSync(mirrorsFile, 'utf-8').replace(/^\uFEFF/, '');
+    return JSON.parse(text);
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 获取当前应使用的 npm registry URL
+ * - 有 mirrors.json 且 registry 字段为 mirror → https://registry.npmmirror.com
+ * - 否则 → undefined（使用 npm 默认）
+ * @returns {string|undefined}
+ */
+export function getRegistryUrl() {
+  const mirrors = readMirrors();
+  if (!mirrors) return undefined;
+  if (mirrors.registry === 'mirror') return 'https://registry.npmmirror.com';
+  return undefined;
+}
+
+/**
+ * 获取 HuggingFace 模型下载端点
+ * - 有 mirrors.json 且 huggingface 为 mirror → https://hf-mirror.com/
+ * - 否则 → undefined（使用 transformers 默认）
+ * @returns {string|undefined}
+ */
+export function getHfEndpoint() {
+  const mirrors = readMirrors();
+  if (!mirrors) return undefined;
+  if (mirrors.huggingface === 'mirror') return 'https://hf-mirror.com/';
+  return undefined;
+}
+
+/**
+ * 获取主动停止标记文件路径（用于 autostart 检查）
+ */
+export function getStoppedFlagPath() {
+  return join(EMBEDDED_ROOT, '.stopped');
+}
+
+/**
+ * 获取 INSTALL_MANIFEST.json 路径与内容
+ */
+export function readInstallManifest() {
+  try {
+    const file = join(EMBEDDED_ROOT, 'INSTALL_MANIFEST.json');
+    if (!existsSync(file)) return null;
+    const text = readFileSync(file, 'utf-8').replace(/^\uFEFF/, '');
+    return JSON.parse(text);
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * agent 包根目录（无论哪种模式，都是本文件所在包的根）
+ */
+export function getAgentPackageRoot() {
+  return PACKAGE_ROOT;
+}

package/src/locales/cli.json

@@ -11,6 +11,9 @@
     "cmdConfig": "  config       查看当前配置",
     "cmdHelp": "  help         显示此帮助信息",
     "cmdRag": "  rag          管理 RAG 可选依赖 (status | install)",
+    "cmdUpdate": "  update       检查并更新到最新版本 (--check 仅检查)",
+    "cmdUninstall": "  uninstall    一键卸载代理端",
+    "cmdAutostart": "  autostart    开机自启管理 (on | off)",
     "startupOptions": "启动选项:",
     "optBackground": "  --background, -b   后台运行（守护进程模式）",
     "optPort": "  --port <端口>      设置监听端口 (默认: 18910)",
@@ -69,6 +72,15 @@
     "ragRestartAdvice": "提示：若多次安装失败，可尝试重启代理服务（aha restart）后再重试。",
     "ragUnknownSub": "未知的 rag 子命令: {sub}",
     "ragHelpUsage": "用法: aha rag <status|install>",
+    "updateLatest": "已是最新版本 v{version}",
+    "updateAvailable": "发现新版本: v{current} → v{latest}（运行 aha update 更新）",
+    "updateInstalling": "正在更新 v{current} → v{latest}...",
+    "updateFailed": "更新失败，请稍后重试",
+    "updateSuccess": "✅ 已更新至 v{version}，服务已重启",
+    "uninstallAutostartRemoved": "已移除开机自启",
+    "uninstallComplete": "✅ 卸载完成。用户数据已保留在 {dataDir}",
+    "autostartDisabled": "开机自启已关闭",
+    "autostartUseScript": "开启自启请重新运行安装脚本，或手动配置系统服务",
     "restartHelper": {
       "waitingOldExit": "等待老进程 {pid} 退出...",
       "waitOldTimeout": "等待老进程退出超时，尝试强制终止...",
@@ -91,6 +103,9 @@
     "cmdConfig": "  config       View current configuration",
     "cmdHelp": "  help         Show this help message",
     "cmdRag": "  rag          Manage RAG optional dependencies (status | install)",
+    "cmdUpdate": "  update       Check and update to latest (--check for info only)",
+    "cmdUninstall": "  uninstall    One-click uninstall agent",
+    "cmdAutostart": "  autostart    Manage auto-start (on | off)",
     "startupOptions": "Startup Options:",
     "optBackground": "  --background, -b   Run in background (daemon mode)",
     "optPort": "  --port <port>      Set listening port (default: 18910)",
@@ -149,6 +164,15 @@
     "ragRestartAdvice": "Tip: if installation keeps failing, try restarting the agent (aha restart) and retry.",
     "ragUnknownSub": "Unknown rag subcommand: {sub}",
     "ragHelpUsage": "Usage: aha rag <status|install>",
+    "updateLatest": "Already at latest version v{version}",
+    "updateAvailable": "New version available: v{current} → v{latest} (run aha update)",
+    "updateInstalling": "Updating v{current} → v{latest}...",
+    "updateFailed": "Update failed, please retry",
+    "updateSuccess": "✅ Updated to v{version}, service restarted",
+    "uninstallAutostartRemoved": "Auto-start removed",
+    "uninstallComplete": "✅ Uninstall complete. User data kept at {dataDir}",
+    "autostartDisabled": "Auto-start disabled",
+    "autostartUseScript": "To enable auto-start, re-run the install script or configure system service manually",
     "restartHelper": {
       "waitingOldExit": "Waiting for old process {pid} to exit...",
       "waitOldTimeout": "Wait for old process exit timeout, trying force kill...",

package/src/rag/install.js

@@ -27,6 +27,7 @@ import { resetRagDetection, detectRagAvailable, getLastRagProbeError, isNodeVers
 import { stopProcessTree } from '../process-tree.js';
 import { logSystem } from '../logger.js';
 import { t as translate, parseAcceptLanguage } from '../i18n.js';
+import { getRegistryUrl } from '../install-mode.js';
 
 // ---- 安装清单（单一事实来源：包自身 package.json 的 ragDependencies 字段） ----
 //
@@ -95,7 +96,10 @@ export function buildRagInstallCommand(opts = {}) {
     // 包损坏/被裁剪：拒绝构建（无包名参数的 npm install 会按依赖树重算包目录，不可接受）
     throw new Error('ragDependencies missing in package.json');
   }
+  // 如果有探测出的镜像 registry，自动注入（npm -g 用户无 mirrors.json 时此值为 undefined）
+  const registryUrl = opts.registry ?? getRegistryUrl();
   const baseArgs = ['install', '--no-save', '--no-audit', '--no-fund'];
+  if (registryUrl) baseArgs.push(`--registry=${registryUrl}`);
   const cwd = getAgentRoot();
   if (isWin) {
     const npmCli = findWinNpmCli(execPath);

package/src/server.js

@@ -1,7 +1,7 @@
 // agent/src/server.js - HTTP Router + WebSocket 服务器
 import http from 'http';
 import { WebSocketServer } from 'ws';
-import { readFileSync, createWriteStream, createReadStream, statSync, existsSync, watch } from 'fs';
+import { readFileSync, writeFileSync, createWriteStream, createReadStream, statSync, existsSync, watch } from 'fs';
 import { readFile, writeFile, readdir, stat, unlink, rmdir, chmod, mkdir, rename } from 'fs/promises';
 import { join, dirname, basename, resolve, isAbsolute, relative } from 'path';
 import { fileURLToPath, pathToFileURL } from 'url';
@@ -525,6 +525,8 @@ export function startServer() {
       agentOperationInProgress = true;
       lastOperationTime = Date.now();
       logSystem('shutdown', { reason: 'api_request', local: isLocal, remote: remoteIp });
+      // 写入主动停止标记，阻止 autostart 自动拉起
+      try { writeFileSync(join(homedir(), '.ai-helper-agent', '.stopped'), new Date().toISOString()); } catch {}
       jsonResponse(res, 200, { success: true, message: t('message.shuttingDown') });
       // 延迟 200ms 再关闭，确保响应数据已送达客户端（res.end() 仅写入缓冲区，不保证客户端已接收）
       setTimeout(() => shutdown(), 200);