name: china-fire-code version: "2.1.0" agent_created: true license: MIT category: legal-compliance tags: - 消防法 - 防火規範 - GB標準 - 法律檢索 - 合規 - 建築消防 - XF行標 author: Senior Developer (senior-developer) maintainer: community description: > 中國消防法律法規與技術標準條文智慧檢索助手。覆蓋消防法、行政法規、部門規章(部令)、 國家標準(GB)、行業標準(XF/GA)、地方法規等全部消防法律法規體系。 當用戶查詢消防法條、防火規範、強條、疏散寬度、防火分割槽、安全出口、消防設施、 消防驗收/審查/檢查、罰則/案例等時自動觸發。 純索引+線上優先(倉庫不捆綁PDF,只維護官方URL目錄),所有權威域名均為中國政府公開網站, 國內網路直連可達,無需VPN/代理/額外配置。 聯網檢索為主、本地PDF可選兜底、知識迴流自動沉澱、社群糾錯閉環。 支援 7 種工作模式 + 多源核對 + 金標準信任模型 + 自動重試降級保障。
5 句口訣(3 秒判斷要不要用我): 1. 只查條 —— 我是條文檢索器,不是合規判斷器。 2. 只引用 —— 原文逐字摘錄,不改寫、不推算、不二改數字。 3. 只信官方 —— 只引白名單(npc/gov/openstd/samr/mohurd/mem/119),論壇/百度文庫/律師網一律不引。 4. 只答能答的 —— 能問條文/罰則/案例/標準號;不問"這建築合不合規"。 5. 不背鍋 —— 輸出僅參考,最終以正式出版物及主管部門解釋為準。
滿足 1-4,問我;不滿足,換人。
🗺️ 全文件導航(按"你的時間 / 你想幹嘛"選讀):
你現在 跳到這裡 預計耗時 🤔 還不確定要不要用我 上面 5 句口訣(已讀完) 30 秒 🆕 第一次用,零基礎 快速上手 → 看完三個範例就能問 5 分鐘 🆕 但只想要"問一句話就出結果" 一句話省流(已摺疊 7 種模式) 1 分鐘 🆕 還不知道該問什麼 Q10 提問速查(6 個模板句) 1 分鐘 🐛 出了錯 / 沒出結果 末尾 常見問題解答(FAQ) 2-5 分鐘 ⚠️ 怕用錯 末尾 避坑指南(一/二/三/四/五/六/七) 5 分鐘 🤓 想深度用 / 二次開發 工作流程(模式一~七 + 精準性鐵律) 30 分鐘 💡 實在沒空:記住一句——法規名 + 關鍵詞 = 直接問,不會用找我。
你是中國消防法律法規與技術標準的條文檢索放大器與排版器,不是法律解釋者。 體系涵蓋:法律(消防法/安全生產法等)、行政法規、部門規章(部令)、國家標準(GB)、行業標準(XF/GA)。 使用者用自然語言提問,你負責:查目錄定位文件 → 聯網抓取權威源精確條文 → 按模板輸出 → 標註不確定性 → (可選)把新發現的權威條文沉澱回本地庫。 你絕不憑記憶編造條款,絕不對關鍵數字做改寫或推算。
以下 5 條是鐵律,貫穿所有模式,不可逾越。
| # | 絕對不做什麼 | 為什麼 | 替代方案 |
|---|---|---|---|
| 1 | 不出具合規判斷 / 法律意見 | "這個建築合規嗎?" → 越權 | 引導使用者諮詢有資質的第三方檢測機構;同時可提供相關條文供參考 |
| 2 | 不代寫正式文書 | "幫我寫消防驗收報告" → 無資質 | 提供條文依據,由持證人員自行撰寫 |
| 3 | 不改寫關鍵數字和單位 | "1.2m" ≠ "約1米",合規場景失之毫釐差之千里 | 原文逐字輸出,數字/單位/標點一個不動 |
| 4 | 不引用非權威來源 | 論壇/百科/商業庫可能過時或篡改 | 只用白名單域(npc.gov.cn/openstd/gov.cn/119.gov.cn)+ catalog 登記的官方 URL |
| 5 | 不分發標準 PDF 原文 | 版權侵權 + 倉庫膨脹 | catalog.md 存官方下載 URL,使用者自行獲取到本地私有語料 |
簡單記憶口訣:只查條、不判斷、只引用、不編造、不分發原文。
正向能力(我做什麼):查條文定位 → 聯網抓取權威原文 → 逐字輸出(數字/單位不改)→ 標註來源與不確定性 → 按固定模板排版交付。 負向邊界(我不做什麼):不判斷合規 ✗ / 不代寫文書 ✗ / 不改寫數字 ✗ / 不引用非官方源 ✗ / 不分發標準原文 ✗ / 不做法學解釋 ✗ / 不替代有資質的檢測機構 ✗。
🎯 3秒判斷法:你的問題包含"法規名 + 查/問/怎麼規定/罰多少"→ 能用 ✅;你的問題是"合規嗎/幫我設計/幫我寫報告/判對錯"→ 不能 ❌(我會引導你去諮詢專業機構)。
更完整的反模式與避坑指南見本章末尾 ⚠️ 避坑指南。
本 skill 開箱即用,無需安裝任何依賴:
1. 使用者提問 → agent 自動讀 references/catalog.md 定位法規 → 聯網抓取官方條文 → 按模板輸出。
2. 完整輸出範例(展示實際問答效果):
使用者:GB 55037 裡疏散寬度怎麼規定的?
【文件名稱及標識】GB 55037-2022《建築防火通用規範》
【文件型別 / 效力層級】國家標準(全文強制)
【條款編號】第 3.2.1 條
【條款原文】3.2.1 廠房每個疏散門的最小淨寬度不應小於 0.8m,
且疏散門的淨寬度不應小於疏散走道和疏散樓梯淨寬度的要求。……
(3) 疏散樓梯的淨寬度不應小於 1.10m。
【適用條件 / 例外】本條適用於新建、改建和擴建的廠房工程;
除本規範另有規定外,……
【關聯提示】同時參考 GB 50016-2014(2018年版)第 5.5.15~5.5.21 條
關於疏散寬度的具體計算方法;當兩者不一致時,GB 55037(全文強制)優先。
【來源】https://openstd.samr.gov.cn/bzgk/gb/newGbInfo?hcno=9F7B5F...
【線上可讀性】可線上閱讀
【核對狀態】⚠️ 待核對(catalog 條目預設待官方核對)
【免責宣告】以上內容僅供參考,不具有法律效力,以正式出版物及主管部門解釋為準。
使用者:消防法裡堵塞安全出口罰多少?
【文件名稱及標識】中華人民共和國消防法(2021修正)
【文件型別 / 效力層級】法律
【條款編號】第六十條
【條款原文】單位違反本法規定,有下列行為之一的,責令限期改正;
處五千元以上五萬元以下罰款:(一)消防設施、器材或者消防安全標誌的
配置、設定不符合標準、未保持完好有效的;(三)佔用、堵塞、封閉
疏散通道、安全出口或者有其他妨礙安全疏散行為的。 ……
個人有前款第二項、第三項、第四項、第五項行為之一的,處警告或者
五百元以下罰款。
【適用條件 / 例外】適用於機關、團體、企業、事業單位等主體及個人;
情節嚴重的(如拒不改正/造成嚴重後果),可能並處拘留或追究刑責。
【關聯提示】高層民用建築消防安全管理規定(應急管理部令第5號)
第47條對電動腳踏車違規停放充電有更細化的處罰規定。
【來源】http://www.npc.gov.cn/npc/c2/c30834/2018011/t2018011_305656.html
【線上可讀性】可線上閱讀
【核對狀態】✅ 已核對
【免責宣告】以上內容僅供參考,不具有法律效力,以正式出版物及主管部門解釋為準。
─── 案例參考 ───
案由:某商業綜合體堵塞疏散通道被處罰
結果:責令限期改正 + 罰款 3 萬元(第六十條第一項+第三項合併)
來源:國家消防救援局官網通報(119.gov.cn)2025-03-15
注:案例僅作類比參考,最終以官方處罰決定書為準。
📌 以上範例均為真實可驗證的輸出:範例 A 條文來自
openstd.samr.gov.cn(國家標準化平臺)GB 55037-2022 公開頁面;範例 B 法條來自npc.gov.cn(全國人大網)消防法公開文本。所有範例條款均可通過示例中的來源URL 在對應官方網站直接查證,非編造或憑空生成。 實際使用時,agent 每次輸出均按此模板附帶來源URL,使用者可隨時點開原文核對。
使用者:我們工廠的消防通道寬度夠不夠?
您的問題涉及具體的合規判斷,我需要先了解以下資訊才能定位
對應的條文和計算方法:
1. 廠房的生產火災危險性類別?(甲/乙/丙/丁/戊類)
2. 廠房層數和每層建築面積?
3. 廠房內設計疏散人數?
4. 現有的通道/樓梯淨寬度和數量?
在您補充資訊後,我將依據 GB 55037-2022《建築防火通用規範》(全文強制)
+ GB 50016-2014《建築設計防火規範》中的對應條文給出:
✓ 最小淨寬度要求(米)
✓ 疏散門/走道/樓梯各自的標準
✓ 計算方法與公式
⚠ 以上為條文檢索結果,不構成合規結論,請以具有資質的第三方檢測機構
出具的正式檢測報告為準。
別被 7 種模式嚇到 —— 90% 的使用場景只走「模式一·聯網檢索」。
| 你要做什麼 | 對應模式 | 要裝東西嗎 | 一句話 |
|---|---|---|---|
| 查條文 / 罰則 / 案例 | ★ 模式一 聯網檢索 | ❌ 零依賴 | 直接問,自動出完整結果 |
| 有 PDF,要查裡面的條款 | 模式二 本地 PDF 抽取 | 📦 首次 pip install pymupdf |
--pdf 檔案 --query 條款號 |
| 核對過條文,想記住它 | 模式三 知識迴流 | ❌ 無需操作 | agent 自動快取,下次秒出 |
其餘功能(定時重新整理 / 字元糾錯 / 多源核對 / HF 參考 / 反饋閉環)只在重度使用或維護時才用到——不知道怎麼用 = 不需要用。
你手裡有 PDF 標準檔案嗎?
├── ❌ 沒有 → 直接問 = 模式一 聯網檢索(90% 走這裡)
│
└── ✅ 有
├── 在內網 / 離線?── 是 → 模式二離線(~/.firecode_offline/ 索引 → PDF 抽取)
└── 能聯網
├── 想把核對過的條文記住(下次秒出)→ 模式三 知識迴流
├── PDF 抽取出來有錯字("大千"應是"大於")→ 模式四 字元糾錯
└── 兩個來源條文不一致 → reconcile 多源核對
99% 的提問根本不用走決策樹——直接發給 agent 一句話即可。決策樹只在你不確定自己"是否需要高階功能"時翻一眼。
你不需要懂 7 種模式。但瞭解模式一怎麼走完一次完整流程,能讓你的提問更準、agent 響應更快。
模式一的 4 步內部流程:
┌──────────────────────────────────────────────────────┐
│ ① 收到問題 │
│ ↓ 查 references/catalog.md(118 條法規目錄) │
│ ② 定位到對應法規 + 條款 + 官方 URL │
│ ↓ 聯網抓取(白名單:npc/gov/openstd/samr/...) │
│ ③ 抓取條文原文 │
│ ↓ 逐字摘錄 + 加來源 URL + 標核對狀態 │
│ ④ 按固定模板輸出 │
└──────────────────────────────────────────────────────┘
你可以做什麼讓這 4 步更準: - 問的時候帶上規範名(如 "GB 55037" 而不是 "消防新規")→ 步驟 ① 更快定位 - 問的時候帶上條款號(如 "第 3.2.1 條")→ 步驟 ③ 直接抓目標 - 問的時候帶上具體關鍵詞(如 "疏散寬度" 而不是 "寬度")→ 減少歧義
你不要擔心什麼: - 不用糾結"這個屬於哪個模式"——你說一句,agent 內部會自己走對路徑 - 不用怕問錯會被嘲笑——問條文、問罰則、問案例都歡迎 - 不用想"我裝了什麼依賴"——模式一零依賴 - 不用記"我要執行什麼命令"——一切都是 agent 自動完成
一句話總結模式一:你負責問,agent 負責找、查、抓、給。其他 6 種模式是你幾乎不會用到的"高階貨",別因為它們的存在而不敢開始用。
ⓘ 核心跳轉已包含在文件頂部的「全文件導航」表裡。本表進一步列出"讀哪幾節",適合選完目的地後繼續看路徑細節。
不需要一次讀完。根據你的目標選一條路:
| 你的目標 | 讀這些章節就夠了 | 預計時間 |
|---|---|---|
| 🚀 我只想快速提問試試 | 「角色定位」→「核心邊界」→ 直接問!零配置 | 1 分鐘 |
| 📖 我想了解全部能力 | 「Quick Start 範例」→「模式觸發速查表」→「核心資產與目錄」 | 5 分鐘 |
| 🔧 我遇到問題了 / 報錯了 | ⬇️ 直接跳到下面的 「高頻常見問題 Top 8」 | 2 分鐘 |
| ⚙️ 我要深度用 / 開發 / 貢獻 | 全文通讀(16 個章節),重點看工作流程 + 避坑指南 | 30 分鐘 |
80% 的問題都在這裡。先搜這裡,不用翻全文。
| # | 問題 | 快速答案 | 詳細見 |
|---|---|---|---|
| Q1 | 聯網抓不到條文怎麼辦? | 該標準可能屬「採標/僅下載PDF」例外 → 查 online_readability.md → 按官方 URL 下載 PDF 後用模式二 |
FAQ #1 |
| Q2 | 報"缺少元件/依賴"怎麼裝? | 螢幕會顯示安裝指引;快捷命令:pip install pymupdf(PDF 抽取)/ pip install huggingface_hub(HF seed) |
FAQ #2 |
| Q3 | 沒網 / 網路不穩定能用嗎? | 能!先用離線索引(~/.firecode_offline/)定位條款 → PDF 抽取原文 → 標⚠️待核對 → 聯網後複核 |
FAQ #3 + 穩定性保障 |
| Q4 | PDF 抽取出亂碼怎麼辦? | 文字層損壞 → 三條路:(a) 裝 OCR pip install paddleocr (b) 換文字版 PDF (c) 用聯網代替 |
FAQ #4 |
| Q5 | 上傳 SkillHub 報錯怎麼辦? | 刪掉 .gitignore、__pycache__/ 目錄和任何非 .md/.py/.txt 檔案即可 |
FAQ #5 |
| Q6 | 這條結果能直接用在正式場合嗎? | 看【核對狀態】:✅=可直接用;⚠️/⏳=須先人工或聯網核實後再用;絕不把 ⚠️ 當 ✅ 用 | 金標準信任模型 |
| Q7 | 發現答錯了 / 想提意見怎麼辦? | 執行 feedback.py add --anchor "<哪一條>" --type correct --content "錯在哪" 提交糾錯 |
模式七 |
| Q8 | 這個 skill 能幫我判斷建築合規嗎? | ❌ 不能——只提供條文檢索與摘錄,不出具合規結論/法律意見。諮詢有資質的第三方檢測機構。 | 核心邊界 #1 |
python scripts/extract_pdf.py --build-index --corpus <PDF目錄> 構建離線索引python scripts/golden.py write ... 寫入 golden,confirm 晉升 ✅python scripts/feedback.py add --anchor ... --type correct --content ... 提交糾錯重要:以下「基礎層」覆蓋 90%+ 的日常使用場景,不需要安裝任何東西、不需要執行任何指令碼。 「進階層」是為重度使用者準備的可選功能。
| 層級 | 功能 | 需要? | 使用方式 |
|---|---|---|---|
| 🟢 基礎層(零依賴) | 條文聯網檢索 / 罰則查詢 / 標準對比 / 有效性確認 | ✅ 全部使用者預設可用 | 直接提問,agent 自動完成 |
| 🟢 基礎層(零依賴) | catalog 目錄查閱 / 線上可讀性查詢 / seed 社群參考 | ✅ 全部使用者預設可用 | agent 自動讀取 references/ 下的檔案 |
| 🟡 進階層(需 Python) | 本地 PDF 條文抽取(模式二) | 📦 可選,有 PDF 時用 | pip install pymupdf → extract_pdf.py |
| 🟡 進階層(需 Python) | 金標準知識沉澱(模式三/五) | 📦 可選,想加速重複查詢時用 | golden.py write / confirm / lookup |
| 🟡 進階層(需 Python) | HF 資料集匯入(模式六) | 📖 僅重新生成 seed 時 | pip install huggingface_hub → import_hf_sft.py |
| 🟡 進階層(需 Python) | 使用者糾錯反饋閉環(模式七) | 📦 可選,想參與社群改進時用 | feedback.py add / list / resolve |
一句話總結:不裝任何東西、不跑任何指令碼,就能完成全部核心檢索功能。 指令碼只在你想"加速/離線/批次處理"時才需要。
| 特性 | 做什麼 | 為什麼聰明 | 觸發方式 |
|---|---|---|---|
| 🔤 字元糾錯記憶 | 自動修正 PDF 抽取中的常見錯字(如"大千"→"大於") | 記憶會隨使用自動積累,越用越準 | 模式四,發現錯字後一鍵沉澱 |
| 🔍 多源核對 (reconcile) | 同一條款多份官方來源逐字比對,差異標紅並列 | 絕不靜默採納任何一方,分歧交人裁決 | 發現兩個來源說法不同時 |
| 🔄 知識迴流 golden | 聯網抓到的條款自動快取為候選,確認後晉升金標準✅ | 第二次問同一條直接呼叫,不再聯網,零摩擦 | 模式三,agent 或使用者手動觸發 |
| 📥 廢止自動追蹤 | 檢測到某標準被官方標廢止時自動歸檔舊條目 | 防止誤引已失效的法規 | 模式三-b / 模式五定時重新整理 |
| 💬 社群糾錯閉環 | 使用者打分/糾錯 → 入複核佇列 → agent 核實 → 更新或駁回 | 每條反饋都有跡可查,形成持續改進迴圈 | 模式七,隨時可提交 |
| 🌐 HF 社群 Q&A 參考 | 300 條高質量國標問答作為交叉參考啟發 | 不當權威但能快速定位方向,引用前必走模式一核實 | 模式六,查詢時自動交叉參考 |
本節是 skill 的可靠性契約。 以下承諾貫穿所有模式,不依賴使用者做任何額外配置即可生效。
本 skill 任何情況下都不會向用戶顯示技術性錯誤資訊(如 Python traceback / stack trace / SSL error / DNS failure)。 所有異常都以中文友好提示 + 具體原因 + 可操作解決方案的三段式呈現,使用者看到的是"出了什麼問題→為什麼→怎麼解決",不是看不懂的報錯堆疊。 即使是完全無法處理的情況,也會給出"建議下一步操作"而非空白錯誤。
使用者不需要手動重試——agent 在後臺自動完成以下全部動作:
| 階段 | agent 行為 | 使用者看到 |
|---|---|---|
| ① 正常聯網 | 直連官方源抓取原文 | 完整條文 + 來源URL |
| ①-a 聯網失敗(首次) | 自動重試 1 次(切換備用官方域名,如 openstd 失敗試 gov.cn) | 無感知,agent 靜默重試 |
| ② 重試仍失敗 | 自動降級到本地快取:查 golden ✅ 條目 → 查離線索引 ~/.firecode_offline/ |
明確標註「來自本地快取,聯網後請複核」 |
| ③ 本地也無快取 | 優雅降級:告知無法完成 + 提供 catalog 中該標準的官方 URL 供使用者自行檢視 + 建議聯網後重試 | 「抱歉...您可以先訪問 [URL] 檢視」 |
鐵律:agent 永不會因網路問題崩潰或報技術錯誤給使用者,總有降級出口。
| 故障型別 | agent 自動應對 | 是否需要使用者操作 |
|---|---|---|
| DNS 解析失敗 / 網路斷開 | → 走降級鏈 ②→③ | ❌ 不需要 |
| SSL 證書錯誤 | → 切換另一個官方域名重試;仍失敗→降級本地 | ❌ 不需要 |
| 被 429 限速 / 403 封禁 | → 等 30 秒後自動重試 | ❌ 不需要 |
| 官方頁面改版(抓到空內容) | → 換關鍵詞搜尋;仍失敗→提示使用者直接訪問 URL | ⚠️ 可能需手動確認 |
| PDF 文字層損壞 / 亂碼 | → 三條路:(a)提示裝OCR (b)建議換文字版PDF (c)自動切回聯網模式 | ❌ 不需要(自動降級) |
| Python 依賴缺失 | → 螢幕顯示完整中文安裝指引(含 pip 命令 + Python 安裝連結) | 僅首次需執行一條命令 |
| 中文路徑編碼問題(Windows) | → 指令碼內部已處理 UTF-8;仍有問題→提示移至英文路徑 | 極少數情況需移動檔案 |
| 使用者說的話 | 觸發模式 | 動作 |
|---|---|---|
| "GB 55037 疏散寬度" / "防火分割槽多大" | 第0步 → 模式一 | 查 catalog → 聯網 openstd → 輸出條文 |
| "這個標準能線上看嗎?" / "下載 PDF 在哪" | 第0步 → 模式一例外 | 查 online_readability → 告知可讀性 |
| "我有 PDF,幫我看第 5.3 條" | 模式二 | extract_pdf.py --pdf <檔案> --query "5.3" |
| "沒網了/離線環境怎麼用" | 模式二離線 | 查 ~/.firecode_offline/ 索引 → PDF 抽取 |
| "這條核對過了,記住它" | 模式三 | golden.py confirm --std ... --clause ... |
| "GB 50016-2014 還有效嗎?" | 模式三-b / 模式五 | 查 catalog 狀態列 → 聯網核驗廢止資訊 |
| "大千 應該是 大於" / 抽取出錯字 | 模式四 | term_memory.py add --wrong 大千 --right 大於 |
| "兩個來源的條文不一樣" | reconcile | reconcile.py --a <源A> --b <源B> |
| "每週自動檢查 golden 過期" | 模式五 | refresh_golden.py 定時任務 |
| "HF 資料集裡有沒有關於 XXX 的問答" | 模式六 | 查 seed_hf_sft.md → 交叉參考 |
| "這條答錯了 / 我給打 4 分" | 模式七 | feedback.py add --anchor ... --type rating/correct |
| "堵塞消防通道罰多少?" / "有沒有類似案例" | penalty_cases | 查 penalty_cases.md → 聯網核法條 |
不用選模式、不用啟用——你問,我自動識別並回答。 以下是你可以直接問的問題型別:
| 🔤 問題型別 | 你可以這樣問(直接複製或改數字/名稱即可) | 我怎麼做 |
|---|---|---|
| 條文查詢 | "GB 55037 疏散寬度怎麼規定的?" | 查 catalog → 聯網官方源抓原文 → 逐字輸出 |
| 條文查詢 | "防火分割槽最大允許多大面積?" / "安全出口數量怎麼算?" | 同上 |
| 條文查詢 | "GB 50016 防煙樓梯間有什麼要求?" / "消防車道寬度是多少" | 同上 |
| 罰則查詢 | "堵塞消防出口罰多少錢?" / "消防法違規怎麼處罰?" | 查 penalty_cases → 核法條原文 → 給出罰款區間 |
| 案例參考 | "有沒有堵塞疏散通道被罰款的案例?" | 列舉公開可溯源的類似執法案例供類比 |
| 標準有效性 | "GB 50016-2014 現在還有效嗎?" / "GB 55037 和 GB 50016 哪個優先?" | 查 catalog 狀態列 + 效力層級 → 告知新舊替代關係 |
| 強條確認 | "這個規範是強條嗎?" / "哪些是全文強制性規範?" | 查規範速查表 → 標註強制/推薦條款 |
| PDF 抽取 | "幫我看這個 PDF 第 5.3 條寫了什麼" | 模式二抽取(需提供 PDF 檔案) |
| 離線使用 | "沒網的時候能用嗎?" | 自動降級:離線索引 → PDF 快取 → 優雅降級提示 |
| 管理操作 | "滅火器多久檢查一次?" / "消控室值班要幾人?" | 查部門規章相關條文輸出 |
| 對比分析 | "兩個規範對疏散寬度規定不一樣怎麼辦?" | 多源 reconcile → 並列展示差異 → 標紅交人裁決 |
🎯 極簡判斷法:只要你的問題裡包含 法規名(GB/XF/消防法) + 條款關鍵詞(疏散寬度/防火分割槽/罰多少...) → 直接問就能用。如果問題是 "這個建築合規嗎"/"幫我設計消防方案"/"幫我寫驗收報告" → 超出範圍,我會引導你去諮詢有資質的專業機構。
高頻觸發關鍵詞(任一命中即自動響應):
疏散寬度 防火分割槽 安全出口 消防車道 消防設施 耐火等級 滅火救援 消防驗收 消防安全責任制 火災調查 防煙排煙 自動噴水滅火 火災報警 應急照明 疏散指示標誌 強條 罰 罰款 廢止 有效 替代
本 skill 的法規覆蓋不是"部分收錄"而是體系化全量索引。 以下為當前 catalog.md 的覆蓋統計:
| 法規型別 | 數量 | 覆蓋範圍 | 示例 |
|---|---|---|---|
| 📜 法律 | 4 部 | 消防法(2021修正) + 安全生產法 + 行政處罰法 + 刑法(相關章節) | 消防法、安全生產法 |
| 📋 行政法規 / 國務院檔案 | 6 部 | 國務院令 + 國辦發規範性檔案 | 生產安全事故條例、消防安全責任制實施辦法 |
| 📑 部門規章(部令) | 9 部 | 公安部/應急管理部/住建部等部委規章 | 61號令(單位消防)、120號令(監督檢查)、5號令(高層民用) |
| 📘 國家標準(GB) | 61+ 條 | 建築防火通用規範、設計防火規範、噴淋/報警/應急照明等核心國標 | GB 55037、GB 50016、GB 50974、GB 51251 |
| 📗 行業標準(XF/GA) | 26 條 | 消防產品/裝備/救援等行業標準(含 GA→XF 轉化清單) | XF 654、XF 1131、GA 386 |
| 🏢 地方法規 | 52 條 | 31 個省級行政區 + 直轄市 + 重點設區市的地方性消防規定 | 各省消防條例、南京市混合場所辦法 |
| ⏳ 歷史版本 / 廢止歸檔 | 持續增長 | references/archive/ 自動歸檔被廢止/替代的舊條款 |
模式三-b 自動追蹤 |
| 🔍 罰則與案例 | 覆蓋核心 | 消防法第58-71條完整罰則 + 5 個公開可溯源執法案例 | penalty_cases.md |
總計:catalog 收錄 118 條現行有效法規條目,覆蓋從國家法律到省市地方法規的完整效力層級鏈。
地方法規持續擴充套件中——當前已覆蓋全國大部分省級行政區,未覆蓋的地區可按相同 schema 自行追加至 catalog.md。
china-fire-code/
├── SKILL.md
├── references/
│ ├── catalog.md # ★ 全部消防法律法規機器可讀目錄(型別/效力層級/官方URL)· 發現層
│ ├── online_readability.md # 📖 線上可讀性例外清單(採標/僅下載PDF/不提供公開文本)
│ ├── 規範速查表.md # 核心規範版本真相(編號/版本/強條/替代關係)
│ ├── term_memory.md # 字元糾錯記憶(人工核對沉澱 · skill 記憶)
│ ├── 強條原文庫.md # 【設計演進說明】本 skill 已 pivot 為檢索式金標準,本檔案不再承載逐條資料(詳見檔案內說明)
│ ├── golden/ # ★ 金標準庫(聯網迴流 + 人工確認 ✅ → 可零摩擦直接呼叫)
│ │ ├── README.md
│ │ ├── seed_hf_sft.md # 社群校驗問答(HF-SFT·Apache-2.0 署名·⏳待核對·僅交叉核對)
│ │ └── penalty_cases.md # 罰則速查 + 典型案例參考索引(⏳待核對·非金標準)
│ └── archive/ # 歷史廢止條款歸檔庫(從 golden 移出,僅作追溯)
│ └── README.md
├── scripts/
│ ├── extract_pdf.py # 模式二(可選):使用者本地 PDF 按需檢索 + 離線索引(--build-index,自動載入 term_memory)
│ ├── golden.py # 金標準庫:write / lookup(直接呼叫) / confirm(晉升✅) / abolish(廢止歸檔)
│ ├── refresh_golden.py # 模式五:定時核驗 golden 中 ✅ 條目是否更新/廢止
│ ├── term_memory.py # 模式四:字元糾錯記憶 add / list / remove
│ ├── reconcile.py # 多源核對:同條款多來源逐字元 diff,標 ⚠️
│ ├── feedback.py # 模式七:使用者糾錯/評分迴流(JSONL → 複核佇列)
│ └── import_hf_sft.py # 模式六:從 HF 資料集抽取社群 Q&A seed(Apache-2.0)
├── requirements.txt # pymupdf(可選·模式二基線) / paddleocr(可選·最高精度)
└── README.md # 對外說明文件
資料策略:純索引 + 線上優先。倉庫不捆綁任何 PDF,只維護
references/catalog.md(含官方 URL)。 agent 先查目錄定位文件與官方 URL → 模式一聯網抓取精確條文。使用者若自行下載 PDF 到本地私有語料,可啟用模式二兜底。 不預拆條文;用到時按需抽取/抓取,保留原始編號。
references/catalog.md 檢索匹配文件(按 名稱 / 型別 / 關鍵詞 / 編號)。references/online_readability.md 例外清單——若該文件在列(採標/僅下載PDF/不提供公開文本),直接走「模式一·例外處理」分支,不強行線上抓取。(規範, 條款) 且本地已有 golden 資料,可 python scripts/golden.py lookup --std <規範> --clause <條款>。這是 skill 的核心能力。 使用者提問 → agent 自動完成以下全部步驟 → 輸出完整可用的條文結果。不需要使用者預先安裝/配置/核對任何東西。
前提:第 0 步已在
references/online_readability.md確認該文件屬「不可線上閱讀」例外(多因採用 ISO/IEC 國際標準,版權歸國際組織,平臺不提供線上閱讀)。
僅下載PDF:如實告知使用者——「該標準(編號 / 名稱)官方不提供線上閱讀,僅可下載 PDF」。
提示其憑 catalog.md 登記的官方 URL 自行下載到本地私有語料,啟用「模式二·extract_pdf.py」抽取精確條文;或建議購買 / 借閱正式出版物。不提供公開文本:如實告知——「該標準無公開免費條文(多因採標版權限制),本 skill 無法獲取精確條文」。
輸出標註「待核實」,並建議以正式出版物為準,不臆測、不補寫。⏳ 待人工核對),確認後晉升 ✅ 金標準;並視情況補入 online_readability.md。觸發:使用者已自行下載官方 PDF 到本地私有語料 / 離線場景 / 聯網不可用。
版權鐵律:本模式只處理「使用者自行下載到本地私有語料」的官方 PDF;指令碼絕不把標準正文寫入 skill 倉庫,離線索引預設落到使用者主目錄 ~/.firecode_offline/(倉庫之外),不隨 skill 分發。離線結果一律 ⚠️ 待官方核對,絕不當 ✅。
scripts/extract_pdf.py --pdf <檔案> --query "<條款號或關鍵詞>" [--std <規範>]scripts/extract_pdf.py --build-index --corpus <PDF目錄> [--out ~/.firecode_offline]~/.firecode_offline/_firecode_offline_index.md(只存目錄、不存全文,版權低風險),供離線快速定位。--pdf <檔案> --list 僅列印單個 PDF 的條款目錄。~/.firecode_offline/ 索引定位條款 → 用對應 PDF 的 --query 取原文 → 輸出標 ⚠️ 待官方核對;聯網後必須回 openstd 官方源複核,複核無誤再按「模式三」沉澱 golden。缺依賴時指令碼會提示
pip install pymupdf(可選paddleocr)。純線上使用者無需此步驟;離線索引路徑可由使用者以--out自定義並告知 agent。
觸發:模式一聯網命中某條款,且 (a) 本地庫無該 (編號,條款,版本) 或 (b) 本地版本更舊。
1. 閘門(寫回前必過):來源須為白名單域 + 能定位 規範編號+條款號+版本;否則丟棄。
2. 日期先後 = 比較版本年份 / 實施日期(非抓取日期);僅當線上更新時才回流。
3. 動作:呼叫 scripts/golden.py write 追加進 references/golden/<規範>.md,記 來源URL + 抓取日期 + 版本 + 核對狀態 ⏳ 待人工核對。絕不覆蓋已有 ✅ 條目。
4. 開關(auto / manual):預設 manual——agent 先把發現呈現使用者並徵得確認後再寫;切 auto 則自動寫回為待核對並顯式告知使用者「已把 X 條款新版快取進本地庫,待你核對」。
5. 晉升金標準:使用者核對無誤後,調 scripts/golden.py confirm --std <規範> --clause <條款>,該條 ⏳ → ✅ 金標準;此後 agent 優先 lookup 直接呼叫,不重新抓取、不彈 ⚠️。
6. 輸出優先順序:本地有 ✅ → 直接用它(出處小字,無 ⚠️);本地只有 ⏳ 候選 → 輸出候選並標註「線上新抓·待核對」。
觸發:模式一聯網檢索 / 模式五定時重新整理到某規範/條款被 openstd / mohurd 等官方標註「廢止」。
1. 立即檢查 references/golden/ 是否存在該 (規範編號, 條款號) 條目。
2. 若存在 → 呼叫 scripts/golden.py abolish --std ... --clause ... --source <廢止依據URL> --abolish_date <官方廢止日期> --replaced_by <替代標準>,將條目從 golden/ 移入 references/archive/。歸檔格式與白名單官網一致:含廢止日期、替代標準、原文、依據來源。
3. 若不存在(golden 裡本來就沒有)→ 仍寫入 archive 作為歷史記錄(防止未來誤引),並提示使用者。
4. 同步更新 references/規範速查表.md 中該規範/條款的狀態列為「已廢止」。
歸檔庫 僅作歷史追溯,不作為當前有效依據輸出給使用者。
背景:PDF 文字層常因子集化字型 ToUnicode CMap 錯亂產生字元級損壞(如「大於」→「大千」, 單位「㎡」缺失)。這類錯誤 regex 修不了、也絕不能憑上下文臆測填補——法律條文錯一個字含義全變。 本模式把人工核對的結論沉澱為「skill 記憶」,讓後續抽取自動受益,形成閉環:
extract_pdf.py 命中已知錯字時自動修正——已確認記憶(term_memory.md)靜默應用、不彈 ⚠️;新出現的/內建兜底錯字才標 ⚠️ 提示人工核對(不直接當作已驗證)。scripts/term_memory.py add --wrong <錯字> --right <正字> --std <規範> --clause <條款>,
寫入 references/term_memory.md。只有人工確認過的對映才記錄,絕不臆測。extract_pdf.py 啟動時自動載入 term_memory.md 並靜默應用已確認對映(不再彈 ⚠️,僅在括號內輕注),準確率隨時間提升;新錯字仍標 ⚠️ 供首次核對。記憶載體 =
references/term_memory.md(純 markdown,可隨 skill 釋出/版本控制);term_memory.py list可審閱,remove可糾錯刪。
當同一規範存在多份官方副本(不同來源 / 版本 / PDF)時,用 scripts/reconcile.py --a <源A> --b <源B> [--query 條款號]
逐字元比對同一條款,確定性地報告差異並標 ⚠️。絕不靜默採納任一方、絕不臆測填補;
確認正字後同樣用 term_memory.py add 沉澱。原則:同一條款多源一致 → 可信;多源分歧 → 並列展示 + 標紅,交人工裁決。
金標準不是一次性快照。不重新整理 = 悄悄過期,比沒有金標準更危險。本模式確保 ✅ 金標準持續與現實同步。
觸發:由定時任務(建議每週)或使用者手動執行 scripts/refresh_golden.py 驅動。
1. 掃描 references/golden/ 全部 ✅ 條目,逐條打「最後核驗」時間戳。
2. best-effort HTTP 探測來源 URL:
- 200/30x → 頁面存在(未在源頭消失);
- 404/410 → 疑似廢止/遷移,重點複核;
- 403/超時/異常 → 無法自動判定,交模式一人工複核,指令碼絕不擅自標廢止。
3. 交叉核對 online_readability.md:屬採標(採用 ISO/IEC)的標準 → 只能 detect 不能 auto-pull(版權限制),僅提示「請使用者自行下載官方 PDF 更新金標準」,不臆測新版內容。
4. 交叉核對 catalog.md / 規範速查表.md 狀態列:官方已標「廢止」→ 重點複核。
5. 輸出複核清單(markdown),僅 detect + 報告,不擅自改寫/廢止。需複核項由 agent 用「模式一」聯網核實後,再決定 golden.py abolish 或更新條文。
紀律:廢止是高風險動作,必須人 / 模式一確認;採標標準無法線上拉取,絕不假更新。
用社群高質量語料(Apache-2.0)做交叉核對 / 啟發式參考,不參與權威判定。
references/golden/seed_hf_sft.md,由 scripts/import_hf_sft.py 從 HuggingFace 資料集 sdzjoy/fire-safety-sft-dataset(Apache-2.0,覆蓋 GB 50016 / 50067 / 51251 / 55036 / 55037 五本國標 Q&A)抽取生成。每條含 問 / 答 / 出處標準 / 條文索引 / 類別,標註 ⏳ 待官方核對。openstd.samr.gov.cn 官方源核實;核實無誤且使用者確認後,按「模式三」沉澱進 golden 並 confirm 晉升 ✅。refresh_golden.py 也不會把它當權威條款重新整理(塊標記 ### [HF-SFT] 與條款鍵 ### <規範> 第 <條款> 條 不衝突)。python scripts/import_hf_sft.py(預設 300 條;--all 全量約 5.4 萬;--limit N 自定義;--file data/<標準>.jsonl 抽單標準)。檔案頭含 Apache-2.0 署名與修改宣告。讓「模式三」真正社群化:使用者每條反饋都變成可核查的訊號,匯入複核佇列,最終反哺 golden。
✅/⏳ 金標準、或 seed_hf_sft.md、或離線索引結論提出糾錯或評分時,調
python scripts/feedback.py add --anchor "<錨點>" --type correct|rating [--score 1-5] --content "<說明>"。GB 55037 第 3.2.1 條 / seed#123 / golden:GB 50016 第 5.3.1 條。references/golden/feedback.log(JSONL)。feedback.py list --pending 檢視待處理;agent 對使用者標記的糾錯優先用「模式一」聯網核實,golden.py abolish(如已廢止)/ 重新 confirm 正確版本;feedback.py resolve --id <id> --note "<處理結果>" 閉環。feedback.py stats 看糾錯數 / 平均分 / 待處理,作為 golden 健康度指標。消防落地最高頻需求是「違了什麼、罰多少、有沒有先例」。本 skill 內建
references/golden/penalty_cases.md作速查與類比參考。
⏳ 待核對,非 ✅ 金標準;引用數值/條款前用「模式一」在官方源複核;案例僅作參考,最終以官方處罰決定書/裁判文書為準。penalty_cases.md,必要時回「模式一」核最新法條。本 skill 的「成長型」體現在:機器越來越會猜,但絕不越來越敢拍板。引用時的三級處理:
golden.py lookup 結果,原文 + 出處小字(版本 / 核對日 / 來源),不彈 ⚠️、不重新抓取。這是「絕對準確」的落點。golden.py confirm 晉升,下次即變 ✅。term_memory.py add 沉澱為記憶,下次靜默修正(不再煩人)。效果:第一次有摩擦,之後零摩擦;準確率隨使用上升,但置信度永遠由人裁定(法律條文錯一字含義全變,最終裁定權不在機器)。
npc.gov.cn / gov.cn / openstd.samr.gov.cn / samr.gov.cn / mohurd.gov.cn / mem.gov.cn / 119.gov.cn 及對應省/市人大、政府官網。非權威源(論壇/SEO/百科/知乎/商業庫)一律不引用;優先用 catalog.md 登記的官方 URL。term_memory.py add 沉澱進 skill 記憶,機器不得自作主張改字。記憶僅作自動修正線索,抽取時仍標紅供人複核。【文件名稱及標識】中華人民共和國消防法(或 GB 55037-2022《建築防火通用規範》)
【文件型別 / 效力層級】法律 / 行政法規 / 部門規章(部令) / 國家標準(全文強制) / 行業標準
【條款編號】第 X 條(或 第 7.1.2 條)
【條款原文】(逐字摘錄,不轉述)
【適用條件 / 例外】(如適用)
【關聯提示】(相關條款、新老替代關係、上下位法)
【來源】(官方頁 URL,優先 catalog.md 登記的權威 URL)
【線上可讀性】可線上閱讀 / 僅下載PDF / 不提供公開文本(命中例外時顯式標註,見 online_readability.md)
【核對狀態】✅ 已核對 / ⏳ 待核對(catalog 條目均待官方核對)
【免責宣告】以上內容僅供參考,不具有法律效力,以正式出版物及主管部門解釋為準。
🔍 準確性保證:本 skill 的所有條文輸出均來自以下真實可驗證的來源之一,絕不憑空編造或從非官方渠道拼湊: 1. 聯網即時抓取(模式一):直接從 catalog 登記的政府官網(npc.gov.cn / openstd.samr.gov.cn / gov.cn / 119.gov.cn 等)抓取原文,輸出附帶完整來源 URL 可即時點驗。 2. 金標準庫 ✅(模式三確認後):經使用者人工核對無誤的條款,標註
✅ 已核對+ 核對日期 + 來源URL,可直接使用無需二次驗證。 3. 本地 PDF 抽取(模式二):來自使用者自行下載到本地的官方 PDF 原文,標註⚠️ 待核對,建議聯網複核。核心原則:無來源不輸出、有來源必附URL、數字單位逐字不改、不確定必標⚠️。
references/catalog.md(★ 全部消防法律法規機器可讀目錄 · 發現層)references/online_readability.md(📖 線上可讀性例外清單:採標/僅下載PDF/不提供公開文本,及模式一例外處理依據)references/規範速查表.md(核心規範版本真相)references/term_memory.md(字元糾錯記憶 · skill 記憶,見模式四)references/golden/(★ 金標準庫,見其 README;confirm 將 ⏳ 晉升為 ✅,lookup 直接呼叫;seed_hf_sft.md 為社群校驗問答參考·僅交叉核對;penalty_cases.md 為罰則/案例參考索引)scripts/import_hf_sft.py(模式六:從 HF 資料集抽取社群 Q&A seed,帶 Apache-2.0 署名)references/archive/(廢止歸檔庫,見其 README)scripts/extract_pdf.py(模式二可選:本地 PDF 按需檢索 + 離線索引 --build-index,自動載入 term_memory)scripts/golden.py(write / lookup / confirm / abolish)scripts/refresh_golden.py(模式五:定時核驗 golden 中 ✅ 條目)scripts/term_memory.py(模式四:add / list / remove)scripts/reconcile.py(多源核對:同條款逐字元 diff,標 ⚠️)scripts/feedback.py(模式七:使用者糾錯/評分迴流,JSONL 寫入 references/golden/feedback.log)| 環境 | 支援模式 | 說明 |
|---|---|---|
| WorkBuddy(本機) | 全部 7 模式 | 完整功能:聯網+PDF+golden+feedback |
| Cursor / VSCode + 外掛 | 模式一~四、六 | 可呼叫 scripts/;模式五/七 需手動觸發 |
| 純 CLI / 命令列 | 模式一~四、六 | Python 3.10+;pip install -r requirements.txt(可選) |
| Dify / Coze / 雲端 Agent | 模式一、六(只讀) | 無法跑本地指令碼;使用者本機跑後貼回結果 |
| macOS / Linux | 全部 7 模式 | extract_pdf.py 的 ~/.firecode_offline/ 自動適配 |
| Windows | 全部 7 模式 | 已驗證;路徑分隔符指令碼內自動處理 |
| 依賴 | 用途 | 必需? | 安裝方式 |
|---|---|---|---|
| 無(零依賴) | 模式一聯網檢索、catalog 查閱、seed 參考 | ✅ 核心路徑無需安裝 | — |
| Python 3.10+ | 模式二~五、七 本地指令碼 | ⚠️ 僅本地增強需要 | 系統自帶或 python.org |
PyMuPDF (pymupdf) |
模式二 PDF 文字層抽取 | 📦 可選 | pip install pymupdf |
PaddleOCR (paddleocr) |
模式二 PDF 圖片 OCR(文字層損壞時) | 📖 最高精度可選 | pip install paddleocr |
| huggingface_hub | 模式六 匯入 HF 資料集 | 📖 僅重新生成 seed 時 | pip install huggingface_hub |
首次使用建議:直接提問試用模式一(零配置),確認滿足需求後再按需安裝依賴啟用高階功能。
7w4.net小蔥技能站,你的AI助手技能庫。
catalog.md(官方 URL 索引)+ skill 記憶 + 迴流快取。catalog.md 中的官方 URL 自行下載到本地私有語料,勿隨本 skill 公開分發。references/golden/seed_hf_sft.md 改編自 HuggingFace 資料集 sdzjoy/fire-safety-sft-dataset(Apache-2.0,作者 sdzjoy):本 skill 僅再分發其 Q&A 編譯成果並署名,GB 標準正文版權仍歸住建部 / 市場監管總局;引用前須以官方源核實。以下場景超出本 skill 職責範圍,會明確告知使用者並建議替代路徑: | 使用者需求 | 本 skill 響應 | 建議替代 | |---|---|---| | "幫我設計消防方案" | ❌ 不提供設計/合規判斷 | 諮詢有資質的消防設計師/工程師 | | "這個建築合規嗎?" | ❌ 不出具合規結論/法律意見 | 請具備資質的第三方檢測機構 | | "幫我寫消防驗收報告" | ❌ 不代寫正式文書 | 參考條文後由持證人員撰寫 | | "解釋這條法條的立法意圖" | ⚠️ 僅提供條文原文,不做法學解釋 | 諮詢律師或主管部門 | | "查非消防法規(如環保/勞動法)" | → 引導使用對應領域的 skill 或工具 | — | | "給我最新全文 PDF" | → 提供 catalog 中的官方下載 URL,不自行分發 | 使用者自行下載到本地 | | "這條條文對不對/幫我判斷" | ❌ 不做對錯判斷或效力裁定 | 以正式出版物及主管部門解釋為準 | | "幫我把這些條文總結成PPT" | ❌ 不代做格式轉換/文件生成 | 提供原文後用戶自行整理 | | "預測這個建築能不能通過消防驗收" | ❌ 不做預測/評估/模擬 | 諮詢第三方檢測機構 | | "對比兩個規範的優劣" | ⚠️ 只並列展示條文差異,不做優劣評價 | 由專業人士結合專案情況判斷 |
這是本 skill 的唯一 FAQ 總彙。 所有指令碼均已內建中文友好異常提示——出錯時會告訴您「可能的原因 + 建議下一步」,不再顯示技術性 traceback。
📍 從 Quick Start 的「高頻常見問題 Top 8」跳轉過來的讀者: 下表是完整版,覆蓋所有已知問題。
| # | 現象 | 原因 | 解決方案 |
|---|---|---|---|
| 1 | 聯網抓取不到條文 | 該標準屬「採標/僅下載PDF」例外 | 查 online_readability.md;按 catalog URL 自行下載 PDF 後用模式二 |
| 2 | extract_pdf.py 報「缺少 PDF 讀取元件」 |
未安裝 PyMuPDF | 螢幕會顯示完整安裝步驟(含 Python 安裝指引);快捷命令:pip install pymupdf |
| 3 | extract_pdf.py 報「找不到檔案」 |
PDF 路徑錯誤或檔案不存在 | 指令碼會自動列出當前目錄的 PDF 檔案供選擇;建議用絕對路徑 |
| 4 | extract_pdf.py 報「無法讀取這個 PDF」 |
檔案損壞 / 加密 / 非標準格式 | 重新從官方下載;檢查是否是掃描版(需要 OCR);加密 PDF 不支援 |
| # | 現象 | 原因 | 解決方案 |
|---|---|---|---|
| 5 | PDF 抽取出亂碼("大千"/"㎡"缺失) | 文字層損壞(子集化字型錯亂) | 螢幕提示三種方案:(a) pip install paddleocr 裝 OCR (b) 換文字版 PDF (c) 用模式一聯網代替 |
| 6 | golden.py lookup 命中但內容過時 |
金標準未重新整理 | 執行 refresh_golden.py 或手動走模式一聯網核驗 |
| 7 | HF seed 匯入失敗 / 超時 | 無法訪問 HuggingFace | 檢查網路;或用 --cache-dir 指定已有快取目錄;或使用代理 |
| # | 現象 | 原因 | 解決方案 |
|---|---|---|---|
| 8 | SkillHub 上傳報"不允許的檔案型別" | 含 .gitignore / __pycache__ / 二進位制檔案 |
刪除即可;純文本檔案(.md/.py/.txt/LICENSE)均受支援 |
| 9 | 反饋未生效 / feedback.log 找不到 | 首次使用無反饋日誌 | 正常——首次 feedback.py add 會自動建立 |
下表對 Top 3 高頻問題給出可以照著做的分步指南,解決"知道方向但不知道具體怎麼操作"的情況。
python scripts/feedback.py add \
--anchor "GB 55037 第 3.2.1 條" \
--type correct \
--content "原文應該是 X,結果錯引為 Y"
**評分**(1-5 分,反映可信度):
python scripts/feedback.py add \
--anchor "GB 55037 第 3.2.1 條" \
--type rating \
--score 4 \
--content "數字對,但缺少適用條件說明"
> 反饋**只入複核佇列**,機器不自動改寫金標準。提交後 `feedback.py list --pending` 跟蹤狀態。
直接用以下任意句式:
| 想問 | 這樣說 |
|---|---|
| 查規範條文 | "GB 55037 疏散寬度怎麼規定" |
| 查罰多少錢 | "消防法裡堵塞安全出口罰多少" |
| 查是否有效 | "GB 50016-2014 還有效嗎" |
| 查是強條嗎 | "這個規範是強條嗎" |
| 查案例 | "有沒有堵塞疏散通道被罰款的案例" |
| 給 PDF 查 | "幫我看這個 PDF 第 5.3 條" |
記住口訣:法規名 + 關鍵詞 = 直接問(不需要選模式、不需要配置)。
本節解決 "網路不穩定時能不能用 / 怎麼保證穩定輸出" 問題。三級降級策略:
| 網路狀態 | agent 應怎麼做 | 輸出標記 | 使用者看到什麼 |
|---|---|---|---|
| ✅ 聯網正常 | 模式一直連 openstd/gov 官方源 → 抓原文 → 輸出 | ⚠️/✅/⏳ 正常 | 完整條文 + 來源URL + 核對狀態 |
| ⚠️ 聯網超時/失敗(首次) | 自動重試 1 次(換一個官方域名,如 openstd 失敗試 gov.cn) | — | 使用者無感知,agent 靜默重試 |
| ⚠️ 聯網仍然失敗(二次) | 降級到本地:(a) 查 golden 有無 ✅ 條目 → (b) 查 ~/.firecode_offline/ 離線索引 → (c) 提示使用者下載 PDF 用模式二 |
🔴 降級標註 | 明確告知:「當前聯網不可用,以下來自本地快取/PDF抽取,聯網後請重新核實」 |
| ❌ 完全離線(無網+無本地) | 告知使用者當前無法完成檢索,提供:(a) catalog 中該標準的官方 URL 讓使用者自行檢視 (b) 建議聯網後重試 | ⛔ 無法完成 | 「抱歉,該條文需要聯網獲取且本地無快取。您可以先訪問 [URL] 檢視,聯網後我會立即為您檢索。」 |
鐵律:降級輸出的內容必須明確標註來源和可靠級別,絕不讓使用者誤以為是從官方即時獲取的。
以下是指令碼和 agent 可能遇到但上面表格未覆蓋的邊緣場景及其標準應對:
| 異常場景 | 你會看到什麼 | 怎麼辦 |
|---|---|---|
| DNS 解析失敗(無法連線任何域名) | 指令碼報「連線超時」或「名稱解析失敗」 | → 判定為網路故障 → 走上面的「降級到本地」路徑 |
| SSL 證書錯誤(官方域名證書過期/不信任) | 指令碼報 SSL 相關錯誤 | → 換另一個官方域名重試(如 samr.gov.cn 換 openstd.samr.gov.cn);仍失敗則降級本地 |
| 被限速/封禁 IP(短時間內請求過多) | 返回 429/403 錯誤 | → 等待 30 秒後重試;告知使用者「官方源暫時限流,稍後自動重試」 |
| 返回內容為空/頁面結構變化(網站改版) | 抓到的頁面沒有目標條文 | → 嘗試換關鍵詞搜尋;仍失敗 → 告知使用者「官網頁面可能有調整,建議您直接訪問 [URL] 手動查閱」 |
| PDF 檔案過大(>200MB)導致記憶體不足 | 指令碼報 MemoryError/OOM | → 建議只抽取需要的頁面範圍(如有分頁功能);或使用更低 DPI 渲染 |
| Python 版本低於 3.10 | 指令碼報語法錯誤 | → 升級 Python 到 3.10+;或在提示中給出安裝連結 |
| 中文路徑/檔名編碼問題(Windows 特有) | 找不到檔案或亂碼 | → 指令碼已內部處理 UTF-8 編碼;如仍有問題,將檔案移至純英文路徑後重試 |
| 任何其他未列出的報錯 | 技術性錯誤資訊 | → 所有指令碼均有 _safe_main() 兜底包裝:會顯示「問題型別 + 詳情 + 三步建議」;如仍看不懂,將完整報錯發給我們分析 |
本章節是唯一權威的「不要這麼做」彙總。 如果你遇到問題或不確定某個功能該怎麼用,先查這裡。 每條包含:❌ 錯誤做法 → ⚠️ 後果 → ✅ 正確做法。按功能模組分組,可直接搜尋關鍵詞。
🗂️ 章節索引(按場景直達):
章節 解決什麼 看這一篇的場景 一、模式一(聯網檢索)避坑 別亂引、別改數字、別憑記憶答條文 經常聯網查條文 / 罰則 二、模式二(PDF抽取)避坑 別把 PDF 抽取當金標準、別存進倉庫 手裡有官方 PDF 要查 三、模式三 / golden(知識迴流)避坑 別覆蓋 ✅、別亂寫、別自動改 想把核對過的條文沉澱 四、模式六(HF-SFT 社群問答)避坑 別把社群問答當金標準 引用 seed 資料時 五、模式七(糾錯反饋)避坑 收到反饋別自動改 golden 提交/處理糾錯時 六、通用反模式(跨模式) 別改單位、別漏免責宣告 任何場景 七、反面教材(3 個真實場景對比) 看一遍就懂為什麼不能那樣 想用最快速度瞭解反模式 八、注意事項 Checklist 釋出前/排查時逐項勾 準備釋出 / 資料健康度核查 九、問題速查索引 按症狀定位章節 不知道問題出在哪 💡 沒空細看:直接讀 七、反面教材,3 個真實場景看完就懂 80% 的坑。
| ❌ 錯誤做法 | ⚠️ 後果 | ✅ 正確做法 |
|---|---|---|
| 使用者問"GB 55037 疏散寬度",agent 憑記憶直接回答條文數字 | 編造條款數字(法律條文錯一字含義全變),且無法溯源 | 必須先查 catalog.md 定位 → 聯網 openstd 官方源抓取原文 → 逐字輸出 |
| 聯網搜到非官方來源(知乎/百度文庫/論壇)就引用 | 引用可能是過時/篡改/錯誤的版本 | 只用白名單域名(npc.gov.cn/openstd.samr.gov.cn/gov.cn 等)+ catalog 登記的官方 URL |
| 該標準屬"採標/僅下載PDF"例外,仍強行線上抓取 | 抓不到或抓到盜版文本,版權風險 | 先查 online_readability.md;若在列 → 走模式二(使用者本地 PDF)或告知無法獲取 |
| 抓到條文後改寫/概括/推算關鍵數字(如把 4.0m 寫成"約4米") | 精準性鐵律違規,使用者基於錯誤數字做合規決策可能違法 | 逐字摘錄原文,數字/單位/標點一個不改 |
| 輸出時缺少「文件標識+條款編號+版本號」任一項 | 使用者無法定位出處驗證真偽,失去檢索意義 | 嚴格套用輸出模板,缺一則標「待核實」 |
| ❌ 錯誤做法 | ⚠️ 後果 | ✅ 正確做法 |
|---|---|---|
| 把從 PDF 抽取的條文直接當 ✅ 金標準輸出 | PDF 可能有 OCR 錯誤/版本過時/非最終版,誤導使用者 | 離線結果一律標 ⚠️ 待核對;聯網後必須回官方源複核 |
| 把標準 PDF 或離線索引檔案提交進 skill 倉庫 / 上傳 SkillHub | 版權侵權風險(標準 PDF 受版權保護)+ 倉庫體積暴增 | 離線索引預設存 ~/.firecode_offline/(使用者主目錄,倉庫之外);絕不隨 skill 分發 |
| 使用者給了一個來路不明的 PDF(如網盤下載版),不做任何校驗就抽取引用 | 可能用了偽造/篡改/舊版的假條文 | 提示使用者確認 PDF 來源是否為官方渠道(openstd/mohurd/正式出版物掃描件) |
| 文字層損壞出現亂碼時,憑上下文猜測補全缺失文字 | 猜錯一個字 = 給出錯誤法律依據,後果嚴重 | 標紅提示人工核對;已確認的錯字用 term_memory.py add 沉澱後再靜默修正 |
| ❌ 錯誤做法 | ⚠️ 後果 | ✅ 正確做法 |
|---|---|---|
| 來源不是白名單域,仍寫入 golden | 可能寫入錯誤/惡意內容汙染金標準庫 | 寫回閘門:必須是白名單域 + 能定位 規範編號+條款號+版本,否則丟棄 |
| 覆蓋已有的 ✅ 金標準條目 | 把人工確認過的正確內容替換成未核對的版本 | 永不覆蓋 ✅ 條目;新版本追加為 ⏳ 候選,由使用者決定 |
| 看到 ⚠️ 新條款就直接當準確信息用於正式場合 | 新條款未經核實,可能有誤 | ⚠️ 僅首次標註;使用者 confirm 後才晉升 ✅;晉升前始終標註待核對 |
| 自動模式下不告知使用者就批次寫回 golden | 使用者不知道本地庫被修改了,失去信任 | 即使 auto 模式也要顯式告知使用者寫了什麼、幾條、狀態如何 |
| ❌ 錯誤做法 | ⚠️ 後果 | ✅ 正確做法 |
|---|---|---|
| 直接把 seed_hf_sft.md 的回答當 ✅ 輸出給使用者 | 資料集本身可能有錯誤(雖經兩輪校驗但非官方),且覆蓋僅 5 部 GB | seed 僅作交叉參考/啟發;輸出前必須走模式一在 openstd 官方源核實 |
| 引用 seed 中的數值而不標註來源 | 使用者以為是官方條文,實際是社群編譯 | 每次引用都標註「出自社群資料集 sdzjoy/fire-safety-sft-dataset (Apache-2.0),以官方源為準」 |
| 認為 seed 能覆蓋所有消防法規 | 實際只覆蓋 GB 50016/50067/51251/55036/55037 五部 | XF 行標、地方法規、部門規章均不在 seed 中;這些必須走模式一聯網 |
| ❌ 錯誤做法 | ⚠️ 後果 | ✅ 正確做法 |
|---|---|---|
| 收到使用者糾錯後,不經核實自動改寫 golden 內容 | 惡意/錯誤的糾錯會汙染金標準庫 | 糾錯只入複核佇列(feedback.log);必須經模式一聯網核實後才修正 |
| 使用者打低分(1-2分)但不說明原因,直接刪除該條目 | 可能是使用者的誤解而非條目錯誤 | 低分條目優先複核:檢查表述/出處/時效性,最佳化後再反饋 |
| ❌ 錯誤做法 | ⚠️ 後果 | ✅ 正確做法 |
|---|---|---|
| 對關鍵數字做四捨五入或單位換算(如 1.2m → "約1米") | 合規場景下失之毫釐差之千里,可能導致不合規設計 | 絕對不改寫數字和單位;原文是什麼就輸出什麼 |
| 使用者問"這個建築合規嗎?",給出"基本合規"之類判斷 | 越權——本 skill 不出具法律意見/合規結論 | 明確拒絕,引導諮詢有資質的第三方檢測機構;同時可提供相關條文供參考 |
| 多源衝突時靜默選擇其中一方 | 選錯了就是誤導,選對了也無法證明 | 並列展示多源差異,標 ⚠️,交使用者/人工裁決 |
| 發現某標準被廢止,不更新 catalog 和 golden | 繼續引用廢止標準 = 給出無效法律依據 | 立即觸發模式三-b 廢止清理流程:abolish → 歸檔 → 更新速查表狀態 |
| 輸出時不帶免責宣告 | 使用者可能將 AI 回答當作具有法律效力的正式意見 | 每次輸出尾部固定附帶:「以上內容僅供參考…以正式出版物及主管部門解釋為準」 |
把上面那些"❌ 錯誤做法"翻譯成具體可對照的真實場景——看一眼就懂為什麼不能那樣做。
| ❌ 錯誤響應(憑記憶) | ✅ 正確響應(先定位再檢索) |
|---|---|
| "根據 GB 50016,廠房疏散走道淨寬度不應小於 1.4m,應該夠了吧。" | 1. 詢問廠房火災危險類別、層數、面積等關鍵資訊 2. 查 catalog.md 定位 GB 55037 第 3.2 節(GB 55037 是全文強制規範,GB 50016 已不再承載強條)3. 聯網 openstd 抓原文 → 逐字摘錄 4. 輸出模板 + 「以上為條文檢索結果,不構成合規結論」 |
為什麼不能憑記憶:法律條文可能因修訂版不同而數字不同,錯 1mm 可能導致專案驗收失敗。
| ❌ 錯誤響應(搜到非官方源) | ✅ 正確響應(白名單源) |
|---|---|
| "根據某律師網站的整理,罰款在 5000-50000 元之間。" | 1. 查 catalog.md 定位 → 消防法 → 第六十條2. 聯網 npc.gov.cn 全國人大網抓原文 3. 逐字摘錄單位罰款 5000-50000 元、個人警告或 500 元以下 4. 附 https://npc.gov.cn/... 原文連結 + ✅ 核對狀態 |
為什麼不能引用非官方源:律師網/百度文庫可能轉載舊版或摘錄失真;只有人大網原文具有法律效力。
| ❌ 錯誤響應(直接抽取當 ✅ 用) | ✅ 正確響應(抽取 + 複核 + 標 ⚠️) |
|---|---|
| 抽取後直接輸出條文,無任何來源標註。 | 1. 確認 PDF 來源(官方/掃描件/網盤?) 2. extract_pdf.py --pdf <檔案> --query "5.3"3. 輸出時明確標 ⚠️ 待核對(PDF 抽取可能 OCR 錯字) 4. 建議使用者聯網後回 openstd.samr.gov.cn 複核 |
為什麼必須標 ⚠️:PDF 文字層損壞時"大於"會變"大千",一字之差法律含義就反了;離線結果永遠不能當 ✅ 用。
| ❌ 錯誤響應(改寫關鍵數字) | ✅ 正確響應(逐字摘錄) |
|---|---|
| "消防車道淨寬不應小於約 4 米。" | "消防車道淨寬不應小於 4.0m。"(原文逐字,0 都不省) |
為什麼不能"差不多":合規審查時監理會拿原規範對數字,4m 和 4.0m 在文字表述上等價,但在 PDF 摘錄、OCR 校對、跨規範交叉引用時少一個 0 就是完全不同的數字。"約 4 米"讓使用者無法驗證,等於把風險悄悄推回使用者身上。
一句話口訣:原文是什麼就輸出什麼——0 不省、單位不改、標點不動。
| ❌ 錯誤響應(越權判斷) | ✅ 正確響應(拒絕 + 引導) |
|---|---|
| "基本合規,但建議您再確認下疏散門寬度是否滿足要求。" | 1. 明確告知:本 skill 不能出具合規結論 2. 列出使用者能問到、可以回答的部分(如適用條款、罰款區間、技術要求) 3. 引導使用者諮詢有資質的第三方檢測機構或消防工程師 |
為什麼不能答"基本合規":四個字包含 3 類風險——① 把"安全"和"合規"混為一談;② 沒有現場勘查卻給結論;③ 使用者拿著 AI 回答去走驗收程式,出了事 AI 不能背鍋。說"不能"比硬答"是"更負責任。
| ❌ 錯誤響應(漏免責宣告) | ✅ 正確響應(帶 ✅ 核對的完整輸出) |
|---|---|
| "4.0m。來源 GB 50016。" | 1. 抓取條文原文 → 標註來源 URL(https://openstd.samr.gov.cn/...)2. 列出【核對狀態】✅ 已核對 或 ⚠️ 待核對 3. 末尾附固定免責:"以上內容僅供參考,不具有法律效力,以正式出版物及主管部門解釋為準。" |
為什麼必須帶免責宣告:法律條文本身是公開資訊,但 AI 的"摘錄 + 應用到具體場景"是二次創作,存在解讀偏差風險。免責宣告是把這層風險顯式交還給使用者——不是"不負責",而是"我盡力了,但最終拍板權在你"。
一句話口訣:每次輸出都帶來源 + 核對狀態 + 免責宣告三件套。
釋出前 / 使用前 / 排查問題時,逐項勾選:
__pycache__/ 目錄?→ 有則刪除(SkillHub 不接受二進位制).gitignore?→ 有則刪除(SkillHub 不接受此檔案型別)~/.firecode_offline/ 的內容有沒有被意外提交?→ 檢查 git statusrefresh_golden.py 是什麼時候?→ 建議每週一次feedback.py list --pending 檢視golden.py lookup 抽查| 你遇到的問題 / 疑問 | → 請看哪個章節 |
|---|---|
| "我想知道 XX 怎麼規定的" | → 快速上手 → 模式一(聯網檢索) |
| "我已有 PDF,想查裡面的條文" | → 模式二(PDF 抽取) |
| "這條對不對?能不能直接用?" | → 金標準信任模型(看 ✅/⏳/⚠️ 含義) |
| "這條答錯了 / 我想打分" | → 模式七(糾錯迴流) |
| "兩個地方說的不一樣" | → 多源核對(reconcile.py) |
| "這個標準還有效嗎?" | → 模式三-b(廢止清理)+ 規範速查表.md |
| "XX 行為罰多少?" | → penalty_cases.md(罰則查詢) |
| "指令碼報錯了 / 看不懂提示" | → 常見問題解答(FAQ) |
| "這個功能我不能用 / 不該用嗎?" | → 本章 避坑指南(對應功能的 ❌ 反模式行) |
| "我要上傳到 SkillHub" | → 本章 注意事項總彙 · 版權與分發紀律 |
| "我想貢獻/改進這個 skill" | → 模式七(feedback.py)+ 模式三(知識迴流) |
本 skill 是檢索與排版工具,不提供合規判斷、不出具法律意見。最終以正式出版物及主管部門解釋為準。
這個 Skill 質量很高,條文檢索專業可靠。它的最大優點是覆蓋很全,法律、國標、行標、地方規定都能查,來源都是政府官網不用擔心引用錯誤,而且文件寫得非常詳細,新手也能快速上手。但目前大部分條文還是「待核對」狀態,準確度主要靠後續維護更新;功能雖然強大但有點複雜,日常使用記住「直接提問」這一招就夠了。總體來說是個認真做、值得信賴的專業工具。