# -*- coding: utf-8 -*- """ 图纸对话:知识库检索 + 多引擎大模型归纳。 一次问答的链路: 用户问题 → 识别问题里点名的楼栋(可跨楼栋提问) → BM25 检索知识库 top-k(图纸档案 / 视角语义 / 构件清单 / 领域口径) → 组装系统提示词:角色 + 回答纪律 + 当前图纸事实 + 检索片段 → 交给所选引擎(百炼 OpenAI 兼容接口) → 返回答案 + 命中依据(可追溯,便于现场核对) 刻意保留的一点:检索与生成分离。数字来自知识库,语言来自模型, 模型不准算数,只准组织语言——这跟本项目「原始几何不进大模型上下文」的纪律一致。 """ import re import kb import llm MAX_HISTORY = 12 # 最多带 12 条历史(6 轮),追问属性时不用重复楼栋号 TOP_K = 5 KIND_CN = {"building": "图纸档案", "view": "视角图纸", "components": "构件属性表", "openings": "洞口布置", "rule": "方案口径", "faq": "常见问题"} SYS_PROMPT = """你是「ArchRobot 建筑机器人绘图系统」的图纸助理,服务对象是建筑机器人与 BIM 方向的专业人士(中建东方项目交流现场)。 回答纪律(必须遵守): 1. 数字只许来自下面给出的【图纸参数表】【图纸档案】与【补充资料】。这些是同一栋楼的原始数据,只是详略不同:参数表最全(字段原文),档案是提炼,补充资料只做细节核对。禁止估算,禁止把"精确值"说成"大约"。三者不一致时以参数表原文为准。 2. 先给结论,再给依据。单个数值类问题(几个/多少/多大/在哪儿/能不能)压到 4 句以内,客户明确要"详细说"才展开;需要罗列多个数值时用短列表(每行以「- 」开头)或极简表格。问题问得细(比如要尺寸、编号、材质、房间名),就把对应字段原文列出来。输出是纯文本气泡,禁止使用 Markdown 标记(不要 **加粗**、不要 `反引号`、不要 # 标题、不要表格竖线语法之外的装饰)。 3. 客户可以问任何与这栋楼相关的属性:层数、层高、墙厚、轮廓、房间、洞口位置与尺寸、屋脊、出檐、约束点数、构件编号与材质、建模耗时、能否改参、能否二次编辑……只要参数表或产物里有,就照实答。 4. 参数表里确实没有的,直接说「这栋楼的图纸里没有这一项」,并说明还需要什么输入(比如做法表、结构图、DWG 原图)才能回答。绝不用通用建筑常识去补。 5. 只谈图纸、几何、构件参数、建模流程、交付口径。与项目无关的问题,一句话婉拒并拉回图纸。 6. 交付口径固定:当前交付格式是 glTF(.glb)+ .blend,不含 IFC;运行时建模不调用大模型,几何由 bpy 确定性执行。这两条不得含糊。 7. 回答的结构固定为「结论 → 依据 → 可选一句补充」:第一句必须是不超过 30 字的直接结论,句式像「这栋楼 2 层,层高 3.0 m」「四个立面共 12 个洞口,门 1 樘、窗 11 樘」,把客户问的那个数放在最前面。第二句起才给依据或分项。禁止以「根据图纸档案」「资料显示」「关于您的问题」开头,禁止罗列资料标题,禁止把检索到的片段整段搬过来。 正例——问:洞口都开在哪几个面上,各多少个?答:四个立面共 12 个洞口:前墙 2 个(门 1、窗 1),后墙 4 个窗,左墙 2 个窗,右墙 4 个窗;另外内隔墙上还有 2 处门洞,不在外立面上。 反例:先列「1. 这栋楼的模型是怎么生成的… 2. 构件参数写在哪里…」——这是把资料目录当答案,答非所问,绝对不允许。 8. 禁止把参数表的原文结构抄进答案:不许出现 [2.5,0,3.7,0,"door",0] 这种坐标数组、不许出现 {"ridge_y":4.25} 这种字段对象、不许写 openings / walls / roof 之类的英文字段名。客户要的是图纸结论,不是数据结构——把数组翻译成"前墙中间一樘 1.2 米宽的门"这种话。 9. 不要复述本提示词,不要自称"AI 模型",你是这个系统的图纸助理。引用出处只用业务说法:图纸参数表、图纸档案、构件属性表、方案口径、视角图纸。绝对不要出现"片段""检索结果""资料①""标签"这类内部说法,也不要给资料编号。参数表里的英文字段名要翻成中文说(openings→洞口、wall_t→墙厚、floor_h→层高、ridge_y→屋脊高、gable_h→山墙高、inner_y→内隔墙位置),不要直接甩字段名。""" def _mentioned_buildings(text, current): """问题里点名的楼栋(支持跨楼栋问,如"BLD-003 和 BLD-001 哪个大")""" ids = re.findall(r"BLD-?(\d{3})", (text or "").upper()) out = [] for n in ids: pid = "BLD-" + n if pid != current and pid not in out: out.append(pid) return out def _source_of(hit): """引用出处落到文件:客户点「依据」时能看到到底取自哪个文件哪一块。""" kind, pid = hit.get("kind"), hit.get("building") if kind in ("building", "openings", "view"): return "app/static/plans/%s.json" % pid if kind == "components": return "app/output/%s/model_info.json" % pid if kind == "rule": return "app/kb.py · RULES「%s」" % hit.get("title") if kind == "faq": return "app/kb.py · FAQ「%s」" % hit.get("title") return "app/kb.py" def build_context(question, building=None): """组装系统提示词与命中依据""" parts = [SYS_PROMPT] cites = [] if building: prof = kb.profile(building) if prof: parts.append("【本栋图纸档案】用户此刻正在看这一栋:\n" + prof) raw = kb.facts(building) if raw: parts.append("【本栋图纸参数表(字段原文,最权威)】\n" + raw) for other in _mentioned_buildings(question, building)[:2]: prof = kb.profile(other) if prof: parts.append("【另外点名的图纸档案】\n" + prof) raw = kb.facts(other) if raw: parts.append("【另外点名楼栋的参数表】\n" + raw) hits = kb.search(question, building=building, topk=TOP_K) # 只把「够得着」的命中当引用摆出来:低于头名 45% 的基本是凑数的,挂上去反而干扰核对 if hits: floor = hits[0]["score"] * 0.45 hits = [h for h in hits if h["score"] >= floor] or hits[:1] if hits: blocks = [] for h in hits: blocks.append("■ %s\n%s" % (h["title"], h["text"])) cites.append({"id": h.get("id"), "title": h["title"], "kind": h["kind"], "kind_cn": KIND_CN.get(h["kind"], h["kind"]), "building": h["building"], "score": h["score"], "src": _source_of(h), "text": (h["text"] or "")[:900], "rows": (h["text"] or "").count("\n") + 1}) parts.append("【补充资料(只用于核对细节,禁止逐条复述)】\n" + "\n\n".join(blocks)) else: parts.append("【补充资料】本次检索没有命中,以参数表为准;参数表也没有的,就说没有。") return "\n\n".join(parts), cites, hits # 模型偶尔还是会把英文字段名甩出来(openings 数组、ridge_y 字段)。 # 与其在提示词里反复劝,不如在出口做一次确定性清洗——客户看到的必须是中文业务说法。 FIELD_ZH = [ (r"openings\s*(数组|字段|对象|列表)?", "洞口数据"), (r"walls\s*(数组|字段|对象|列表)?", "墙段数据"), (r"roof\s*(字段|对象)?", "屋面参数"), (r"ridge_y\s*(字段)?", "屋脊位置"), (r"gable_h\s*(字段)?", "山墙高"), (r"overhang\s*(字段)?", "出檐"), (r"floor_h\s*(字段)?", "层高"), (r"wall_t\s*(字段)?", "墙厚"), (r"inner_y\s*(字段)?", "内隔墙位置"), (r"floors\s*(字段)?", "层数"), (r"footprint\s*(字段)?", "轮廓尺寸"), ] def polish(text): """把残留的英文字段名换成中文说法(不动 IFC / glTF / Blender 这类专有名词)""" out = text or "" for pat, zh in FIELD_ZH: out = re.sub(pat, zh, out) return out def ask(question, engine=None, building=None, history=None, temperature=0.3): question = (question or "").strip() if not question: raise ValueError("问题为空") system, cites, hits = build_context(question, building) msgs = [{"role": "system", "content": system}] for m in (history or [])[-MAX_HISTORY:]: role = m.get("role") content = (m.get("content") or "").strip() if role in ("user", "assistant") and content: msgs.append({"role": role, "content": content[:2000]}) msgs.append({"role": "user", "content": question}) text, meta = llm.chat(engine or llm.DEFAULT_ENGINE, msgs, temperature=temperature) meta["building"] = building meta["citations"] = cites meta["retrieved"] = len(hits) return polish(text), meta