Extensions
Plugins 插件
理解 Plugin 与 Skill 的区别,安装与开发入门
Plugins 插件
Plugin(插件) 是 WinCode 应用层面的扩展机制。与 Skill 给 AI 引擎加"方法论"不同,Plugin 给 WinCode 应用本身加"能力",例如工作区辅助、界面增强、外部系统集成等。
Plugin 与 Skill 的关键差异
| 维度 | Skill | Plugin |
|---|---|---|
| 作用对象 | AI 引擎(影响对话) | WinCode 应用(影响界面/流程) |
| 触发机制 | AI 主动调用技能 | 应用在特定事件上调用 |
| 形式 | Markdown 文档 | 配置文件 + 入口脚本 |
| 典型用例 | 开发流程引导 | 工作区辅助、第三方集成 |
简而言之:Skill 是"对 AI 说的提示词",Plugin 是"对 WinCode 写的扩展代码"。
plugin.json 配置
每个 Plugin 是一个目录,至少包含 plugin.json:
{
"id": "workspace-helper",
"name": "Workspace Helper",
"version": "1.0.0",
"description": "Built-in placeholder plugin for workspace helper capabilities.",
"capabilities": ["workspace"],
"entrypoint": "index.js"
}字段说明:
| 字段 | 必填 | 说明 |
|---|---|---|
id | 是 | 插件唯一 ID |
name | 是 | 显示名 |
version | 推荐 | 语义化版本号 |
description | 推荐 | 一行简介 |
capabilities | 是 | 能力标签数组,例如 ["workspace"]、["ui"]、["integration"] |
entrypoint | 是 | 入口文件名,位于同一目录 |
安装 Plugin
扩展中心提供两种安装方式:
从本地目录安装
- 点击扩展中心顶部 插件目录 按钮
- 在系统对话框中选择一个包含
plugin.json的目录 - 安装成功后刷新列表,Plugin 出现在"插件"列
从压缩包安装
- 点击扩展中心顶部 插件压缩包 按钮
- 选择
.zip文件(内部结构需包含plugin.json) - 安装完成后列表自动刷新
管理 Plugin
每张 Plugin 卡片有三个操作:
| 按钮 | 行为 |
|---|---|
| 启用 / 停用 | 停用后插件不再被加载 |
| 卸载 | 删除插件目录与所有文件 |
停用不删除文件,重新启用即可恢复;卸载会彻底移除。
开发入门
开发一个 Plugin 最少需要:
my-plugin/
├── plugin.json # 配置
└── index.js # 入口最简 index.js:
module.exports = {
activate(context) {
// context 提供应用 API
console.log("Plugin activated:", context.pluginId);
},
deactivate() {
console.log("Plugin deactivated");
}
};开发流程:
- 在任意目录编写
plugin.json+index.js - 通过扩展中心"插件目录"按钮安装
- 启用后观察应用日志,调试
- 修改代码后需要在扩展中心点击"刷新"重新加载
内置 Plugin
WinCode 当前预装了一个工作区辅助 Plugin(workspace-helper),作为 placeholder 预留了工作区能力的扩展点。
后续版本计划加入更多内置 Plugin,例如:
- 项目管理集成(Jira、TFS)
- 代码质量分析
- 自动化部署触发