myagent-ai 1.26.0 → 1.26.2

package/agents/main_agent.py

@@ -75,104 +75,58 @@ class MainAgent(BaseAgent):
 - <recall_memory>: 你在上一轮通过 <recall> 指定的记忆搜索结果。系统根据你提供的关键字和时间点搜索了 top5 相关记忆。
 - 两种记忆互补：automemory 是自动匹配的，recall_memory 是你主动指定搜索的。如果 automemory 不足，使用 <recall> 请求更多。
 3. 工具使用指南 — 只有两个工具: command 和 web_control
-4. 文件自动发送与下载链接: docx-create、xlsx-create、ppt-create、pdf-create、write 等命令执行成功后会**自动**将文件发送给用户（无需手动调用 send-file）。系统会返回包含下载链接的文件卡片，LLM 不需要自行拼接文件链接。仅在需要发送其他独立文件（如已存在的文件）时，才使用 myagent-ai send-file <文件路径> [描述]。向用户展示下载链接时，务必使用 Markdown 超链接格式: [文件名](完整URL)。
+4. 文件自动发送与下载链接: docx-create、xlsx-create、ppt-create、pdf-create 等命令执行成功后会**自动**将文件发送给用户（无需手动调用 send-file）。系统会返回包含下载链接的文件卡片，LLM 不需要自行拼接文件链接。仅在需要发送其他独立文件（如已存在的文件）时，才使用 myagent-ai send-file <文件路径> [描述]。向用户展示下载链接时，务必使用 Markdown 超链接格式: [文件名](完整URL)。
 
 **command**（执行命令行，所有操作都通过它完成）:
   <tool><toolname>command</toolname><parms>{"command": "要执行的命令"}</parms><timeout>超时秒数</timeout></tool>
 
-所有 CLI 命令 (通过 command 工具调用 myagent-ai):
+【重要】命令执行规则:
+- Shell 原生命令（ls/cat/grep/ps/df/uname/python3/pip/npm/git/curl/wget 等）直接执行，不要加任何前缀
+- 文件读写直接用 cat/tee/python3 等，不要用 myagent-ai read/write
+- 只有下面的 myagent 专有命令才需要 myagent-ai 前缀
+- 多个命令可用 && 连接一次执行（减少回调次数）
 
-【感知】
+【myagent 专有命令】（需要 myagent-ai 前缀）:
+
+感知:
 - OCR 文字识别: myagent-ai ocr 图片路径 [ch|en]
-- 图片分析(VLM): myagent-ai analyze-image 图片路径 [分析提示词]
+- 图片分析(VLM): myagent-ai analyze-image 图片路径 [提示词]
 - 语音转文字: myagent-ai transcribe 音频路径 [zh|en|ja]
 
-【搜索】
+搜索:
 - 网络搜索: myagent-ai search 关键词 [-n 数量]
-- 读取网页: myagent-ai read-url URL [--raw]
-- 获取URL原始内容(API): myagent-ai fetch-url URL [-m METHOD] [-H 'Key:Val'] [-d DATA]
-
-【文件操作】
-- 读文件: myagent-ai read 文件路径 [--offset N] [--limit N]
-- 写文件: myagent-ai write 文件路径 -c "内容" [--append]
-- 列出目录: myagent-ai ls 目录 [-p "*.py"] [-r] [--max N]
-- 删除: myagent-ai rm 路径 [-r]
-- 搜索文件内容: myagent-ai grep 关键词 目录 [-p "*.py"]
-- 移动/重命名: myagent-ai mv 源路径 目标路径
-- 发送文件给用户: myagent-ai send-file 文件路径 描述
+- 读取网页: myagent-ai read-url URL
+- 获取URL内容(API): myagent-ai fetch-url URL [-m METHOD] [-H 'Key:Val'] [-d DATA]
 
-【文档生成】
-- 创建Word: myagent-ai docx-create -c '{JSON内容}' -t 标题 (自动发送文件)
+文档生成 (执行后自动发送文件给用户):
+- 创建Word: myagent-ai docx-create -c '{JSON}' -t 标题
 - 读取Word: myagent-ai docx-read 文件.docx
-- 创建Excel: myagent-ai xlsx-create -s '{JSON工作表}' -t 标题 (自动发送文件)
+- 创建Excel: myagent-ai xlsx-create -s '{JSON}' -t 标题
 - 读取Excel: myagent-ai xlsx-read 文件.xlsx [--sheet 名称]
 - 编辑Excel: myagent-ai xlsx-edit 文件.xlsx append-row -d '{JSON}'
-- 创建PPT: myagent-ai ppt-create -s '{JSON幻灯片}' (自动发送文件)
+- 创建PPT: myagent-ai ppt-create -s '{JSON幻灯片}'
 - 读取PPT: myagent-ai ppt-read 文件.pptx
-- 创建PDF: myagent-ai pdf-create -c '{JSON内容}' (自动发送文件)
-- 读取PDF: myagent-ai pdf-read 文件.pdf [--start N] [--end N]
-
-【系统】
-- 系统信息: myagent-ai sysinfo
-- 列出进程: myagent-ai ps [--filter 名称] [--limit N]
-- 环境变量: myagent-ai env [KEY]
-- 路径信息: myagent-ai pathinfo 路径
-
-【浏览器】
-- 打开网页: myagent-ai browser-open URL
-- 浏览器截图: myagent-ai browser-screenshot
-- 点击元素: myagent-ai browser-click CSS选择器
-- 填写输入: myagent-ai browser-fill CSS选择器 值
-- 执行JS: myagent-ai browser-eval 'JS代码'
-- 标签页管理: myagent-ai browser-navigate list|select|new|close
-- 关闭浏览器: myagent-ai browser-close
-
-【GUI桌面】(仅Windows/macOS桌面)
-- 屏幕截图: myagent-ai screenshot [区域] [-m 显示器]
-- 鼠标点击: myagent-ai mouse-click X Y [-b left] [-c 1]
-- 鼠标拖拽: myagent-ai mouse-drag X1 Y1 X2 Y2
-- 输入文本: myagent-ai type-text "文本" [--clear]
-- 快捷键: myagent-ai hotkey copy|paste|ctrl+c|alt+tab
-- 列出窗口: myagent-ai window-list [--filter 关键词]
-- 聚焦窗口: myagent-ai window-focus 标题 [--maximize]
-- 屏幕元素识别: myagent-ai screen-element 描述 [区域]
-
-【记忆】
-- 搜索记忆: myagent-ai memory [--keyword 关键词] [--limit N]
-
-【Agent间通信】
-- 向其他Agent发送消息: myagent-ai chat --agent <Agent路径> --message "消息内容"
-- 向其他Agent发送文件: myagent-ai chat --agent <Agent路径> --file "文件路径"
-- 同时发送消息和文件: myagent-ai chat --agent <路径> -m "消息" -f "文件路径"
-- 可同时发送多个文件: myagent-ai chat --agent <路径> -f "文件1|文件2|文件3"  （用|分隔多个文件路径）
-
-【压缩解压】
-- 压缩文件/文件夹: myagent-ai zip 路径1 [路径2] ... [-o 输出.zip] [--exclude __pycache__ *.pyc .git]
-- 解压zip文件: myagent-ai unzip 文件.zip [-o 输出目录]
-
-【媒体播放】
-- 播放音频: myagent-ai playaudio --url 音频URL [--title 标题] 或 myagent-ai playaudio --file 本地路径
-- 播放视频: myagent-ai playvideo --url 视频URL [--title 标题] 或 myagent-ai playvideo --file 本地路径
-
-【通用Shell命令】
-- 执行代码: python3 script.py 或 python3 -c "代码"
-- 文件列表: ls -la 目录
-- 系统信息: uname -a / df -h / free -h
+- 创建PDF: myagent-ai pdf-create -c '{JSON}' [-o 输出路径]
+- 读取PDF: myagent-ai pdf-read 文件.pdf
+
+浏览器 (Playwright):
+- 打开/截图/点击/填写/执行JS/标签页管理/关闭:
+  myagent-ai browser-open|browser-screenshot|browser-click|browser-fill|browser-eval|browser-navigate|browser-close
+
+GUI桌面 (仅Windows/macOS):
+- screenshot, mouse-click, mouse-drag, type-text, hotkey, window-list, window-focus, screen-element
+
+记忆/通信/媒体:
+- 搜索记忆: myagent-ai memory [--keyword 关键词]
+- Agent间通信: myagent-ai chat --agent <路径> -m "消息" [-f "文件"]
+- 发送文件给用户: myagent-ai send-file 文件路径 描述
+- 播放音频/视频: myagent-ai playaudio/playvideo --url URL [--title 标题]
 
 调用示例:
+  <tool><toolname>command</toolname><parms>{"command": "ls -la /tmp && df -h && python3 --version"}</parms><timeout>10</timeout></tool>
   <tool><toolname>command</toolname><parms>{"command": "myagent-ai search 人工智能最新进展"}</parms><timeout>15</timeout></tool>
   <tool><toolname>command</toolname><parms>{"command": "myagent-ai docx-create -c '{\"title\": \"报告\", \"sections\": [{\"heading\": \"摘要\", \"body\": \"内容\"}]}' -t 周报"}</parms><timeout>30</timeout></tool>
-  <tool><toolname>command</toolname><parms>{"command": "myagent-ai ppt-create -s '{JSON幻灯片}'"}</parms><timeout>30</timeout></tool>
-  <tool><toolname>command</toolname><parms>{"command": "myagent-ai playaudio --url https://music.163.com/song?id=123 --title 歌曲名"}</parms><timeout>10</timeout></tool>
-  <tool><toolname>command</toolname><parms>{"command": "myagent-ai playvideo --url https://www.bilibili.com/video/BV123 --title 视频名"}</parms><timeout>10</timeout></tool>
-  <tool><toolname>command</toolname><parms>{"command": "myagent-ai chat --agent default/coder --message \"请帮我分析这段代码的时间复杂度\""}</parms><timeout>10</timeout></tool>
-  <tool><toolname>command</toolname><parms>{"command": "myagent-ai chat --agent default/coder -f \"/path/to/report.pdf\" -m \"请审阅这份报告\""}</parms><timeout>10</timeout></tool>
-  <tool><toolname>command</toolname><parms>{"command": "myagent-ai zip /path/to/project -o backup.zip --exclude __pycache__ .git"}</parms><timeout>30</timeout></tool>
-  <tool><toolname>command</toolname><parms>{"command": "myagent-ai unzip /path/to/archive.zip -o ./output"}</parms><timeout>30</timeout></tool>
-
-多个命令可用 && 连接一次执行（强烈推荐，减少LLM回调次数）:
-  <tool><toolname>command</toolname><parms>{"command": "myagent-ai search xxx && myagent-ai read-url https://..."}</parms><timeout>30</timeout></tool>
-  <tool><toolname>command</toolname><parms>{"command": "myagent-ai sysinfo && myagent-ai ps --filter python"}</parms><timeout>15</timeout></tool>
+  <tool><toolname>command</toolname><parms>{"command": "cat /etc/os-release && uname -a && free -h"}</parms><timeout>10</timeout></tool>
 
 **file_send**（向用户发送文件，文件会以卡片形式显示在聊天中）:
   <tool><toolname>file_send</toolname><parms>{"file_path": "文件的绝对路径", "description": "文件描述（可选）"}</parms><timeout>30</timeout></tool>

package/core/context_builder.py

@@ -173,6 +173,7 @@ class ContextBuilder:
             self._build_task_plan(task_plan),
             self._build_tools(self.skill_registry),
             self._build_skill_prompts(self.skill_registry),
+            self._build_runtime_env(),
             self._build_exec_warnings(),
         ]
 
@@ -821,6 +822,64 @@ class ContextBuilder:
         """
         return ""
 
+    def _build_runtime_env(self) -> str:
+        """[v1.26.0] 构建运行环境信息段落 — 操作系统、Shell、可用工具链。"""
+        import os
+        import platform
+        import subprocess
+        import shutil
+
+        lines = ["<runtime_env>"]
+
+        # 操作系统
+        system = platform.system()
+        release = platform.release()
+        machine = platform.machine()
+        lines.append(f"操作系统: {system} {release} ({machine})")
+
+        # Shell 信息
+        shell_name = os.environ.get("SHELL", "")
+        if not shell_name and system == "Windows":
+            shell_name = os.environ.get("COMSPEC", "cmd.exe")
+        if shell_name:
+            lines.append(f"默认Shell: {shell_name}")
+
+        # 常用工具检测
+        useful_tools = []
+        for tool in ["python3", "python", "pip3", "pip", "node", "npm", "npx",
+                      "git", "curl", "wget", "bash", "zsh", "sh",
+                      "docker", "docker-compose", "ffmpeg", "jq", "tar", "zip", "unzip",
+                      "grep", "sed", "awk", "find", "cat", "head", "tail", "wc"]:
+            path = shutil.which(tool)
+            if path:
+                useful_tools.append(tool)
+        lines.append(f"可用命令: {', '.join(useful_tools)}")
+
+        # Python 版本
+        try:
+            result = subprocess.run(
+                ["python3", "--version"], capture_output=True, text=True, timeout=5
+            )
+            if result.returncode == 0:
+                lines.append(f"Python: {result.stdout.strip()}")
+        except Exception:
+            pass
+
+        # Node 版本
+        node_path = shutil.which("node")
+        if node_path:
+            try:
+                result = subprocess.run(
+                    ["node", "--version"], capture_output=True, text=True, timeout=5
+                )
+                if result.returncode == 0:
+                    lines.append(f"Node.js: {result.stdout.strip()}")
+            except Exception:
+                pass
+
+        lines.append("</runtime_env>")
+        return "\n".join(lines)
+
     def _build_exec_warnings(self) -> str:
         """[v1.23.44] 构建执行环境警告段落，提醒 Agent 避免常见错误。"""
         import os
@@ -844,8 +903,7 @@ class ContextBuilder:
             "- 禁止执行: bash start.sh / ./start.sh (同上，启动脚本)",
             "- 禁止执行: myagent-ai start / myagent-ai run (重复启动服务)",
             "- 如需测试 myagent 模块，请直接 import: python -c 'from agents.main_agent import MainAgent; ...'",
-            "- 如需搜索项目代码，请使用: myagent-ai grep &lt;关键词&gt; &lt;路径&gt; (注意: 不支持 -n/-i/-r 等系统 grep 参数)",
-            "- 如需操作文件，请使用: myagent-ai file-read / file-write / file-search 等 CLI 命令",
+            "- 文件操作请使用原生命令: cat, head, tail, grep, find 等",
             "</exec_warnings>",
         ]
         return "\n".join(lines)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "myagent-ai",
-  "version": "1.26.0",
+  "version": "1.26.2",
   "description": "本地桌面端执行型AI助手 - Open Interpreter 风格 | Local Desktop Execution-Oriented AI Assistant",
   "main": "main.py",
   "bin": {

package/skills/registry.py

@@ -33,11 +33,11 @@ logger = get_logger("myagent.skills")
 BUILTIN_TOOLS: List[Dict[str, Any]] = [
     {
         "name": "command",
-        "description": "执行 Shell 命令 — 所有操作（文件、搜索、文档生成、系统管理等）均通过此工具完成。LLM 通过 myagent-ai CLI 子命令调用各项能力。",
+        "description": "执行 Shell 命令 — 所有操作均通过此工具完成。Shell 原生命令（ls/cat/grep/ps/df/uname/python3/pip/npm/git 等）直接执行，不要加 myagent-ai 前缀。只有 myagent 专有命令（docx-create/search/ocr 等）才需要 myagent-ai 前缀。",
         "category": "platform",
         "handler": "ToolDispatcher._exec_command",
         "parameters": [
-            {"name": "command", "type": "string", "description": "Shell 命令（如 myagent-ai search xxx, python3 script.py 等）", "required": True},
+            {"name": "command", "type": "string", "description": "Shell 命令（如 ls -la, grep -r pattern dir, myagent-ai search xxx, python3 script.py 等）", "required": True},
         ],
     },
     {
@@ -134,18 +134,7 @@ CLI_COMMANDS: List[Dict[str, Any]] = [
     {"name": "fetch-url", "category": "search", "cli": "myagent-ai fetch-url <url> [-m METHOD] [-H 'K:V'] [-d DATA]",
      "description": "获取 URL 原始内容 (API 调用)"},
     # ── 文件操作 ──
-    {"name": "read", "category": "file", "cli": "myagent-ai read <path> [--offset N] [--limit N]",
-     "description": "读取文件内容"},
-    {"name": "write", "category": "file", "cli": "myagent-ai write <path> -c 'content' [--append]",
-     "description": "写入文件（自动触发文件发送）"},
-    {"name": "ls", "category": "file", "cli": "myagent-ai ls <dir> [-p '*.py'] [-r] [--max N]",
-     "description": "列出目录内容"},
-    {"name": "rm", "category": "file", "cli": "myagent-ai rm <path> [-r]",
-     "description": "删除文件或目录"},
-    {"name": "grep", "category": "file", "cli": "myagent-ai grep <query> <dir> [-p '*.py']",
-     "description": "搜索文件内容"},
-    {"name": "mv", "category": "file", "cli": "myagent-ai mv <source> <dest>",
-     "description": "移动/重命名文件"},
+    # [v1.26.1] read/write/ls/rm/grep/mv 为原生命令，直接用 cat/tee/ls/rm/grep/mv，不再包装
     {"name": "send-file", "category": "file", "cli": "myagent-ai send-file <path> [description]",
      "description": "发送文件给用户"},
     # ── 文档生成 ──
@@ -168,12 +157,7 @@ CLI_COMMANDS: List[Dict[str, Any]] = [
     {"name": "pdf-read", "category": "document", "cli": "myagent-ai pdf-read <path> [--start N] [--end N]",
      "description": "读取 PDF 文件内容"},
     # ── 系统 ──
-    {"name": "sysinfo", "category": "system", "cli": "myagent-ai sysinfo",
-     "description": "获取系统信息（OS/内存/磁盘/CPU）", "aliases": ["system-info"]},
-    {"name": "ps", "category": "system", "cli": "myagent-ai ps [--filter name] [--limit N]",
-     "description": "列出系统进程", "aliases": ["process-list"]},
-    {"name": "env", "category": "system", "cli": "myagent-ai env [KEY]",
-     "description": "获取环境变量"},
+    # [v1.26.1] sysinfo/ps/env 为原生命令，直接用 uname/ps/env/free/df 等，不再包装
     {"name": "pathinfo", "category": "system", "cli": "myagent-ai pathinfo <path>",
      "description": "获取路径详细信息"},
     # ── 浏览器 ──

package/start.js

@@ -19,7 +19,7 @@
  */
 "use strict";
 
-const { spawn, execSync, execFileSync } = require("child_process");
+const { spawn, spawnSync, execSync, execFileSync } = require("child_process");
 const path = require("path");
 const fs = require("fs");
 const os = require("os");
@@ -782,14 +782,15 @@ function main() {
   if (cmd === "reinstall") { cmdReinstall(pkgDir); return; }
   if (cmd === "install")   { cmdInstall(pkgDir); return; }
 
-  // [v1.22.0] CLI 子命令 — 轻量级，不需要完整启动 myagent
+  // [v1.26.0] CLI 子命令 — 仅保留 myagent 专有命令
+  // 原生命令 (ls/grep/cat/ps/cp/mv/rm/...) 直接透传 shell，不再包装
   const CLI_CMDS = [
     // 感知
     "ocr", "analyze-image", "transcribe",
     // 搜索
     "search", "read-url", "fetch-url",
-    // 文件操作
-    "read", "write", "ls", "rm", "grep", "mv", "send-file",
+    // 文件发送
+    "send-file",
     // 文档 - Word
     "docx-create", "docx-read",
     // 文档 - Excel
@@ -798,9 +799,6 @@ function main() {
     "ppt-create", "ppt-read",
     // 文档 - PDF
     "pdf-create", "pdf-read",
-    // 系统
-    "system-info", "sysinfo", "process-list", "ps",
-    "env", "pathinfo",
     // 浏览器
     "browser-open", "browser-screenshot", "browser-close",
     "browser-click", "browser-fill", "browser-eval", "browser-navigate",
@@ -813,8 +811,6 @@ function main() {
     "playaudio", "playvideo",
     // Agent 通信
     "chat",
-    // 压缩解压
-    "zip", "unzip",
     // 帮助
     "help", "-h", "--help",
   ];
@@ -858,7 +854,20 @@ function main() {
     return;
   }
 
-  // 默认: 直接启动
+  // [v1.26.1] 未知命令 → 透传 shell 执行（避免 myagent-ai ls -la 被误传给 main.py）
+  // 仅当无参数或以 -- 开头时才启动 myagent 服务
+  if (cmd && !cmd.startsWith("-")) {
+    const cmdStr = args.join(" ");
+    const result = spawnSync(
+      process.platform === "win32" ? "cmd.exe" : "bash",
+      [process.platform === "win32" ? "/c" : "-c", cmdStr],
+      { stdio: "inherit", env: process.env },
+    );
+    process.exit(result.status || 0);
+    return;
+  }
+
+  // 无参数 / --web / --tray / --server / --debug 等 → 启动 myagent 服务
   cmdRun(pkgDir, args);
 }