# 插件精灵使用说明

> 插件精灵是面向跨境电商工作的 Chrome 用户脚本运行器。你可以安装脚本、配置常用参数，并通过手动、批量、定时或 MCP 方式执行任务。

## 1. 快速开始

第一次使用只需要完成四步：

1. 从[产品下载页](/download)下载最新安装包并解压；
2. 在 Chrome 扩展程序页面开启开发者模式，加载已解压的扩展程序；
3. 打开插件精灵，使用微信验证码或 License 登录；
4. 前往[脚本库](/scripts)安装需要的脚本，然后在脚本中心运行。

插件精灵不会替脚本保存目标网站的 Cookie。需要登录的网站仍在浏览器页面中由你本人登录，脚本只在声明的站点范围内运行。

## 2. 安装与登录

### 安装 Chrome 扩展

在[产品下载页](/download)下载 ZIP，解压到一个固定目录。打开 `chrome://extensions`，开启“开发者模式”，点击“加载已解压的扩展程序”并选择解压后的目录。

升级时先移除旧版本，再加载新版本目录。不要直接删除仍在加载中的扩展目录。

### 登录插件精灵

插件精灵支持微信验证码和 License 登录。首次登录后，按照页面提示完成飞书或钉钉通知配置；当前版本要求至少配置其中一种，便于任务完成或失败时及时收到结果。

## 3. 脚本中心

### 安装脚本

从[脚本库](/scripts)打开脚本详情，确认脚本说明、站点权限和更新记录后再安装。安装完成的脚本会出现在插件的脚本中心。

### 管理脚本

每个脚本都可以独立完成以下操作：

- 启用或停用运行；
- 打开设置并填写脚本参数；
- 手动调用脚本提供的 Tool；
- 检查更新或卸载；
- 决定是否发布给 MCP 客户端调用。

脚本的运行开关与 MCP 发布开关相互独立。脚本中心是审查发布范围的唯一入口，不提供“一次发布全部脚本”的批量操作。

## 4. 常用配置

常用配置用于保存可以跨任务复用的参数，例如 Token、表格地址、店铺标识或默认市场。

- 配置默认只保存在当前浏览器；需要跨设备使用时手动开启同步。
- 一个脚本可以声明配置模板，插件会据此生成输入项。
- 调用脚本时，手动填写的参数优先于自动带入的常用配置。
- 只有你在本次任务中选择的配置组会传给脚本，不会把所有配置都暴露出去。

不要在脚本源码、任务结果或公开报告中写入 Cookie、License、Token 等真实凭据。

## 5. 运行任务

插件精灵的手动、批量、定时和 MCP 调用最终都会进入脚本的同一个任务处理器，因此结果格式和错误处理保持一致。

### 手动运行

在脚本中心选择 Tool，填写必要参数和常用配置后开始任务。需要网页环境的脚本会在匹配页面中执行；后台脚本可以在插件的离屏环境中运行。

### 批量运行

批量任务会把你选择的输入字段逐项展开执行。开始前确认目标字段、条目数量和写入方式，避免重复写入或覆盖已有数据。

### 定时任务

定时任务在触发时读取最新的常用配置。修改 Token 或目标表格后不必重新创建计划，但应先手动运行一次确认新配置有效。

## 6. 任务中心

任务中心集中展示正在运行和已经完成的任务。你可以查看状态、详情、脚本返回的数据和报告，也可以对支持的任务执行停止、重试、下载报告或删除记录。

排查失败任务时，先查看错误信息和任务输入，再确认目标网站登录状态、脚本权限与常用配置是否有效。更深入的实测差异可查阅[实测知识库](/docs/knowledge)。

## 7. MCP 连接

MCP 页面只负责连接开关、服务地址和客户端配置；哪些脚本可以暴露给 AI，由脚本中心中的逐脚本开关决定。

### 推荐操作顺序

1. 在 MCP 页面开启连接并复制配置；
2. 在 Claude Desktop、Codex 或其他 MCP 客户端中添加插件精灵；
3. 回到脚本中心，逐个检查脚本权限和行为；
4. 只为适合交给 AI 调用的脚本开启“MCP 发布”。

新安装脚本默认不会发布给 MCP。MCP 发起的任务不会发送普通任务通知，客户端可以通过 `get_report` 读取进度和结果。

## 8. 账号与通知

账号页用于查看登录状态和管理通知渠道。飞书与钉钉通知直接发送到你配置的目标，建议先发送测试消息，再用于正式任务。

如果更换设备或浏览器，登录状态、本地常用配置和目标网站会话可能需要重新设置；已开启同步的配置会在登录后按产品提示恢复。

## 9. 安全与权限

安装或发布脚本前，请重点检查：

- 脚本声明的访问网站是否与功能一致；
- 是否会写入、删除或覆盖业务数据；
- 是否需要 Token、Cookie 或其他敏感凭据；
- 是否适合通过 MCP 交给 AI 自动调用；
- 批量任务的数量和影响范围是否可控。

MCP 连接和脚本发布默认采用最小授权思路。只开启当前需要的能力，任务完成后可以关闭单个脚本的 MCP 发布或关闭整个 MCP 连接。

## 10. 获取帮助

- 想开发或改造脚本：查看[脚本开发说明](/docs/development)；
- 遇到平台接口差异：查看[实测知识库](/docs/knowledge)；
- 安装新脚本：前往[脚本库](/scripts)；
- 下载或升级插件：前往[产品下载页](/download)；
- 了解数据处理边界：查看[隐私政策](/privacy)。

向他人反馈问题时，建议提供插件版本、脚本名称与版本、任务时间、错误信息和可复现步骤；发送截图或日志前先移除账号、Cookie、Token、License 等敏感信息。