跳到正文

Lumo Userscripts

Lumo Userscripts

用一句话得到的脚本。

原生 MV3 用户脚本管理器,提供标准 MCP 端点。Lumo 可以在获得批准后创建、编辑并启用脚本。

MCP 端点chrome.userScriptsGM API本地优先
智能体集成

智能体能操作的扩展。

Lumo 通过 MCP 连接,请求一次批准,然后在读懂页面的同一段对话里创建、编辑并启用脚本。

  • 默认只读,写入需单独开启
  • 复核模式让新脚本保持禁用
  • 每次写入都有审计
阅读连接指南
智能体协议

读、写、复核。

探测决定提供方是否可用;三个独立开关决定智能体能做什么。

H

Lumo

MCP 客户端

Lumo Userscripts

MCP 提供方

P
L0

L0 探测:已安装、已开启、已授权?

sendMessage(extId, { channel: 'lumo:probe' })
L0

无状态返回服务与状态

{ service, status: { enabled, authorized, ready } }
—

你批准调用方一次

settings → agent → allowedExtensionIds
L1

L1 会话:运行端口上的 MCP

connect(extId, { name: 'lumo:mcp' })
L1

智能体调用工具面

tools/list · tools/call
只认 sender.id
每次调用复核策略
写入审计

端点

默认关闭。

写入

第二个开关。

复核

新脚本保持禁用。

工具面namespace: userscripts
list

脚本库,或某个 URL 上运行的脚本。

只读
get

元数据与分页源码。

只读
diagnostics

运行时可用性、注册与错误。

只读
set_enabled

启用或禁用脚本。

写入
create

校验元数据并保存新脚本。

写入
edit

原子锚点编辑。

写入
update

替换源码或元数据覆盖。

写入
install

从 URL 安装及其依赖。

写入
delete

移入回收站。

写入
只读工具需要授权;写入需要单独开关,并记录审计。
安装

装一次,到处运行。

粘贴 URL、拖入文件或使用剪贴板。安装页先展示脚本的触达范围。

  • URL、文件与剪贴板
  • @require 与 @resource 解析
  • 感知权限的更新
阅读文档
编辑器

真正的编辑器,不是文本框。

CodeMirror 6、元数据校验、覆盖、变量与资源——智能体编辑的是同一份脚本。

  • CodeMirror 6
  • 元数据校验与覆盖
  • 变量和资源在同一处
阅读文档
运行时

原生注册,两套引擎。

脚本通过 chrome.userScripts 运行。MAIN world 服务页面脚本,隔离 host 运行沙箱脚本。

引擎MAIN + USER_SCRIPT
匹配@match · @include
依赖@require · @resource
存储IndexedDB

GM_setValue

按脚本存储

GM_xmlhttpRequest

跨域请求

GM_cookie

Cookie 访问

GM_download

受管下载

GM_notification

系统通知

GM_registerMenuCommand

脚本命令

GM_addStyle

作用域样式

GM_addElement

DOM 注入

GM_setClipboard

写入剪贴板

GM_getTab

标签页状态

unsafeWindow

页面世界访问

GM.* aliases

Promise 化 API

变量在更新后仍然保留
1// 读取一次,变化时写入。
2const theme = GM_getValue('theme', 'system');
3GM_registerMenuCommand('切换主题', () => {
4 GM_setValue('theme', theme === 'dark' ? 'light' : 'dark');
5});
控制

没有你的许可,什么都不会运行。

权限在安装前可见。需要更多权限的更新会等待批准。日志与回收站都在一次点击之内。

权限用途
userScripts动态脚本注册
storage, unlimitedStorage设置与受限元数据
tabs, activeTab, webNavigation, scripting标签页上下文与诊断
declarativeNetRequest把 .user.js 导航重定向到安装页
cookies, downloadsGM_cookie、GM_download
notifications, contextMenus, alarms, clipboardWriteGM API 与后台任务

回收站

删除的脚本仍可恢复。

备份

导出与恢复 JSON 或 ZIP。

更新检查

新增权限必须由你决定。

日志

注册与运行时诊断。

安装

Chrome 138+ 与一个开关。

Chrome 要求你为扩展允许一次用户脚本。

01

打开发布页

下载压缩包或未打包构建。

打开 GitHub Releases
02

加载已解压扩展

启用开发者模式,然后加载已解压的扩展程序。

阅读文档
03

允许用户脚本

在扩展卡片上启用「允许用户脚本」。

阅读文档
Chrome 138+。仅在从源码构建时需要 Node 22+。隐私

同样来自 Lumo

想先读懂页面?

Lumo 能读懂页面、调用浏览器与 DevTools 工具,并通过 MCP 驱动这个管理器。

了解 Lumo