插件精灵使用说明
从安装、脚本管理和常用配置，到任务中心与 MCP 连接，一处了解插件精灵的完整使用方式。
插件精灵是面向跨境电商工作的 Chrome 用户脚本运行器。你可以安装脚本、配置常用参数，并通过手动、批量、定时或 MCP 方式执行任务。
1. 快速开始
第一次使用只需要完成四步：
- 从产品下载页下载最新安装包并解压；
- 在 Chrome 扩展程序页面开启开发者模式，加载已解压的扩展程序；
- 打开插件精灵，使用微信验证码或 License 登录；
- 前往脚本库安装需要的脚本，然后在脚本中心运行。
插件精灵不会替脚本保存目标网站的 Cookie。需要登录的网站仍在浏览器页面中由你本人登录，脚本只在声明的站点范围内运行。
2. 安装与登录
安装 Chrome 扩展
在产品下载页下载 ZIP，解压到一个固定目录。打开 chrome://extensions，开启“开发者模式”，点击“加载已解压的扩展程序”并选择解压后的目录。
升级时先移除旧版本，再加载新版本目录。不要直接删除仍在加载中的扩展目录。
登录插件精灵
插件精灵支持微信验证码和 License 登录。首次登录后，按照页面提示完成飞书或钉钉通知配置；当前版本要求至少配置其中一种，便于任务完成或失败时及时收到结果。
3. 脚本中心
安装脚本
从脚本库打开脚本详情，确认脚本说明、站点权限和更新记录后再安装。安装完成的脚本会出现在插件的脚本中心。
管理脚本
每个脚本都可以独立完成以下操作：
- 启用或停用运行；
- 打开设置并填写脚本参数；
- 手动调用脚本提供的 Tool；
- 检查更新或卸载；
- 决定是否发布给 MCP 客户端调用。
脚本的运行开关与 MCP 发布开关相互独立。脚本中心是审查发布范围的唯一入口，不提供“一次发布全部脚本”的批量操作。
4. 常用配置
常用配置用于保存可以跨任务复用的参数，例如 Token、表格地址、店铺标识或默认市场。
- 配置默认只保存在当前浏览器；需要跨设备使用时手动开启同步。
- 一个脚本可以声明配置模板，插件会据此生成输入项。
- 调用脚本时，手动填写的参数优先于自动带入的常用配置。
- 只有你在本次任务中选择的配置组会传给脚本，不会把所有配置都暴露出去。
不要在脚本源码、任务结果或公开报告中写入 Cookie、License、Token 等真实凭据。
5. 运行任务
插件精灵的手动、批量、定时和 MCP 调用最终都会进入脚本的同一个任务处理器，因此结果格式和错误处理保持一致。
手动运行
在脚本中心选择 Tool，填写必要参数和常用配置后开始任务。需要网页环境的脚本会在匹配页面中执行；后台脚本可以在插件的离屏环境中运行。
批量运行
批量任务会把你选择的输入字段逐项展开执行。开始前确认目标字段、条目数量和写入方式，避免重复写入或覆盖已有数据。
定时任务
定时任务在触发时读取最新的常用配置。修改 Token 或目标表格后不必重新创建计划，但应先手动运行一次确认新配置有效。
6. 任务中心
任务中心集中展示正在运行和已经完成的任务。你可以查看状态、详情、脚本返回的数据和报告，也可以对支持的任务执行停止、重试、下载报告或删除记录。
排查失败任务时，先查看错误信息和任务输入，再确认目标网站登录状态、脚本权限与常用配置是否有效。更深入的实测差异可查阅实测知识库。
7. MCP 连接
MCP 页面只负责连接开关、服务地址和客户端配置；哪些脚本可以暴露给 AI，由脚本中心中的逐脚本开关决定。
推荐操作顺序
- 在 MCP 页面开启连接并复制配置；
- 在 Claude Desktop、Codex 或其他 MCP 客户端中添加插件精灵；
- 回到脚本中心，逐个检查脚本权限和行为；
- 只为适合交给 AI 调用的脚本开启“MCP 发布”。
新安装脚本默认不会发布给 MCP。MCP 发起的任务不会发送普通任务通知，客户端可以通过 get_report 读取进度和结果。
8. 账号与通知
账号页用于查看登录状态和管理通知渠道。飞书与钉钉通知直接发送到你配置的目标，建议先发送测试消息，再用于正式任务。
如果更换设备或浏览器，登录状态、本地常用配置和目标网站会话可能需要重新设置；已开启同步的配置会在登录后按产品提示恢复。
9. 安全与权限
安装或发布脚本前，请重点检查：
- 脚本声明的访问网站是否与功能一致；
- 是否会写入、删除或覆盖业务数据；
- 是否需要 Token、Cookie 或其他敏感凭据；
- 是否适合通过 MCP 交给 AI 自动调用；
- 批量任务的数量和影响范围是否可控。
MCP 连接和脚本发布默认采用最小授权思路。只开启当前需要的能力，任务完成后可以关闭单个脚本的 MCP 发布或关闭整个 MCP 连接。
10. 获取帮助
向他人反馈问题时，建议提供插件版本、脚本名称与版本、任务时间、错误信息和可复现步骤；发送截图或日志前先移除账号、Cookie、Token、License 等敏感信息。