GitHubHelp

Michaelxwb/ai-api-plugin

统一模型接入 SDK，提供插件接入方式

★ 1Forks 0TypeScriptGitHub ↗Compare

README

AI API Plugin

用于将浏览器中的第三方 AI 平台接入到评估平台（plugin-platform）。插件通过 WebSocket 与服务端通信，在目标网页内完成定位、输入、发送与结果抓取。

功能

  • 连接 WebSocket 服务（plugin-platform）
  • 手动定位页面元素并生成 locators
  • 自动发送问题并获取回复
  • 心跳保持与断线重连

目录结构

  • src/ 插件核心逻辑（background/content/locator/sender）
  • popup/ 插件设置页面
  • dist/ 构建输出（加载到 Chrome）

环境要求

  • Node.js 18+（建议 LTS）
  • Chrome / Chromium

安装依赖

npm install

构建

npm run build

本地加载到 Chrome

  1. 打开 chrome://extensions
  2. 开启「开发者模式」
  3. 点击「加载已解压的扩展程序」，选择本项目的 dist/

基本使用

  1. 打开插件设置页
  2. 填写 WebSocket 地址（如 ws://localhost:8080/ws）
  3. 需要鉴权时填写 Token
  4. 点击「保存配置」→「连接」
  5. 进入目标平台页面，按平台要求完成元素定位

配置字段说明

  • WebSocket 服务地址：评估平台的 WebSocket 地址
  • 认证令牌：服务端启用鉴权时填写
  • 心跳间隔：保持连接的心跳频率（毫秒）

常见问题

  • 连接不上：确认 plugin-platform 服务已启动，地址正确，浏览器网络可访问
  • 断线重连慢：调整心跳间隔、检查浏览器是否休眠或节能模式
  • 无响应：确认 locators 对应当前页面结构，必要时重新定位

相关项目

Contributors

Michaelxwb

Issues