如快通过 package.json 顶层的 commands 字段识别插件命令列表。
基本结构:
json
{
"name": "hello-world-plugin",
"version": "0.0.1",
"type": "module",
"commands": [
{
"name": "hello",
"title": "Hello UI",
"mode": "view",
"searchable": true,
"placeholder": "输入内容并回车执行"
},
{ "name": "storage-demo", "title": "Storage Demo", "mode": "no-view" }
]
}字段说明:
commands[].name:命令标识。No-View / Script 命令需与构建出的文件名一致(见下)。commands[].title:命令展示名称。commands[].mode:view:有界面,在 iframe 中渲染 UI。no-view:无界面命令,作为独立指令出现在命令面板中,运行在 Node Worker 中。script:仅供 View 命令内部调用的脚本,不出现在命令面板中。- (将来会支持
background)。
commands[].searchable:是否在全局搜索中检索到该命令(仅对mode: "view"/mode: "no-view"有意义)。commands[].placeholder:当命令需要搜索(searchable: true)时,显示在搜索框中的占位文案。
目录建议:
- UI 代码:
src/,Vite 构建输出到dist/ - No-View 代码:
src/no-view/*.ts - No-View 构建:使用独立
vite.worker.config.ts输出到dist/,文件名与命令名一致 - 发布目录:
dist/,需包含index.html、静态资源、package.json、以及 No-View 的*.mjs