基于 ScriptCat 引擎 · 用户脚本工具集

ScriptCats

一套面向 ScriptCat 引擎的用户脚本、可复用库与 Agent Skills，专注浏览器自动化、内容处理与日常效率工具的工程化实践。

5
用户脚本
9
可复用库
6
Agent Skills
UMD
通用模块规范

✨项目亮点

面向浏览器端的工程化脚本与库，便于复用、二次开发与跨项目协作。

🧩
模块化库
所有库采用 UMD 规范，兼容 ScriptCat、油猴、Node.js 与 AMD。
🤖
Agent Skills
为 ScriptCat Agent 提供浏览器自动化、定时任务等可调用技能。
🔐
类型安全
提供 TypeScript 声明文件，支持智能提示与编译期检查。
📦
开箱即用
单文件 .user.js 即可安装，每个库附带 demo.html 与 README。

📜用户脚本

直接安装到 ScriptCat 即可运行的 .user.js，覆盖 AI、文件上传、订阅解析与发布辅助。

AI 会话面板（智能猫）
smartcat.user.js
单文件 ScriptCat AI Agent 面板，支持页面内唤起、发送上下文、复制结果和本地配置。
v1.0.0@match *://*/*document-idle
安装脚本
AI 选择工具栏
ai-selection-toolbar.user.js
选中文本后显示可配置的 AI 工具栏：问问 AI、复制、翻译、朗读、总结。
v1.0.1GM_xmlhttpRequest@require TextSelectionToolbar
安装脚本
OPFS 文件上传助手
opfs-uploader.user.js
通过脚本猫菜单上传文件或文件夹到指定 OPFS 目录，带美观 UI 界面与进度展示。
v0.4.1CAT.agent.opfsGM_addStyle
安装脚本
SingBox 订阅解析器
parser-singbox-config.user.js
解析 sing-box 订阅 URL，提取节点信息并生成可用的 config.json，支持一键复制。
v0.1.0@connect *GM_setClipboard
安装脚本
ScriptCat 自动生成描述助手
scriptcat-publish-assistant.user.js
在 ScriptCat 发布脚本时，自动根据脚本代码生成描述和更新日志，节省重复编写时间。
v0.4.1@match scriptcat.orgCAT.agent.conversation
安装脚本

📚可复用库

采用 UMD 通用模块规范，可被脚本猫、油猴脚本、Node.js 与 AMD 环境直接引用。

CNBClient
libs/CNBClient
CNB 平台 API 客户端：自动处理 access_token、仓库 / Issue / PR / 构建流水线 / 工作空间等资源的 CRUD。
createIssuesearchIssuesGM_xmlhttpRequest
READMEDemo
ContextMenu
libs/ContextMenu
浏览器右键菜单组件，支持自定义菜单项、分组、图标、快捷键与事件回调。
DOMUMD
READMEDemo
TextSelectionToolbar
libs/TextSelectionToolbar
文本选择工具栏组件，划词即出现悬浮操作条，支持事件、SVG 图标与生命周期管理。
SVGEvent
READMEDemo
XUtils
libs/XUtils
通用工具函数库：类型检测、文件操作、字符串工具、Cookie、DOM 工具、数据转换与函数工具。
typeCheckcookiedom
README
XHooks
libs/XHooks
Web API Hook 工具库：hookJSONParse / hookFetch / hookXMLHttpRequest / hookPromise，支持 pre/post 钩子。
pre/postXHRPromise
README
XCryptos
libs/XCryptos
MD5 / HMAC-MD5 / WebCrypto Hash 加密工具库，统一封装 WebCrypto 与回退实现，支持 hex / base64 输出。
MD5HMACWebCrypto
README
LineLoadingProgress
libs/LineLoadingProgress
顶部线性加载进度条组件，常用于模拟页面加载状态，可独立控制进度与完成动画。
UIanimationUMD
READMEDemo
Sha
libs/Sha
基于 jsSHA 的 SHA 哈希工具库，支持 SHA-1 / SHA-256 / SHA-512 等多种摘要算法。
SHA-1SHA-256SHA-512
README
ElementSelector
libs/ElementSelector
页面元素选择工具库：让用户通过鼠标点选 DOM 元素，hover 高亮 + 浮动面板（确认/取消），支持回调与 Promise 双形态。
Shadow DOMtoSelectHTMLtoSelectText
READMEDemo
page-agent
libs/page-agent
基于 alibaba/page-agent 1.12.2 的浏览器内 AI 代理：用自然语言指令驱动 LLM 自动操作页面（点击、滚动、读取元素等）。
AI Agentqwen3.5-plusShadow DOM
READMEDemo

🎬库演示入口

所有 libs/**/demo.html 的演示页面集中入口，浏览器中可直接预览效果。

CNBClient 演示
libs/CNBClient/demo.html
CNB 平台 API 客户端演示：仓库、Issue、PR、构建流水线、工作空间等 CRUD 操作的可视化测试。
createIssuesearchIssuesworkspaces
打开 DemoREADME
ContextMenu 演示
libs/ContextMenu/demo.html
浏览器右键上下文菜单组件演示：自定义菜单项、分组、图标、快捷键与事件回调的可视化示例。
DOMUMDshortcut
打开 DemoREADME
TextSelectionToolbar 演示
libs/TextSelectionToolbar/demo.html
文本选择工具栏组件演示：划词后悬浮操作条，支持事件、SVG 图标与生命周期管理。
SVGEventfloating
打开 DemoREADME
ElementSelector 演示
libs/ElementSelector/demo.html
页面元素选择工具演示：鼠标点选 DOM 元素、hover 高亮 + 浮动面板（确认/取消），支持回调与 Promise。
Shadow DOMtoSelectHTMLtoSelectText
打开 DemoREADME
XUI 演示
libs/XUI/demo.html
XUI.notify 通知演示：Shadow-DOM 隔离的 toast 组件，四种语义类型、自定义时长、多通知堆叠。
toastShadow DOM零依赖
打开 DemoREADME
page-agent 演示
libs/page-agent/demo.html
浏览器内 AI 代理演示：可视化配置 model / baseURL / apiKey / maxSteps，可手动执行自然语言任务（含内置测试场景：购物车、导航、读取按钮文本等）。
AI Agentqwen3.5-plusShadow DOM
打开 DemoREADME
LineLoadingProgress 演示
libs/LineLoadingProgress/demo.html
顶部进度条演示：4 种样式预设、6 个真实业务场景（基础/trickle/手动控制/异步/错误回滚/动态改配置）、滑块控制 set/inc、实时进度环可视化。
UIanimationUMD
打开 DemoREADME

🚀快速开始

在用户脚本中通过 @require 一键引入，或在浏览器中直接打开 demo.html。

在脚本猫中引用
// ==UserScript==
// @name 我的脚本
// @require https://cdn.jsdelivr.net/gh/.../CNBClient.js
// @grant GM_xmlhttpRequest
// ==/UserScript==

const client = new CNBClient({ accessToken: 'xxx' });
await client.createIssue({ repo: 'foo/bar', title: 'bug' });
在普通网页中调试
<!-- 直接引入 UMD 版本 -->
<script src="./libs/CNBClient/cnbclient.js"></script>
<script src="./libs/XUtils/xutils.js"></script>

<script>
  const utils = new XUtils();
  utils.log(utils.isString('hello'));
</script>

🤖Agent Skills

位于 skills/scriptcat-skills 的 ScriptCat Agent 技能包，通过 SKILL.cat.md 一键安装。

🌐
browser-automation
页面分析、DOM 操作、表单填写、截图、导航
⏰
scheduled-tasks
基于 cron 的定时任务，支持 internal / event 模式
🛠️
skill-creator
辅助创建、测试和打包新的 Skill
📄
file-parser
解析 Excel / PDF / Word / CSV / PPT 等格式
🐱
scriptcat-dev
脚本猫 / 油猴脚本开发助手 — 编写、调试、优化
📊
synology-office-sheet
读写群晖 Synology Office 电子表格单元格
📱
wechat-publisher
微信公众号运营助手 — 素材收集、文章编写与发布
🌸
xiaohongshu-publisher
小红书运营助手 — 笔记编写、风格学习、配图生成

⚙️开发工具

辅助本仓库开发与脚本维护的工具链与资源。

TypeScript 声明
scriptcat.d.ts · global.d.ts
为 ScriptCat GM_* 与 CAT.agent.* API 提供完整类型定义，配合 IDE 实现智能提示与编译期校验。
查看 scriptcat.d.ts查看 global.d.ts
merge-dts.sh
merge-dts.sh
一键合并仓库内所有 *.d.ts 到 global.d.ts，自动跳过 scriptcat.d.ts 等重复声明，可加 --dry-run 预览。
查看脚本
文档与教程
docs/
本地缓存的 ScriptCat 官方文档与脚本猫变更日志，便于离线查阅与版本对照。
浏览文档