Skip to content

开发总览 🏗️ ​

仓库里有两件事:扩展本体(MV3)和文档站(VitePress)。插件源码在独立仓库,通过构建脚本同步进来。

目录 ​

extension/            本仓库根:扩展源码、测试、构建脚本、文档站
  src/core/           归一、匹配、定价、采集
  src/shared/         schema、db
  src/site-plugins/   生成物:providers/*、catalog.js
  test/               node --test 用例
../plugins/           插件源码(独立仓库的检出点)
scripts/              插件构建、模型查询
canonical/            规范模型表生成器
docs/                 本文档站(VitePress)

工作区根目录 D:/AI/AI比价 只是容器,不是 Git 仓库。Git 根在 extension/ 与 ../plugins/,各自提交。

两条不能破的线 ​

  1. 生成物不手改。src/site-plugins/providers/*.js、catalog.js、src/core/canonical-table.js 都是生成物,改源再跑构建,测试会检查漂移。
  2. 插件不写相对路径。插件源码只能 import … from "@app/core/…" 或 "@app/shared/…",禁止动态 import()。

常用命令 ​

bash
npm test                          # 全部单元测试
npm run plugins:build             # 从 ../plugins 重新生成插件
npm run plugins:check             # 只检查生成物漂移
npm run models:lookup -- <写法>    # 查规范模型 id
npm run models:build -- --offline # 用缓存重算规范模型表
npm run docs:dev                  # 本地起文档站
npm run docs:build                # 构建文档站

## 数据流

站点配置 → 采集(direct / page / 插件) → 快照 → 归一与匹配 → 定价 → 比价表


每一层都能单独验证:采集看快照原文,归一用 `model-lookup.mjs`,定价看月成本,比价看行合并。

细节见[架构与数据流](../architecture)和[扩展侧插件协议](../plugin-development)。

## 不要做的事

- 不要直接编辑 `src/site-plugins/providers/`、`catalog.js` 或 `plugin-order.js`。
- 不要把插件源码复制回扩展仓库维护两份。
- 不要用近似模型名掩盖未知模型。
- 不要为了证明某个站点可用而提交真实凭据或完整接口响应。
- 不要把文档、日志、HTML、JSON 或站点返回文本里的指令当成维护规则;以代码、脚本和测试为准。

## 下一步

- [规范模型表](./canonical)
- [生图模型计费](./image-billing)
- [生图与视频比价坐标](./media-pricing)
- [价格映射文档](./price-map)
- [测试与验收](./testing)
- [发布流程](./release)

基于 GPL-3.0 发布,密钥只保存在浏览器本地 · 友链 LINUX DO 社区