Moss 系统基础工具

简介

Moss 系统基础工具是一套本地系统能力插件，让 AI 员工能帮你查时间、看系统信息、列目录、读文件、执行 CMD 命令、查看网络配置。

内置 Python，解压即用，无需填 Token 或邮箱。 推荐 Windows 使用。

包含能力

安装步骤

1. 下载解压

下载 Windows 版，解压到固定目录，例如：

D:\moss-plugins\system-tools\

解压后应包含：greeting_plugin.py、run.bat、python/ 文件夹。

2. 测试

在插件目录打开命令行，执行：

run.bat --action time

看到 "success": true 即表示安装成功。

其他测试命令：

run.bat --action system
run.bat --action dir --path "D:\开发项目"
run.bat --action network
run.bat --action exec --command "ipconfig"
run.bat --action file --filepath "D:\test.txt"

注册技能（6 个，供 AI 调用）

打开 Moss 工作台 → 技能 → 添加技能。

所有技能共用同一个脚本路径（改成你的实际路径）：

D:\moss-plugins\system-tools\run.bat

技能 1：get_time

技能名称： get_time

技能描述： 获取当前系统时间。当用户询问现在几点、当前日期时间时使用。

脚本路径： D:\moss-plugins\system-tools\run.bat

参数 JSON：

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "description": "操作类型，固定为 time",
      "enum": ["time"]
    }
  },
  "required": ["action"]
}

技能 2：get_system_info

技能名称： get_system_info

技能描述： 获取系统信息，包括计算机名、用户名、操作系统等。

脚本路径： D:\moss-plugins\system-tools\run.bat

参数 JSON：

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "description": "操作类型，固定为 system",
      "enum": ["system"]
    }
  },
  "required": ["action"]
}

技能 3：exec_cmd

技能名称： exec_cmd

技能描述： 执行 CMD 命令，可用于 dir、ipconfig、echo 等系统管理操作。AI 会从用户描述中提取要执行的命令。

脚本路径： D:\moss-plugins\system-tools\run.bat

参数 JSON：

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "description": "操作类型，固定为 exec",
      "enum": ["exec"]
    },
    "command": {
      "type": "string",
      "description": "要执行的 CMD 命令，如 dir、ipconfig、echo hello"
    }
  },
  "required": ["action", "command"]
}

注意：此技能可执行任意 CMD 命令，请仅在可信环境使用。

技能 4：list_dir

技能名称： list_dir

技能描述： 列出指定目录下的文件和文件夹。

脚本路径： D:\moss-plugins\system-tools\run.bat

参数 JSON：

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "description": "操作类型，固定为 dir",
      "enum": ["dir"]
    },
    "path": {
      "type": "string",
      "description": "要列出的目录路径，如 D:\\开发项目，默认为当前目录"
    }
  },
  "required": ["action"]
}

技能 5：read_file

技能名称： read_file

技能描述： 读取指定文本文件的内容。

脚本路径： D:\moss-plugins\system-tools\run.bat

参数 JSON：

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "description": "操作类型，固定为 file",
      "enum": ["file"]
    },
    "filepath": {
      "type": "string",
      "description": "要读取的文件完整路径，如 D:\\config\\app.json"
    }
  },
  "required": ["action", "filepath"]
}

技能 6：get_network

技能名称： get_network

技能描述： 获取网络配置信息，包括 IP 地址、子网掩码、默认网关等。

脚本路径： D:\moss-plugins\system-tools\run.bat

参数 JSON：

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "description": "操作类型，固定为 network",
      "enum": ["network"]
    }
  },
  "required": ["action"]
}

使用示例

注册完成后，在 Moss 对话中直接说：

• 现在几点了？
• 获取系统信息
• 列出 D:\开发项目 目录
• 查看网络信息，我的 IP 是多少
• 读取 D:\config\app.json 的内容
• 执行 dir 命令

注意事项

• 推荐 Windows：脚本基于 CMD，macOS/Linux 部分功能不可用
• exec_cmd 需谨慎：可执行任意 CMD 命令，仅在可信环境使用
• 无需额外依赖：使用 Python 标准库，不用 pip install
• 与邮件、推送、TTS 等插件独立，需分别安装

常见问题