ssurui 4dee32195f fix: 检索不到内容时的答复改得柔和并每次换措辞,修正一处语义错误的兜底文案
三处改动:

1. 系统提示词:把"直接回复我不知道"改成"说明手册中暂未查到相关内容
   并给一条可操作的建议(补充车型/年款、部件名称,或把故障现象描述得
   更具体)"。顺带把提示词从 510 字精简到 318 字。

2. generator.ts 新增 withToneHint():每次请求随机挑一条措辞引导追加到
   系统提示词末尾。原因是实测发现,只在提示词里写"每次换一种措辞"完全
   无效——模型每次请求都是无状态的,不知道上次说了什么,同样输入连发
   三次答复一字不差。改为让输入本身产生差异后,实测六次开头分别是
   "很抱歉/手册里/目前检索到的资料/这部分内容/手册中/抱歉",措辞不再
   雷同。没有采用调高 temperature 的做法:那会同时影响命中文档的正常
   回答,而维修手册问答更看重稳定准确;实测正常问答两次结果都忠于原文
   且带正确引用,确认不受影响。

3. queryHandler/visionHandler 里 chunks.length===0 时硬编码回复的
   "我不知道。"是语义错误的:search() 是全表余弦排序后截断,只要库里有
   文档就一定返回结果,走到这个分支只可能是知识库为空。回一句"我不知道"
   会让人以为是模型答不上来,实际应该引导去导入文档,已改为对应文案。

注意:改的是 DEFAULT_CONFIG,只对新配置生效。已部署设备的 config.json
里存的仍是旧提示词(getConfig 合并时会覆盖默认值),需要手动删除该字段
或在设置页重新保存才会用上新版。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QeoAy5KmkHuKWHAktpEsaN
2026-09-03 21:05:17 +08:00

elec_rag_ui — 智能电子手册前端

基于 Electron + Vue3 + TypeScript + LanceDB 构建的本地化 RAG(检索增强生成)桌面应用。

仅支持 Linux(银河麒麟 Kylin V10 / Ubuntu),适配 ER160(揽月 M50 NPU)和 ER25(芯动力 RPP)计算卡。服务进程管理委托给 er_backend(HTTP 17700),前端专注 RAG 逻辑与用户交互。

技术栈

  • 框架:Electron + electron-vite + Vue3 + TypeScript
  • UI:Naive UI(弹窗/通知)+ 自定义工业风 CSS
  • 状态管理:Pinia
  • 向量数据库:LanceDB(嵌入式,无需额外服务)
  • 本地向量化:@huggingface/transformers + onnxruntime-node
  • 生成引擎:llama.cpp server(通过 er_backend 管理)
  • Markdown 渲染:marked

支持硬件

计算卡 嵌入方式 生成方式
ER160(揽月 M50 NPU) llamacpp NPU(默认)或本地 CPU llamacpp
ER25(芯动力 RPP) 本地 CPU(固定) llamacpp

推理请求(生成 + 嵌入)统一经 er_backend 代理转发(http://127.0.0.1:17700),实际 llama-server 监听哪个端口由 er_backend 后端配置决定,前端不感知、也不需要按计算卡型号推导端口。

目录结构

elec_rag_ui/
├── src/
│   ├── main/               # Electron 主进程
│   │   ├── index.ts        # 入口:全屏启动、菜单禁用、信号处理
│   │   ├── config.ts       # 配置读写(userData/config.json)
│   │   ├── ipc/            # IPC 处理器
│   │   └── rag/            # RAG 核心逻辑
│   ├── preload/index.ts    # contextBridge
│   ├── renderer/           # Vue3 前端
│   │   └── src/
│   │       ├── App.vue     # 根布局(顶栏 + 主区)
│   │       ├── components/ # ChatPanel / IndexPanel / SettingsModal 等
│   │       ├── stores/     # Pinia store
│   │       └── types/      # TypeScript 类型定义
│   └── batch_questions.txt # 批量测试问题示例
├── models/                 # 本地模型(onnx 由 Git LFS 管理)
│   ├── bge-small-zh-v1.5/  # 嵌入模型(512 维,~24MB),本地 CPU 向量化回退用
│   └── asr/                # Paraformer 流式语音识别模型(~376MB)
├── docs/                   # 示例文档(用于测试索引与问答)
├── resources/              # 应用图标、TTS/ASR worker
├── stubs/sharp/            # sharp 原生模块 stub
├── package.json
├── electron-builder.config.ts
└── electron.vite.config.ts

依赖:er_backend

本应用依赖 er_backend(端口 17700)管理 llama-server 推理服务进程。启动前请确保 er_backend 已运行:

# PAD 上
cd /opt/er-backend
nohup ./node/node manager/index.js &

# 或通过 systemd(deb 安装后自动配置)
systemctl status er-backend

er_backend 管理界面:http://<PAD-IP>:17700(配置模型路径、启动/停止服务)

模型文件

models/ 目录中的 .onnx 文件通过 Git LFS 管理。克隆后拉取实体文件:

git lfs install
GIT_SSL_NO_VERIFY=true git lfs pull

语音识别默认不带自动加标点(标点恢复模型未随包分发);如需要可自行准备 sherpa-onnx punct 模型, 在设置里把"标点恢复模型目录"指过去即可,代码本身已支持该功能。

开发模式

npm install
npm run dev:linux    # Linux(--no-sandbox,开发专用)

开发模式下需要设置 DISPLAY 环境变量(有图形界面时自动可用)。

打包

npm run package:kylin            # Linux x64,产出 AppImage + .deb
npm run package:kylin:arm64:deb  # Linux ARM64 deb(推荐,须在 ARM64 机器/真机上执行,已验证可行)
npm run package:kylin:arm64      # Linux ARM64(AppImage + deb),真机 Kylin 上 deb 目标
                                  # 走 electron-builder 自带 fpm 必现 tar failed,
                                  # 用 package:kylin:arm64:deb 代替

数据存储

内容 路径
配置文件 ~/.config/elec_rag_ui/config.json
向量数据库 ~/.config/elec_rag_ui/lancedb/

许可证

MIT License

Description
No description provided
Readme 646 MiB
Languages
F* 42.2%
TypeScript 33.8%
Vue 18.5%
JavaScript 2.4%
CSS 2%
Other 1.1%