模块化产品知识库

它解决什么问题

很多团队维护产品数据的方式是堆 wiki 页面和 Excel 表，数据散落在表格、文档和公告里。不同品类的字段不一致，直接让下游代码按具体产品硬编码，结果要么结构化数据没人持续维护，要么复制粘贴到难以收拾。这套 Skill 把「框架」和「数据」彻底拆开：一套通用查询引擎、一套通用数据库 schema、一套卡片生成器；每个行业或品牌只是 产品模块/ 下的一个目录和一个 data.db，可以被其他工作流单独调用。

核心能力与工作方式

查询层提供四个 action：list_products 按品类或子品类列出产品概览；get_card 读取单个产品的完整知识卡片，优先复用已生成的 DOCX；get_materials 提取关键参数、互联和场景摘要；export_all 输出 DOCX 卡片合集和 XLSX 数据汇总。CLI 用 --module、--action、--product 组合调用，Python 里导入 ProductKB(root)，也可以直接在对话里说「查华为全生态的所有产品」。

底层是 6 张表：products 存基础信息，product_params 存 key-value 参数，interconnections 存产品间联动，scenarios 和 scenario_products 存场景叙事，product_curated 存人工整理的叙述层内容。卡片生成器按「基础信息、工作逻辑、能力清单、互联关系、场景适配」五节输出 DOCX，并会自动给缺失单位的数值补单位（长度补 mm、功率补 kW、续航补 km）。

自主更新是重要组成部分：每日自动化任务先 WebFetch 官网规格页，失败则降级到 WebSearch，再按「官网规格页 > 官网详情页 > 鸿蒙智行官网 > 华为商城 > 第三方门户 > 采购文档 > 电商 > 新闻百科」的优先级入库。错误处理写得很细：官网结构变了尝试通用 HTML 解析；产品名匹配必须用精确 product_id，严禁 LIKE 模糊匹配（SKILL.md 给出了「智能MINI」误匹配到「智能MINI Pro」、ID 23 变 24 的真实案例）；数据库操作前先 cp data.db data.db.bak，失败时回滚。

新增品牌模块的流程是「建目录、用 scripts/schema.sql 初始化 data.db、抓取官网、LLM 解析填充、运行 generate_cards_v6.py、写 module.json」。框架的四个核心引擎文件已随技能打包，模块目录作为外部数据根保留。

适用边界

知识库已包含华为全生态 204 款产品（在售 199 款、即将上市 5 款）和鸿蒙智选 34 款产品的结构化数据，参数总数 7238 条，互联关系 1093 条，其中跨产品生态互联 209 条。但需要注意的是，scenario_products 关联表当前为空，场景有 6 条定义但没有关联到具体产品。两条每日自动化任务都在跑 daily_run.py，功能重叠，建议合并。另外单次更新建议不超过 50 款产品，大批量要走分批策略。