智能猫 SmartCat 用户脚本
脚本简介
智能猫（SmartCat）是一个运行在 ScriptCat 扩展环境下的轻量级 AI Agent 面板脚本。它以单文件形式实现，为用户提供了一个便捷的浮动面板，可以通过快捷键在任意网页上快速唤起，向 ScriptCat 内置 AI Agent 发送问题或指令。
功能介绍
- 快捷键唤起面板
Windows/Linux：Alt+K
macOS：Command+K 或 Alt+K
按下快捷键即可在页面中央打开智能猫面板，也可以通过 ScriptCat 扩展菜单中的「打开智能猫 SmartCat」选项唤起。
- @上下文引用
在输入框中输入 @ 符号可触发上下文引用功能，支持以下几种引用类型：
| 指令 | 功能说明 |
|------|----------|
| @file | 引用一个本地文本文件作为上下文 |
| @selection | 在页面上选择一个 DOM 节点作为上下文 |
| @page | 自动提取当前页面的正文文本作为上下文 |
| @img | 在页面上选择一张图片作为上下文 |
输入 @ 后会自动显示可用的引用选项，按 Tab 键可快速补全。
- 工具栏操作
面板底部提供以下操作按钮：
发送：向 AI Agent 发送当前输入的内容（快捷键：Ctrl/⌘+Enter）
重试：重新发送上一次的消息
复制：将 AI 回复内容复制到剪贴板
清空：清空当前的回复显示
文件：打开本地文件选择器
最近：查看最近 8 条对话记录
清本地：清除所有本地存储的草稿和历史记录
- 节点选择器
当使用 @selection 或 @img 时，脚本会进入节点选择模式：
鼠标移动时，高亮显示可选择的元素
顶部显示当前悬停元素的详细信息（标签名、字符数或图片尺寸）
点击确认选择，Esc 键取消选择
选择完成后自动返回面板
- 智能上下文构建
发送消息时，脚本会自动构建包含以下信息的上下文：
当前网页标题
当前页面 URL
当前选中文本（未使用 @selection 时）
用户引用的文件内容
用户选择的页面节点内容
用户选择的图片信息
页面正文文本（使用 @page 时）
- 本地数据管理
自动保存草稿：输入内容会自动保存，关闭面板后重新打开可恢复
对话历史：最近 8 条对话记录保存在本地
跨页面同步：使用相同的存储键，草稿和配置可跨会话保留
- 面板拖拽
面板顶部标题栏支持鼠标拖拽移动位置
拖拽时面板自动切换到绝对定位模式
面板位置会限制在视口范围内
使用方法
基础使用流程
- 在任意网页上按下快捷键（Alt+K 或 Command+K）
- 在输入框中输入您的问题
- 可选：使用 @ 指令添加上下文引用
- 按下发送按钮或 Ctrl/⌘+Enter 提交
- 等待 AI 回复，查看显示区的响应内容
- 使用复制按钮或手动选择复制回复内容
- 按 Esc 或点击 × 按钮关闭面板
添加文件上下文
- 在输入框中输入 @file 并确认
- 或直接点击工具栏的「文件」按钮
- 选择一个本地文本文件
- 文件内容将被读取并附加到消息上下文中
- 发送消息
添加页面内容上下文
- 输入 @selection 或 @img
- 进入节点选择模式后，将鼠标移到目标内容上
- 点击确认选择
- 发送消息
查看历史记录
- 点击「最近」按钮
- 查看最近 8 条对话的 Q&A 内容
- 可手动复制需要的对话内容
技术特性
存储机制
脚本优先使用 ScriptCat 的 GM_getValue/GM_setValue API，失败时自动降级到 localStorage。这确保了在不同环境下都能正常工作。
字符限制
为防止上下文过大，脚本对各类内容设置了字符上限：
| 内容类型 | 最大字符数 |
|----------|-----------|
| 附件文件 | 12,000 |
| 页面正文 | 20,000 |
| 节点文本 | 12,000 |
超过限制的内容会被截断，并在上下文中标注提示。
样式隔离
面板使用 Shadow DOM 风格的 CSS 隔离，所有样式都带有 !important 声明，确保在任意网页上都能正确显示，不受页面原有样式影响。
系统要求
已安装 ScriptCat 浏览器扩展
扩展版本支持 CAT.agent.conversation API
现代浏览器（Chrome、Firefox、Edge 等主流浏览器）
注意事项
- 脚本需要 ScriptCat 扩展环境才能调用内置 Agent，纯油猴环境下会提示 API 不可用
- 节点选择器会排除面板自身元素，避免选层面板
- 面板使用高 z-index（2147483647）确保始终在最顶层
- 文件读取仅支持文本文件，不支持二进制文件
- 面板状态（位置、配置）不会持久化保存，刷新页面后重置
