插件精灵使用指南

插件精灵把网页上的重复工作变成可重复运行的功能：安装脚本，在网页旁选择商品或填写参数，批量或定时执行，再到工作台查看数据、报告和附件。需要 AI 帮忙时，可以单独授权它调用功能或查询已有结果。

第一次使用，先完成下面的安装和一次手动运行。通知机器人、云盘和远程 MCP 都可以之后再配置。

安装与首次运行

第一步：安装扩展

从官网下载页选择 Chrome 商店安装，或下载 Windows／macOS 通用 ZIP。使用 ZIP 时，先解压到一个固定文件夹，再打开 chrome://extensions，开启开发者模式，点击“加载已解压的扩展程序”，选择包含 manifest.json 的文件夹。

在扩展详情中开启 “允许用户脚本”，并按实际需要授予网站访问权限。提示条里的“打开扩展详情”只负责带你到浏览器设置，开关仍需你本人开启。Chrome 的不同版本可能使用不同的许可入口，以当前浏览器提示为准。

第二步：登录并安装一个功能

打开插件精灵，使用界面提供的微信验证码或 License 登录。进入功能中心，选择需要的功能，查看用途、参数与网站权限，确认后安装。

未绑定飞书或钉钉也可以运行。需要目标网站登录的功能，请先在浏览器登录该网站；数据表写入、云盘保存等额外能力仍需要各自授权。

第三步：跑一次，再查看结果

1. 打开目标网页，在右侧贴边入口展开插件；也可以直接进入工作台。
2. 选择功能，核对输入参数。支持商品选择的功能可以从页面勾选商品。
3. 点击“运行任务”。开始前的校验错误会显示在表单中。
4. 点击功能旁的提醒，进入工作台的“任务进程”；完成后打开本次数据或报告。

第一次先用一个输入验证结果，确认符合需要后再批量或定时运行。已经提交的任务先查看进程，避免因为等待重复点击运行。

网页助手与商品选择

贴边面板和悬浮球

默认使用贴边悬停面板：鼠标移到网页右侧入口会展开，展开后保持显示，点击右上角关闭。展开时为网页内容让位，关闭后恢复。在同一浏览器窗口切换标签页时，展开或折叠状态保持一致。

在“设置 → 显示设置”可以切换为悬浮球与浮窗。入口出现在已授予网站权限的普通网页；浏览器内部页、扩展商店等受浏览器限制。没有匹配功能的网页默认显示书签。插件保留浏览器原来的新标签页。

找到功能、查看提醒

功能按分类一行一个展示，可搜索；搜索框旁的九宫格打开全部功能选择窗，选择后回到原面板填写参数。列表连续滚动。

当前页面适用的功能会出现在列表；有正在进行的任务、未读报告或未查看失败的功能也会保留提醒。出现在提醒列表，不代表能在当前网页运行，实际运行仍受脚本匹配与权限限制。

功能右侧的数字表示未读报告批数；悬停或聚焦后可查看相应文字。点击提醒会定位工作台中该功能的任务进程。面板负责选择和启动，完整数据、报告、附件在工作台查看。

只有作者明确声明为“页面增强”的脚本，前台行右侧才显示快捷开关。该开关与工作台启停同步，影响所有网页。停用后如需撤掉当前页面已注入的内容，点击“刷新当前页”应用；先保存网页上未提交的内容。

选择一个或多个商品

进入支持商品选择的功能后，页面中可识别的商品会出现勾选控件。选择一个商品用于单次运行，选择多个用于批量运行；拖入商品也只填充或加入选择，不会自动执行。

商品识别与参数填充取决于脚本的明确声明及页面内容。请核对 ASIN、站点和首图，识别不到时仍可手动填写。脚本未声明该能力时不会猜测字段；切换商品或网页后，应重新确认本次目标。

功能管理与任务运行

安装、分类与更新功能

工作台左侧按已安装功能切换。搜索框旁的添加入口可打开功能中心；上方直接提供“功能市场、链接安装、本地文件、源码安装”四种方式。预览后核对来源、用途、网站范围和申请的功能权限，勾选确认再安装。取消或只查看预览不会授权；需要邮箱、账号等具体资源时，仍由你另行选择。

常用功能可以置顶；新建分类后，把功能拖到分类名称即可归类，也可从功能菜单调整。分类支持折叠、改名和删除，删除分类不会卸载其中的功能。

“介绍与管理”展示功能说明；“功能配置”提供更新、源码编辑、启停、并发和各类授权设置。在“脚本源码”修改后，先校验并核对更新预览，再确认保存到当前功能。配置、启停及业务数据保留；新增权限需要再次确认，其他窗口已改过源码时需重新读取。保存到本机不等于发布到官网。

脚本由你主动检查更新，插件更新不会强行覆盖用户已安装的脚本源码。同步或恢复带来的未确认权限需要明确确认，不能沿用另一台设备的授权。批量卸载功能会保留原有历史数据，删除数据须另行操作。

参数与常用配置

“运行任务”按当前脚本的声明生成参数表单。必填项、类型和范围不满足时会在原表单提示；网页识别到的值也需要核对。普通参数可在本次浏览器会话中保留，密码和文件按界面提示重新提供。

常用配置用于复用明确选择的参数或连接，不会把所有配置都交给每个脚本。历史已绑定配置的定时任务会按原绑定读取参数；修改连接或 Token 后，建议先手动运行验证。不要把真实凭据写进脚本源码、公开报告或反馈截图。

批量与并发

批量运行会把选定的输入逐项展开成任务。开始前检查条目、目标字段和操作范围，每项任务独立显示结果。

在“设置 → 脚本服务 → 任务运行速度”选择即可：省资源一次运行 1 个任务，标准（推荐）最多同时运行 4 个，更快最多同时运行 8 个。其他任务自动排队；选择后点击“保存运行方式”生效。电脑或网站变慢时，可以调低。

通常不用修改“自定义数量”。原来保存过的自定义设置会保留；这里可以分别调整整个插件、每个功能及每个网站的数量。在“功能配置 → 任务并发”还可以为单个功能选择继承默认或 1–8 个任务。总数量和目标网站限制仍然有效，需要同一个原网页的任务会等待该网页可用。

定时运行

在运行窗口选择定时方式，确认计划和输入后保存。修改或停用计划会更新相应闹钟；执行前会重新检查当前计划状态。

定时任务依赖浏览器与扩展后台可运行。浏览器关闭、休眠、账号或权限失效时，不承诺继续执行；恢复后的补跑以该计划设置和任务记录为准。

任务、数据与报告

先确认任务状态

每个功能有“介绍与管理、任务进程、数据结果、报表、附件文件”几个区域。“任务进程”用于查看排队、运行、完成、失败和停止状态。

成功任务可查看结果；失败任务可重试，修正权限或参数问题后再执行。重试会创建一次新任务，保留原记录。可删除单条或批量删除允许清理的历史记录，运行中的任务须先停止或等待完成。

任务执行、本机结果保存与通知发送分别记录。通知失败不等于采集失败；主动停止也不等于执行错误。看到“结果未知”或回传“待核对”时，先检查已有记录，避免重复产生外部写入。

一次运行是一批结果

“数据结果”的批次选择器用于切换全部数据或某次运行。一次任务采集 36 条记录，仍是一批数据；记录数说明该批内容的多少。

列表显示任务编号、输入摘要与采集时间，帮助区分重复采集；敏感输入会隐藏。可以搜索、按字段筛选、勾选记录和下载 Excel。导出时确认“筛选结果”或“选中记录”的范围。

提醒只在实际打开相应任务详情或本次结果后清除；浏览全部列表不会把所有报告标成已读。脚本声明任务图片且提供有效图片时，任务可显示对应首图；没有图片时显示功能图标。

报表与附件

“报表”基于已有结构化数据创建图表，同一功能的已保存报表全部展开。顶部可选择“一行 1 个”或“一行 2 个”，布局会保存；窄窗口自动显示一列。每份报表都有自己的设置、名称和全屏入口，某张报表失败时仍可查看其他报表。

“BI 看板”可以把保存的报表安排到不同页面与分类，同一报表可放到多个页面。看板支持独立设置、拖动排序和全屏查看。删除看板页面或归属不会删除底层采集数据。

“附件文件”保存脚本实际生成或下载的文件。可以查看本机文件及云盘保存状态；“保存到云盘”由该功能的开关和实际连接共同决定。关闭保存不会删除已有云端副本，重新开启后只处理仍在本机文件库中、尚未确认上传的文件。

在功能配置中开启自动回传时，如果尚未连接云盘，会先打开云盘连接窗口。完成连接后返回当前功能，再确认开启；取消连接不改变这个功能的回传开关，也不会因此开启全部资料备份。

脚本没有结构化数据时，仍可查看原始返回与附件。数据表格按声明的数据结构展示；插件不会通过猜测脚本名称把报告里的任意数组展开成业务数据。

回传飞书或钉钉表格

在当前功能的数据结果或配置中进入“回传表格”，选择已有连接，或保存新的具体数据表链接，核对字段并明确启用。机器人通知与数据表回传使用不同的配置与权限。

确认回传后，后台验证目标权限、匹配字段、补齐允许创建的列、写入并读回确认。关闭工作台窗口不影响已提交的后台回传；浏览器关闭、休眠或账号失效会暂停处理。

本机数据向表格单向回传，不会自动拉回表格中的编辑，也不会自动删除远端旧记录。飞书需具体多维表格链接及该表授权；钉钉 AI 表格需有编辑权限的应用与操作人。普通电子表格或分享短链不能直接替代这些目标。

让 AI 调用功能与查询数据

连接 MCP

进入“设置 → MCP”，按界面引导授权自己的 Cloudflare 账号并准备在线服务。服务地址、证书和连接检测完成后，再复制配置到支持 MCP 的 AI 客户端。无需安装额外本机 MCP 程序。

授权与部署进度在后台进行，关闭配置窗口不等于取消；需要暂停时使用“暂停配置”。网络失败会有限重试，权限撤销、连接冲突等问题需按提示处理。“正在准备访问地址”不代表已经连接成功。

更新在线服务时，在连接检测通过前保留原连接。移除连接会处理对应入口和维护授权，保留个人云项目、本机与云端数据；中途失败按提示重试移除。

分别授权运行和数据查询

功能的运行开关、MCP 调用开关和数据查询授权分别控制。只向 AI 开放你需要的功能；结果数据默认不因安装脚本而全部开放，按数据授权设置明确选择可查询范围。

如果尚未连接或启用 MCP，在功能配置中点击“允许 AI 通过 MCP 运行本功能”会先打开 MCP 连接设置。按引导完成 Cloudflare 连接和授权后返回，再确认开启该功能。未完成连接时不会把开关显示成已生效。

AI 调用仍遵循同一套参数、账号、脚本许可、网站权限和任务并发规则。浏览器离线时，无法执行网页脚本或查询本机报告。远程请求经过你的 Cloudflare 服务并交给调用客户端，应按实际工作需要选择授权内容。

MCP 授权有效期、试用与续期状态以设置中的授权页面为准。到期或更换电脑后，检查当前授权、连接和功能开关；只开账号备份不会自动开启 AI 调用。

让 AI 帮你编写脚本

需要目录中没有的功能，可以下载AI 开发手册交给外部 AI Agent。先说明目标、输入、结果和运行范围，再确认需求及验收标准，最后安装完成的脚本验证。

开发参数、数据结构和权限声明见脚本开发说明；平台接口差异与已验证结论见实测知识库。这部分资料与普通使用指南分开维护。

书签与小工具

收藏和整理网页

在网页助手的“书签”中点击加号，或从工作台个人中心添加。页面、分类与小组可以一起选择；名称支持新增。分类可选择图标或列表，小组以 Tab 切换，书签可拖动排序或移动到其他分类、小组。

账号、密码和两步验证信息是可选项，留空可只保存书签。网页已填写的登录信息只有实际识别到时才会带入；密码框按是否存在真实内容显示，不用默认星号假装已保存。需要时可在编辑窗重新读取，核对后再保存。

邮箱、笔记与验证码

“小工具”集中提供邮箱、记事本、两步验证、网站账号和 Passkey 等入口。邮箱默认按纯文本阅读，可切换原文排版或重新读取正文；具体收发、缓存和附件权限按该邮箱配置处理。

匹配当前 HTTPS 网站的账号或验证器可以主动填入；多账号时先选择。验证码支持单框及分格框，不替你点击网站提交。网站自身可能在完整输入后立即验证。关联按准确的网站来源判断，不按品牌名称猜测。

Passkey

在书签编辑窗口点击“添加 Passkey”，选择此网站已打开的安全设置页面，点击“准备保存并前往网站”。如果尚未打开网站，先从窗口打开并登录，再回来刷新标签页列表。随后由网站发起创建通行密钥，插件在独立确认窗口中解锁并保存；书签窗口本身不能替网站生成注册请求。

在对应网站先从插件“准备保存新 Passkey”或“准备登录”，再回到网站发起通行密钥操作，并在插件窗口输入独立解锁密码确认。完成、取消或超时后结束本次接管。

现有系统或浏览器 Passkey 不能直接导入，可在网站允许时重新登记。插件保存的通行密钥使用独立密码保护；新电脑恢复后仍需原解锁密码，账号恢复密钥不能替代它。忘记密码无法恢复这些通行密钥，应保留网站其他登录方式。具体兼容范围见账号与凭据能力说明。

备份与恢复

选择适合的备份位置

在连接与备份中选择“连接并启用完整备份”后，上述云盘备份内容一起启用，不再逐项勾选。已有连接也可以点击“启用完整备份”；只是打开设置，不会重新开启原来暂停的备份。

原来明确关闭的某个功能、数据集或邮箱仍保留原选择。只会备份本机已有的实际内容，不补下载缺失的历史附件。暂停或移除连接不会删除已有备份文件。

备份到电脑文件夹

浏览器会让你选择文件夹并授予写入权限。数据库与私有资料使用恢复密码加密保存，附件按备份清单保存并校验。请保管好文件夹和恢复密码。

有实际内容变化时可自动生成备份；暂停自动备份后仍可手动备份。浏览器关闭、文件夹权限失效或磁盘不足时会暂停或报错，不把不完整写入当作成功。只有下载路径、没有正文的历史文件，不会被当作已经备份了文件内容。

从备份恢复与换电脑

选择备份目录或连接相同备份目标，先读取并校验备份，再查看恢复预览，确认后合并可恢复内容。恢复保留已有资料与删除保护，不按一个文件名直接覆盖当前数据库；恢复的脚本需要重新确认并启用。

账号按现行单台登录规则管理，换电脑可能使旧电脑退出。新电脑先检查连接并恢复已有资料，再开启后续备份；网站权限、脚本许可、自动填充与某些服务授权仍需本人确认。Passkey 还需原来的独立解锁密码。

只浏览备份列表或打开恢复预览不会执行恢复。旧格式、缺失正文或校验失败会在恢复阶段提示，不猜测补回缺失文件。不要为了修复连接错误先删除本机数据。

通知与常用设置

在哪里调整设置

显示设置和 MCP 不需要再打开一层设置窗口。脚本服务按“任务运行速度、AI 分析接口、HTTP 请求、飞书表格、外部 MCP”分块，已保存的配置和添加按钮都在对应分块中；只有新增或编辑时才打开表单。

HTTP 请求只填写该请求的地址、认证和参数；不需要在此选择 AI、MCP 或表格模板。填写后可保存，取消则返回原设置页面。外部 MCP 服务用于让脚本调用外部工具，统一在“脚本服务”中管理；“MCP”设置用于让 AI 调用插件功能和数据。

任务通知

飞书和钉钉机器人用于任务通知，也可在明确配置后接收指令；它们不是普通脚本运行的前置条件。未绑定飞书时，工作台顶部与运行区域提供醒目提醒，仍可提交任务。

关闭提醒后，本次打开工作台期间切换页面和刷新同一标签页不会反复提示；下次重新打开工作台仍未绑定时会再次显示。关闭提醒不改变真实通知开关。绑定且启用后提示自动消失。

机器人显示“已绑定”不一定代表当前电脑的推送凭据和网站权限已经齐备。通知失败时，在通知设置中检查授权、同步本机推送并发送测试消息；脚本成功、本机保存和通知发送分别查看。

通过飞书私聊运行功能，需要按连接说明开启个人服务与消息事件，并在本机打开接收指令。只在需要接收的电脑开启，功能和参数仍会校验。原始数据保留在工作台，通知并不替代结果归档。

更新与问题排查

更新插件和脚本

官网和 GitHub 提供同一份通用 ZIP。下载新版后覆盖原固定文件夹，再到浏览器扩展管理页重新加载插件，重新打开工作台并刷新旧网页。保留原目录和扩展身份，不要通过卸载来更新；不同扩展 ID 的本机资料不会自动互读。Chrome 商店安装由浏览器按商店版本更新。

脚本有自己的版本，在该功能的配置中检查更新。插件已更新不代表已安装脚本自动升级；旧脚本缺少新声明时，需由作者更新脚本。

常见情况

反馈问题时提供插件版本、脚本名称与版本、操作步骤、任务时间和错误提示。截图和日志先移除账号、Cookie、Token、License 等敏感信息。

更多资料：脚本开发 · 实测知识库 · 隐私政策 · 下载与更新。