// 10

插件市场

概述

插件市场是 DeepSeno 的能力扩展中心。一个插件 = 一段 JSON 配置,粘贴即安装。

不再区分"技能"和"MCP 服务器",统一为插件。所有扩展能力通过同一个入口管理。

三种插件类型

类型特征说明
纯提示词插件只有 instructions让 AI 以特定角色工作,零开销,无需启动外部进程
MCP 工具插件只有 mcp启动外部 MCP Server,给 AI 增加工具能力
混合插件两者都有既定义角色指令,又提供 MCP 工具

安装方式

打开 DeepSeno → 插件市场 → 点右上角 [+ 添加],支持四种方式:

  1. 市场推荐一键安装 — 从推荐列表直接安装预配置插件
  2. 粘贴 JSON — 将完整的插件 JSON 配置粘贴到输入框
  3. 粘贴 Markdown — 粘贴包含 ```json 代码块的 Markdown 文本,系统自动提取 JSON
  4. 选择文件 — 选择本地 .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如果填写,插件会在侧边栏创建专属入口

instructionsmcp 至少要有一个,可以两个都有(混合插件)。

MCP 配置

字段说明
mcp.command启动命令:npxnodepython
mcp.args参数数组。npx 包通常第一个参数是 -y(自动确认),第二个是包名
mcp.env环境变量,传给子进程。值为空字符串 "" 的键会在安装时提示用户填写
mcp.autoStart是否随应用启动自动运行(默认 true

Page 配置

字段说明
page.iconlucide-react 图标名,如 clipboardmailbrain
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": "浏览器助手"
  }
}