# eval-chrome-plus

**Repository Path**: xeval/eval-chrome-plus

## Basic Information

- **Project Name**: eval-chrome-plus
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-11-05
- **Last Updated**: 2026-11-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Chrome Plus

> 一个**谷歌浏览器插件聚合项目**：单个仓库承载多个相互独立的 Chrome 扩展（Manifest V3）。

## 项目简介

AI Chrome Plus 是一个 Chrome 插件（浏览器扩展）聚合开发仓库。与「一个仓库一个插件」的组织方式不同，本项目把**多个独立功能的插件**放在同一个仓库中统一管理：

- 每个插件在 `plugins/<plugin-name>/` 下**自成一体**，拥有自己的 `manifest.json` 与源码；
- 插件之间**互不依赖**，可以各自独立开发、独立加载调试、独立打包发布；
- 仓库层面只提供统一的目录约定、忽略规则与（后续）批量构建 / 打包脚本，不把多个插件耦合到一起。

当前已落地**第一个插件**（`deepseek-translate`），其余插件将按同一套约定逐个加入。

## 已完成插件

> 一个插件一行、一句话说明。新增插件后在表尾追加，并把详细文档写进该插件自己的 `README.md`。

| 插件 | 一句话说明 | 版本 |
| --- | --- | --- |
| [`deepseek-translate`](plugins/deepseek-translate/README.md) | 划词或输入框里的文字，调 DeepSeek 自动在中英文之间互译，译文可直接替换原文。 | v0.1.0 · 可用 |

- 安装与配置（填 DeepSeek API Key、选提示词）见插件文档：[plugins/deepseek-translate/README.md](plugins/deepseek-translate/README.md)
- 暂无其它插件；新增插件请按「[新增插件规范](#新增插件规范)」落地，并在此表登记。

## 项目状态

| 项 | 说明 |
| --- | --- |
| 仓库形态 | 多插件聚合（monorepo） |
| 运行形态 | Chrome 扩展，每个插件独立为 Manifest V3 包 |
| 已完成插件 | 1 个（`deepseek-translate`，v0.1.0） |
| 插件存放位置 | `plugins/<plugin-name>/` |
| 仓库地址 | `git@gitee.com:xeval/eval-chrome-plus.git` |
| 主分支 | `main` |

## 目录结构

```
.
├── plugins/                          # 所有插件的聚合目录（一个子目录 = 一个插件）
│   ├── deepseek-translate/           # ✅ 已完成：DeepSeek 划词翻译（v0.1.0）
│   │   ├── manifest.json             # 该插件的 Manifest V3 入口
│   │   ├── src/
│   │   │   ├── background/           # Service Worker：翻译请求出口、菜单、快捷键
│   │   │   ├── content/              # Content Script：划词悬浮 / 译文卡片 / 输入框替换
│   │   │   ├── popup/                # 工具栏弹窗
│   │   │   └── options/              # 设置页（Key、提示词、推荐案例、开关）
│   │   ├── test/                     # node:test 单元测试（打桩 fetch，不烧额度）
│   │   ├── scripts/check.mjs         # 静态自检：manifest / 引用 / DOM id / 消息闭环
│   │   └── README.md                 # 该插件自己的说明
│   └── <plugin-name>/                # 后续插件沿用同一结构
├── shared/                           # （规划）跨插件复用的纯函数模块
├── scripts/                          # （规划）批量构建、打包、发布脚本
├── docs/                             # （规划）全局性文档
├── .gitignore
└── README.md
```

> `shared/`、`scripts/`、`docs/` 为规划项，按需逐步引入；单个插件内部结构也可按自身复杂度裁剪。

## 开发与调试

由于本仓库包含多个插件，**调试时必须指向某一个具体插件目录**，而不是仓库根目录。

1. 打开 Chrome，地址栏输入 `chrome://extensions/`。
2. 打开右上角「开发者模式」。
3. 点击「加载已解压的扩展程序」，选择某个插件目录，例如 `plugins/deepseek-translate/`（若该插件有构建流程，则选择其 `dist/`）。
4. 修改代码后，在扩展页点击对应插件的「重新加载」即可生效，不会影响其他插件。
5. 调试：
   - Service Worker 日志：该插件详情页 →「检查视图」。
   - 页面注入脚本日志：对应页面的开发者工具 Console。

## 新增插件规范

新增一个独立功能的插件时，请遵循以下约定：

1. 在 `plugins/` 下创建以插件功能命名的目录，使用小写短横线命名（如 `plugins/page-reader/`）。
2. 该目录内自带 `manifest.json`，其中 `name` / `version` / `permissions` 只描述本插件，**最小权限原则**，不申请与其他插件共用的宽泛权限。
3. 该目录内自带 `README.md`，说明本插件做什么、怎么加载、有哪些权限与已知限制。
4. 插件之间不做直接代码引用；确需复用的逻辑放到 `shared/`，并以纯函数 / 无副作用模块的形式提供。
5. 在根 `README.md` 的「[已完成插件](#已完成插件)」表中登记一句话说明与新插件链接。
6. 构建产物（`dist/`、`*.zip`、`*.crx`、`*.pem`）不提交到仓库。

## 协作约定

### 分支

- `main`：稳定分支
- `feature/<plugin-name>-<desc>`：新增或改造某个插件
- `fix/<plugin-name>-<desc>`：修复某个插件的问题
- `chore/<desc>`：仓库级维护（脚本、文档、忽略规则）

### 提交信息

采用约定式提交（Conventional Commits），**涉及具体插件时在 scope 中标注插件目录名**：

```
feat(page-reader): 新增网页正文提取能力
fix(page-reader): 修复在 SPA 页面注入失败的问题
docs: 更新插件清单与目录约定
chore: 补充批量打包脚本
```

### 忽略规则

`node_modules/`、各插件 `dist/`、构建产物与本地环境配置均不纳入版本控制，详见 `.gitignore`。

## 待办（TODO）

- [x] 落地第一个插件：`plugins/deepseek-translate/`（划词翻译，v0.1.0）
- [ ] 继续补充新的独立功能插件（每新增一个即在「[已完成插件](#已完成插件)」登记）
- [ ] 补充批量构建 / 打包脚本（`scripts/`）
- [ ] 沉淀跨插件复用模块的约定（`shared/`）
- [ ] 补充插件开发规范文档（`docs/`）
- [ ] 补充测试与发布流程

## 许可证

暂未确定（待补充）。