插件中心

插件中心用来发现、安装和运行小工具。插件就是带界面的片段，和普通片段放在一起。也可以从搜索窗口的 插件市场 进去。

插件能做什么？

插件是运行在 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 命令。」

安全机制

插件在独立小窗口里运行，权限比主窗口少：

• 不能直接翻你的片段库
• 用剪贴板或弹提示前，要你点头同意
• 清单里可以声明它需要哪些窗口能力，应用会按声明收紧

典型工作流

开发者工具箱

安装：@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 私有仓库或本地目录同步分享。

插件后台

有的插件要点一次就算出结果，有的需要在后台多待一会儿。打开 设置 → 扩展 → 插件后端，可以限制超时和同时开几个。这只服务 这台电脑，不会对网上开放。插件窗口能碰的文件比主窗口少，这是有意的。开发时，在设置里指定允许加载的本地目录。

插件开发

想做一枚「选日期再插入」的小工具：不必另装一套系统。插件就是勾了插件模式的片段，可以带自己的小窗口。

清单、触发词、搜索窗里的插件页，用的是同一套运行方式。规范正文在 设置 → MCP 那张卡片里。

另见：MCP