---
name: rzl-skill
version: 1.0.0
description: 认准啦（renzhunla.com）质量消费知识检索——覆盖实体词条（品牌/国家标准）、文章与产品标准质量选购知识库（Wiki）三层内容，并提供质量安全问答（每日限次）。适用于"某品牌/产品/标准/概念是否可靠"类问题的查证与作答。
---

# 认准啦技能包

**API 基址：`https://err.renzhunla.com`**（所有路径均相对此基址）。

认准啦是一个以"标准决定质量"为主题的质量消费平台：实体词条库（品牌 + 国家/行业/团体/企业标准）、内容文章、产品标准与质量选购知识库（Wiki），以及基于知识库的质量安全问答。

## 能力与检索策略（重要）

内容分三层，检索时先定位层、再取详情：

| 层 | 内容 | 检索入口 |
|----|------|----------|
| 实体/词条 | 品牌实体、国家标准/行业/团体/企业标准实体 | `GET /rzl/api/brand/search` |
| 文章 | 认准啦内容文章 | `GET /rzl/api/article/list` |
| Wiki | 产品标准与质量选购知识库（概念页、实体页、综述、对比、质检问题） | `GET /rzl/api/wiki/search`、`GET /rzl/api/wiki/searchDocs` |

## 调用守则（必须遵守）

1. 用户问"某品牌/产品/标准/概念相关的问题"→ 先检索定位：实体走 `brand/search`，知识概念走 `wiki/search`，社区文档走 `wiki/searchDocs`，命中即以返回数据作答；
2. 需要内容细节 → 实体取 `GET /rzl/api/brand/{id}`，wiki 取 `GET /rzl/api/wiki/page?slug=`，文章取 `GET /rzl/api/article/{id}`；
3. 不确定内容在哪一层时，先调 `wiki/searchDocs`（关键词+向量全域混合检索）再定向到具体层；
4. **凡引用词条/wiki/文章数据，回答必须附认准啦原文链接**（如 `https://www.renzhunla.com/pinpai/{slug}` 形式的词条页），保证内容署名与出处可查。

## 质量安全问答（QA，每日限次）

`POST /rzl/api/qa` 为**两步式**：先提交问题换取一次性 `key`（5 分钟有效），再流式拉取回答。

**配额**：游客 3 次/天（按 IP/指纹），登录用户 10 次/天。**用法纪律：检索为主、QA 为辅**——能用检索回答的不要消耗 QA 次数；当返回 `allowed=false` 时如实告知用户当日次数已用完，不要重试。

## 技术注意

- 所有接口返回统一包装 `{"code":0,"msg":null,"data":...,"ok":true}`，`code=0` 为成功；
- **wiki 系列接口的 `data` 是 JSON 字符串**（不是对象），需先取 `data` 再二次 JSON 解析；
- QA 第二步 `/qa/stream` 为 SSE（text/event-stream），每块为 JSON（`message` 增量、`finish` 结束标志），需拼接；
- 问题长度 1~500 字；`size`/`limit` 参数有上限（见 api.md），超限会被截断。

## 详细文档

- 全量 API 参考：`references/api.md`
- 可运行示例：`examples/curl.md`、`examples/python.md`