# @12-apps/product-research 中文文档

规范地址：https://npmcn.com/package/%4012-apps/product-research/

版本：2\.12\.0
npm 元数据更新时间：2026-11-11T13:53:18.457Z
中文译文更新时间：2026-11-11T13:57:16.075Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%4012-apps/product-research
原文对照：https://npmcn.com/package/%4012-apps/product-research/?lang=original
项目主页：https://github.com/12-apps/shared-packages#readme
源码仓库：https://github.com/12-apps/shared-packages

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：387 kB，77 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.0\.0
- 运行依赖：1 个
- peer 依赖：@12-apps/wiring \>=1\.3\.0
- 首次发布：2026-08-05T02:17:29.923Z
- 最新版本发布：2026-11-11T13:53:18.033Z
- 近 30 天下载量：32830（2026-10-04 至 2026-11-02，npm 官方下载统计）
- 已发布版本数：46（近 12 个月 46 个）

## 中文简介

通用,可携式的研究对购引擎:多源时价发现(商店连接器,SRP,手动价格列表),无AI相关评分,单位价格排名. 与主机端口的无框架核心(db/cache/document/catalog). 零应用相接.

## 安装

```sh
npm install @12-apps/product-research
```

也可以使用：`pnpm add @12-apps/product-research`、`yarn add @12-apps/product-research`、`bun add @12-apps/product-research`

## README

# @ 12- 应用程序/ 产品- 研究

多来源价格研究:商店连接器、付费搜索提供者和 手动出价列表,按相关性评分并按单价排序. 本页 仅涵盖复制主机的用品;其余的种类.

-   **每句为主机配置.** 软件包的编译没有措辞 a 读者看. 每个表面都把复制件当作一个需要的字段,或者一个表格 或解析器 `(ctx) => table` (单位:千美元)`ResearchCopySource<T>`,形状 `localeCopy(PACK)` 从 `@12-apps/i18n` 返回.
-   **两种语言的船,作为被命名的包.** `./en-US` 财务报告和审定财务报表 `./pt-BR` 导出 它们; 也没有默认。 根项和 `./locales` 导出 同一个包按了标记, 对于一个解析器.

## 包里,每个插上

| 字段 | 页:1 美国 | pt-BR (英语) | 以标签键入 |
| --- | --- | --- | --- |
| `diagnostics` 打开 `createApiProductResearch` (单位:千美元)`./http`),打开 `ConnectorContext` 继续 `ResearchDeps` (单位:千美元)`runResearch`(中文(简体) ) | `EN_US_RESEARCH_DIAGNOSTICS` | `PT_BR_RESEARCH_DIAGNOSTICS` | `RESEARCH_DIAGNOSTICS` |
| `messages` 打开 `createApiProductResearch` | `EN_US_RESEARCH_MESSAGES` | `PT_BR_RESEARCH_MESSAGES` | `RESEARCH_HTTP_MESSAGES` |
| 论点 `createResearchBudgetBlueprint` (单位:千美元)`./manifest`(中文(简体) ) | `EN_US_RESEARCH_BUDGET_COPY` | `PT_BR_RESEARCH_BUDGET_COPY` | `RESEARCH_BUDGET_COPY` |
| 权限段标签,由手工贡献构成 | `EN_US_RESEARCH_PERMISSION_LABELS` | `PT_BR_RESEARCH_PERMISSION_LABELS` | `RESEARCH_PERMISSION_LABELS` |

```ts
import { PT_BR_RESEARCH_DIAGNOSTICS } from '@12-apps/product-research/pt-BR';

const ctx: ConnectorContext = {
  logger,
  fetchJson,
  diagnostics: PT_BR_RESEARCH_DIAGNOSTICS,
  locale: 'pt-BR',
};
```

传出同样的 `diagnostics` (和 `locale`改为: `ConnectorContext` 财务报告和审定财务报表 `ResearchDeps`:管道本身的判决和连接器的故障 在一份报告中.

`MARKET_VOCABULARY` (单位:千美元)`EN_US_MARKET_VOCABULARY`, (中文(简体) ), `PT_BR_MARKET_VOCABULARY`)为 没有复制。 是商店和供应商的软件包里 床单,所以它跟随 市场搜索,从来没有读者,和 `vocabulary` 采取一个桌子而不是一个解析器.

### 连接失败

`diagnostics.connectors` 连通者自己的失败:Mercado Livre 搜索和目录查询没有回答任何问题(`mercadoLivreSearchUnreachable(url)`, (中文(简体) ), `mercadoLivreCatalogUnreachable(url)`),缺少访问符 (单位:千美元)`mercadoLivreAuthFailed(sourceLabel)`),手动价格商店抛出 (单位:千美元)`manualStoreUnavailable(cause)`)和一个没有连接符的源类型 (单位:千美元)`noConnector(sourceType)`) (中文(简体) ). 块是可选的,所以一个更老的包保存 编译;没有它,连接器会记录 `EN_US_RESEARCH_DIAGNOSTICS.connectors`这就是他们一直记录的. 两包都装满了 失败请求的 URL 或商店的 原因,因为源行上的原因是唯一的诊断 获得.

## 常见问题

### @12-apps/product-research 是什么？

通用,可携式的研究对购引擎:多源时价发现\(商店连接器,SRP,手动价格列表\),无AI相关评分,单位价格排名\. 与主机端口的无框架核心\(db/cache/document/catalog\)\. 零应用相接\.

### 如何安装 @12-apps/product-research？

在项目目录运行 npm install @12-apps/product-research，或使用 pnpm add / yarn add / bun add。

### @12-apps/product-research 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/12-apps\_\_product-research 是否存在。

### @12-apps/product-research 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @12-apps/product-research 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @12-apps/product-research 可以商用吗？

@12-apps/product-research 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @12-apps/product-research 的下载量有多少？

根据 npm 官方下载统计，@12-apps/product-research 在 2026/10/04 – 2026/11/02 这 30 天内被下载 32,830 次，日均约 1,094 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @12-apps/product-research 还在维护吗？

最新版本 2\.12\.0 发布于 2026/11/11（今天）；至今共发布 46 个版本，其中过去 12 个月发布了 46 个；首次发布于 2026/08/05。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。