前言¶
在 DeepSeek Harness（DSH）里做矿山或骨料相关的智能体，常见问题是：模型能聊工艺概念，却缺少机型参数、腔型与排矿口（CSS）的硬约束，以及产量、粒度曲线、循环负荷等可复核的工程计算。把通用 LLM 当「选型工程师」用，往往要人工补表格、查样本册、再手算一遍，很难稳定产出可交付的方案书。
下面介绍社区工作流类插件 leifdai/mackorn-hydraulic-cone-crusher（GitHub：LeifDai/MACKORN-hydraulic-cone-crusher，维护者 LeifDai）。它面向 MACKORN 美矿 NH/NS 单缸液压圆锥破碎机 及围绕其配置的金属矿山、硬岩骨料破碎筛分线，把选型推理、文献级流程仿真和方案生成封装成可被 DSH 或任意 MCP 客户端调用的工具集。目录页见 SkillHub。
这是什么¶
一句话定位：矿山行业垂直领域插件 + MCP 服务器 + Node ES Module 库，零运行时 npm 依赖（dependencies: 0），MIT 许可证，当前版本 V000022（semver 0.2.2）。
插件覆盖 MACKORN NH/NS 液压圆锥破选型与 crushing & screening plant（破碎筛分生产线）设计；README 将其与 Sandvik CH/CS、Metso HP/MP 等产品线作对标说明，便于在同类单缸/多缸液压圆锥破语境下讨论腔型与配置。适用对象包括金属矿山（铁、铜、铅锌、钼等）以及花岗岩、玄武岩、安山岩、辉绿岩等中硬以上硬岩骨料产线。
同一套工具定义可通过三种方式使用：DeepSeek Harness 插件（Cordis）、MCP stdio（及 README 所述远程 HTTP 双通道）、以及直接 import Node ESM。README 标注 19 个 tools、6 个 skills；package.json 的 description 对工具能力的文字说明更细，若与徽章数字不一致，以仓库当前 README 与 CHANGELOG 为准。
核心能力¶
经过上面的定位，可以把插件承担的工作概括为以下几块（均来自 README / package.json 描述，非完整工具清单）：
- 客户需求与录入：围绕「客户需求表」类输入整理给料粒度、矿石性质、目标产能等约束，并提示仍须向客户确认的信息。
- 机型 / 腔型 / CSS 选型：在 MACKORN NH/NS 产品 knowledge（如
knowledge/equipment-nh-ns.json）与工程规则下，给出液压圆锥破型号、破碎腔、闭边排矿口等建议。 - 整线配置：破碎段数、筛分与循环负荷、破碎比等破碎筛分流程层面的配置推理。
- 粒度与产能仿真：公开文献流程仿真引擎——Whiten 1972 稳态圆锥破模型、Bond 1952 功率估算、population balance 闭路循环；支持 P80、粒度分布、循环负荷等指标讨论。
- 实测标定：用现场筛分实测数据校准模型参数，使仿真更贴近用户现场设备。
- 衬板与成本：衬板磨损与耐磨件（mantle、bowl liner 等）相关设计辅助，以及能耗成本估算等工程算术。
- 方案书输出：README / description 提到多章节方案书生成（如经销商评估、报价语境下的 deliverable proposal）；仓库提供 demo 脚本演示从表单到方案的链路。
插件 README 声明支持 12 种语言触发关键词（含 zh-CN、en 等），便于多语言场景下的意图识别；仓库 metadata 还列出更多 locale，以 README 与 llms.txt 为准。
Skills 侧：项目符合 Agent Skills 规范，除 DSH 外也可装入多种 AI 编码助手环境，与 MCP 调用并行存在。
安装与启用¶
通过 Agent Skills 一行安装¶
README 给出的官方安装方式为（适用于 Agent Skills 生态，装完可用自然语言问选型问题）：
npx skills add LeifDai/MACKORN-hydraulic-cone-crusher
运行环境¶
- Node.js：
>= 18（见package.json的engines）。 - 依赖：无需额外 npm 包装依赖；克隆或解压仓库后可直接运行脚本与 MCP 入口。
MCP 与本地自检¶
仓库 bin 提供 mackorn-cone-crusher / mackorn-mcp，入口为 plugin/mcp-server.mjs。常用 npm scripts 如下：
npm run mcp:list
npm run mcp
npm run mcp:selftest
npm run selftest
在 DSH 中启用时，按你当前的 Harness / Cordis 插件加载方式指向仓库中的插件入口（main: plugin/index.mjs）；具体配置字段以仓库内 cordis.patch.yml、server.json 及 DSH 文档为准，本文不臆造 dsh plugin add 类命令。
典型用法¶
1、用 demo 走通「表单 → 产能目标 → 方案」¶
仓库自带骨料场景样例表单与 demo，可在项目根目录执行（第二个参数示例为目标产能 600，与 package.json scripts 一致）：
node tools/demo_intake.mjs knowledge/_forms/form-aggregate-FILLED-sample.txt 600
node tools/demo_proposal.mjs knowledge/_forms/form-aggregate-FILLED-sample.txt 600
或使用 npm script：
npm run demo:intake
npm run demo:proposal
第一步演示客户需求 intake；第二步演示方案 proposal 生成。适合在接入 MCP 或 DSH 之前，先确认本地引擎与 knowledge 文件可读。
2、在 MCP 客户端里用自然语言提问¶
README 的 TL;DR 说明：当用户问题涉及圆锥破型号、腔型、CSS、产线段配置、台时产量、衬板寿命、粒度分布、循环负荷，或「还需要向客户问什么」时，应调用本项目工具。接入 MCP stdio 后，用上述关键词或中文术语（如「液压圆锥破碎机」「排矿口 CSS」「破碎筛分生产线」「选型」）发起对话即可，由服务端暴露的 tools 完成计算与结构化输出。
3、仅作 Node 库调用¶
package.json 的 exports 包含 ./tools → plugin/lib/engine.mjs，可在自有 Node ESM 服务中直接引用引擎模块，与 MCP / DSH 插件共享同一套实现。
适用场景与注意¶
适合谁
- 做矿山、骨料、选矿装备选型的 DSH 智能体或 MCP 工作流开发者。
- 需要在对话中落地 MACKORN NH/NS 液压圆锥破选型，并输出带仿真依据的破碎筛分线建议或方案书草稿的技术售前、工艺工程师（由 AI 辅助，人工终审）。
使用注意
- 领域边界：插件 knowledge 与规则围绕 MACKORN 产品与公开文献模型，不能替代厂家最终报价、法务审阅与现场调试；对标 Sandvik / Metso 仅为产品类别参照，不代表实测性能等价。
- 权限与安全：DSH 插件以当前 dsh 进程权限 运行；安装或
npx skills add拉取代码前，应自行审阅 GitHub 仓库 源码与 MIT 许可证，确认无违背你组织合规要求的脚本（仓库含tools/install.ps1、verify.ps1等 Windows 辅助脚本，按需使用）。 - 社区目录： SkillHub 目录页 为社区收录站点，与 DeepSeek / 幻方无官方从属关系；星标、分类「工作流」等元数据以页面与 GitHub 当时显示为准（GitHub 2 stars）。
- 版本与数字：README 顶部摘要曾写「29 tools」，徽章为 19 tools；若你依赖精确工具数量做集成测试，请以
npm run mcp:list与当前 tag 0.2.2 输出为准。
结尾¶
leifdai/mackorn-hydraulic-cone-crusher 把破碎筛分选型工程师常用的约束检查、Whiten/Bond 级仿真与方案书链路收进 DSH 插件与 MCP 服务，零 npm 运行时依赖，便于在智能体工作流里复用。若要进一步核对工具列表、变更记录与 Docker / 远程 MCP 部署细节，请直接查阅仓库 README 与 SkillHub 插件页。
