Skip to Content
文件⚡ 核心功能🧩 外掛

外掛中心

外掛中心用來發現、安裝和執行小工具。外掛就是帶界面的片段，和普通片段放在一起。也可以從搜尋視窗的 外掛市集 進去。

@codeexpander/plugin-timestamp
安装
时间戳转换
ts
JSON 格式化
json
二维码
qr

插件中心：npm 包名安装。插件是 plugin_mode 片段，不是另一张表。

外掛能做什麼？

外掛是執行在 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 私有倉庫或本地目錄同步分享。

外掛後臺

有的外掛要點一次就算出結果，有的需要在後臺多待一會兒。打開 設定 → 擴充 → 外掛後端，可以限制超時和同時開幾個。這只服務 這臺電腦，不會對網上開放。外掛視窗能碰的檔案比主視窗少，這是有意的。開發時，在設定裡指定允許加載的本地目錄。

外掛開發

想做一枚「選日期再插入」的小工具：不必另裝一套系統。外掛就是勾了外掛模式的片段，可以帶自己的小視窗。

开发片段插件
从模板创建、从本地目录导入，或使用 Cursor + CodeExpander MCP 生成插件。
1创建插件
使用 Cursor（MCP）推荐

在设置 → MCP 启用服务端，让 AI 按规范生成片段。

codeexpander-plugins

公开仓库里的插件规范与示例。

2导入到 CodeExpander
从目录导入

选择含 plugin.json 与入口的文件夹，写入片段库。

选择文件夹
软链模式导入本地开发

只存 manifest，运行时读该目录。受 dev_plugin_base_dirs 限制。

选择文件夹

插件开发窗：步骤 1 用 Cursor MCP 创建；步骤 2 从目录导入或软链。插件是 plugin_mode 片段，不是另一张表。

途徑適合
外掛開發窗按步驟從範本創建，或導入檔案夾
本地檔案夾已有清單和入口頁，放到應用允許的目錄
外掛中心從市集安裝，安裝後變成一條片段
設定裡的 MCP讓編輯器裡的 AI 按規範生成片段

清單、觸發詞、搜尋窗裡的外掛頁，用的是同一套執行方式。規範正文在 設定 → MCP 那張卡片裡。

另見：MCP

最後更新於
📋 剪貼簿⚡ 腳本