前言¶
在 DeepSeek Harness（DSH）裏做質量或貫標相關智能體時，常見做法是讓用戶自由描述審覈現象，再由模型憑記憶去猜條款號和不符合等級。這樣容易出現編號混用（例如仍用 2008 版條款）、引文無法對照正式標準，以及整改建議缺少「糾正 / 糾正措施 / 驗證」的結構。下面介紹社區插件 iso_analyze_finding_GB19001-2016（維護者 hxd3tomato），它把「現象 → 條款 → 等級 → 陳述 → 整改 → 報告」拆成 6 個可調用的工具，並隨包攜帶離線知識庫，供模型在對話中按步驟調用。
這是什麼¶
iso_analyze_finding_GB19001-2016 是面向 GB/T 19001-2016（ISO 9001:2015）貫標 的 DSH bundle 插件。它在 SkillHub 社區目錄中歸類爲 admin-security；當前 GitHub 星標爲 0，許可證爲 MIT，包版本 0.1.0，要求 Node >=22、DSH >=0.2.0 且 <0.3.0。
插件解決的核心問題是：把內審/外審現場描述的結構化分析交給可重複調用的工具鏈，而不是完全依賴模型即興發揮。知識庫隨包分發：57 個條款塊、34 個不符合案例、238 條檢查項；npm 側 0 個依賴，Python 側僅標準庫，可離線運行。
核心功能：六個工具¶
README 將整條鏈路做成下表中的 6 個工具（參數名以倉庫文檔爲準）：
| 工具 | 作用 | 關鍵參數 |
|---|---|---|
| iso_analyze_finding | 現象定性：主條款、嚴重程度、四段式陳述、待補證據、追問鏈、整改三件套 | text（必填）、doc_ref、top_k、record |
| iso_match_clause | 僅條款匹配：Top N、命中詞、候選排除理由 | text、top_k |
| iso_suggest_capa | 整改三件套（糾正 / 糾正措施 / 驗證）及責任、時限、橫向排查 | clause（必填）、severity、text、doc_ref |
| iso_clause_lookup | 條款原文、意圖、應查證據、易混條款、案例、檢查項 | clause（必填） |
| iso_audit_findings | 本會話不符合清單（list 或 clear） | action |
| iso_audit_report | 生成內審報告（Markdown 彙總、逐條詳情、等級統計） | audit_id、purpose、scope、date、team |
設計上的約束（資料原文）：每條結論帶條款號、逐字引文與置信度，引文須能在標準原文中找到；輸出校驗包括條款必須存在、禁止 2008 版編號、禁止空泛詞等。引擎失敗（非 0 退出或超時）時工具報錯並附 stderr 尾部，不靜默返回空結論。
運行機制簡述：模型調用工具 → lib/tools.js 組裝參數並維護按會話隔離的不符合清單 → lib/engine.js 通過 spawn(python engine/bridge.py <cmd>) 以 JSON 與 Python 引擎通信 → engine/iso_kb 加載 knowledge/data 完成匹配、定級與分析。
安裝與啓用¶
安裝後需重啓 DeepSeek Harness 桌面應用：profile 配置只在啓動時組合。
從 GitHub 安裝（推薦）¶
dsh plugin --profile desktop add github:hxd3tomato/iso_analyze_finding_GB19001-2016
私有倉庫首次安裝需要該 profile 具備 GitHub 訪問權限（環境變量 GITHUB_TOKEN 或 git 憑據）。若需鎖定到某次提交：
dsh plugin --profile desktop add github:hxd3tomato/iso_analyze_finding_GB19001-2016#<commit-sha>
其他方式¶
本地目錄：
dsh plugin --profile desktop add ./iso_analyze_finding_GB19001-2016
tarball（無需 git、無需構建授權）：
pnpm pack
dsh plugin --profile desktop add ./iso_analyze_finding_GB19001-2016-0.1.0.tgz
無 dsh CLI 時可用 PowerShell 腳本 scripts/install.ps1 手工安裝。卸載可用 scripts/uninstall.ps1 或：
dsh plugin --profile desktop remove iso_analyze_finding_GB19001-2016
配置（可選）¶
在 profile 的 cordis.patch.yml 中按 id 覆蓋（patch 會替換整行 config，需重述所有鍵）：
- id: tool-iso-audit
name: 'iso_analyze_finding_GB19001-2016'
config:
python: '' # 解釋器路徑；留空則自動探測
bridge: '' # 默認包內 engine/bridge.py
dataDir: '' # 默認包內 knowledge/data
timeoutMs: 60000
recordByDefault: true
解釋器探測順序：config.python → 環境變量 ISO_KB_PYTHON → DSH 自帶 Python（~/.dsh/dsh-runtimes/...）→ PATH 中的 python / python3 / py。
自檢¶
在會話中說：用 iso_clause_lookup 查 7.5.3；或查看加載探針：Get-Content $env:TEMPiso-audit-plugin.log。可用環境變量 ISO_AUDIT_MARKER 修改探針路徑。
典型用法¶
README 給出的對話觸發示例：
用戶：查機加工車間 2 號線，4 個工位還在用 B/2 版作業指導書，受控清單是 C/0 版
模型：iso_analyze_finding(...) -> 7.5.3 成文信息的控制；MAJOR（76）；排除 7.5.2 的理由；待補：發放記錄、回收記錄
用戶：整改怎麼做？
模型：iso_suggest_capa(clause="7.5.3", severity="MAJOR")
用戶：把今天這幾條出個報告
模型：iso_audit_report(audit_id="IA-2026-02")
生成報告前需先通過 iso_analyze_finding 且 record=true（或依賴 recordByDefault: true）寫入會話清單，否則報告可能爲空。
適用場景與注意¶
適合誰：在 DSH 桌面 profile 中做 GB/T 19001-2016 內審輔助、條款查閱、不符合定性與會話內報告彙總的開發者或審覈支持場景。
權限與安全：插件以當前 DSH 進程權限運行；安裝前應自行審閱 GitHub 源碼 與 MIT 許可證。社區目錄 SkillHub 插件頁 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
免責與數據：條款原文來自 GB/T 19001-2016 掃描件 OCR 後人工校正（confidence 0.85~0.95）；對外出具報告應以正式出版文本爲準。應用指南意圖摘自 GB/T 19002-2018；案例庫爲共性案例，落地需結合行業與規模改寫。插件不替代審覈員判斷，條款與等級須經審覈組長複覈後簽發。
故障排查要點：重啓後看不到 6 個工具時，檢查 profile 的 package.json 與 dsh.profile.bundles；無 Python 時在 config.python 寫明路徑；中文亂碼時確認引擎設置了 PYTHONUTF8；結論停在父條款時補充具體證據詞；清單爲空則先記錄不符合項。
結尾¶
iso_analyze_finding_GB19001-2016 把貫標審覈中重複、可規則化的步驟收斂爲 6 個 DSH 工具，並以內置知識庫支撐離線條款匹配與 CAPA 建議。進一步瞭解可訪問社區目錄頁 https://www.skillhub.cn/plugins/hxd3tomato/iso_analyze_finding_GB19001-2016 與倉庫 https://github.com/hxd3tomato/iso_analyze_finding_GB19001-2016。
