WeKnora deployment source with the reviewed wiki identity, summary and recovery fixes

2026-09-22 16:19:06 +08:00
commit f7fc992f57
3929 changed files with 1006607 additions and 0 deletions
@@ -0,0 +1,75 @@
+# 智能家居中控 Pro 产品手册
+
+**产品型号**：HUB-Pro-2024  
+**文档版本**：v2.1  
+**适用固件**：≥ 3.4.0
+
+## 1. 产品概述
+
+智能家居中控 Pro 是星云科技（NovaTech）推出的家庭物联网中枢，负责统一管理灯光、空调、窗帘、安防传感器等设备。用户可通过手机 App、语音助手或本地触摸屏完成场景联动。
+
+核心卖点：
+
+- 本地离线可用：断网后局域网内仍可执行已配置场景
+- 多协议兼容：同时支持 Matter、Zigbee 3.0、Wi-Fi 与蓝牙 Mesh
+- 边缘 AI：内置轻量模型，可识别「我回家了」「准备观影」等口语化指令
+
+## 2. 技术规格
+
+| 项目 | 参数 |
+| --- | --- |
+| 处理器 | 四核 ARM Cortex-A55，1.8 GHz |
+| 内存 / 存储 | 4 GB RAM / 32 GB eMMC |
+| 无线协议 | Wi-Fi 6、Zigbee 3.0、蓝牙 5.2、Thread |
+| 有线接口 | 千兆以太网 ×1、USB-C（调试）×1 |
+| 供电 | DC 12V / 2A，典型功耗 8W |
+| 工作温度 | 0℃ ~ 40℃ |
+| 最大接入设备数 | 256（推荐 ≤ 120 以保证响应速度） |
+
+## 3. 首次配置
+
+1. 将设备接通电源，指示灯呈蓝色慢闪表示等待配网。
+2. 打开 NovaHome App，选择「添加中控」，扫描机身二维码。
+3. 按向导连接家庭 Wi-Fi；若使用有线网络，可跳过 Wi-Fi 步骤。
+4. 完成固件检查；如有更新，建议先升级再添加子设备。
+
+> **注意**：首次配网时手机需与中控处于同一 2.4 GHz 频段。5 GHz-only 路由器需先开启 2.4 GHz 兼容模式。
+
+## 4. 场景联动示例
+
+### 4.1 「回家模式」
+
+触发条件（满足任一即可）：
+
+- 手机 GPS 进入家庭地理围栏
+- 大门指纹锁解锁
+- 语音说「我回来了」
+
+执行动作：
+
+- 客厅主灯调至 70% 暖白光
+- 空调设为 26℃ 制冷（仅夏季模板生效）
+- 关闭安防布防
+
+### 4.2 「离家模式」
+
+触发条件：所有家庭成员手机离开地理围栏超过 5 分钟。
+
+执行动作：关闭全屋灯光、关闭空调、启动安防布防、关闭燃气机械手（如已接入）。
+
+## 5. 常见问题
+
+**Q：中控离线后语音还能用吗？**  
+A：若语音模块走云端识别，断外网后仅支持 App 与本地触摸屏；若配置了本地语音包，可继续使用基础指令。
+
+**Q：一个账号能绑定几台中控？**  
+A：个人版最多 3 台；企业版按合同授权，默认 50 台。
+
+**Q：保修政策？**  
+A：整机保修 24 个月，电池类配件 12 个月。人为拆解、进水不在保修范围。
+
+## 6. 相关文档
+
+- 安装与接线说明见《中控 Pro 硬件安装指南》
+- 报销与出差携带设备规定见《员工手册 · 报销与资产》
+- Q1 功能路线图见《产品会议纪要 · Q1 规划》
@@ -0,0 +1,70 @@
+# 产品会议纪要 · 2024 Q1 规划
+
+**会议主题**：智能家居产品线 Q1 优先级评审  
+**时间**：2024-01-15 14:00–16:30  
+**地点**：总部 A 栋 3F 梧桐会议室  
+**记录人**：李薇（产品运营）
+
+## 参会人员
+
+| 姓名 | 部门 | 角色 |
+| --- | --- | --- |
+| 陈浩 | 产品部 | 产品总监 |
+| 张明 | 研发部 | 知识库与 AI 模块负责人 |
+| 王雪 | 设计部 | 交互设计负责人 |
+| 赵磊 | 测试部 | 测试经理 |
+| 刘洋 | 销售部 | 华东区销售总监 |
+
+## 一、Q1 核心目标
+
+1. **中控 Pro 固件 3.5**：完成 Matter 1.2 认证，3 月底前发布灰度。
+2. **NovaHome App 4.0**：重构设备列表与场景编辑器，2 月中旬进入内测。
+3. **企业版知识助手**：基于自研 RAG 方案，为售后团队提供安装/排障问答（由张明团队承接 POC）。
+
+## 二、功能优先级（MoSCoW）
+
+| 优先级 | 功能 | 负责人 | 目标日期 |
+| --- | --- | --- | --- |
+| Must | Matter 桥接稳定性修复 | 硬件组 | 2024-02-01 |
+| Must | 场景编辑器拖拽改版 | 王雪 | 2024-02-15 |
+| Must | 售后知识库 POC 上线内网 | 张明 | 2024-03-01 |
+| Should | 本地语音包离线识别 | 语音组 | 2024-03-15 |
+| Could | 能耗统计周报 | 数据组 | Q2 再评 |
+
+## 三、关键决议
+
+### 3.1 售后知识库 POC 范围
+
+- **首期语料**：产品手册、安装指南、Top 50 工单 FAQ，预计 200 篇左右。
+- **验收标准**：随机 100 道售后题，Top-3 命中率 ≥ 85%，回答必须带出处链接。
+- **技术选型**：采用私有化部署的 WeKnora 实例，Embedding 用本地模型，对话模型接公司统一 API 网关。
+- **负责人**：张明；产品对接人：李薇。
+
+### 3.2 App 4.0 体验原则
+
+- 设备列表默认按「房间」分组，支持一键切换「按类型」视图。
+- 场景编辑从「表单式」改为「卡片 + 时间轴」，降低新用户学习成本。
+
+### 3.3 销售侧反馈
+
+刘洋反馈：华东区客户最关心 **断网可用** 与 **多中控级联**（别墅场景）。级联方案列入 Q2 预研，本季度仅输出技术可行性报告。
+
+## 四、风险与依赖
+
+| 风险 | 影响 | 缓解措施 |
+| --- | --- | --- |
+| Matter 认证排期紧张 | 固件发布推迟 | 提前 2 周提交预认证材料 |
+| 售后语料质量参差 | 问答准确率不达标 | 由赵磊团队做抽样标注，每周复盘 |
+| 统一 API 网关限流 | POC 演示卡顿 | 申请专用配额，演示环境独立租户 |
+
+## 五、待办事项
+
+- [ ] 张明：1 月 20 日前完成 WeKnora 测试环境部署与首批语料导入（陈浩审批资源）
+- [ ] 王雪：1 月 25 日前输出场景编辑器高保真原型
+- [ ] 李薇：每周五发送 POC 进度邮件给参会人
+- [ ] 赵磊：2 月 1 日前提交 Top 50 FAQ 清洗版 Excel
+
+## 六、下次会议
+
+- **时间**：2024-02-05 14:00  
+- **议题**：App 4.0 内测反馈、知识库 POC 中期评审
@@ -0,0 +1,88 @@
+# 员工手册（节选）· 报销与休假
+
+**生效日期**：2024-01-01  
+**适用对象**：星云科技全体正式员工  
+**归口部门**：人力资源部 · 财务部
+
+## 1. 差旅报销
+
+### 1.1 交通费
+
+| 职级 | 飞机 | 高铁 / 动车 | 市内交通 |
+| --- | --- | --- | --- |
+| M3 及以上 | 经济舱 | 一等座 | 实报实销，单日上限 300 元 |
+| M1–M2 | 经济舱 | 二等座 | 实报实销，单日上限 200 元 |
+| 普通员工 | 经济舱（需提前 3 天审批） | 二等座 | 实报实销，单日上限 150 元 |
+
+**规定**：
+
+- 机票需通过公司指定商旅平台预订；自行购票报销需在行程结束后 7 个工作日内提交。
+- 连续乘坐超过 6 小时的高铁，可申请升级一等座，须直属主管邮件审批。
+
+### 1.2 住宿费
+
+| 城市级别 | 每晚上限（含税） |
+| --- | --- |
+| 一线城市（北上广深） | 600 元 |
+| 新一线城市 | 450 元 |
+| 其他城市 | 350 元 |
+
+超标部分由个人承担，除非活动主办方统一安排且取得财务部特批。
+
+### 1.3 餐饮与补贴
+
+- 出差期间餐饮费 **不单独报销**，按天数领取差旅补贴：
+  - 国内一线城市：150 元 / 天
+  - 国内其他城市：120 元 / 天
+  - 境外：按财务部当月汇率表执行
+- 客户招待餐费走 **业务招待费** 流程，与差旅报销分开。
+
+## 2. 日常费用报销
+
+### 2.1 提交时限
+
+所有发票须在 **费用发生日起 30 日内** 提交 OA 报销单。逾期需直属主管 + 财务经理双签说明。
+
+### 2.2 常见科目
+
+| 科目 | 说明 | 附件要求 |
+| --- | --- | --- |
+| 办公用品 | 单价 < 500 元 | 发票 + 采购清单 |
+| 培训费 | 外部认证、行业会议 | 发票 + 培训通知 + 结业证明 |
+| 测试设备采购 | 研发测试用样机、传感器 | 发票 + 项目编号 + 资产入库单 |
+
+**研发人员**购买测试用智能家居中控、传感器等硬件，须先在资产系统创建「研发样机」条目，再关联报销单。参考《产品手册 · 智能家居中控 Pro》中的型号与规格填写。
+
+## 3. 年假与请假
+
+### 3.1 年假天数
+
+按工龄计算（以入职日期为准）：
+
+| 工龄 | 年假天数 |
+| --- | --- |
+| 1 年以下 | 5 天 |
+| 1–10 年 | 10 天 |
+| 10 年以上 | 15 天 |
+
+当年 3 月 31 日前入职的员工，当年年假按剩余月份折算；之后入职次年才开始享受全额年假。
+
+### 3.2 请假流程
+
+1. 提前在 OA 提交请假单，选择类型（年假 / 病假 / 事假等）。
+2. 3 天以内：直属主管审批；3–7 天：部门总监审批；7 天以上：HR 备案。
+3. 病假连续超过 2 天需附二级以上医院证明。
+
+### 3.3 与项目冲突
+
+若请假期间有已定版的发布节点（如固件 3.5 灰度、知识库 POC 验收），须在项目群同步并指定 **工作交接人**。张明团队 POC 相关请假，需额外知会产品总监陈浩。
+
+## 4. 违规处理
+
+- 虚假发票、重复报销：一经查实，追回款项并按《员工奖惩制度》处理。
+- 未经审批的境外差旅：费用不予报销。
+
+## 5. 联系方式
+
+- 报销政策咨询：财务部 `finance@novatech.example`（示例邮箱）
+- OA 系统问题：IT 服务台分机 8800
@@ -0,0 +1,95 @@
+# 技术方案 · 售后知识库 POC
+
+**项目代号**：Nova-KB-POC  
+**版本**：0.3 草案  
+**作者**：张明（研发部）  
+**评审人**：陈浩（产品部）、赵磊（测试部）  
+**最后更新**：2024-01-18
+
+## 1. 背景与目标
+
+星云科技售后团队每日处理约 400 条安装与排障工单。现有方案依赖 Confluence 全文搜索，一线工程师反馈「搜得到段落但不知道哪句能直接回复客户」。
+
+本 POC 目标：
+
+1. 导入产品手册、会议纪要、FAQ 等内部文档；
+2. 支持自然语言提问，返回答案 + **可追溯出处**；
+3. 4 周内完成内网演示，供 Q1 规划会中期评审。
+
+## 2. 系统架构
+
+```text
+[语料来源]  Confluence 导出 / Markdown / PDF 手册
+      ↓
+[WeKnora]   docreader 解析 → 分块 → 向量 + BM25 混合检索
+      ↓
+[模型层]    Embedding：本地 bge-m3
+            LLM：公司 API 网关 → DeepSeek-V3
+      ↓
+[接入]      售后工单系统 iframe 嵌入（二期）
+```
+
+### 2.1 关键角色
+
+| 角色 | 姓名 | 职责 |
+| --- | --- | --- |
+| 技术负责人 | 张明 | 部署、语料管道、检索调优 |
+| 产品对接 | 李薇 | 需求优先级、验收题库 |
+| 测试负责人 | 赵磊 | 标注 100 道验收题、准确率统计 |
+| 审批人 | 陈浩 | 资源申请、范围裁剪 |
+
+### 2.2 与中控产品的关系
+
+POC 首期语料以 **智能家居中控 Pro** 为主（参见《产品手册》），辅以《Q1 产品会议纪要》中的里程碑与责任人信息，便于回答「谁负责」「什么时候交付」类问题。
+
+## 3. 语料清单（首批）
+
+| 序号 | 文档 | 格式 | 预估分块 |
+| --- | --- | --- | --- |
+| 1 | 智能家居中控 Pro 产品手册 | Markdown / PDF | 40 |
+| 2 | Q1 产品会议纪要 | Markdown | 25 |
+| 3 | 员工手册 · 报销与休假（售后出差场景） | Markdown | 30 |
+| 4 | Top 50 工单 FAQ | Excel 导入 | 50 |
+
+**合计约 145 个知识单元**，满足 3 月 1 日内网演示最低要求。
+
+## 4. 检索策略
+
+- **默认**：向量 + BM25 混合检索，RRF 融合，Top-5 送入 LLM。
+- **可选**：开启 Rerank（`bge-reranker-v2-m3`）提升多义词场景准确率。
+- **暂不启用**：知识图谱（Neo4j 尚未纳入 POC 环境）、Wiki 自动生成。
+
+### 4.1 分块参数（建议）
+
+| 参数 | 值 | 说明 |
+| --- | --- | --- |
+| chunk_size | 512 | 与手册段落长度匹配 |
+| chunk_overlap | 64 | 保留表格上下文 |
+| 父子分块 | 开启 | 检索命中子块、生成用父块 |
+
+## 5. 验收用例（示例）
+
+| 问题 | 期望答案要点 | 期望出处 |
+| --- | --- | --- |
+| 中控 Pro 最多能接多少设备？ | 256，推荐 ≤ 120 | 产品手册 · 技术规格 |
+| Q1 知识库 POC 什么时候验收？ | 2024-03-01 内网上线 | Q1 会议纪要 |
+| 一线城市住宿报销上限？ | 600 元 / 晚 | 员工手册 · 差旅报销 |
+| Matter 认证目标版本？ | 固件 3.5，3 月底灰度 | Q1 会议纪要 |
+| 谁负责售后知识库 POC？ | 张明 | 会议纪要 / 本方案 |
+
+赵磊将据此扩展为 100 道正式验收题。
+
+## 6. 风险
+
+1. **语料过期**：产品手册 v2.1 与即将发布的 v2.2 冲突 → 建立「语料 Owner」机制，李薇每月核对。
+2. **幻觉**：强制 Prompt 要求「仅根据引用回答；无依据则回复不知道」。
+3. **权限**：POC 阶段单租户；生产需按区域售后组拆分知识库 ACL。
+
+## 7. 里程碑
+
+| 日期 | 交付物 |
+| --- | --- |
+| 2024-01-20 | WeKnora 测试环境可用，导入首批 3 份 Markdown |
+| 2024-02-01 | FAQ Excel 导入完成，混合检索 + Rerank 调参 |
+| 2024-02-05 | 中期评审演示 |
+| 2024-03-01 | 100 题验收报告 |
@@ -0,0 +1,72 @@
+[
+  {
+    "tag_name": "售后",
+    "standard_question": "智能家居中控保修多久？",
+    "similar_questions": ["保修期几年", "质保多长时间"],
+    "negative_questions": [],
+    "answers": ["整机保修 24 个月，电池类配件 12 个月。人为拆解、进水不在保修范围。"]
+  },
+  {
+    "tag_name": "产品",
+    "standard_question": "断网后语音还能用吗？",
+    "similar_questions": ["没有网络能语音控制吗", "离线能用语音吗"],
+    "negative_questions": [],
+    "answers": ["若语音走云端识别，断外网后仅支持 App 与本地触摸屏；配置本地语音包后可继续使用基础指令。"]
+  },
+  {
+    "tag_name": "产品",
+    "standard_question": "一个账号能绑几台中控？",
+    "similar_questions": ["最多添加多少台中控", "账号设备数量限制"],
+    "negative_questions": [],
+    "answers": ["个人版最多 3 台；企业版按合同授权，默认 50 台。"]
+  },
+  {
+    "tag_name": "人事",
+    "standard_question": "一线城市住宿报销上限是多少？",
+    "similar_questions": ["北上广深酒店报销额度", "住宿标准"],
+    "negative_questions": [],
+    "answers": ["一线城市（北上广深）每晚上限 600 元/晚（含税），超标部分个人承担。"]
+  },
+  {
+    "tag_name": "人事",
+    "standard_question": "出差餐饮怎么报？",
+    "similar_questions": ["餐费能报销吗", "吃饭费用"],
+    "negative_questions": [],
+    "answers": ["出差期间餐饮费不单独报销，按天数领取差旅补贴：一线城市 150 元/天，其他城市 120 元/天。"]
+  },
+  {
+    "tag_name": "项目",
+    "standard_question": "Q1 知识库 POC 什么时候上线？",
+    "similar_questions": ["售后知识库什么时候验收", "POC 交付日期"],
+    "negative_questions": [],
+    "answers": ["目标 2024-03-01 前完成内网演示，由张明负责技术交付。"]
+  },
+  {
+    "tag_name": "项目",
+    "standard_question": "谁负责售后知识库 POC？",
+    "similar_questions": ["知识库项目负责人是谁", "POC 技术负责人"],
+    "negative_questions": [],
+    "answers": ["技术负责人是研发部张明，产品对接人是李薇，测试负责人是赵磊。"]
+  },
+  {
+    "tag_name": "产品",
+    "standard_question": "中控 Pro 支持哪些协议？",
+    "similar_questions": ["能连哪些智能设备协议", "Matter 支持吗"],
+    "negative_questions": [],
+    "answers": ["支持 Matter、Zigbee 3.0、Wi-Fi 与蓝牙 Mesh；固件 3.5 计划完成 Matter 1.2 认证。"]
+  },
+  {
+    "tag_name": "人事",
+    "standard_question": "年假 10 年工龄有多少天？",
+    "similar_questions": ["工作满十年年假", "工龄年假天数"],
+    "negative_questions": [],
+    "answers": ["工龄 1–10 年为 10 天年假，10 年以上为 15 天；按入职日期计算。"]
+  },
+  {
+    "tag_name": "项目",
+    "standard_question": "Matter 认证计划什么时候完成？",
+    "similar_questions": ["Matter 1.2 什么时候过认证", "固件 3.5 发布时间"],
+    "negative_questions": [],
+    "answers": ["计划在 2024 年 3 月底前发布固件 3.5 灰度，完成 Matter 1.2 认证。"]
+  }
+]