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