前言¶
在 DeepSeek Harness（DSH）裏做客戶端或遊戲相關自動化時，常見需求是查詢本機已安裝的遊戲版本、模組與賬號，並在用戶明確授權後再執行安裝或啓動。若把啓動器能力直接寫進會話腳本，既要處理本地路徑與權限，又要和 Harness 的工具權限模型對齊，維護成本偏高。pmcl-dsh 是面向 PMCL 啓動器的 DSH 客戶端類插件：通過調用本機 PMCL CLI（com.pmcl.cli.PmclCli），以參數數組方式執行命令，默認只開放只讀查詢；安裝、改設置與啓動需在 profile 中單獨打開權限。
這是什麼¶
pmcl-dsh（GitHub：PCML-Z/pmcl-dsh，維護者 PCML-Z）是 PMCL 啓動器的 DeepSeek Harness 插件，簡介爲「DeepSeek Harness plugin for the PMCL launcher」。插件不包含 Minecraft 本體，也不包含 PMCL 啓動器源碼；啓動器在 PCML-Z/PCML。當前 package 版本爲 0.1.0，許可證 MIT，運行環境要求 Node.js >= 20。
核心功能¶
插件向 DSH 註冊 Cordis 行 id pmcl，並提供四類工具（會話開始時會註冊技能 pmcl-launcher，內含給模型的操作順序說明）：
| 工具 | 作用 |
|---|---|
pmcl_doctor |
檢查 jar、數據目錄以及 allowLaunch、allowMutations 兩個權限開關 |
pmcl_query |
只讀：版本、模組、存檔、賬號、Java、日誌、配置、模組搜索 |
pmcl_action |
寫入類操作；allowMutations 爲 false 時直接拒絕 |
pmcl_launch |
啓動已安裝版本；進程起來後即返回，不等待遊戲退出 |
allowMutations 與 allowLaunch 默認均爲 false。下列能力仍須在 PMCL 圖形界面中完成，插件不代勞：微軟設備碼登錄、從 URL 安裝插件、JVM 參數與 Java 可執行文件路徑、自定義下載鏡像與代理主機。
模組市場「搜索再安裝」須在單次 CLI 進程內完成，因此 install-mod 參數爲：搜索詞、結果序號（從 1 開始）、可選遊戲版本、可選加載器，例如 ["sodium", "1", "1.21.1", "fabric"]。
安裝與啓用¶
準備 PMCL CLI 胖 jar¶
插件默認在 ~/.pmcl/pmcl-cli.jar 查找 CLI。胖 jar 由啓動器倉庫 PCML-Z/PCML 構建，Gradle 產出路徑爲 cli/build/libs/cli.jar。在 PCML 倉庫根目錄執行：
./gradlew :cli:jar
mkdir -p ~/.pmcl
cp cli/build/libs/cli.jar ~/.pmcl/pmcl-cli.jar
安裝 DSH 插件¶
將插件加入 DeepSeek Harness 的 profile（web）：
dsh plugin --profile web add github:PCML-Z/pmcl-dsh
安裝後重啓 dsh。
數據目錄與 jar 路徑¶
默認數據目錄爲 ~/.pmcl，與桌面版 PMCL 一致。可設置插件配置項 workDir，或在啓動 Harness 前設置環境變量 PMCL_WORKDIR。jar 不在默認位置時，設置插件的 jar 或環境變量 PMCL_CLI_JAR。
權限配置¶
在所用 profile 的 cordis.patch.yml 中覆蓋 pmcl 行以允許啓動：
- id: pmcl
config:
allowLaunch: true
若還需允許安裝版本、離線登錄、修改安全設置、管理模組，增加 allowMutations: true。覆蓋會整行替換 config，缺省字段仍由插件 schema 補全。
典型用法¶
- 會話開始後，先調用
pmcl_doctor確認 jar、目錄與權限是否符合預期。 - 使用
pmcl_query查看版本、模組、存檔、賬號等只讀信息。 - 在 profile 已開啓
allowMutations時，通過pmcl_action執行寫入類操作；開啓allowLaunch後，用pmcl_launch啓動指定已安裝版本。
開發與自測可在插件倉庫執行：
npm test
適用場景與注意¶
適合已在本地使用 PMCL、並希望在 DSH 會話中做可控查詢或（經顯式授權後）安裝、啓動操作的開發者。插件以當前 dsh 進程的用戶權限調用本機 CLI，安裝插件前應閱讀 GitHub 源碼 與 MIT 許可證，自行評估是否滿足環境與安全要求。DSH 生態採用「一切皆插件」思路；社區目錄 skillhub.cn 爲獨立站點，與 DeepSeek、幻方無官方從屬關係，本文不以「官方應用商店」表述。
結尾¶
pmcl-dsh 把 PMCL 啓動器的 CLI 能力封裝爲 DSH 工具與 pmcl-launcher 技能，默認偏只讀，突變與啓動由 profile 顯式開關。進一步瞭解可參閱目錄頁 https://www.skillhub.cn/plugins/PCML-Z/pmcl-dsh 與倉庫 https://github.com/PCML-Z/pmcl-dsh。
