// 10
插件市场
概述
插件市场是 DeepSeno 的能力扩展中心。一个插件 = 一段 JSON 配置,粘贴即安装。
不再区分"技能"和"MCP 服务器",统一为插件。所有扩展能力通过同一个入口管理。
三种插件类型
| 类型 | 特征 | 说明 |
|---|---|---|
| 纯提示词插件 | 只有 instructions | 让 AI 以特定角色工作,零开销,无需启动外部进程 |
| MCP 工具插件 | 只有 mcp | 启动外部 MCP Server,给 AI 增加工具能力 |
| 混合插件 | 两者都有 | 既定义角色指令,又提供 MCP 工具 |
安装方式
打开 DeepSeno → 插件市场 → 点右上角 [+ 添加],支持四种方式:
- 市场推荐一键安装 — 从推荐列表直接安装预配置插件
- 粘贴 JSON — 将完整的插件 JSON 配置粘贴到输入框
- 粘贴 Markdown — 粘贴包含
```json代码块的 Markdown 文本,系统自动提取 JSON - 选择文件 — 选择本地
.json或.md文件导入
插件配置格式
完整的 voicebrain-plugin.json 格式:
{
"id": "my-plugin",
"name": "插件名称",
"description": "一句话描述",
"version": "1.0.0",
"instructions": "注入给 AI 的系统提示词",
"mcp": {
"command": "npx",
"args": ["-y", "package-name"],
"env": {},
"autoStart": true
},
"page": {
"icon": "brain",
"menuLabel": "侧边栏标签",
"welcomeMessage": "欢迎语"
}
}
字段说明
| 字段 | 必填 | 说明 |
|---|---|---|
id | 是 | 唯一标识,只能包含字母、数字、-、_ |
name | 是 | 在界面上显示的名称 |
description | 否 | 一句话描述,显示在插件卡片上 |
version | 否 | 语义化版本号,用于更新检测 |
instructions | 二选一 | 注入 LLM 系统提示词。启用后 AI 对话时遵循这些指令 |
mcp | 二选一 | MCP 工具服务配置(见下文) |
page | 否 | 如果填写,插件会在侧边栏创建专属入口 |
instructions和mcp至少要有一个,可以两个都有(混合插件)。
MCP 配置
| 字段 | 说明 |
|---|---|
mcp.command | 启动命令:npx、node、python 等 |
mcp.args | 参数数组。npx 包通常第一个参数是 -y(自动确认),第二个是包名 |
mcp.env | 环境变量,传给子进程。值为空字符串 "" 的键会在安装时提示用户填写 |
mcp.autoStart | 是否随应用启动自动运行(默认 true) |
Page 配置
| 字段 | 说明 |
|---|---|
page.icon | lucide-react 图标名,如 clipboard、mail、brain |
page.menuLabel | 侧边栏显示的标签(默认使用 name) |
page.welcomeMessage | 打开页面时显示的欢迎语 |
完整示例
会议专家(纯提示词 + page)
{
"id": "meeting-expert",
"name": "会议专家",
"description": "会议纪要提取与行动项整理",
"version": "1.0.0",
"instructions": "你是一位会议纪要专家。当用户提到会议内容时:\n1. 提取所有议题和讨论要点\n2. 明确列出做出的决策\n3. 整理行动项(负责人 + 截止日期)\n4. 按时间线组织内容\n5. 标注关键参与者和他们的观点",
"page": {
"icon": "clipboard",
"menuLabel": "会议专家",
"welcomeMessage": "我可以帮你整理会议纪要、提取行动项。把会议内容告诉我吧。"
}
}
文件系统(MCP 工具)
{
"id": "filesystem",
"name": "文件系统",
"description": "读写本地文件",
"version": "1.0.0",
"mcp": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/Documents"],
"autoStart": true
}
}
调研助手(混合插件)
{
"id": "research-assistant",
"name": "调研助手",
"description": "联网搜索 + 专业分析",
"version": "1.0.0",
"instructions": "你是一位专业调研助手。收到用户的调研需求后:\n1. 先用搜索工具收集相关信息\n2. 对比多个来源,识别一致性和矛盾\n3. 提炼关键发现,标注信息来源\n4. 给出结论和建议\n5. 用结构化格式呈现(标题、要点、表格)",
"mcp": {
"command": "npx",
"args": ["-y", "@kazuph/mcp-fetch"],
"autoStart": true
},
"page": {
"icon": "search",
"menuLabel": "调研助手",
"welcomeMessage": "我可以帮你搜索、分析、整理调研资料。说说你想了解什么?"
}
}
23 个内置工具
以下工具始终可用,无需安装插件。AI 根据对话意图自动调用:
| 工具 | 功能 | 触发词示例 |
|---|---|---|
create_todo | 创建待办事项 | "帮我记一下明天要..." |
complete_todo | 完成待办事项 | "标记 xx 为已完成" |
delete_todo | 删除待办或备忘 | "删掉那条待办" |
delete_items | 删除待办/备忘/决策等事项 | "把这几条都删了" |
list_items | 列出待办/备忘等事项(支持按类型筛选) | "我有哪些待办" |
create_memo | 创建备忘录 | "帮我记个备忘" |
generate_report | 生成报告(日报/周报/月报) | "生成本周周报" |
query_knowledge | 查询知识库(RAG) | "之前讨论过 xx 吗" |
search_recordings | 搜索录音记录 | "找一下关于 xx 的录音" |
update_memory | 更新 AI 记忆 | "记住我的邮箱是..." |
list_memories | 列出记忆条目 | "你记得关于我的什么" |
set_reminder | 设置定时提醒 | "下午三点提醒我..." |
list_reminders | 列出已有提醒 | "我设了哪些提醒" |
create_scheduled_task | 创建定时任务 | "每天早上 9 点发日报" |
list_scheduled_tasks | 列出定时任务 | "我有哪些定时任务" |
manage_scheduled_task | 管理定时任务(暂停/恢复/删除) | "暂停那个定时任务" |
lookup_person | 查询人物信息 | "张三是谁" |
send_email | 发送邮件 | "帮我发封邮件给..." |
web_search | 网页搜索 | "搜一下最新的..." |
create_pptx | 创建 PPT | "做一个关于 xx 的 PPT" |
create_docx | 创建 Word 文档 | "生成一份 Word 文档" |
create_pdf | 创建 PDF | "导出为 PDF" |
read_pdf | 读取 PDF 内容 | "帮我看看这个 PDF" |
send_file | 发送文件 | "把文件发到..." |
插件安装的 MCP 工具会自动出现在 AI 的工具列表中,前缀为 plugin_<插件id>_<工具名>。
管理操作
- 启用/禁用 — 临时关闭插件而不删除配置
- 编辑 — 直接修改插件的 JSON 配置
- 卸载 — 彻底删除插件
- 升级 — npx 类插件更新版本号后重新安装即可
环境变量
mcp.env 中值为空字符串 "" 的键,表示该环境变量需要用户手动填写(如 API Key)。
安装包含空值环境变量的插件时,插件会自动禁用以避免因缺少配置导致启动失败。用户填写完毕后手动启用。
示例:
{
"mcp": {
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": ""
}
}
}
安装后需要在插件设置中填入实际的 Token 值。
插件专属页面
配置了 page 字段的插件会在侧边栏创建独立入口。点击进入后是插件的专属对话界面:
- AI 始终以插件定义的角色身份回答
- 对话上下文与主助手独立
- 插件提供的 MCP 工具在此页面中可用
旧格式迁移
Skill 迁移为插件
旧格式(settings.json 中的 skills 数组元素):
{
"id": "email_writer",
"name": "邮件助手",
"description": "专业邮件撰写",
"instructions": "你是一位专业邮件撰写助手...",
"enabled": true,
"page": { "icon": "mail" }
}
新格式(直接粘贴安装):
{
"id": "email_writer",
"name": "邮件助手",
"description": "专业邮件撰写",
"version": "1.0.0",
"instructions": "你是一位专业邮件撰写助手...",
"page": {
"icon": "mail",
"menuLabel": "邮件助手",
"welcomeMessage": "我可以帮你撰写专业邮件,告诉我邮件的要点。"
}
}
变化:加 version,去掉 enabled(安装即启用),其余完全一样。
MCP Server 迁移为插件
旧格式(settings.json 中的 mcpServers 数组元素):
{
"id": "memory",
"name": "持久记忆",
"description": "MCP 知识图谱记忆",
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-memory"],
"env": {},
"enabled": true,
"autoStart": true
}
新格式:
{
"id": "memory",
"name": "持久记忆",
"description": "MCP 知识图谱记忆",
"version": "1.0.0",
"mcp": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-memory"],
"autoStart": true
}
}
变化:command/args/env/autoStart 整体移入 mcp 对象中,去掉 enabled,加 version。
Skill + MCP 合并为混合插件
以前需要分别添加一个 Skill 和一个 MCP Server,现在可以合成一个插件:
{
"id": "browser-assistant",
"name": "浏览器助手",
"description": "智能浏览器操作 + 网页分析",
"version": "1.0.0",
"instructions": "你是一个浏览器操作专家。用户提供 URL 时:\n1. 使用浏览器工具打开页面\n2. 提取关键内容并总结\n3. 如需要可以截图保存",
"mcp": {
"command": "npx",
"args": ["-y", "@playwright/mcp", "--headless"],
"autoStart": true
},
"page": {
"icon": "monitor",
"menuLabel": "浏览器助手"
}
}