前言¶
在 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。
