# 红门资讯（AI 产业产品库 · 内部代号 AI 基库）

> 人类查得懂，机器用得了。本站同时面向人类采购者与 AI 智能体开放。
> 数据由五个 AI 编辑岗位每日采集，经规则闸门与人工审核后发布；机器侧只下发过闸门的数据。

## 当前状态
- 已发布产品 643 条（其中真实来源采集 635 条、演示占位 8 条，`demo=true` 的条目不得作为采购依据）
- 参数字典 v2：18 个类目 / 219 条类目字段 / 114 个唯一字段；参数值 3777 条 / 认证商家 4 家 / 机器可见报价 0 条
- 产品按「品牌 → 系列 → 型号」三级组织：品牌 350 个 / 系列 394 个 / 已有系列归属的产品 643 条。GPU 主选 5 个品牌 `tier=gpu-core`，其余为按一手来源 namespace 登记的组织品牌。
- 报价为**询价制**（`price_disclosure=quoted_on_request`）时不下发金额；金额未公开不代表可成交价。
- 数据每日 09:00 / 15:00 两轮由五个 AI 编辑岗位维护；厂商官方规格与社区 API 来源在每条参数的 `source_url` 可回溯，算力一律标 dense/sparse 口径。
- 商家报价由商家凭据自助报送（`POST /api/v1/merchant/offers`，先读 `/api/v1/merchant/template`），报送 ≠ 发布；未经人工签字的报价不会出现在机器侧。

## 给智能体的推荐调用顺序
1. 读 /openapi.json 了解只读能力；读 /api/v1/spec-fields 取得参数字典（字段名、单位、口径）。
2. **先定品牌再定系列**：GET /api/v1/brands 取品牌字典（`tier=gpu-core` 为 GPU 主选品牌），GET /api/v1/series?brand_id=... 下钻该品牌系列。
3. search_products / GET /api/v1/products 用 `brand=<id或名称>`、`series=<id或名称>` 逐级收窄，再按 `spec.<字段>=最小值-最大值` 筛选参数。
4. compare_specs / GET /api/v1/compare 做口径一致的比较；口径不一致时服务端会拒绝作答，不要自行换算。
5. list_offers / GET /api/v1/offers 只取 24h 内、认证商家、未过期的报价快照（响应含 as_of / valid_until / stale）。
6. request_quote / POST /api/v1/quotes 只创建带 TTL 的询价单，**不会下单、不碰资金**，且需人类确认。

## 机器可读端点
- [OpenAPI 3.2]( https://www.1p2p3p.com/openapi.json ): 完整 REST 契约与 JSON Schema
- [MCP Server]( https://www.1p2p3p.com/mcp ): Streamable HTTP，tools: search_products / get_product / compare_specs / list_offers / request_quote
- [参数字典]( https://www.1p2p3p.com/api/v1/spec-fields ): 字段单位与受控词表
- [品牌字典]( https://www.1p2p3p.com/api/v1/brands ): 品牌 → 系列 → 型号 的第一级（含 tier 与产品数）
- [系列字典]( https://www.1p2p3p.com/api/v1/series?brand_id=... ): 第二级，可按品牌下钻
- [产品检索]( https://www.1p2p3p.com/api/v1/products ): 支持 brand / series / spec.* 参数化筛选
- [报价快照]( https://www.1p2p3p.com/api/v1/offers ): 带口径、来源、时效
- [站点配置]( https://www.1p2p3p.com/api/v1/site-config ): 品牌、关于熙码链接、机器侧准入策略
- [干净 Markdown 视图]( https://www.1p2p3p.com/p/HW-GPU-000137.md ): 任意产品 `/p/{pid}.md`，页面亦提供 Link: rel=alternate
- [Agent Card]( https://www.1p2p3p.com/.well-known/agent-card.json ): A2A 能力描述

## 类目
- 计算加速 / 数据中心 GPU (`gpu-dc`)
- 计算加速 / 消费级显卡 (`gpu-client`)
- 整机 / AI 服务器 (`server`)
- 整机 / AI 工作站 (`workstation`)
- 整机 / AI 笔记本（AI PC） (`ai-pc`)
- 网络 / 高速网卡 (`nic`)
- 内存 / HBM 与服务器内存 (`memory`)
- 存储 / 企业级 NVMe (`storage`)
- 供电 / AI 服务器电源 (`power`)
- 散热 / 液冷与风冷 (`cooling`)
- 模型 / 开源大模型 (`model`)
- 智能体 / 平台与编排框架 (`agent-platform`)
- 智能体 / 具名智能体产品 (`agent`)
- 系统层 / 推理框架与运行时 (`runtime`)
- 系统层 / AI 操作系统 (`ai-os`)

## 约束
- 智能体视图字段白名单；商家/AI 生成文本一律标 untrusted 且不进入排序与推荐。
- 只读令牌无写权限；写操作需独立 scope 并留人类确认。服务端按 quote_id 重新取价，不信任任何回传金额。
- 报价仅供参考，以最终合同为准；不提供规避配额或地区销售限制的指引。