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