Skip to Content
文档⚡ 核心功能🧩 插件中心

插件中心

插件中心是发现、安装、管理和运行插件的入口。插件可以扩展 CodeExpander 的能力,添加自定义工具、转换器、格式化器和集成 —— 全部可从搜索窗口直达。


插件能做什么?

插件是运行在 CodeExpander 内部的小应用,可以:

  • 添加自定义工具 — 时间戳转换器、JSON 格式化、取色器、计算器
  • 处理文件 — 拖入文件到搜索窗口,插件自动解析并转换
  • 集成工作流 — 生成二维码、Base64 编解码、SQL 格式化
  • 提供 AI 能力 — 代码审查、自动注释、测试生成

安装插件

从 npm 安装(推荐)

最快捷的安装方式:

  1. 从主窗口或搜索窗口打开插件中心
  2. 安装区域输入 npm 包名(如 @codeexpander/plugin-timestamp
  3. 点击安装

官方插件使用 @codeexpander/plugin-* 前缀,由团队维护。

前提:系统需已安装 Node.js 和 npm。

从本地目录导入

如果你本地已有插件文件夹:

  1. 点击从目录导入
  2. 选择包含 plugin.json 和入口文件的文件夹
  3. 插件立即出现在列表中

通过 AI 创建(MCP)

让 AI 为你自动生成插件:

  1. 设置 → MCP 中启用 MCP 服务器
  2. 连接你的 AI 助手(Cursor、Claude Desktop 等)
  3. 描述需求 —— 如「创建一个把 CSV 转成 Markdown 表格的插件」
  4. AI 自动生成并安装插件

管理插件

浏览与搜索

插件中心以卡片形式展示所有已安装插件。搜索框支持按以下维度过滤:

  • 名称 — 如「时间戳」
  • 类别 — 如「开发者工具」、「转换器」
  • 描述 — 关键词搜索

运行插件

  • 从插件中心 — 点击任意插件卡片打开其界面
  • 从搜索窗口 — 输入插件名称或其定义的命令触发词
  • 带文件运行 — 拖拽文件到搜索窗口,支持文件的插件自动激活

固定与整理

  • 固定常用插件,让它们显示在搜索窗口空态中
  • 隐藏不常用插件,减少干扰
  • 卸载彻底移除

插件构成

一个插件本质上是一个特殊片段,包含:

  • plugin.json — 元数据(名称、描述、图标、类别、入口文件)
  • 入口文件 — 插件的界面(HTML/JS)
  • 命令 — 可选的关键词触发器,用于搜索窗口

示例:「时间戳转换」插件可能定义:

  • 命令:ts — 在搜索中输入 ts 1714392000 即时转换
  • 界面:从插件中心打开时显示可视化日历选择器

创建自己的插件

方式一:手动(适合开发者)

创建文件夹结构:

my-plugin/ plugin.json ← 清单文件 index.html ← 界面

plugin.json 示例:

{ "main": "index.html", "title": "我的插件", "description": "做一件有用的事", "category": "工具", "features": [ { "code": "myCmd", "explain": "运行我的命令", "cmds": ["my", "mp"] } ] }

通过插件中心 → 从目录导入即可使用。

方式二:AI 辅助(适合所有人)

向通过 MCP 连接的 AI 助手描述想法,AI 自动处理:

  • 编写 HTML/JS
  • 创建清单文件
  • 自动安装

示例提示词:「创建一个统计选中文字字数的插件,在搜索窗口中添加 wc 命令。」


安全机制

插件在独立窗口中运行,权限受限:

  • 无法直接访问你的片段数据
  • 仅通过 postMessage 与宿主通信
  • 剪贴板和提示操作需显式授权
  • 可在 plugin.json 中声明可选的 Tauri 权限(如 core:window:allow-set-size

典型工作流

开发者工具箱

安装:@codeexpander/plugin-timestamp@codeexpander/plugin-json@codeexpander/plugin-color

日常使用:

  1. 搜索窗口 → ts + 粘贴时间戳 → 即时转换
  2. 搜索窗口 → json + 粘贴 JSON → 格式化并校验
  3. 搜索窗口 → color + 粘贴 HEX → 查看 RGB/HSL 转换

内容创作者

安装:@codeexpander/plugin-qr@codeexpander/plugin-base64

  1. 搜索窗口 → qr + 粘贴链接 → 生成二维码图片
  2. 搜索窗口 → b64 + 粘贴文本 → Base64 编解码

团队内部插件

团队可开发内部插件用于:

  • 公司 API 签名生成
  • 内部文档模板
  • 部署命令执行

通过 npm 私有仓库或本地目录同步分享。