设备维修知识库 AI 问答器｜工业AI分析工具
这个工具解决什么问题
特征工程做得对不对，比换模型有用得多。这工具把关键量的重要性排序摆出来。
> 先在本地把你的手册与案例检索出来，再让 AI 组织答案并标注出处 —— 答不上来时，是知识库缺内容。
示例输出（真实运行结果节选）
==============================================================================
设备维修知识库 AI 问答报告 2026-10-07 23:00:30
==============================================================================
知识库：5 篇文档，切分为 18 个片段（按小节切）
检索：BM25（k1=1.5，b=0.75，中文二元切分），返回 Top-4
一、本地检索结果（这一步完全可复核，与模型无关）
------------------------------------------------------------------------------
问：真空泵抽速下降怎么排查
1) 得分 28.23 ｜ 真空系统维护与抽速异常.md # 第一步 排除测量问题
第一步 排除测量问题 真空泵抽速下降的第一嫌疑不是泵，而是测量。先看真空计读数与工艺结果是否一致。 若两者背离，优先校准真空计。判定方法：同一腔体两台独立真空计读数差超过 5% 即需校准。…
2) 得分 14.62 ｜ 真空系统维护与抽速异常.md # 第四步 泵本体判定
第四步 泵本体判定 最后才怀疑泵。核对泵油更换周期、密封件更换周期与累计运行小时。抽速曲线在低真空段 正常、高真空段不足，通常指向泵内磨损而非外部泄漏。…
3) 得分 13.53 ｜ 真空系统维护与抽速异常.md # 第二步 查流路
第二步 查流路 进气过滤器、管路、阀体结垢是抽速下降最常见的物理原因。经验分布中约六成案例最终 定位到过滤器堵塞而不是泵本体。处理：更换滤芯、做管路吹扫，并记录更换前压差。…
4) 得分 2.33 ｜ 药液浓度管理.md # 偏差处理
偏差处理 浓度偏低时先核对补液泵行程与原料批号，再查在线浓度计是否漂移。 经验上一半以上的「浓度偏低」报警来自浓度计探头结垢。…
问：机械手取片超时抖动怎么处理
1) 得分 23.08 ｜ 机械手取片超时.md # 现象分类
现象分类 取片超时按持续时间分三类：小于 2 秒为抖动，2~10 秒为功能异常，超过 10 秒或伴随停机为故障。…
2) 得分 20.11 ｜ 机械手取片超时.md # 与其他设备的联动
与其他设备的联动 若同一时段多台机械手同时出现抖动，优先查
适用场景
· 现场排故支持、新人带教、把老师傅经验沉淀成可检索的知识库 · 先把 PDF/Word 手册转成 md 放进 kb/，检索质量立刻提升
怎么用
python maintenance_kb_qa.py
首次运行会自动生成示例数据并输出完整报告。 把示例数据换成你自己的（保持列名一致）后重新运行即可。
方式二：环境变量
set DEEPSEEK_API_KEY=你的密钥 # Windows export DEEPSEEK_API_KEY=你的密钥 # Linux / macOS
方式三：命令行临时指定（不落盘，适合共用电脑）
python maintenance_kb_qa.py --token 你的密钥
接口根地址与模型名也可用 DEEPSEEK_BASE_URL / DEEPSEEK_MODEL 覆盖， 换供应商时只改根地址即可 —— 请求体会话结构是 OpenAI 兼容格式。
输入数据
kb/ 目录下的 .md 或 .txt（脚本自带 5 篇示例：真空系统、机械手超时、温控校准、药液管理、点检备件）
输出内容
· BM25 本地检索（中文二元切分），列出每个问题的 Top-4 命中片段与得分 · 命中为空时明确提示「该补文档，而不是让模型硬答」 · AI 段：按命中片段作答，每条结论标注（来源：文件名 # 小节名）
没有 Token 也能用（离线模式）
离线也能跑：检索结果本身就可直接用（命中片段就是答案的出处）
配置 Token 后，报告里的 AI 段落会自动补全；调用失败时也不会中断， 本地计算部分照常输出，只是在报告里标注 AI 段失败原因。
依赖
无。仅使用 Python 标准库（urllib / json / csv / math / re 等）， 不需要 pip 安装任何包，Windows / Linux / macOS 均可运行。
可调参数与计算口径
脚本顶部集中了主要阈值与常量：KB_DIR=os.path.join(HERE, "kb")、REPORT_TXT="kb_qa_report.txt"、USAGE_CSV="ai_usage_log.csv"、TEMPLATE_JSON="deepseek_config.json"、DEFAULT_BASE="https://api.deepseek.com"、DEFAULT_MODEL="deepseek-chat"。改完直接重跑即可，不必改动计算逻辑。
--q：单个问题（默认 ""）--raw：只看本地检索结果，不调 AI--mock：演示模式，不联网--token（默认 ""）--model（默认 ""）
会生成哪些文件
运行后除控制台输出外，还会生成：kb_qa_report.txt、ai_usage_log.csv、deepseek_config.json、真空系统维护与抽速异常.md、机械手取片超时.md、温控回路校准.md。
脚本里的主要处理步骤
tokenize()：中文按二元切分 + 英文数字按词；不做停用词表，交给 BM25 的 idf 压权重。
以上步骤在脚本中是分开的函数，可以单独调用或按需替换其中一段，不必整体重写。
工具中出现的字段与提示
- 真空泵抽速下降怎么排查
- 机械手取片超时抖动怎么处理
- 热电偶漂移如何校准和判定
- 内置默认值
- 配置文件 %s
- 配置读取失败 %s：%s
- 环境变量 DEEPSEEK_API_KEY
- 输入token
- 输出token
- 合计token
- 估算费用
- 中文按二元切分 + 英文数字按词；不做停用词表，交给 BM25 的 idf 压权重。
- 设备维修知识库 AI 问答器
- 只看本地检索结果，不调 AI
- 演示模式，不联网
下载与文件清单
压缩包内包含：主程序脚本、示例数据文件、示例输出报告、中文说明文档，以及同主题 AI 提示词一套。解压后按说明运行即可，示例数据可直接试跑。
主程序文件：maintenance_kb_qa.py。
本站工具免费下载，无需注册。工具为 Python 脚本，Python 3.8 及以上环境可直接运行，核心功能尽量不依赖第三方库。
常见问题
阈值可以改成我们自己的标准吗？
可以，脚本顶部已把主要阈值与常量集中声明，按自己产线的标准修改后重跑即可，不需要改计算逻辑。
附赠的提示词怎么用？
把提示词与自己的数据一起交给大模型，可以让它按同一套口径帮你改写分析流程或扩展报告字段。
示例数据能直接跑吗？
可以。示例数据与主程序在同一压缩包内，解压后直接运行即可看到完整输出，确认无误再替换成自己的台账。
同分类的其它工具
所属分类 工业AI与智能分析工具包，也可回到 工具资源包下载页 按分类查找。
