memi-agent 1.0.0 → 1.0.2

package/README.md

@@ -1,90 +1,239 @@
-# Memi Agent
-
-本地 AI 助手，终端 + 网页双模式，支持 DeepSeek/OpenAI/Anthropic 等模型。
-
-## 安装
-
-```bash
-git clone https://github.com/yourname/memi.git
-cd memi
-npm install --prefix memi-server
-npm install --prefix memi-client
-```
-
-## 启动
-
-```bash
-# 启动后端
-npm start --prefix memi-server
-
-# 启动前端（可选）
-npm run dev --prefix memi-client
-
-# 启动 CLI
-node memi-agent.js
-# 或用 .bat
-memi chat
-```
-
-## 配置
-
-```bash
-memi onboard    # 6 步新手引导
-```
-
-## 命令
-
-| 命令 | 说明 |
-|---|---|
-| `memi chat` | 进入对话 |
-| `memi status` | 查看配置 |
-| `memi skills` | 技能列表 |
-| `memi sessions` | 会话管理 |
-| `memi doctor` | 系统诊断 |
-| `memi agent` | Agent 信息 |
-| `memi dashboard` | 打开网页版 |
-| `memi onboard` | 重新配置 |
-| `memi update` | 检查更新 |
-| `memi version` | 版本 |
-| `memi help` | 帮助 |
-
-## 对话内命令
-
-| 命令 | 说明 |
-|---|---|
-| `/help` | 帮助 |
-| `/history` | 对话历史 |
-| `/sessions` | 会话列表 |
-| `/new` | 新建会话 |
-| `/load 名称` | 加载会话 |
-| `/save` | 保存会话 |
-| `/tools` | 工具调用记录 |
-| `/stats` | 会话统计 |
-| `/balance` | API 余额 |
-| `/think` | 思考强度 |
-| `/currency` | 切换币种 |
-| `/agent` | 智能体管理 |
-
-## ClawHub 兼容
-
-```bash
-npm i -g clawhub
-clawhub install weather    # 安装 OpenClaw 技能
-memi skills                # 自动识别
-```
-
-## 网页版
-
-`http://localhost:3001/dashboard`
-
-## 目录结构
-
-```
-memi/
-├── memi-agent.js        # CLI 入口
-├── memi.bat             # Windows 快捷启动
-├── memi-server/         # Express 后端
-├── memi-client/         # React 前端
-├── memi-config/         # 配置 & 技能 & 会话
-└── README.md
-```
+
+<p align="center">
+  <pre style="font-size: 12px; line-height: 1.2;">
+ __  __  ___  __  __  ___
+|  \/  || __||  \/  ||_ _|
+| |\/| || _| | |\/| | | |
+|_|  |_||___||_|  |_||___|
+  </pre>
+</p>
+
+<p align="center">
+  <strong>你的本地 AI 助手 — 终端、网页、聊天软件，无处不在。</strong>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/memi-agent"><img src="https://img.shields.io/npm/v/memi-agent?style=for-the-badge&color=6366f1" alt="npm version"></a>
+  <a href="https://github.com/memi-ai/memi/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="MIT License"></a>
+  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/Node-18+-green.svg?style=for-the-badge" alt="Node.js 18+"></a>
+  <a href="#docker"><img src="https://img.shields.io/badge/Docker-ready-2496ED?logo=docker&logoColor=white&style=for-the-badge" alt="Docker"></a>
+</p>
+
+**Memi** 是一个运行在你本机的个人 AI 助手。它在终端里跟你聊天，在网页上给你看板，还打通了 Telegram / 飞书 / 企业微信 / QQ —— 所有渠道共享同一个会话和记忆。
+
+支持 80+ AI 模型商（DeepSeek / OpenAI / Anthropic / 通义千问 / Moonshot / 智谱 …），自带 60+ 工具，兼容 ClawHub 技能生态。
+
+---
+
+## 快速开始
+
+```bash
+# 全局安装
+npm install -g memi-agent
+memi onboard
+
+# 或者一行搞定（无需安装）
+npx memi-agent onboard
+```
+
+`memi onboard` 会引导你完成模型配置、工作区初始化、渠道接入，**macOS / Linux / Windows** 都支持。
+
+启动后：
+
+```bash
+memi chat        # 终端对话
+memi dashboard   # 打开网页控制台 → http://localhost:3001/dashboard
+memi status      # 查看当前状态
+```
+
+---
+
+## 亮点
+
+- **双界面** — 终端 CLI + 网页 Dashboard，同一个后端，无缝切换。
+- **多渠道收件箱** — Telegram、飞书/Lark、企业微信、QQ，消息统一路由到 Agent 处理。
+- **60+ 工具** — 文件读写、命令执行、网络搜索、图片生成、HTTP 请求、系统信息、向量记忆搜索、浏览器自动化、网页抓取、定时提醒……
+- **ClawHub 兼容** — 直接安装 OpenClaw 社区的 Skill，`clawhub install` 即装即用。
+- **多 Agent 协作** — `@agent` 语法切换/协作，每个 Agent 可以有独立的 system prompt 和模型。
+- **12 步新手引导** — 交互式 onboard，配模型、装守护进程、接渠道，一条龙。
+- **系统守护进程** — schtasks (Windows) / launchd (macOS) / systemd (Linux) 一键安装，开机自启。
+- **网关安全** — `MEMI_GATEWAY_TOKEN` 鉴权，DM 白名单，避免未授权访问。
+- **工作区文档** — SOUL.md / MEMORY.md / USER.md / IDENTITY.md / TOOLS.md 每日注入 system prompt，保持记忆连续性。
+- **浏览器自动化** — Agent 可操控真实浏览器，打开网页、点击、截图。基于 Playwright。
+- **图片管道** — 文生图 → 视觉审查 → 自动重试，直到满意。
+- **会话管理** — 保存/加载/重命名会话，支持 `/stats` 统计 Token 用量和费用。
+- **80+ 模型商** — 兼容 OpenAI API 格式的所有提供商，一键切换。
+
+---
+
+## 渠道支持
+
+| 渠道 | 接入方式 | 配置命令 |
+|---|---|---|
+| Telegram | Webhook | `memi telegram <token>` |
+| 飞书 / Lark | Webhook + WebSocket 长连接 | `memi feishu <token>` |
+| 企业微信 | Webhook | `memi wecom <key>` |
+| QQ | Webhook (go-cqhttp) | `memi qq <token>` |
+
+所有渠道共享同一个 Agent 会话，在 Dashboard 里可以实时看到每条消息和工具调用。
+
+> **安全提示**：对外暴露前务必设置 `MEMI_GATEWAY_TOKEN` 环境变量，并配置渠道白名单。
+
+---
+
+## 命令参考
+
+### CLI 命令
+
+| 命令 | 说明 |
+|---|---|
+| `memi chat` | 进入交互对话 |
+| `memi onboard` | 12 步新手引导（模型/守护/渠道） |
+| `memi dashboard` | 打开网页控制台 |
+| `memi status` | 查看模型、端点、会话数、技能数 |
+| `memi skills` | 列出已安装技能 |
+| `memi sessions` | 列出所有会话 |
+| `memi doctor` | 系统诊断（Node 版本、API 连通性、服务状态） |
+| `memi agent` | 显示当前 Agent 信息 |
+| `memi config` | 查看配置；`memi config edit` 重新配置 |
+| `memi update` | 检查 GitHub Release 更新 |
+| `memi server start` | 启动后端服务 |
+| `memi browser install` | 安装 Playwright + Chromium |
+| `memi rag index` | 索引工作区文档为向量库 |
+| `memi rag search <query>` | 语义搜索工作区记忆 |
+| `memi daemon install` | 安装系统守护进程（开机自启） |
+| `memi version` | 显示版本号 |
+
+### 对话内斜杠命令
+
+| 命令 | 说明 |
+|---|---|
+| `/help` | 帮助信息 |
+| `/history` | 查看对话历史 |
+| `/sessions` | 会话列表 |
+| `/new` | 新建会话 |
+| `/load <name>` | 加载会话 |
+| `/save` | 保存当前会话 |
+| `/rename <name>` | 重命名会话 |
+| `/tools` | 工具调用记录 |
+| `/stats` | Token 用量与费用估算 |
+| `/balance` | API 余额查询 |
+| `/think off\|low\|medium\|high\|max` | 思考强度 |
+| `/currency` | 切换币种 (¥/$) |
+| `/clear` | 清空当前会话 |
+| `/agent list\|use\|add` | 多 Agent 管理 |
+| `/exit` | 退出对话 |
+
+---
+
+## 配置
+
+最小配置（`memi-config/config.json`）：
+
+```json5
+{
+  endpoint: "https://api.deepseek.com/v1",
+  apiKey: "sk-...",
+  model: "deepseek-chat",
+  port: 3001
+}
+```
+
+`memi onboard` 会交互式生成完整配置，包括渠道 Token、技能目录、工作区路径等。
+
+---
+
+## ClawHub 技能
+
+Memi 兼容 [ClawHub](https://clawhub.ai) 技能生态：
+
+```bash
+npm install -g clawhub
+clawhub install weather      # 安装天气技能
+memi skills                  # 自动识别并加载
+```
+
+也可以在对话中用 `/import_skill <url>` 从 GitHub 直接导入。
+
+---
+
+## 工作区文档
+
+这些文件放在 `memi-config/workspace/`，每天自动注入 Agent 的 system prompt，并支持向量搜索：
+
+| 文件 | 作用 |
+|---|---|
+| `SOUL.md` | Agent 人格定义 |
+| `MEMORY.md` | 长期记忆 |
+| `USER.md` | 用户偏好 |
+| `IDENTITY.md` | 身份设定 |
+| `TOOLS.md` | 工具使用说明 |
+
+Agent 可通过 `rag_search` 工具随时检索这些文档，无需占用每次对话的上下文窗口。
+
+---
+
+## 从源码运行
+
+```bash
+git clone https://github.com/memi-ai/memi.git
+cd memi
+
+npm install --prefix memi-server
+
+# 启动后端
+npm start --prefix memi-server
+
+# 新开终端，启动 CLI
+node memi-agent.js chat
+```
+
+---
+
+## Docker
+
+```bash
+# 克隆仓库
+git clone https://github.com/memi-ai/memi.git
+cd memi
+
+# 一键启动
+docker compose up -d
+
+# 或者单独构建
+docker build -t memi-agent .
+docker run -d -p 3001:3001 -v memi-config:/app/memi-config memi-agent
+```
+
+访问 `http://localhost:3001/dashboard`。
+
+---
+
+## 技术栈
+
+| 层 | 技术 |
+|---|---|
+| CLI | Node.js (CommonJS) |
+| 后端 | Express + WebSocket |
+| 前端 | React (memi-client) + 原生 HTML Dashboard |
+| AI 协议 | OpenAI-compatible `/v1/chat/completions` |
+| 浏览器 | Playwright (Chromium) — 可选，按需安装 |
+| 图片 | pollinations.ai + 视觉审查循环 |
+| 平台 | Windows / macOS / Linux |
+
+---
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=memi-ai/memi&type=date&legend=top-left)](https://www.star-history.com/#memi-ai/memi&type=date&legend=top-left)
+
+---
+
+## 社区
+
+- Issues & PR: [github.com/memi-ai/memi](https://github.com/memi-ai/memi)
+- AI/vibe-coded PRs welcome! 🤖
+
+---
+
+MIT © 2025 Memi

package/memi-agent.js

@@ -1079,7 +1079,7 @@ const cmd = process.argv[2] || "chat";
     case "update":
       out(A.g + "  检查更新... ");
       try {
-        const r = await fetch("https://api.github.com/repos/YOURNAME/memi/releases/latest", { signal: AbortSignal.timeout(8000) });
+        const r = await fetch("https://api.github.com/repos/memi-ai/memi/releases/latest", { signal: AbortSignal.timeout(8000) });
         if (!r.ok) throw new Error("HTTP " + r.status);
         const d = await r.json();
         const latest = (d.tag_name || "").replace(/^v/, "");
@@ -1159,6 +1159,53 @@ const cmd = process.argv[2] || "chat";
         log("");
       } catch { fail("无法读取"); }
       break;
+    case "rag": {
+      const sub = process.argv[3];
+      if (sub === "index") {
+        log(A.b + "  索引中..." + A.r);
+        try {
+          const { indexWorkspace } = require("./memi-server/utils/vectorStore");
+          const c = loadCfg();
+          const r = await indexWorkspace(c);
+          if (r) ok(`已索引 ${r.chunks} 个文本块` + (r.embedded > 0 ? ` (${r.embedded} 已嵌入)` : ""));
+          else fail("索引失败");
+        } catch(e) { fail("索引失败: " + e.message); }
+      } else if (sub === "search") {
+        const query = process.argv.slice(4).join(" ");
+        if (!query) { log(A.g + "  用法: memi rag search <查询语句>"); break; }
+        try {
+          const { search } = require("./memi-server/utils/vectorStore");
+          const c = loadCfg();
+          const result = await search(query, c);
+          log(A.b + "\n  RAG 搜索: " + query + "\n" + A.r);
+          log(result);
+        } catch(e) { fail("搜索失败: " + e.message); }
+      } else if (sub === "stats") {
+        try {
+          const { stats } = require("./memi-server/utils/vectorStore");
+          const s = stats();
+          log(A.b + "\n  向量库统计\n" + A.r);
+          log(`  文档块: ${s.chunks}`);
+          log(`  来源文件: ${s.sources.join(", ") || "无"}`);
+          log(`  总字符: ${s.totalChars}`);
+          log(`  向量嵌入: ${s.hasEmbeddings ? "✓" : "✗ (使用关键词匹配)"}`);
+          log("");
+        } catch(e) { fail("统计失败: " + e.message); }
+      } else if (sub === "clear") {
+        try {
+          const { clearIndex } = require("./memi-server/utils/vectorStore");
+          clearIndex();
+          ok("向量索引已清除");
+        } catch(e) { fail("清除失败: " + e.message); }
+      } else {
+        log(A.b + "  memi rag <子命令>\n" + A.r);
+        log(`  ${A.ck}index${A.r}    索引工作区文档`);
+        log(`  ${A.ck}search${A.r}   搜索记忆  ${A.g}memi rag search <查询语句>${A.r}`);
+        log(`  ${A.ck}stats${A.r}    向量库统计`);
+        log(`  ${A.ck}clear${A.r}    清除索引`);
+      }
+      break;
+    }
     case "doctor": {
       let ok = true;
       log(A.b + "\n  Memi Doctor  —  诊断报告\n");
@@ -1343,6 +1390,31 @@ const cmd = process.argv[2] || "chat";
       } catch(e) { fail("打包失败: " + e.message); }
       break;
     }
+    case "browser": {
+      const sub = process.argv[3];
+      if (sub === "install") {
+        log(A.b + "  安装 Playwright + Chromium..." + A.r);
+        try {
+          const { installBrowser } = require("./memi-server/utils/browser");
+          const result = await installBrowser();
+          ok(result);
+        } catch(e) { fail("安装失败: " + e.message); }
+      } else if (sub === "test") {
+        try {
+          const { navigate, closeBrowser } = require("./memi-server/utils/browser");
+          const result = await navigate("https://example.com");
+          log(A.b + "\n  Browser Test\n" + A.r);
+          log(result.slice(0, 500));
+          await closeBrowser();
+          ok("浏览器测试通过 ✓");
+        } catch(e) { fail("测试失败: " + e.message); }
+      } else {
+        log(A.b + "  memi browser <子命令>\n" + A.r);
+        log(`  ${A.ck}install${A.r}  安装 Playwright + Chromium`);
+        log(`  ${A.ck}test${A.r}     测试浏览器是否可用`);
+      }
+      break;
+    }
     case "help": case "--help": case "-h":
       log(A.b + "\n  Memi Agent CLI\n");
       log(`  ${A.ck}chat${A.r}      对话`);
@@ -1351,9 +1423,9 @@ const cmd = process.argv[2] || "chat";
       log(`  ${A.ck}reset${A.r}    重置     ${A.ck}config${A.r}   配置`);
       log(`  ${A.ck}server${A.r}   服务     ${A.ck}skills${A.r}   技能`);
       log(`  ${A.ck}dashboard${A.r}面板     ${A.ck}sessions${A.r} 会话`);
-      log(`  ${A.ck}daemon${A.r}   守护进程  ${A.ck}update${A.r}   更新`);
+      log(`  ${A.ck}rag${A.r}      向量记忆  ${A.ck}daemon${A.r}   守护`);
+      log(`  ${A.ck}browser${A.r}  浏览器    ${A.ck}update${A.r}   更新`);
       log(`  ${A.ck}version${A.r}  版本     ${A.ck}help${A.r}     帮助`);
-      log(`  ${A.ck}help${A.r}     帮助`);
       log("");
       break;
     default:

package/memi-server/index.js

@@ -149,4 +149,12 @@ wss.on("connection", (ws) => {
 server.listen(PORT, () => {
   console.log(`memi-server is running on port ${PORT}`);
   console.log(`WebSocket: ws://localhost:${PORT}/api/gateway/ws`);
+
+  // 自动索引工作区文档（异步，不阻塞启动）
+  try {
+    const { indexWorkspace } = require("./utils/vectorStore");
+    indexWorkspace().then(r => {
+      if (r && r.chunks > 0) console.log(`[RAG] 向量索引完成: ${r.chunks} 块, ${r.embedded} 已嵌入`);
+    }).catch(() => {});
+  } catch {}
 });

package/memi-server/utils/agent.js

@@ -871,6 +871,120 @@ const TOOLS = [
       }
     },
   },
+  {
+    name: "rag_search",
+    description:
+      "在工作区文档中执行语义搜索。传入查询语句，返回最相关的文档片段（SOUL.md / MEMORY.md / USER.md / IDENTITY.md / TOOLS.md）。\n" +
+      "适用场景：用户问「我之前说过什么」「我的偏好是什么」「Agent 的人设是什么」等问题时，用此工具检索长期记忆。",
+    parameters: {
+      type: "object",
+      properties: {
+        query: { type: "string", description: "搜索查询语句" },
+      },
+      required: ["query"],
+    },
+    handler: async (args) => {
+      try {
+        const configPath = path.join(__dirname, "..", "..", "memi-config", "config.json");
+        let config = {};
+        try { config = JSON.parse(fs.readFileSync(configPath, "utf8")); } catch {}
+        const { search } = require("./vectorStore");
+        return await search(args.query, config);
+      } catch (e) {
+        return "RAG 搜索失败: " + e.message;
+      }
+    },
+  },
+  {
+    name: "rag_index",
+    description:
+      "重建工作区文档的向量索引。当工作区文档（SOUL.md 等）被修改后，需要重新索引。此工具会读取所有工作区文档并建立向量搜索库。",
+    parameters: {
+      type: "object",
+      properties: {},
+      required: [],
+    },
+    handler: async () => {
+      try {
+        const configPath = path.join(__dirname, "..", "..", "memi-config", "config.json");
+        let config = {};
+        try { config = JSON.parse(fs.readFileSync(configPath, "utf8")); } catch {}
+        const { indexWorkspace } = require("./vectorStore");
+        const r = await indexWorkspace(config);
+        return `向量索引已重建：${r.chunks} 个文本块，${r.embedded} 个已嵌入向量。`;
+      } catch (e) {
+        return "索引失败: " + e.message;
+      }
+    },
+  },
+  {
+    name: "browser_navigate",
+    description:
+      "打开一个网页并获取其文本内容。url 是完整的网页地址（带 https://），返回页面标题和文本摘要。" +
+      "适用场景：用户要求查看某个网页、获取在线文档内容、抓取信息等。",
+    parameters: {
+      type: "object",
+      properties: {
+        url: { type: "string", description: "完整网页地址，例如 https://example.com" },
+      },
+      required: ["url"],
+    },
+    handler: async (args) => {
+      try {
+        const { navigate } = require("./browser");
+        return await navigate(args.url);
+      } catch (e) {
+        if (e.message && e.message.includes("Playwright 未安装")) {
+          return e.message;
+        }
+        return "浏览器导航失败: " + e.message;
+      }
+    },
+  },
+  {
+    name: "browser_screenshot",
+    description:
+      "对当前浏览器页面截图。返回截图文件路径。适用场景：用户要求看某个页面的样子、验证页面显示等。",
+    parameters: {
+      type: "object",
+      properties: {},
+      required: [],
+    },
+    handler: async () => {
+      try {
+        const { screenshot } = require("./browser");
+        return await screenshot();
+      } catch (e) {
+        if (e.message && e.message.includes("Playwright 未安装")) {
+          return e.message;
+        }
+        return "截图失败: " + e.message;
+      }
+    },
+  },
+  {
+    name: "browser_click",
+    description:
+      "在浏览器页面上点击一个元素。selector 是 CSS 选择器（例如 '#submit' 或 '.btn-primary'）。点击后返回新页面内容。",
+    parameters: {
+      type: "object",
+      properties: {
+        selector: { type: "string", description: "CSS 选择器，如 '#login' 或 'button.submit'" },
+      },
+      required: ["selector"],
+    },
+    handler: async (args) => {
+      try {
+        const { click } = require("./browser");
+        return await click(args.selector);
+      } catch (e) {
+        if (e.message && e.message.includes("Playwright 未安装")) {
+          return e.message;
+        }
+        return "点击失败: " + e.message;
+      }
+    },
+  },
 ];
 
 // ─── Agent 循环（提示词驱动工具调用）─────────────

package/memi-server/utils/browser.js

@@ -0,0 +1,123 @@
+// ╔══════════════════════════════════════════════════════════╗
+// ║  Memi Browser — Playwright 浏览器自动化                    ║
+// ║  Agent 可操控真实浏览器：导航、点击、输入、截图             ║
+// ╚══════════════════════════════════════════════════════════╝
+
+const fs = require("fs");
+const path = require("path");
+
+let browser = null;
+let page = null;
+let playwright = null;
+
+// ─── 懒加载 Playwright ───────────────────────────────────
+async function ensurePlaywright() {
+  if (playwright) return playwright;
+  try {
+    playwright = require("playwright");
+  } catch {
+    throw new Error(
+      "Playwright 未安装。请运行: npm install playwright && npx playwright install chromium\n" +
+      "或运行: memi browser install"
+    );
+  }
+  return playwright;
+}
+
+// ─── 启动浏览器 ──────────────────────────────────────────
+async function ensureBrowser(headless = true) {
+  const pw = await ensurePlaywright();
+  if (!browser || !browser.isConnected()) {
+    browser = await pw.chromium.launch({
+      headless,
+      args: ["--no-sandbox", "--disable-setuid-sandbox", "--disable-dev-shm-usage"],
+    });
+    page = await browser.newPage();
+    await page.setViewportSize({ width: 1280, height: 800 });
+  }
+  return { browser, page };
+}
+
+// ─── 关闭浏览器 ──────────────────────────────────────────
+async function closeBrowser() {
+  try {
+    if (page) { await page.close().catch(() => {}); page = null; }
+    if (browser) { await browser.close().catch(() => {}); browser = null; }
+  } catch {}
+}
+
+// ─── 导航 ────────────────────────────────────────────────
+async function navigate(url, timeout = 30000) {
+  const { page } = await ensureBrowser();
+  await page.goto(url, { waitUntil: "domcontentloaded", timeout });
+  const title = await page.title();
+  const text = await page.evaluate(() => document.body.innerText.slice(0, 5000));
+  return `**${title}**\n${text}`;
+}
+
+// ─── 点击 ────────────────────────────────────────────────
+async function click(selector) {
+  const { page } = await ensureBrowser();
+  await page.waitForSelector(selector, { timeout: 10000 });
+  await page.click(selector);
+  await page.waitForLoadState("domcontentloaded").catch(() => {});
+  const title = await page.title();
+  const text = await page.evaluate(() => document.body.innerText.slice(0, 3000));
+  return `点击后页面: **${title}**\n${text}`;
+}
+
+// ─── 输入 ────────────────────────────────────────────────
+async function typeText(selector, text) {
+  const { page } = await ensureBrowser();
+  await page.waitForSelector(selector, { timeout: 10000 });
+  await page.fill(selector, text);
+  return `已在 ${selector} 中输入: ${text.slice(0, 200)}`;
+}
+
+// ─── 截图 ────────────────────────────────────────────────
+async function screenshot(fullPage = true) {
+  const { page } = await ensureBrowser();
+  const buf = await page.screenshot({ fullPage, type: "png" });
+  // 保存到 memi-config
+  const dir = path.join(__dirname, "..", "..", "memi-config");
+  const fname = `screenshot_${Date.now()}.png`;
+  const fpath = path.join(dir, fname);
+  fs.writeFileSync(fpath, buf);
+  return `截图已保存: ${fpath} (${(buf.length / 1024).toFixed(1)} KB)`;
+}
+
+// ─── 获取页面内容 ────────────────────────────────────────
+async function getContent() {
+  const { page } = await ensureBrowser();
+  const title = await page.title();
+  const url = page.url();
+  const text = await page.evaluate(() => document.body.innerText.slice(0, 8000));
+  return `**${title}**\nURL: ${url}\n\n${text}`;
+}
+
+// ─── 执行 JS ─────────────────────────────────────────────
+async function evaluate(script) {
+  const { page } = await ensureBrowser();
+  const result = await page.evaluate(script);
+  return JSON.stringify(result).slice(0, 5000);
+}
+
+// ─── 安装 Playwright ─────────────────────────────────────
+async function installBrowser() {
+  const { execSync } = require("child_process");
+  const cwd = path.join(__dirname, "..");
+  try {
+    console.log("安装 playwright...");
+    execSync("npm install playwright", { cwd, stdio: "inherit" });
+    console.log("安装 Chromium...");
+    execSync("npx playwright install chromium", { cwd, stdio: "inherit" });
+    return "Playwright + Chromium 安装完成！现在可以使用浏览器工具了。";
+  } catch (e) {
+    throw new Error("安装失败: " + e.message);
+  }
+}
+
+module.exports = {
+  navigate, click, typeText, screenshot, getContent, evaluate,
+  closeBrowser, installBrowser, ensurePlaywright
+};

package/memi-server/utils/vectorStore.js

@@ -0,0 +1,218 @@
+// ╔══════════════════════════════════════════════════════════╗
+// ║  Memi Vector Store — 向量记忆 / RAG 引擎                  ║
+// ║  嵌入工作区文档，支持语义搜索                               ║
+// ╚══════════════════════════════════════════════════════════╝
+
+const fs = require("fs");
+const path = require("path");
+
+const CONFIG_DIR = path.join(__dirname, "..", "..", "memi-config");
+const VECTOR_FILE = path.join(CONFIG_DIR, "vectors.json");
+const CHUNK_SIZE = 500; // 每块最多 500 字符
+const TOP_K = 5;
+
+// ─── 读取配置 ────────────────────────────────────────────
+function readConfig() {
+  try {
+    const raw = fs.readFileSync(path.join(CONFIG_DIR, "config.json"), "utf8");
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+
+// ─── 获取嵌入向量 ───────────────────────────────────────
+async function getEmbedding(text, config) {
+  if (!config) config = readConfig();
+  if (!config || !config.apiKey) throw new Error("未配置 API Key");
+
+  const endpoint = (config.api1?.baseUrl || "https://api.deepseek.com/v1").replace(/\/$/, "");
+  const apiKey = config.api1?.apiKey || config.apiKey;
+  // 优先用 embedding 模型，否则用对话模型（DeepSeek 不支持 embedding，用 OpenAI 兼容端点）
+  const model = config.embeddingModel || "text-embedding-3-small";
+
+  try {
+    const axios = require("axios");
+    const resp = await axios.post(
+      `${endpoint}/embeddings`,
+      { model, input: text },
+      { headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" }, timeout: 30000 }
+    );
+    return resp.data?.data?.[0]?.embedding;
+  } catch (e) {
+    // 如果 embedding API 失败，回退到简单的关键词匹配模式
+    console.warn("Embedding API 不可用，使用关键词匹配模式:", e.message);
+    return null;
+  }
+}
+
+// ─── 余弦相似度 ─────────────────────────────────────────
+function cosineSimilarity(a, b) {
+  if (!a || !b || a.length !== b.length) return 0;
+  let dot = 0, na = 0, nb = 0;
+  for (let i = 0; i < a.length; i++) {
+    dot += a[i] * b[i];
+    na += a[i] * a[i];
+    nb += b[i] * b[i];
+  }
+  const denom = Math.sqrt(na) * Math.sqrt(nb);
+  return denom === 0 ? 0 : dot / denom;
+}
+
+// ─── 简单关键词匹配（无 embedding API 时的回退）─────────
+function keywordMatch(query, chunks) {
+  const terms = query.toLowerCase().split(/\s+/).filter(t => t.length > 1);
+  return chunks.map((chunk, idx) => {
+    const text = chunk.text.toLowerCase();
+    let score = 0;
+    for (const term of terms) {
+      if (text.includes(term)) score += 1;
+      // 部分匹配加分
+      for (let i = 0; i < term.length - 1; i++) {
+        if (text.includes(term.slice(i, i + 2))) score += 0.1;
+      }
+    }
+    return { idx, score, chunk };
+  }).sort((a, b) => b.score - a.score);
+}
+
+// ─── 分块 ───────────────────────────────────────────────
+function chunkText(text, source) {
+  const chunks = [];
+  const paragraphs = text.split(/\n\n+/);
+  let current = "";
+
+  for (const para of paragraphs) {
+    if ((current + para).length > CHUNK_SIZE && current.length > 0) {
+      chunks.push({ text: current.trim(), source });
+      current = para;
+    } else {
+      current += (current ? "\n\n" : "") + para;
+    }
+  }
+  if (current.trim()) chunks.push({ text: current.trim(), source });
+
+  return chunks;
+}
+
+// ─── 索引工作区文档 ─────────────────────────────────────
+async function indexWorkspace(config) {
+  if (!config) config = readConfig();
+  const wsDir = path.join(CONFIG_DIR, "workspace");
+  const files = ["SOUL.md", "MEMORY.md", "USER.md", "IDENTITY.md", "TOOLS.md"];
+
+  const allChunks = [];
+  for (const file of files) {
+    const fpath = path.join(wsDir, file);
+    if (!fs.existsSync(fpath)) continue;
+    const text = fs.readFileSync(fpath, "utf8");
+    const chunks = chunkText(text, file);
+    for (const c of chunks) allChunks.push(c);
+  }
+
+  // 尝试获取嵌入
+  const needsEmbedding = config && config.apiKey;
+  let vectors = [];
+
+  if (needsEmbedding) {
+    for (let i = 0; i < allChunks.length; i++) {
+      const emb = await getEmbedding(allChunks[i].text, config);
+      vectors.push({ id: i, text: allChunks[i].text, source: allChunks[i].source, embedding: emb });
+    }
+  } else {
+    vectors = allChunks.map((c, i) => ({ id: i, text: c.text, source: c.source, embedding: null }));
+  }
+
+  // 写入文件
+  try {
+    fs.writeFileSync(VECTOR_FILE, JSON.stringify(vectors, null, 2));
+  } catch {}
+
+  return { chunks: vectors.length, embedded: vectors.filter(v => v.embedding).length };
+}
+
+// ─── 搜索 ───────────────────────────────────────────────
+async function search(query, config, topK = TOP_K) {
+  if (!config) config = readConfig();
+
+  // 加载向量库
+  let vectors = [];
+  if (fs.existsSync(VECTOR_FILE)) {
+    try {
+      vectors = JSON.parse(fs.readFileSync(VECTOR_FILE, "utf8"));
+    } catch {}
+  }
+
+  if (vectors.length === 0) {
+    return "向量库为空。请先运行 `memi rag index` 索引工作区文档。";
+  }
+
+  // 如果有 embedding，用向量搜索
+  if (vectors[0]?.embedding) {
+    const qEmb = await getEmbedding(query, config);
+    if (qEmb) {
+      const scored = vectors
+        .map(v => ({ ...v, score: cosineSimilarity(qEmb, v.embedding) }))
+        .sort((a, b) => b.score - a.score)
+        .slice(0, topK);
+
+      return scored.map((s, i) =>
+        `**${s.source}** (相似度: ${(s.score * 100).toFixed(1)}%)\n${s.text.slice(0, 500)}`
+      ).join("\n\n---\n\n");
+    }
+  }
+
+  // 回退：关键词匹配
+  const results = keywordMatch(query, vectors).slice(0, topK);
+  return results.map((r, i) =>
+    `**${r.chunk.source}** (匹配度: ${r.score.toFixed(1)})\n${r.chunk.text.slice(0, 500)}`
+  ).join("\n\n---\n\n");
+}
+
+// ─── 添加文档 ───────────────────────────────────────────
+async function addDocument(name, text, config) {
+  if (!config) config = readConfig();
+
+  const chunks = chunkText(text, name);
+  let vectors = [];
+
+  if (fs.existsSync(VECTOR_FILE)) {
+    try { vectors = JSON.parse(fs.readFileSync(VECTOR_FILE, "utf8")); } catch {}
+  }
+
+  const startId = vectors.length;
+  for (let i = 0; i < chunks.length; i++) {
+    const emb = config?.apiKey ? await getEmbedding(chunks[i].text, config) : null;
+    vectors.push({ id: startId + i, text: chunks[i].text, source: name, embedding: emb });
+  }
+
+  try {
+    fs.writeFileSync(VECTOR_FILE, JSON.stringify(vectors, null, 2));
+  } catch {}
+
+  return chunks.length;
+}
+
+// ─── 清除索引 ───────────────────────────────────────────
+function clearIndex() {
+  if (fs.existsSync(VECTOR_FILE)) fs.unlinkSync(VECTOR_FILE);
+}
+
+// ─── 统计 ───────────────────────────────────────────────
+function stats() {
+  if (!fs.existsSync(VECTOR_FILE)) return { chunks: 0, sources: [], totalChars: 0, hasEmbeddings: false };
+  try {
+    const vectors = JSON.parse(fs.readFileSync(VECTOR_FILE, "utf8"));
+    const sources = [...new Set(vectors.map(v => v.source))];
+    return {
+      chunks: vectors.length,
+      sources,
+      totalChars: vectors.reduce((sum, v) => sum + v.text.length, 0),
+      hasEmbeddings: vectors.some(v => v.embedding),
+    };
+  } catch {
+    return { chunks: 0, sources: [], totalChars: 0, hasEmbeddings: false };
+  }
+}
+
+module.exports = { indexWorkspace, search, addDocument, clearIndex, stats, getEmbedding };

package/package.json

@@ -1,8 +1,11 @@
 {
   "name": "memi-agent",
-  "version": "1.0.0",
-  "description": "本地 AI 助手 — 终端 + 网页双模式，63 个工具，80+ 提供商，4 个消息渠道",
-  "bin": { "memi": "memi-agent.js" },
+  "version": "1.0.2",
+  "description": "本地 AI 助手 — 终端 + 网页双模式，65+ 工具（含浏览器自动化、向量记忆搜索），80+ 模型商，4 个消息渠道，ClawHub 兼容，Docker 支持",
+  "bin": {
+    "memi": "memi-agent.js",
+    "memi-agent": "memi-agent.js"
+  },
   "files": [
     "memi-agent.js",
     "README.md",
@@ -15,13 +18,32 @@
     "memi-server/utils/agent.js",
     "memi-server/utils/aiProxy.js",
     "memi-server/utils/importSkill.js",
+    "memi-server/utils/vectorStore.js",
+    "memi-server/utils/browser.js",
     "memi-client/dist/",
     "memi-config/workspace/"
   ],
   "scripts": {
     "postinstall": "cd memi-server && npm install --omit=dev"
   },
-  "keywords": ["ai", "agent", "cli", "llm", "deepseek", "openai"],
+  "keywords": [
+    "ai",
+    "agent",
+    "cli",
+    "llm",
+    "deepseek",
+    "openai"
+  ],
   "license": "MIT",
-  "engines": { "node": ">=18" }
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/memi-ai/memi.git"
+  },
+  "bugs": {
+    "url": "https://github.com/memi-ai/memi/issues"
+  },
+  "homepage": "https://github.com/memi-ai/memi#readme",
+  "engines": {
+    "node": ">=18"
+  }
 }