技术资料库建设任务 · 规划与测试方案
文档性质：规划与测试方案（未落地） 编制日期：2026-10-20 ｜ 编制：液压行业知识库维护方 状态：待评审 → 评审通过后分阶段实施 本文件不产生任何实际采集、不写入知识库正文、不创建定时任务。 所有落地动作须在方案确认后执行。
一、为什么需要这个任务：现状盘点与真实缺口
1.1 现状盘点（2026-10-20 实测）
| 模块 | 文件数 | 体量 | 实际性质 |
|---|---|---|---|
| 00_入门培训 | 6 | 56 KB | 原理、元件速览、回路、术语、安全 —— 入门级，非技术体系 |
| 01_行业认知 | 7 | 84 KB | 产业链宏观、板块、企业、品牌矩阵、技术路线、制造视角、产业带 |
| 02_产品画册 | 7 | 124 KB | 选型与型号命名规则（泵/阀/马达/缸/系统/密封辅件/型号速查） |
| 03_销售作战 | 5 | 56 KB | 客户地图、技术方案、采购流程、商务谈判、TCO |
| 04_组织与培训 | 5 | 64 KB | 销售组织、参考资料、考核、能力模型、教材 |
| 05_外贸出海 | 6 | 56 KB | 市场地图、客户画像、背调、询盘、合规、渠道 |
| 07_标准与规范 | 6 | 40 KB | 89 条标准索引（编号+名称+中外对照） |
| 08_客户案例 | 1 | 20 KB | 恒立墨西哥工厂单案例 |
| 06_行业资讯 | 57 期 | — | 日报/周报/月报/品牌档案 23 份/技术专题 3 份 |
1.2 缺口判定（用章节结构证明，不靠印象）
缺口一：产品文档回答的是”选哪个”，不是”它是什么参数”。
以 02_产品画册/01_液压泵_国际国内一线选型与型号规则.md（272 行）为例，其章节为：
一、板块全景与选型主线 → 二、国际一线品牌与标杆系列 → 三、国内一线品牌与对标系列
四、型号命名规则逐段解析（Rexroth A10VSO / Eaton PVH / Parker PVplus / Kawasaki K3V）
五、选型六步法 → 六、采购要点 → 引用源全篇没有一张”排量 × 额定压力 × 最高压力 × 转速 × 容积效率 × 重量 × 安装方式”的参数表。 它教人”看懂型号 A10VSO 71 DFR/31R 每一段是什么意思”，但不给”这个型号的额定压力到底是多少 bar、容积效率多少、多重”。这是 know-which（选哪个），不是 know-what-spec（它是什么规格）。
缺口二：品牌档案是”公司档案”，不是”产品清单”。
23 份品牌档案（12+4 国际、6+1 国内）的内容结构是：基本情况 / 业绩趋势 / 经营重点 / 核心看点 / 竞争位置与风险 / 跟踪清单。全部是公司层面叙事（营收、战略、并购、股价），没有一篇列出该品牌的”系列矩阵 → 型号 → 参数”三级清单。所以现在要回答”Bosch Rexroth 的 A10VSO 系列在中国能买到哪些排量档、压力等级怎么分”，库里查不到。
缺口三：辅件只有 1 份合并文档，且是”命名规则”而非”参数库”。
02_产品画册/06_密封件与液压辅件_选型与型号规则.md（237 行）一份文档装了四类：密封件、滤芯、蓄能器、管接头。结构是：分类与命名 → 材质选型 → 品牌格局 → 询价必填要素。同样缺参数级数据——滤芯的过滤精度/β 值/纳污容量/压差曲线；密封件的沟槽尺寸/硬度/温度区间/介质相容性；管接头的通径/压力等级/螺纹标准；蓄能器的容积/预充压力/耐压/认证。用户点名的这四类，现在各只有 1/4 份文档的”命名规则”深度。
缺口四：产业链只有 1 份宏观文档，无量化结构。
01_行业认知/01_液压行业上下游产业链.md（225 行）是”环节 + 代表企业”的定性罗列。缺：上游钢材/铸件的牌号与成本占比、密封材料的材料体系、油液的黏度等级与更换周期、电控元件（传感器/比例电磁铁/控制器）的供应格局；下游各应用（挖机/农机/注塑/冶金/船舶/风电）的液压件价值量占比与年需求量的量化数据。
缺口五：技术本体只有入门 6 份，缺”工程级”体系。
现有 00 模块是”给销售讲清楚原理”。缺：流体力学计算（沿程损失/局部损失/热平衡/蓄能器容积计算）、系统设计方法（工况分析→元件匹配→验算）、故障诊断与失效分析（污染/气蚀/泄漏/爬行的机理与判据）、试验与测试方法（型式试验/出厂试验/耐久试验的项次与判定）、仿真建模（AMESim/Simulink 的建模边界）。
1.3 结论
现有知识库是”销售侧的现象层 + 情报层的动态层”，缺一个”产品侧的事实层”。 本任务就是补这一层，且必须与现有内容互补而非重复——不重写选型手册，不重复资讯日报，只做”可被选型手册引用的结构化事实底座”。
二、任务目标（可量化）
2.1 总目标
建立液压产品与技术资料的结构化数据库，使知识库能回答三类此前无法回答的问题：
| 问题类型 | 当前能否回答 | 建成后目标 |
|---|---|---|
| ”某品牌某系列有哪些型号、各自什么参数” | ❌ 查不到 | ✅ 型号级检索，参数带测试条件 |
| ”某类辅件（滤芯/密封/接头/蓄能器）怎么选、参数含义是什么” | 🟡 只有命名规则 | ✅ 参数定义 + 选型判据 + 互换关系 |
| ”某技术问题（发热/爬行/污染）的机理与判据” | 🟡 入门级 | ✅ 工程级计算式 + 判定阈值 |
2.2 量化指标（首年，12 个月）
| 维度 | 指标 | 说明 |
|---|---|---|
| 型号记录 | ≥ 3,000 条 | 覆盖 6 大品类（泵/阀/马达/缸/辅件/系统）× 主流品牌主力系列 |
| 品牌覆盖 | ≥ 40 个品牌 | 现有 23 份品牌档案中 ≥ 20 个 + 新增 ≥ 20 个 |
| 参数完整率 | ≥ 90% | 必填字段齐全的型号记录占比 |
| A/S 级源占比 | ≥ 70% | 一手官方（S）+ 权威二手（A）来源占比 |
| 单位规范化率 | 100% | 全部数值统一到 SI 或行业白名单单位，禁止混用 |
| 跨源冲突标注率 | 100% | 有冲突必须标注并保留全部取值，禁止静默取舍 |
| 抽样复核错误率 | < 2% | 每批抽 10%（不少于 5 条）人工核对原文 |
| 站点构建 | 100% 成功、0 死链 | 沿用现有 G0–G6 门禁 + 新增 Q1–Q2 |
2.3 明确不做（防止范围蔓延）
| 不做 | 原因 |
|---|---|
| 不做资讯采集 | 已有 e96de581 资讯日报（每日 09:00），重复建设 |
| 不做价格采集 | 价格随渠道/批量/汇率剧烈波动，且公开价不可靠，易误导报价 |
| 不做全 SKU 穷举 | 单品牌单系列可达数百型号，无工程意义；只做主力系列 + 代表型号 |
| 不做竞品逆向/拆解 | 无合法数据源，且涉及商业秘密 |
| 不转载样本 PDF 原文 | 版权风险；只提取参数为结构化字段，注明来源链接 |
| 不写结论性市场判断 | 留给 01_行业认知 与品牌档案，保持职责边界 |
三、采集范围
3.1 五类采集对象
| 编号 | 对象 | 采集内容 | 当前库内状态 |
|---|---|---|---|
| C1 | 技术本体 | 计算式、设计方法、故障机理、试验项次、仿真边界 | 入门级 6 份，缺工程级 |
| C2 | 产品定义与规格 | 品类定义、结构原理、参数定义与典型值域、选型判据 | 有命名规则，缺参数定义与值域 |
| C3 | 品牌标准产品清单 | 系列矩阵 → 型号 → 参数三级 | 空白（仅有公司档案） |
| C4 | 辅件专项 | 滤芯/密封件/管接头/蓄能器/冷却器/油液 | 合并 1 份，缺参数级 |
| C5 | 产业链 | 上游材料与元件、中游制造、下游应用、后市场 | 定性 1 份，缺量化 |
3.2 数据来源分级（四级，决定能否入库）
| 级别 | 定义 | 典型来源 | 使用规则 |
|---|---|---|---|
| S 级 一手官方 | 数据责任主体自己发布 | 品牌官网产品页/样本 PDF/选型软件；企业年报/招股书/公告（巨潮、SEC、港交所）；标准全文（ISO / openstd.samr.gov.cn / 全国标准信息公共服务平台）；协会官方统计（CHPSA、NFPA、VDMA、中国工程机械工业协会） | 可直接入库为事实，标注 URL + 抓取时间 |
| A 级 权威二手 | 有编辑责任与底稿的机构 | 券商深度研报（华创/东吴/中信等）、政府与海关统计、检测机构报告、行业年鉴 | 可入库，须标注”转引自”并保留原始出处 |
| B 级 媒体转述 | 行业媒体 | Hydraulics & Pneumatics（hpmag.co.uk）、Fluid Power Journal、Fluid Power World、OEM Off-Highway、HeavyQuip、中国液压网 | 仅作线索，须回 S 级核实后才入库；未核实者标注”媒体转述，待核” |
| C/D 级 聚合站 | 无一手能力的聚合/榜单站 | 报告大厅、三个皮匠、发现报告、八方资源网、CNPP 榜单 | 禁止入库为事实，只能作为”待查清单”线索；库内已有记录显示此类站点存在误标年份问题 |
纪律来源：B/C 级处理规则沿用
09_项目治理/02_验收判据与质量门禁.md与资讯日报既有口径（D-08：引用源必含国际层至少两层）。聚合站误标年份一事已在库内多处记录，本任务沿用”不入库”处理。
3.3 优先级排序（决定实施顺序）
| 优先级 | 范围 | 理由 |
|---|---|---|
| P0 | C4 辅件（滤芯/密封/接头/蓄能器）+ C2 参数定义 | 最快见效；辅件是询价高频、现有覆盖最薄；参数定义是 C3 的前置 |
| P1 | C3 品牌产品清单（泵 → 阀 → 缸 → 马达） | 价值最高但工作量最大；按品类分批 |
| P2 | C5 产业链量化 | 依赖 P1 的品类结构 |
| P3 | C1 技术本体工程级 | 最慢，但决定长期专业度 |
四、数据分类与字段结构（本方案核心）
4.1 实体关系
Brand（品牌）
└─ Series（产品系列）
└─ Model（型号/SKU，最小粒度）
└─ Spec（参数观测，一条数值一条记录）
Standard（标准）── 关联 ── Series / Model / Auxiliary
Auxiliary（辅件）── 独立实体，含互换关系
ChainNode（产业链节点）── 独立实体关键设计决策：参数不直接写在 Model 上，而是拆成独立的 Spec 观测记录。
原因：同一型号的参数常有多个来源且数值不一致（样本版次、测试条件差异）。若直接填在 Model 上，必须”选一个”，等于静默取舍；拆成 Spec 后每个数值都带来源、条件、时间，冲突可追溯、可比较、可回滚。这是本方案与”做个 Excel 表”的根本区别。
4.2 E1 品牌 Brand
| 字段 | 类型 | 必填 | 说明 / 取值约束 |
|---|---|---|---|
brand_id | string | ✔ | ASCII slug，全局唯一（如 bosch-rexroth） |
name_cn | string | ✔ | 中文名（如 博世力士乐） |
name_en | string | ✔ | 英文法定名 |
country | enum | ✔ | ISO 3166-1 两字母；中国台湾/香港/澳门按”中国台湾”等口径 |
hq_city | string | ○ | 总部城市 |
founded_year | int | ○ | 创立年 |
ownership | enum | ✔ | 上市 / 国有 / 民营 / 外资 / 合资 |
ticker | string | ○ | 交易所:代码（如 SH:601100） |
category_scope | string[] | ✔ | 涉及品类（泵/阀/马达/缸/辅件/系统/电控） |
china_presence | string | ○ | 在华工厂/合资/代理形态 |
source_url | string | ✔ | 主要信息来源 |
source_grade | enum | ✔ | S / A / B |
fetched_at | date | ✔ | 抓取日 YYYY-MM-DD |
verified_at | date | ○ | 人工复核日 |
4.3 E2 产品系列 Series
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
series_id | string | ✔ | brand_id + - + 系列代号（如 bosch-rexroth-a10vso） |
brand_id | FK | ✔ | 指向 E1 |
category | enum | ✔ | 泵 / 阀 / 马达 / 缸 / 辅件 / 系统 |
sub_category | enum | ✔ | 泵：柱塞/齿轮/叶片/螺杆；阀：方向/压力/流量/比例/伺服/插装；马达：柱塞/齿轮/摆线/径向柱塞；缸：单作用/双作用/伸缩/伺服 |
tech_route | enum | ○ | 斜盘式 / 斜轴式 / 内啮合 / 外啮合 / 内曲线 等 |
series_name | string | ✔ | 厂商标称系列名（A10VSO、PVH、K3V…） |
pressure_class | string | ○ | 压力等级带（中压 ≤16 MPa / 中高压 16–25 / 高压 25–35 / 超高压 >35） |
displace_range | range | ○ | 排量覆盖范围（cm³/r） |
speed_range | range | ○ | 转速范围（r/min） |
key_features | string[] | ○ | 控制方式、变量形式、特性（如”DFR 压力流量复合控制”） |
launch_year | int | ○ | 首次发布年 |
status | enum | ✔ | 在产 / 停产 / 换代中 / 未上市 |
standard_ref | FK[] | ○ | 关联 E7 标准 |
source_url / source_grade / fetched_at | — | ✔ | 同 E1 |
4.4 E3 型号 Model（最小粒度）
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model_id | string | ✔ | 全局唯一，建议 series_id + - + 规格码 |
series_id | FK | ✔ | 指向 E2 |
model_code | string | ✔ | 厂商完整订货码（保留原始写法，不改写、不规范化） |
displacement_cc | number | ○ | 排量 cm³/r |
pressure_rated_bar | number | ✔ | 额定（连续）压力 |
pressure_max_bar | number | ✔ | 最高（峰值）压力 |
speed_max_rpm | number | ○ | 最高转速 |
flow_lpm_at_ref | number | ○ | 参考转速下流量（必须同时在 Spec 中记参考转速） |
torque_nm | number | ○ | 输出扭矩 |
power_kw | number | ○ | 输入功率 |
efficiency_vol_pct | number | ○ | 容积效率 |
efficiency_total_pct | number | ○ | 总效率 |
weight_kg | number | ○ | 净重 |
mount_type | enum | ○ | ISO 安装法兰代号 / SAE A/B/C |
port_type | enum | ○ | 螺纹 / 法兰 / SAE / BSPP / 米制 |
control_type | string | ○ | 压力补偿 / 负载敏感 / 电比例 / 手动 / 恒功率 |
fluid_temp_range | range | ○ | 工作油温（℃） |
viscosity_range | range | ○ | 适用黏度（mm²/s） |
ip_class | string | ○ | 防护等级（含电控时） |
noise_db | number | ○ | 噪声（须记测试距离与工况） |
price_band | enum | ○ | 仅记价格带（高/中/低），不记具体价格 |
status | enum | ✔ | 在产 / 停产 / 替代型号 |
source_url / source_grade / fetched_at | — | ✔ | 同 E1 |
专业注记：
pressure_rated_bar与pressure_max_bar必须分列。行业里最常见的误用是拿”峰值压力”当”连续工作压力”报给客户，导致选型偏乐观。同理flow_lpm必须绑定参考转速，否则不同品牌不可比。
4.5 E4 参数观测 Spec（冲突可追溯的核心）
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
spec_id | string | ✔ | 全局唯一 |
model_id | FK | ✔ | 指向 E3（辅件则指向 E5） |
param_name | enum | ✔ | 白名单参数名（见 4.5.1） |
value | number | ✔ | 数值 |
unit | enum | ✔ | 白名单单位（见 4.5.2） |
condition | object | ○ | 测试条件：转速/油温/黏度/测试标准/环境 |
tolerance | string | ○ | 允差（如 ±2%） |
source_url | string | ✔ | 该数值的具体页面/样本版次 |
source_grade | enum | ✔ | S / A / B |
fetched_at | date | ✔ | 抓取日 |
conflict_flag | bool | ✔ | 与其他源是否冲突 |
conflict_group | string | ○ | 同参数同型号的比对组 ID |
4.5.1 参数名白名单（首批 40 个）
| 类别 | 参数 |
|---|---|
| 压力 | pressure_rated、pressure_max、pressure_peak、pressure_setting_range |
| 流量 | displacement、flow_rated、flow_max、leakage |
| 转速/功率 | speed_min、speed_max、speed_rated、power_input、torque_rated |
| 效率 | efficiency_vol、efficiency_total、efficiency_mech |
| 物理 | weight、dimension_length、dimension_width、dimension_height |
| 介质 | fluid_viscosity_min、fluid_viscosity_max、fluid_temp_min、fluid_temp_max、filtration_nominal、filtration_absolute_beta、water_content_max |
| 噪声 | noise_level |
| 辅件专用 | burst_pressure、proof_pressure、precharge_pressure、gas_volume、beta_ratio、dirt_holding_capacity、hardness_shore、groove_width、thread_size、nominal_bore |
| 寿命 | life_cycles、service_interval |
4.5.2 单位白名单
| 物理量 | 唯一入库单位 | 允许输入的其他单位（自动换算） |
|---|---|---|
| 压力 | bar | MPa、psi、kgf/cm² |
| 排量 | cm3/r | mL/r、in³/r |
| 流量 | L/min | gpm、m³/h |
| 转速 | r/min | rpm |
| 扭矩 | N·m | kgf·m、lbf·ft |
| 功率 | kW | HP、PS |
| 温度 | ℃ | ℉ |
| 黏度 | mm2/s | cSt（等同，仅记录换算） |
| 长度 | mm | in、cm |
| 质量 | kg | lb |
| 噪声 | dB(A) | — |
纪律：入库一律换算为左列唯一单位；
原始值 + 原始单位保留在condition.raw中以便复核。禁止混用（如一个品牌用 psi、另一个用 bar 而不换算）。
4.6 E5 辅件 Auxiliary
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
aux_id | string | ✔ | 唯一 ID |
brand_id | FK | ✔ | 品牌 |
aux_type | enum | ✔ | 滤芯 / 密封件 / 管接头 / 蓄能器 / 冷却器 / 油液 / 其他 |
sub_type | enum | ✔ | 滤芯：吸油/回油/压力/离线；密封：O 圈/斯特封/格莱圈/YX 圈/防尘圈/组合密封；接头：卡套/焊接/法兰/快换/软管接头；蓄能器：皮囊/活塞/隔膜 |
spec_system | enum | ✔ | 命名/尺寸体系：HYDAC 代号 / DIN 2353 / ISO 8434 / SAE J517 / ISO 6149 / 厂标 |
key_params | object | ✔ | 按 aux_type 差异化（见下） |
interchange | string[] | ○ | 可互换/替代型号（跨品牌） |
compatibility | string[] | ○ | 适配介质/温度/系统 |
life_cycle | string | ○ | 更换周期/循环寿命/压差报警值 |
certification | string[] | ○ | 认证（ATEX/DNV/CE/SIL/ASME） |
source_url / source_grade / fetched_at | — | ✔ | 同 E1 |
四类辅件的差异化关键参数：
| 辅件 | 必须采集的参数 |
|---|---|
| 滤芯 | 过滤精度（μm，注明 nominal 还是 absolute）、β 值（β(c) ≥ 200/1000）、纳污容量（g）、额定流量（L/min）、压差曲线/初始压降、旁通阀开启压差、材质（玻纤/金属网/纸质）、尺寸（外径×高×内径）、密封材质 |
| 密封件 | 类型、材质（NBR/FKM/PU/PTFE）、硬度（Shore A）、温度区间、介质相容性、沟槽尺寸（宽×深）、适用压力、表面粗糙度要求、挤出间隙极限 |
| 管接头 | 连接标准（DIN 2353 / ISO 8434-1 24° 锥 / SAE J514 37° 扩口 / ISO 6149）、通径 DN、螺纹规格、额定压力、材质、表面处理、最小爆破压力、弯曲半径（软管） |
| 蓄能器 | 类型（皮囊/活塞/隔膜）、公称容积（L）、预充压力 P₀、最高工作压力、爆破压力、充气介质（N₂）、接口螺纹、认证（PED/ASME/GB）、温度区间 |
4.7 E6 产业链节点 ChainNode
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
node_id | string | ✔ | 唯一 ID |
layer | enum | ✔ | 上游-原材料 / 上游-元件 / 中游-制造 / 下游-主机 / 后市场 |
category | string | ✔ | 钢材、铸件、密封材料、油液、电控元件、泵、阀、缸、系统、挖机、农机、注塑机… |
name | string | ✔ | 企业名 |
products | string[] | ○ | 具体产品/牌号 |
capacity | string | ○ | 产能（注明口径与年份） |
market_share | string | ○ | 份额（必须标注”估算”与年份） |
customers | string[] | ○ | 下游客户 |
suppliers | string[] | ○ | 上游供应商 |
region | string | ○ | 产业带/国别 |
cost_share | string | ○ | 成本占比（如”钢材占缸体成本 35%“，须标来源） |
source_url / source_grade / fetched_at | — | ✔ | 同 E1 |
4.8 E7 标准 Standard（与 07 模块对接）
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
std_id | string | ✔ | 如 ISO-4413 |
code | string | ✔ | 标准号（含年份则写全，不含则标”现行版”） |
title_cn / title_en | string | ✔ | 中英文名称 |
version_year | int | ○ | 版本年 |
status | enum | ✔ | 现行 / 即将实施 / 废止 / 被替代 |
equivalent | enum | ○ | IDT（等同）/ MOD（修改）/ NEQ（非等效） |
scope | string | ○ | 适用范围 |
linked_categories | string[] | ○ | 关联品类 |
source_url | string | ✔ | openstd.samr.gov.cn / iso.org 官方页 |
现有 07 模块已有 89 条标准索引。本任务不重建，只做两件事：① 补
status/equivalent字段（现有多为”编号+名称”）；② 建立 Standard ↔ Series/Model 的关联。
五、更新周期
5.1 四档节奏（按”信息变化速度”分，不是按内容重要性）
| 档 | 触发条件 | 范围 | 频率 | 单次批量上限 |
|---|---|---|---|---|
| T1 事件驱动 | 标准换版/废止、品牌新品发布、并购、召回、重大产品变更 | 受影响的标准/系列/型号 | 每周检一次 + 事件即时 | ≤ 6 份文档 |
| T2 季度 | 品牌产品线更新、年报口径、渠道变化 | E1 品牌、E2 系列 | 每季首月 | ≤ 6 个品牌 |
| T3 半年 | 产业链结构、区域产能、份额估算 | E6 产业链 | 每半年 | ≤ 6 个节点组 |
| T4 年度 | 技术本体、定义体系、标准体系全景 | C1 技术本体、E7 标准 | 每年 1 次全量复核 | 分批，每批 ≤ 6 份 |
5.2 执行时间窗口（避开已有任务）
| 时段 | 已有任务 | 本任务安排 |
|---|---|---|
| 09:00 | e96de581 资讯日报 | 不占用 |
| 10:30 | fa5c27e2 长任务推进 | 不占用 |
| 11:30 | — | 本任务固定窗口（每周三） |
| 部署 | 由长任务/日报触发 | 本任务产出不自动部署，攒批后由人工确认发布 |
为什么是周三 11:30：① 避开两个已有任务与站点部署打架；② 周三可覆盖周一周二发布的新品与公告；③ 11:30 距午间有缓冲，长任务超时不会连环阻塞。
5.3 单次执行流程（每次 30–45 分钟预算）
① 读队列（上一轮遗留的待核实清单 + 本期事件源）
② 采集（≤6 份，每份记录 URL + 抓取时间 + 源级别）
③ 抽取（按 E1–E7 schema 生成结构化记录）
④ 自动校验（Q1 结构门 + Q2 一致性门）
⑤ 冲突处理（多源冲突 → 保留全部 + conflict_flag=true）
⑥ 抽样复核（人工 10%，不少于 5 条）
⑦ 写入（Markdown 人读视图 + JSON 机读数据）
⑧ 记账（更新看板 + 执行日志 + 遗留清单）六、验证与质量控制
6.1 三级门禁
| 门 | 类型 | 检查项 | 不通过处理 |
|---|---|---|---|
| Q1 结构门 | 自动 | ① 必填字段非空 ② 枚举值在白名单内 ③ 单位在白名单内 ④ model_id/slug 全局唯一 ⑤ 日期格式 YYYY-MM-DD ⑥ FK 指向存在 | 该条记录拒收，记入遗留清单 |
| Q2 一致性门 | 自动 | ① 同型号跨源比对：压力/排量/重量偏差 > 5% 报警 ② 单位换算校验（原始值 ↔ 入库值） ③ 父子关系完整（Series 必有 Brand，Model 必有 Series） ④ 参数值域合理性（如压力 > 1000 bar、排量 > 10000 cm³/r 报警） ⑤ 标准号格式校验 | 标记 conflict_flag，双值都保留，进入人工判定队列 |
| Q3 抽样门 | 人工 | 每批抽 10%（≥5 条），逐条核对：数值是否与源页一致、条件是否遗漏、单位是否换错、结论是否越界 | 错误率 > 2% → 整批退回重做 |
6.2 数据质量五条铁律
| # | 铁律 | 违反后果 |
|---|---|---|
| 1 | 不编造。查不到就写”未提及”或留空，不用推测填补 | 最高优先级，违者整批作废 |
| 2 | 不静默取舍。多源冲突必须双值保留 + 标注 | 静默取舍会让错误无法追溯 |
| 3 | 不混淆口径。额定压力 ≠ 最高压力；nominal 精度 ≠ absolute 精度；ISO VG ≠ SAE 黏度等级 | 口径混淆是最常见的选型事故来源 |
| 4 | 不带条件不用。每个数值必须能回答”在什么转速/油温/黏度/标准下测的” | 无条件数值不可比，等于无效 |
| 5 | 不越界结论。采集层只记事实，不做”谁更好/该选谁”的判断 | 结论留给 03_销售作战 与品牌档案 |
6.3 冲突处理机制
发现冲突
├─ 差异 < 5% → 取最新版次，另一值存入 Spec 历史，不报警
├─ 差异 5%–20% → conflict_flag=true，双值并列，标注各自条件与日期
└─ 差异 > 20% → 升级人工复核；若无法判定，两个值都标"待核实"，并在文档显式提示禁止行为：取平均值、取”看起来合理”的那个、隐去较旧值。
6.4 可追溯性要求
每条记录必须能回答四个问题：
- 这个数从哪来（
source_url精确到页面/样本版次，不是首页） - 什么时候取的（
fetched_at） - 可信度多少（
source_grade） - 谁复核过（
verified_at+ 复核人）
6.5 与现有门禁的关系
| 现有门禁 | 本任务 |
|---|---|
| G0 扫描规模 | 沿用 |
| G1 引用源章节 | 沿用（每份新文档必须有） |
| G2 抬头日期 | 沿用 |
| G3a/b/c 资讯 frontmatter | 仅当产出物放 06 时适用；本任务放独立模块不适用 |
| G4 品牌标签 | 沿用（品牌相关文档须带国际/国产标签） |
| G5 ASCII slug | 沿用 |
| G6 slug 唯一 | 沿用 |
| Q1/Q2 | 新增，需扩展 check_kb.py（新增 G7 结构门、G8 一致性门） |
七、测试方案
7.1 四阶段递进测试
| 阶段 | 名称 | 范围 | 目的 | 准入条件 | 准出判据 |
|---|---|---|---|---|---|
| T0 | 冒烟测试 | 1 个品牌 × 1 个系列 × 3 个型号 | 验证”采集→抽取→校验→写入”链路通 | 字段定义定稿 | 3 条记录全部通过 Q1；字段可填满率 ≥ 70% |
| T1 | 单品类试点 | 液压泵 1 个完整品类（含 ≥3 品牌 × ≥3 系列 × ≥10 型号） | 验证字段设计是否够用、是否冗余 | T0 通过；schema 定稿 | 必填字段完整率 ≥ 90%；发现 schema 缺陷 ≤ 3 个并完成修订 |
| T2 | 全品类批次 | 泵/阀/马达/缸/辅件 5 类，各 ≥3 品牌 | 验证产能与一致性 | T1 通过 | 每批 Q1 通过率 ≥ 95%；Q2 冲突率 < 10%；抽样错误率 < 2% |
| T3 | 长期稳定性 | 连续 4 周，每周三执行 | 验证节奏可持续、冲突机制有效、无累积漂移 | T2 通过 | 4 周按期完成 ≥ 3 次；无字段漂移；遗留清单收敛（不增长） |
7.2 测试用例（每阶段必测）
| 用例 | 场景 | 预期行为 |
|---|---|---|
| TC-01 | 填入超范围压力（如 5000 bar 的泵） | Q2 值域校验报警，进入人工队列 |
| TC-02 | 同一型号两个来源压力差 15% | conflict_flag=true，双值保留，标注条件 |
| TC-03 | 输入单位为 psi 的原始值 | 自动换算为 bar，condition.raw 保留原值 |
| TC-04 | 必填字段缺失 | Q1 拒收，记入遗留清单，不写入正文 |
| TC-05 | 型号码含特殊字符（如 A10VSO 71 DFR/31R-PPA12N00） | model_code 原样保留，model_id 用 ASCII slug |
| TC-06 | C 级聚合站作为唯一来源 | 拒收，转为”待查线索” |
| TC-07 | 同一系列下型号排量重复 | 报警（可能是版次重复或录入错误） |
| TC-08 | 标准已废止仍被引用 | status=废止 标记，文档显式提示”不可用于新合同” |
| TC-09 | 辅件跨品牌互换关系 | interchange 字段记录，须注明”尺寸兼容”还是”性能等效” |
| TC-10 | 新记录与已有记录冲突 | 不覆盖旧的，新增 Spec 记录 + 关联 conflict_group |
7.3 失败与回滚
| 失败类型 | 处理 |
|---|---|
| 单批 Q1 通过率 < 80% | 停止写入，排查 schema 或抽取逻辑，修复后重跑 |
| 抽样错误率 > 2% | 整批退回，不写入；记录失败原因 |
| 连续 2 批次失败 | 暂停任务，人工介入复盘 |
| 站点构建失败 | 回滚到上一版本 dist；本任务产出不自动部署，天然有缓冲 |
| 数据污染（错误写入正文） | 从 Git 历史回滚对应文件；09_项目治理/03_长任务执行日志.md 记录事件 |
7.4 测试通过后的实施顺序
T0（1 周）→ T1（2–3 周）→ [评审：schema 定稿] → T2（4–6 周）→ T3（4 周）→ 转常态总周期估算：11–14 周进入常态运行。 之后按第五节四档节奏持续更新。
八、产出物与站点落位
8.1 产出物形态（双轨）
| 形态 | 文件 | 用途 |
|---|---|---|
| 人读视图 | 10_技术资料库/**.md | 站点渲染、销售查阅、评审 |
| 机读数据 | src/data/*.ts 或 public/data/*.json | 前端表格/图表、跨文档引用、后续可做检索 |
为什么双轨：记忆中的既有约定是”品牌/产品/术语等展示字段放
src/data/*.ts，不写 Markdown frontmatter（嵌套 YAML 会被 import 丢弃）“。参数是嵌套结构，塞 frontmatter 必丢，因此必须走 data 文件，Markdown 只放人读表格与说明。
8.2 建议模块结构（新增 10_技术资料库/）
10_技术资料库/
├── 00_资料库导读与使用说明.md
├── 01_技术本体/
│ ├── 01_流体力学计算与选型公式.md
│ ├── 02_液压系统设计方法.md
│ ├── 03_故障诊断与失效分析.md
│ ├── 04_试验与测试方法.md
│ └── 05_仿真建模边界.md
├── 02_产品定义与规格/
│ ├── 01_液压泵_定义与参数体系.md
│ ├── 02_液压阀_定义与参数体系.md
│ ├── 03_液压马达_定义与参数体系.md
│ ├── 04_液压缸_定义与参数体系.md
│ └── 05_液压系统_定义与参数体系.md
├── 03_品牌产品清单/
│ ├── 01_博世力士乐_产品清单.md
│ ├── 02_派克汉尼汾_产品清单.md
│ └── ...（按品牌，P1 分批）
├── 04_辅件专项/
│ ├── 01_滤芯_参数与选型.md
│ ├── 02_密封件_参数与选型.md
│ ├── 03_管接头与软管_参数与选型.md
│ ├── 04_蓄能器_参数与选型.md
│ └── 05_冷却器与油液.md
└── 05_产业链/
├── 01_上游材料与元件.md
├── 02_中游制造与产能.md
├── 03_下游应用需求结构.md
└── 04_后市场与再制造.md8.3 站点落位的技术前提（需代码改动，实施前须确认）
| 改动点 | 文件 | 说明 |
|---|---|---|
| ① 模块标签映射 | hydrolearning/scripts/import-docs.mjs 的 GROUP_LABEL | 新增 '10': '技术资料库' |
| ② 导航/首页入口 | src/pages/index.astro 等 | 新增模块卡片 |
| ③ 数据文件挂载 | src/data/ | 参数表以 TS 导入 |
这是本次方案唯一需要改代码的地方。若不想动代码，退路是复用
02_产品画册/目录（新增文件即可上线，零代码改动），代价是模块语义混杂（选型手册与参数库混在一起）。建议新增模块，但把代码改动作为”实施前确认项”单列。
九、风险与对策
| 风险 | 影响 | 对策 |
|---|---|---|
| 样本 PDF 版权 | 法律风险 | 只提取参数为结构化字段，不转载全文、不存 PDF 原件；标注来源链接 |
| 官网反爬/需登录 | 采集失败 | 限速（≤1 req/2s）、缓存、优先用公开产品页；需登录的样本列为”人工获取” |
| 型号爆炸 | 无法穷举 | 只做主力系列 + 代表型号；在导读中明确”覆盖范围与不覆盖范围” |
| 参数口径不一致 | 不可比、误导 | 强制 E4 观测模型 + 测试条件必填 + 单位白名单换算 |
| 版本漂移 | 旧数据被当现行 | fetched_at + verified_at 双时间戳；年度 T4 全量复核 |
| 人力不可持续 | 半途而废 | 单次 ≤6 份 + 周更节奏 + 遗留清单收敛考核（T3 阶段验证） |
| 与资讯日报抢源 | 重复劳动 | 日报只收”事件”，本任务只收”事实”；共用信源清单但产出物不同 |
| 结论越界 | 专业风险 | 采集层禁止输出”谁更好/该选谁”，只记事实与条件 |
十、实施前置确认项（需你拍板）
| # | 事项 | 选项 | 建议 |
|---|---|---|---|
| 1 | 是否新增 10_技术资料库/ 模块 | A. 新增（需改 3 处代码）／ B. 复用 02_产品画册/（零改动） | A，语义清晰，长期可维护 |
| 2 | 首年型号目标 | A. 3,000 条／ B. 1,500 条（保守）／ C. 5,000 条（激进） | A，按 T2 产能测算可持续 |
| 3 | 是否采集价格区间 | A. 只记价格带（高/中/低）／ B. 记具体报价区间／ C. 完全不记 | A，具体价格不可靠 |
| 4 | 品牌优先级 | A. 先国际品牌（资料规范）／ B. 先国内品牌（贴近业务）／ C. 按品类混编 | C，按品类组织，每品类内外资各半 |
| 5 | 执行频率 | A. 每周三 11:30／ B. 每两周／ C. 每日 | A，与现有任务错峰 |
| 6 | 是否自动部署 | A. 不自动（攒批人工确认）／ B. 自动部署 | A，资料库需人工把关 |
十一、附：本方案未做的事
为避免误解，明确本轮没有做以下任何一项：
- ❌ 未创建任何定时任务（
automation_update未调用） - ❌ 未采集任何外部数据
- ❌ 未向知识库写入任何产品/技术内容
- ❌ 未修改
check_kb.py门禁 - ❌ 未改动站点代码，未部署
本轮唯一产出即本方案文档。 待第十节六项确认后，再按 T0 → T1 → T2 → T3 顺序落地。
引用源与扩展阅读
本方案的事实依据（均来自本知识库内部，未引入外部新数据）：
09_项目治理/02_验收判据与质量门禁.md—— 门禁 G0–G6 定义与判据设计原则09_项目治理/01_长任务看板.md—— 长任务流（数据核实 → 更新文档 → 补工具 → 更新索引）与单次批量纪律09_项目治理/03_长任务执行日志.md—— 历史执行记录与踩坑07_标准与规范/00_标准总览与使用说明.md—— 标准体系分层（ISO/EN/GB/SAE/DIN）与”等效采用 ≠ 条款逐字相同”口径02_产品画册/01_液压泵_...、02_产品画册/06_密封件与液压辅件_...—— 用于证明现有文档为”选型规则”而非”参数库”06_行业资讯/品牌档案/00_国内外品牌结构化档案汇总.md—— 23 份品牌档案的实体清单与 7 维度字段（本方案 E1 的既有基础）06_行业资讯/00_行业资讯导读.md§2.2 —— 精简与链接约定、信源分级要求README.md—— 知识库模块划分与完成度基线
外部权威来源（方案中提及、落地时须回一手页面）：
- 标准：ISO（iso.org，TC131 流体传动系统）、国家标准全文公开系统（openstd.samr.gov.cn）、全国标准信息公共服务平台
- 协会：中国液压气动密封件工业协会（CHPSA）、美国流体动力协会（NFPA）、德国机械制造协会（VDMA）、中国工程机械工业协会（cncma.org）
- 品牌样本：各品牌官网产品页与选型软件（Bosch Rexroth、Parker、Eaton、Danfoss、Kawasaki、HAWE、Atos、HYDAC、Yuken、Bucher、Moog、Enerpac、STAUFF、Donaldson 等）
- 上市公司披露：巨潮资讯网（cninfo.com.cn）、上交所、深交所、北交所、港交所披露易、SEC EDGAR
- 行业媒体：Hydraulics & Pneumatics（hpmag.co.uk）、Fluid Power Journal、Fluid Power World、OEM Off-Highway、HeavyQuip Magazine
口径声明：方案中的量化目标（3,000 条型号、40 个品牌、90% 完整率等）为规划值，非既有事实；实际达成情况须在执行日志中按批次记账，不得事后倒改目标。