# Admin.NET.Copilot-plugins

**Repository Path**: nobb2333/admin.net.copilot-plugins

## Basic Information

- **Project Name**: Admin.NET.Copilot-plugins
- **Description**: admin.NET 项目的浏览器插件部分
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-27
- **Last Updated**: 2026-04-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Admin.NET AI 插件

[English](./README_EN.md) | **中文**

<p align="center">
  <img src="public/icon/128.png" alt="Admin.NET AI 插件" width="128" height="128">
</p>

<p align="center">
  <strong>为 Admin.NET 项目提供 AI 功能的浏览器扩展插件</strong>
</p>

## 功能特性

- 🤖 **AI 对话** - 与 Admin.NET 集成的智能对话助手
- 📝 **OCR 识别** - 截图和图片文字识别功能
- 📚 **知识库** - AI 驱动的知识管理系统
- 💬 **历史记录** - 对话历史管理
- ⚙️ **自定义配置** - 灵活的设置和个性化选项
- 📋 **表单辅助** - AI 辅助表单填写

## 安装方式

### 从源码安装

1. 克隆仓库
```bash
git clone https://github.com/your-username/Admin.NET_Plugin.git
cd Admin.NET_Plugin
```

2. 安装依赖
```bash
pnpm install
```

3. 构建扩展
```bash
pnpm build
```

4. 在浏览器中加载扩展
   - 打开 Chrome/Edge 浏览器，访问 `chrome://extensions/`
   - 启用"开发者模式"
   - 点击"加载已解压的扩展程序"，选择 `.output/chrome-mv3` 目录

## 开发指南

```bash
# 启动固定 9222 的浏览器；也可手动指定端口
pnpm browser
pnpm browser -- --port 9222

# WXT 原生开发模式，会像以前一样自动打开浏览器
pnpm dev

# 接管已有浏览器；如果没有，就自动起一个，再把扩展装进去
pnpm dev:attach
pnpm dev:attach -- --port 9222

# 生产环境构建
pnpm build

# Firefox 版本构建
pnpm build:firefox

# 创建 zip 压缩包
pnpm zip
```

### 避免每次开发都打开新浏览器

项目现在只保留三个开发命令。

命令说明：

- `pnpm browser`
  启动一个固定 `9222` 的专用 Chrome/Edge。也支持 `pnpm browser -- --port 9333` 临时指定端口。
  日志会打印当前使用的端口、profile 路径，以及是否顺带预加载了已构建的扩展。
- `pnpm dev`
  纯 WXT 原生开发模式，会自动打开浏览器。
  日志会明确打印这是 WXT 原生 runner，不是 attach 模式；端口通过 `WXT_CHROMIUM_PORT` 传给 WXT，默认是 `9222`。
- `pnpm dev:attach`
  先启动 WXT，等 `.output/chrome-mv3-dev` 构建完成后：
  如果 `9222` 已有浏览器，就接管它并自动加载扩展；
  如果没有，就自动启动一个 `9222` 浏览器，并直接带上 `--load-extension` 把扩展装进去。
  也支持 `pnpm dev:attach -- --port 9333` 指定目标端口。
  日志会明确打印它最终走的是：
  `CDP Extensions.loadUnpacked` 注入已有浏览器
  或
  `--load-extension` 启动新浏览器
  如果检测到 Chrome 137+，启动时会直接打印 attach 风险警告。

首次成功加载后，扩展会出现在这个专用 profile 里。由于现在使用固定扩展 ID，你只需要在这个 profile 里 pin 一次，后面就会一直保留。

说明：
- 当前这套栈里，WXT/web-ext 不能真正 attach 到一个现成的 Chromium 进程并替它装扩展，所以“接管”本质上是复用你已经启动好的固定 profile 浏览器。
- 专用浏览器 profile 默认放在 `/tmp/admin-net-plugin-dev-profile`，避免污染你日常浏览器。
- 如果你手动启动 Chrome，请带上 `--enable-unsafe-extension-debugging`，否则通过 CDP 自动加载扩展很可能失败。
- Chrome 没有给扩展提供可靠的“自动固定到工具栏”官方接口，所以这一步无法稳定脚本化。现在已经把扩展 ID 固定住了，pin 一次后会跟着这个 profile 长驻。

### 兼容性记录

- `pnpm dev`
  依赖 WXT 原生 runner。当前项目使用 `WXT 0.20.13`，这条链路是最稳定的。
- `pnpm dev:attach`
  属于补充链路，不等同于 WXT 原生能力。
- 在品牌版 Google Chrome 上，基于 `--load-extension` 或 CDP 的自动装载链路不如 WXT 原生 runner 稳定。
- 根据 Chrome 官方 2025 年 6 月公告，`--load-extension` 自 Chrome 137 起已被移除，因此在较新版本的品牌版 Chrome 上，这条 attach 链路可能失效或行为不稳定。
- 当前机器上的 Google Chrome 版本是 `146.0.7680.165`。在这个版本上，`pnpm dev:attach` 已验证存在“不显示扩展入口/未真正装入 profile”的风险。
- 如果后续需要把 attach 链路做得更可靠，应优先切换到 Chromium 或 Chrome for Testing，而不是继续依赖品牌版 Google Chrome。

## 技术栈

- **框架**: [WXT](https://wxt.dev/) + [Vue 3](https://vuejs.org/)
- **状态管理**: [Pinia](https://pinia.vuejs.org/)
- **数据库**: [Dexie](https://dexie.org/) (IndexedDB)
- **语言**: TypeScript

## 推荐 IDE 配置

- [VS Code](https://code.visualstudio.com/) + [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar)

## 许可协议

本项目是 [Admin.NET](https://github.com/zuohuaijun/Admin.NET) 生态系统的一部分。