Site Sense

site-sense

让你的 AI 编码命令行工具看见 Web 门户。无需云端，不存储数据，只读。

你正在和 AI 助手对话。它说 “前往 Azure Portal，检查 NSG 规则。” 你切换窗口、导航、截图、描述所见，再把内容粘贴回去。你成了人工中间件。

site-sense 可以解决这个问题。 AI 调用 MCP 工具 → 浏览器扩展捕获当前标签页 → AI 看到你所看到的内容。

快速开始

选项 A：从 Chrome Web Store 安装（推荐）

1. 从 Chrome Web Store 安装 site-sense
2. 克隆仓库并运行设置：

git clone https://github.com/NordmanLive/site-sense.git
cd site-sense
npm install && npm run build
npm run setup -- --browser chrome    # or edge

选项 B：加载未打包的扩展（开发）

git clone https://github.com/NordmanLive/site-sense.git
cd site-sense
npm install && npm run build
npm run setup -- --browser chrome    # or edge

然后手动加载扩展：

1. 打开 edge://extensions（或 chrome://extensions）
2. 启用开发者模式
3. 点击加载已解压的扩展程序 → 选择 dist/extension/

将以下内容添加到命令行工具的 MCP 配置中：

{
  "mcpServers": {
    "site-sense": {
      "command": "node",
      "args": ["/path/to/site-sense/dist/bridge/src/index.js"]
    }
  }
}

然后询问 AI：“我的浏览器标签页上有什么？”

首次使用时 → 会弹出窗口 → 点击允许 → 完成。之后所有捕获都会自动进行，直到你关闭终端。

工作原理

CLI (Claude Code / Copilot CLI)
    ↕ stdin/stdout (MCP protocol)
MCP Server (TypeScript)
    ↕ Unix domain socket (no network)
Native Host (thin relay)
    ↕ Chrome native messaging (stdio)
Extension (TypeScript, Manifest V3)
    ↕ inject → content → background
Browser Tab → accessibility tree + screenshot

两个 MCP 工具：

工具	功能
site_sense_capture	当前标签页的无障碍树和屏幕截图
site_sense_status	检查连接状态和会话授权情况

权限模式

模式	效果	安装警告
默认	在每个页面点击扩展图标以授予访问权限	无
所有网站	在弹出窗口中切换 → 可捕获任意页面	一次性提示

CLI 会话结束时，所有网站权限会被撤销。

安全性

原则	方式
不联网	使用原生消息传递（stdio）——DLP 无法检测
不存储数据	仅驻留内存——CLI 断开连接后即消失
不执行写操作	绝不会点击、输入或修改页面
不申请宽泛权限	activeTab + scripting + nativeMessaging
不捕获机密	跳过表单值，移除 URL 令牌
权限仅限当前会话	每次 CLI 会话都会重置权限

请参阅 SECURITY.md，了解威胁模型和 DLP 合规性。

架构

扩展包含三层处理流程：

层	上下文	职责
注入层	页面（world: MAIN）	遍历 DOM，构建紧凑的无障碍树
内容层	隔离环境	通过 postMessage 中继捕获请求（验证来源）
后台层	Service Worker	原生消息传递、会话状态、屏幕截图

技术栈

组件	技术
扩展	TypeScript + Vite
MCP 服务	TypeScript + @modelcontextprotocol/sdk + zod
测试	vitest — 10 个测试，耗时 <1s
构建包	扩展 9KB，总计 7 个依赖项

故障排除

症状	解决方法
connected: false	扩展未加载，或 ID 不匹配。检查 edge://extensions。
Cannot capture	导航到 http:// 或 https:// 页面。
内容脚本无响应	点击页面上的扩展图标，或启用所有网站模式。
扩展图标显示为灰色	在 edge://extensions 中重新加载扩展。

文档

文档	用途
SECURITY.md	威胁模型、DLP 合规性

许可证

Apache-2.0