mcpywrap 0.3.3__tar.gz → 0.3.5__tar.gz

{mcpywrap-0.3.3 → mcpywrap-0.3.5}/CHANGELOG.md

@@ -1,5 +1,20 @@
 # 更新记录
 
+## 0.3.5
+
+- 网络连接接入统一游戏会话：`connect/run --detach --json` 返回进程身份与日志，可复用 status/logs/stop、Skill 截图与按键脚本；网络 JSON 启动现在要求 `--detach`。
+- 新增 `doctor --mcs-auth` 只读组件检查；Skill 安装脚本分别报告 CLI 能力与组件是否具备，按任务显式要求可选能力。
+- 冒烟脚本支持 `--mcs-auth` 与 `--connect`，共用日志标记验证和本次会话清理；精简 Skill 入口并补充编辑器、地图合并及网络指引。
+- 修复 Windows PowerShell 5.1 中文脚本读取与 GBK 管道兼容；JSON 无损保留 Unicode，会话 SDK／引擎日志统一解码为 UTF-8 后脱敏。
+
+## 0.3.4
+
+- 新增显式 `--mcs-auth`：网络连接、单人测试和单人项目 GUI 可按次使用已登录的 MC Studio 身份；默认仍不读取身份，配置文件不能自动启用。
+- 发布包包含自签名桥接、公钥证书和校验清单，无需用户编译；先正常尝试启用，仅在适用的证书信任错误下，经人工确认安装当前用户证书并重试一次。
+- MCS 未运行、取消授权、系统阻止和重试失败均给出用户可理解的提示；Skill 的非交互／JSON 模式全程不弹窗、不安装证书，返回错误代码和处理提示。
+- 单人会话通过管道传递身份，临时配置退出即清理；SDK 和引擎日志在落盘前脱敏，长期世界配置不保存凭据。
+- 已完成真实 MCS 身份读取、网络服手动进服和单人 Mod 双端加载验证。token 自动刷新与运行期认证 RPC 尚未接入；自签名信任不能覆盖 Smart App Control 或组织策略。
+
 ## 0.3.3
 
 - 新增实验性 `mcpy connect HOST --port PORT`，无需项目配置或登录身份即可尝试连接服务器。

{mcpywrap-0.3.3 → mcpywrap-0.3.5}/MANIFEST.in

@@ -1,8 +1,13 @@
 include LICENSE README.md CHANGELOG.md
 include docs/releasing.md
 include docs/local-dependencies.md docs/engine-discovery.md docs/development.md
+include docs/mcs-auth.md
 recursive-include tests *.py
 recursive-include skills *.md *.yaml *.ps1 *.py
+include scripts/build_mcs_auth_bridge.py
+include scripts/check_mcs_auth_bridge.py
+recursive-include native/mcs_auth *.cs *.c *.cer *.json
+recursive-include mcpywrap/mcstudio/bridge_payload *.exe *.dll *.cer *.json
 prune test
 prune .git
 global-exclude __pycache__ *.py[cod] *.cppconfig *.log

{mcpywrap-0.3.3/mcpywrap.egg-info → mcpywrap-0.3.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcpywrap
-Version: 0.3.3
+Version: 0.3.5
 Summary: A wrapper for Minecraft China Edition Addons management
 Author-email: boybook <boybook@easecation.net>
 License-Expression: MIT
@@ -140,9 +140,26 @@ host = "192.168.31.101"
 port = 19132
 ```
 
-空目录只需上述配置，无需执行 `mcpy init`；已有 Addon 项目也可添加此表。当前使用未认证连接，不读取登录身份或 token，不保证服务器允许进服；项目依赖仍会校验，但暂不装配本地 Mod。
+空目录只需上述配置，无需执行 `mcpy init`；已有 Addon 项目也可添加此表。默认使用未认证连接，不读取登录身份或 token，不保证服务器允许进服；项目依赖仍会校验，但暂不装配本地 Mod。
 
-网络模式前台输出日志并显示日志文件路径，按 Ctrl+C 结束本次游戏。暂不支持 Map 项目、GUI、`--detach`、`--new` 或本地世界实例 ID。
+网络模式默认前台输出日志，Ctrl+C 结束本次游戏。增加 `--detach --json` 可返回会话，与本地游戏共用 `status/logs/stop` 及 Skill 截图、按键脚本：
+
+```powershell
+mcpy --project D:\tests\server --non-interactive connect example.com --detach --json
+mcpy --project D:\tests\server status --session <id> --json
+mcpy --project D:\tests\server stop --session <id> --json
+```
+
+目录须已存在；临时 `connect` 不读取项目配置，只在该目录保存会话。后续操作使用启动返回的 `project` 和 `session`。
+网络模式暂不支持 Map、Qt GUI、`--new` 或本地世界实例 ID；进程启动不等于成功进服。
+
+### 使用 MC Studio 登录身份（可选）
+
+单人测试用 `mcpy run --mcs-auth`，网络服用 `mcpy connect <地址> --mcs-auth`；图形管理页可用 `mcpy ui --mcs-auth`。必须先打开并登录 MC Studio，且每次显式加参数，配置文件不会自动启用登录。
+
+发布包自带签名桥接组件，无需编译。程序先尝试启用；若确认为证书信任问题，人工交互模式会说明影响，并在你同意后安装当前用户证书、重试一次。安装证书不保证 Smart App Control 或组织策略放行。`--non-interactive`／`--json` 全程无弹窗、不安装证书，失败返回原因与处理提示。
+
+身份按次读取，日志脱敏，单人世界的长期配置不保存凭据。当前不支持 token 自动刷新和运行期认证代理。信任范围、移除方法及开发构建见[登录组件说明](docs/mcs-auth.md)。
 
 ## AI Agent 使用
 
@@ -155,8 +172,8 @@ port = 19132
 
 也可以下载仓库 ZIP，将完整的 `skills/mcpywrap` 文件夹复制到对应 Agent 的技能目录。
 无需从源码安装 Python 项目；CLI 和 Skill 分别安装，`pip/uv install` 不会自动注册 Skill。
-Skill 中的 `scripts/bootstrap.ps1` 可使用已有 uv 安装 CLI，并检查是否具备所需命令能力。
-请使用 mcpywrap 0.3.3 或更高版本；需要固定组合时，可从 `v0.3.3` 标签安装对应 Skill。
+Skill 中的 `scripts/bootstrap.ps1` 使用已有 uv 安装或复用 CLI，报告可选能力；`-RequireCapability network-sessions` 或 `mcs-auth` 仅在任务需要时检查。身份参数与桥接组件就绪分别报告，Git／可编辑安装可能缺少组件。
+推荐使用 mcpywrap 0.3.5 或更高版本，可从 `v0.3.5` 标签安装对应 Skill。网络会话需 `connect --help` 包含 `--detach`，实际能力以脚本检测为准。
 
 安装后可直接描述任务：
 

{mcpywrap-0.3.3 → mcpywrap-0.3.5}/README.md

@@ -113,9 +113,26 @@ host = "192.168.31.101"
 port = 19132
 ```
 
-空目录只需上述配置，无需执行 `mcpy init`；已有 Addon 项目也可添加此表。当前使用未认证连接，不读取登录身份或 token，不保证服务器允许进服；项目依赖仍会校验，但暂不装配本地 Mod。
+空目录只需上述配置，无需执行 `mcpy init`；已有 Addon 项目也可添加此表。默认使用未认证连接，不读取登录身份或 token，不保证服务器允许进服；项目依赖仍会校验，但暂不装配本地 Mod。
 
-网络模式前台输出日志并显示日志文件路径，按 Ctrl+C 结束本次游戏。暂不支持 Map 项目、GUI、`--detach`、`--new` 或本地世界实例 ID。
+网络模式默认前台输出日志，Ctrl+C 结束本次游戏。增加 `--detach --json` 可返回会话，与本地游戏共用 `status/logs/stop` 及 Skill 截图、按键脚本：
+
+```powershell
+mcpy --project D:\tests\server --non-interactive connect example.com --detach --json
+mcpy --project D:\tests\server status --session <id> --json
+mcpy --project D:\tests\server stop --session <id> --json
+```
+
+目录须已存在；临时 `connect` 不读取项目配置，只在该目录保存会话。后续操作使用启动返回的 `project` 和 `session`。
+网络模式暂不支持 Map、Qt GUI、`--new` 或本地世界实例 ID；进程启动不等于成功进服。
+
+### 使用 MC Studio 登录身份（可选）
+
+单人测试用 `mcpy run --mcs-auth`，网络服用 `mcpy connect <地址> --mcs-auth`；图形管理页可用 `mcpy ui --mcs-auth`。必须先打开并登录 MC Studio，且每次显式加参数，配置文件不会自动启用登录。
+
+发布包自带签名桥接组件，无需编译。程序先尝试启用；若确认为证书信任问题，人工交互模式会说明影响，并在你同意后安装当前用户证书、重试一次。安装证书不保证 Smart App Control 或组织策略放行。`--non-interactive`／`--json` 全程无弹窗、不安装证书，失败返回原因与处理提示。
+
+身份按次读取，日志脱敏，单人世界的长期配置不保存凭据。当前不支持 token 自动刷新和运行期认证代理。信任范围、移除方法及开发构建见[登录组件说明](docs/mcs-auth.md)。
 
 ## AI Agent 使用
 
@@ -128,8 +145,8 @@ port = 19132
 
 也可以下载仓库 ZIP，将完整的 `skills/mcpywrap` 文件夹复制到对应 Agent 的技能目录。
 无需从源码安装 Python 项目；CLI 和 Skill 分别安装，`pip/uv install` 不会自动注册 Skill。
-Skill 中的 `scripts/bootstrap.ps1` 可使用已有 uv 安装 CLI，并检查是否具备所需命令能力。
-请使用 mcpywrap 0.3.3 或更高版本；需要固定组合时，可从 `v0.3.3` 标签安装对应 Skill。
+Skill 中的 `scripts/bootstrap.ps1` 使用已有 uv 安装或复用 CLI，报告可选能力；`-RequireCapability network-sessions` 或 `mcs-auth` 仅在任务需要时检查。身份参数与桥接组件就绪分别报告，Git／可编辑安装可能缺少组件。
+推荐使用 mcpywrap 0.3.5 或更高版本，可从 `v0.3.5` 标签安装对应 Skill。网络会话需 `connect --help` 包含 `--detach`，实际能力以脚本检测为准。
 
 安装后可直接描述任务：
 

{mcpywrap-0.3.3 → mcpywrap-0.3.5}/docs/development.md

@@ -19,6 +19,7 @@ python skills/mcpywrap/scripts/smoke.py --project D:\mods\test --game --expect-l
 
 脚本结束后停止自己创建的会话；日志和产物留在项目中。
 需要手动截图验证时直接运行 `run --no-gui --detach --json`，保存会话 ID，操作完后显式 stop。
+网络验证使用 `smoke.py --project <已有目录> --connect <地址> --expect-log <约定标记>`，不打包项目。单人与网络测试都可显式加 `--mcs-auth`；脚本停止自己创建的会话。
 历史验收记录仅用于追溯，不能代替当前版本测试。
 
 发布见 [发布流程](releasing.md)。

{mcpywrap-0.3.3 → mcpywrap-0.3.5}/docs/engine-discovery.md

@@ -52,4 +52,4 @@ mcpy --project D:\mods\demo stop --session <id> --json
 
 只打开游戏窗口，日志写入返回的文件。`running` 表示进程存活，加载是否成功应查看项目日志或游戏画面。
 Computer Use 只接手游戏画面；Qt 管理、模板及日志页留给人工操作。
-本功能不包含第三方网络服 IP/端口连接。
+以上示例是本地世界会话。网络连接可用 `mcpy connect <地址> --detach --json`，或配置服务器后执行 `run --detach --json`；同样使用返回的项目路径、会话 ID 读取日志、截图、输入和停止。临时 connect 不读取项目引擎配置，使用 CLI 参数或环境变量覆盖。

mcpywrap-0.3.5/docs/mcs-auth.md

@@ -0,0 +1,45 @@
+# MC Studio 登录身份
+
+登录始终由 MC Studio 完成。`--mcs-auth` 只在本次启动读取已登录身份，不代填密码，不默认启用，也不会在失败时偷偷改用匿名身份。
+
+```powershell
+mcpy run --mcs-auth
+mcpy connect 192.168.31.101 --port 19132 --mcs-auth
+mcpy ui --mcs-auth
+# Agent：后台单人测试，任何失败都返回 JSON，不弹窗或安装证书
+mcpy --project D:\mods\demo --non-interactive run --mcs-auth --detach --json
+```
+
+本地与网络均支持 `--detach --json`，共用会话查询、日志和停止。GUI 登录支持单人项目，网络目标使用 CLI。
+
+`mcpy doctor --mcs-auth --json` 可只读检查组件文件，不读取身份、不写缓存、不修改证书。组件具备不表示已登录或系统策略允许启用。
+
+## 用户会看到什么
+
+- MCS 未运行或未完成登录：提示先打开并登录；普通测试可去掉 `--mcs-auth`。
+- 登录组件可正常启用：直接继续，无需安装证书。
+- 组件被阻止且其完整签名只缺少根信任：人工交互时提供“信任此发布者并重试”，默认选择取消。确认前展示用途、信任范围、发布者、指纹与有效期。
+- 安装后仍失败：停止重试，说明系统或组织策略仍可能阻止组件；不关闭 Windows 安全保护。
+- 纯 CLI／Skill：`--non-interactive` 或 `--json` 不显示对话框、不读取确认输入、不安装证书。JSON 包含 `ok`、`error`、`hint`，身份失败另有 `code`，例如 `studio_unavailable`、`component_blocked`。
+
+## 证书与隐私
+
+组件使用项目自签名证书，不是公共 CA 认证的发布者。证书只在用户明确同意后加入 **当前用户**的“受信任的根证书颁发机构”，不会写入整机证书库。同一证书签署的其他代码也可能因此获得信任；这不是一次性的单文件例外，也不能覆盖 Smart App Control 或企业应用控制。
+
+发布包只包含公共证书和签名文件，不包含私钥。证书指纹与文件 SHA-256 在 `mcpywrap/mcstudio/bridge_payload/manifest.json` 中；加载和证书提示前都会检查组件完整性。
+
+桥接通过当前用户专用的一次性命名管道返回登录信息，不把 token 放入命令行或会话记录。游戏需要的身份仅写入本次运行配置，退出后删除；日志在写入磁盘前脱敏。MCS 必须保持运行；重新登录后应重新启动测试。
+
+停止使用时，去掉 `--mcs-auth` 即可。若曾安装证书，可打开 `certmgr.msc`，在当前用户的“受信任的根证书颁发机构 → 证书”中找到 `mcpywrap Project Code Signing`，核对上述指纹后移除。不要移除其他证书。已加载的托管桥接程序集会随 MC Studio 退出而卸载。
+
+## 开发与发布
+
+源代码位于 `native/mcs_auth`。CI 使用 x86 MSVC 和系统自带的 .NET Framework C# 编译器；本机开发也可使用 x86 TinyCC：
+
+```powershell
+python scripts/build_mcs_auth_bridge.py --cc <x86-tcc.exe> --output <输出目录>
+```
+
+发布时由 CI 从 GitHub Actions secrets 取得加密 PFX 与密码，在临时 runner 中签署组件并清理私钥。仓库不保存私钥或编译后的组件，只保存源码与公钥校验信息。`scripts/check_mcs_auth_bridge.py` 检查源代码、产物、架构及发布者是否匹配；详见[发布流程](releasing.md)。
+
+`MCPY_MCS_BRIDGE_DIR` 可指定开发组件目录；程序不会为任意外部组件提供证书信任安装。发布包的组件会缓存到用户目录的 `.local/share/mcpywrap/mcs-auth-bridge/<版本摘要>`，避免应用目录重定向造成外部终端找不到文件。

{mcpywrap-0.3.3 → mcpywrap-0.3.5}/docs/releasing.md

@@ -2,6 +2,12 @@
 
 主分支和 PR 运行 Windows Python 3.9、3.12、3.14 的自动化测试。通过后构建 wheel/sdist、运行严格元数据检查、检查产物内容，并在独立环境安装 wheel 验证 CLI 和模块导入。
 
+Windows CI 先用 MSVC 从 `native/mcs_auth` 编译 x86 登录桥接，再签名并通过构建产物交给测试和 Python 打包任务；编译后的 EXE/DLL 不提交到 Git。仓库只保留发布者公钥证书和指纹。
+
+仓库 Actions secrets：`MCS_BRIDGE_SIGNING_PFX` 保存 Base64 编码的加密 PFX，`MCS_BRIDGE_SIGNING_PASSWORD` 保存独立的强密码。只有 main／发布标签的签名步骤可读取它们，PR 只构建未签名测试产物。CI 将证书导入临时 runner 的个人证书库，签名后清理，不安装根信任。私钥、PFX 和密码均不进入日志或 artifact。
+
+轮换签名身份时，需要同时更新这两个 secrets 和 `native/mcs_auth/publisher.cer`、`publisher.json`。脚本会拒绝与仓库固定公钥不匹配的签名证书；未签名产物不能进入 PyPI 发布任务。
+
 发布凭据使用 PyPI Trusted Publishing，不在仓库或工作流中保存长期 API token。在 PyPI 项目 `mcpywrap` 的 Publishing 设置添加 GitHub publisher：
 
 | 字段 | 值 |

{mcpywrap-0.3.3 → mcpywrap-0.3.5}/mcpywrap/__init__.py

@@ -1,4 +1,4 @@
 # -*- coding: utf-8 -*-
 """mcpywrap - 将 Python 3 代码转换为 Python 2 代码的工具"""
 
-__version__ = '0.3.3'
+__version__ = '0.3.5'

mcpywrap-0.3.5/mcpywrap/__main__.py

@@ -0,0 +1,18 @@
+# -*- coding: utf-8 -*-
+"""
+mcpywrap 命令行工具的入口点
+"""
+
+from .cli import cli
+
+def main():
+    """主函数，作为 CLI 入口点"""
+    import sys
+    # Keep the caller's text encoding; unsupported symbols must not abort an operation.
+    for stream in (sys.stdout, sys.stderr):
+        if hasattr(stream, 'reconfigure'):
+            stream.reconfigure(errors='backslashreplace')
+    cli()
+
+if __name__ == "__main__":
+    main()

{mcpywrap-0.3.3 → mcpywrap-0.3.5}/mcpywrap/command_context.py

@@ -37,6 +37,11 @@ def json_output():
     return bool(current and current.json_output)
 
 
+def human_interaction():
+    current = _context.get()
+    return current is not None and not non_interactive() and not json_output()
+
+
 @contextlib.contextmanager
 def project_scope(path):
     previous = _context.get()
@@ -89,7 +94,10 @@ class OperationGroup(click.Group):
                     result = {'ok': False, 'error': '操作已中断', 'hint': None}
                 except (ValueError, OSError) as exc:
                     code = 1
-                    result = {'ok': False, 'error': str(exc), 'hint': '请核对项目配置和相关文件路径。'}
+                    result = {'ok': False, 'error': str(exc),
+                              'hint': getattr(exc, 'hint', '请核对项目配置和相关文件路径。')}
+                    if getattr(exc, 'code', None):
+                        result['code'] = exc.code
                 except Exception as exc:
                     code = 1
                     with tempfile.NamedTemporaryFile(mode='w', encoding='utf-8', prefix='mcpy-error-',
@@ -103,7 +111,8 @@ class OperationGroup(click.Group):
                 data = {'ok': code == 0, 'error': None, 'hint': None}
                 if isinstance(result, dict):
                     data.update(result)
-                click.echo(json.dumps(data, ensure_ascii=False), file=output)
+                # ASCII JSON survives both GBK consoles and UTF-8 subprocess pipes losslessly.
+                click.echo(json.dumps(data, ensure_ascii=True), file=output)
             elif code:
                 click.echo('错误: ' + str((result or {}).get('error') or '操作失败'), err=True)
                 if (result or {}).get('hint'):

mcpywrap-0.3.5/mcpywrap/commands/connect_cmd.py

@@ -0,0 +1,22 @@
+"""无项目的临时网络连接，可显式使用 MCS 当前身份。"""
+import click
+
+from ..command_context import OperationCommand
+from ..mcstudio.discovery import engine_options
+from ..mcstudio.network import ServerTarget, run_network
+
+
+@click.command(cls=OperationCommand)
+@engine_options
+@click.argument('host')
+@click.option('--port', type=click.IntRange(1, 65535), default=19132, show_default=True)
+@click.option('--mcs-auth', is_flag=True, help='本次连接使用已登录的 MC Studio 身份')
+@click.option('--detach', is_flag=True, help='后台连接并返回游戏会话；JSON 必须指定')
+def connect_cmd(host, port, mcs_auth=False, detach=False, **engine_overrides):
+    """尝试连接服务器；前台采集日志，Ctrl+C 结束本次游戏。
+
+    默认不读取登录身份；--mcs-auth 要求 MCS 已登录及本机桥接可用。
+    不读取项目配置，不装配本地 Mod，不保证服务器接受连接。
+    """
+    return run_network(ServerTarget(host, port, 'mcs' if mcs_auth else 'none'),
+                       engine_overrides=engine_overrides, detach=detach)

{mcpywrap-0.3.3 → mcpywrap-0.3.5}/mcpywrap/commands/doctor_cmd.py

@@ -9,7 +9,8 @@ from ..mcstudio.discovery import (
 
 @click.command(cls=OperationCommand)
 @engine_options
-def doctor_cmd(**overrides):
+@click.option('--mcs-auth', is_flag=True, help='同时只读检查登录组件；不读取身份或安装证书')
+def doctor_cmd(mcs_auth=False, **overrides):
     """诊断游戏发现和运行资源（只读，无需初始化项目）"""
     result = discover_engines(current_project(), overrides=overrides)
     data = result.to_dict()
@@ -21,6 +22,11 @@ def doctor_cmd(**overrides):
         _, issues = studio_installation(purpose)
         data['resources'][purpose].extend(issues)
     data['ok'] = bool(result.selected and not result.error and not data['resources']['run'])
+    if mcs_auth:
+        from ..mcstudio.bridge_assets import inspect_bridge
+        data['mcs_auth'] = inspect_bridge()
+        if not data['mcs_auth']['component_available']:
+            data.update(ok=False, error=data['mcs_auth']['error'], hint=data['mcs_auth']['hint'])
     from ..command_context import json_output
     if not json_output():
         for candidate in result.candidates:
@@ -30,4 +36,7 @@ def doctor_cmd(**overrides):
         for kind, issues in data['resources'].items():
             for issue in issues:
                 click.echo(f'资源 [{kind}]: {issue}')
+        if mcs_auth:
+            click.echo('登录组件: ' + ('文件齐全，尚未验证登录和系统策略' if data['mcs_auth']['component_available']
+                                     else data['mcs_auth']['error']))
     return data

{mcpywrap-0.3.3 → mcpywrap-0.3.5}/mcpywrap/commands/run_cmd.py

@@ -125,7 +125,8 @@ def _build_dependency_tree(node, tree_node):
 
 
 def _run_game_with_instance(config_path, level_id, all_packs, wait=True, log_callback=None,
-                            engine_overrides=None, no_gui=False, logging_port=None, output_path=None):
+                            engine_overrides=None, no_gui=False, logging_port=None, output_path=None,
+                            auth_context=None, auth_config_path=None, capture_output=False):
     """使用指定的实例运行游戏
     
     Args:
@@ -141,6 +142,8 @@ def _run_game_with_instance(config_path, level_id, all_packs, wait=True, log_cal
     from pathlib import Path
     from ..dependencies import read_project
     project_dir = str(Path(config_path).resolve().parent.parent)
+    if auth_context is not None and (not auth_config_path or not no_gui or wait):
+        raise ValueError('带身份的单人测试必须通过会话 worker 启动')
     config = read_project(project_dir)
     if 'server' in config.get('tool', {}).get('mcpywrap', {}):
         # GUI/旧会话也不能将网络目标误启动成本地世界。
@@ -259,13 +262,20 @@ def _run_game_with_instance(config_path, level_id, all_packs, wait=True, log_cal
             log_message(f"✓ 已创建world_resource_packs.json，包含{len(resource_packs_config)}个资源包", "success")
             
     # 启动游戏
+    launch_config_path = config_path
+    if auth_context is not None:
+        auth_context.apply(runtime_config)
+        launch_config_path = auth_config_path
+        with open(launch_config_path, 'w', encoding='utf-8') as stream:
+            json.dump(runtime_config, stream, ensure_ascii=False)
     logging_port = logging_port if logging_port is not None else _gen_random_port()
 
     log_message(f"🚀 正在启动游戏实例: {level_id[:8]}...", "bright_blue")
     
     with console.status("启动游戏中...", spinner="dots"):
-        game_process = open_game(config_path, logging_port=logging_port, wait=False, engine=engine,
-                                 **({'output_path': output_path} if output_path else {}))
+        game_process = open_game(launch_config_path, logging_port=logging_port, wait=False, engine=engine,
+                                 **({'capture_output': True} if auth_context is not None or capture_output else
+                                    {'output_path': output_path} if output_path else {}))
 
     if not game_process:
         log_message("❌ 游戏启动失败", "error")
@@ -331,20 +341,22 @@ def _gen_random_port():
 @engine_options
 @click.option("--no-gui", is_flag=True, help="只显示游戏，不打开辅助 GUI")
 @click.option("--detach", is_flag=True, help="后台运行并返回游戏会话")
+@click.option('--mcs-auth', is_flag=True, help='本次单人测试或网络连接使用已登录的 MC Studio 身份')
 @click.option('--new', '-n', is_flag=True, help='创建新的游戏实例')
 @click.option('--list', '-l', is_flag=True, help='列出所有可用的游戏实例')
 @click.option('--delete', '-d', help='删除指定的游戏实例 (输入实例ID前缀)')
 @click.option('--force', '-f', is_flag=True, help='强制删除，不提示确认')
 @click.option('--clean-all', is_flag=True, help='清空所有游戏实例')
 @click.argument('instance_prefix', required=False)
-def run_cmd(new, list, delete, force, clean_all, instance_prefix, no_gui, detach, **engine_overrides):
+def run_cmd(new, list, delete, force, clean_all, instance_prefix, no_gui, detach, mcs_auth=False, **engine_overrides):
     """游戏实例运行与管理
     
     可直接运行 'mcpy run' 启动最新实例，或使用选项管理实例。
 
-    配置 [tool.mcpywrap.server] host/port 时改为未认证网络连接，
+    配置 [tool.mcpywrap.server] host/port 时改为网络连接；默认未认证，
+    可用 --mcs-auth 显式读取 MCS 身份，单人测试同样支持此选项。
     不装配本地 Mod，不保证服务器接受连接。网络模式前台采集日志，
-    Ctrl+C 结束本次游戏，暂不支持 --detach。
+    Ctrl+C 结束本次网络游戏；--detach 返回可查询、操作和停止的会话。
     """
     base_dir = str(current_project())
     if (delete or clean_all) and non_interactive() and not force:
@@ -352,6 +364,8 @@ def run_cmd(new, list, delete, force, clean_all, instance_prefix, no_gui, detach
     # 检查项目是否已初始化
     if not config_exists():
         require_project()
+    if mcs_auth and (list or delete or clean_all):
+        raise click.UsageError('--mcs-auth 仅用于网络连接，不用于存档管理')
 
     # 在存档选择、配置同步和目录创建之前分流；管理选项仍只管理本地存档。
     if not (list or delete or clean_all):
@@ -360,13 +374,14 @@ def run_cmd(new, list, delete, force, clean_all, instance_prefix, no_gui, detach
         config = read_project(base_dir)
         target = configured_target(config)
         if target is not None:
+            if mcs_auth:
+                from dataclasses import replace
+                target = replace(target, auth='mcs')
             if new or instance_prefix:
                 raise click.UsageError('网络模式不支持 --new 或本地世界实例 ID')
-            if detach:
-                raise click.UsageError('网络模式暂不支持 --detach；请在终端会话中前台运行')
             packs = prepare_project(base_dir, config)
             return run_network(target, project_dir=base_dir, packs=packs,
-                               engine_overrides=engine_overrides)
+                               engine_overrides=engine_overrides, detach=detach)
 
     # 确保 map 项目的 setuptools 配置同步
     ensure_map_setuptools_sync(interactive=False)
@@ -395,6 +410,10 @@ def run_cmd(new, list, delete, force, clean_all, instance_prefix, no_gui, detach
     all_packs = _setup_dependencies(project_name, base_dir)
     if all_packs is None:
         raise click.ClickException('依赖校验失败')
+    auth_context = None
+    if mcs_auth:
+        from ..mcstudio.mcs_auth import acquire_identity
+        auth_context = acquire_identity()
 
     # 确定要使用的实例
     config_path = None
@@ -444,14 +463,12 @@ def run_cmd(new, list, delete, force, clean_all, instance_prefix, no_gui, detach
     from ..command_context import json_output
     if json_output() and not detach:
         raise click.UsageError('run --json 需要 --detach，避免等待游戏退出')
-    if no_gui or detach or non_interactive():
+    if no_gui or detach or non_interactive() or mcs_auth:
         from ..mcstudio import sessions
         import time
-        data = sessions.start(base_dir, config_path, level_id, engine_overrides)
-        result = {'application': 'game', 'project': base_dir, 'session': data['session'],
-                  'state': data['state'], **data['game'], 'log_path': data['log_path'],
-                  'engine_log_path': data.get('engine_log_path'),
-                  'window_title_hint': 'Minecraft', 'window_verified': False}
+        data = sessions.start(base_dir, config_path, level_id, engine_overrides,
+                              **({'auth_context': auth_context} if auth_context is not None else {}))
+        result = sessions.handoff(data)
         if detach:
             return result
         click.echo('会话: ' + data['session'] + '；日志: ' + data['log_path'])

{mcpywrap-0.3.3 → mcpywrap-0.3.5}/mcpywrap/commands/ui_cmd.py

@@ -10,7 +10,8 @@ console = Console()
 
 
 @click.command(cls=OperationCommand)
-def ui_cmd():
+@click.option('--mcs-auth', is_flag=True, help='本次 GUI 单人测试使用已登录的 MC Studio 身份')
+def ui_cmd(mcs_auth=False):
     """启动图形界面"""
     from ..command_context import json_output
     if non_interactive() or json_output():
@@ -25,5 +26,5 @@ def ui_cmd():
     
     from ..ui.project_ui import show_run_ui
     # 显示图形界面
-    show_run_ui(str(current_project()))
+    show_run_ui(str(current_project()), mcs_auth=mcs_auth)
 

mcpywrap-0.3.5/mcpywrap/mcstudio/auth_interaction.py

@@ -0,0 +1,86 @@
+"""Human-only recovery for the optional identity feature; no silent certificate trust."""
+import json
+import os
+from pathlib import Path
+import subprocess
+
+
+def _powershell_json(script, directory):
+    environment = dict(os.environ, MCPY_BRIDGE_CHECK=str(directory))
+    environment = {k: v for k, v in environment.items() if k.casefold() != 'psmodulepath'}
+    powershell = str(Path(os.environ.get('WINDIR', r'C:\Windows'))/'System32/WindowsPowerShell/v1.0/powershell.exe')
+    result = subprocess.run([powershell, '-NoProfile', '-Command', script],
+                            env=environment, capture_output=True, timeout=20,
+                            creationflags=subprocess.CREATE_NO_WINDOW)
+    if result.returncode:
+        return None
+    try:
+        return json.loads(result.stdout.decode('utf-8-sig'))
+    except (ValueError, UnicodeError):
+        return None
+
+
+def certificate_can_help(directory, certificate):
+    """Offer recovery only for intact signatures terminating at an untrusted root."""
+    script = r'''
+[Console]::OutputEncoding=[Text.UTF8Encoding]::new($false)
+$items=@()
+foreach($name in @('Injector.exe','Loader.dll','McpyMcsAuth.dll')) {
+ $sig=Get-AuthenticodeSignature -LiteralPath (Join-Path $env:MCPY_BRIDGE_CHECK $name)
+ $untrusted=$false
+ if($sig.SignerCertificate) {
+  $chain=New-Object Security.Cryptography.X509Certificates.X509Chain
+  $chain.ChainPolicy.RevocationMode='NoCheck'
+  $valid=$chain.Build($sig.SignerCertificate)
+  $states=@($chain.ChainStatus | ForEach-Object {$_.Status.ToString()})
+  $untrusted=(!$valid -and $states.Count -eq 1 -and $states[0] -eq 'UntrustedRoot')
+ }
+ $items+=@{status=$sig.Status.ToString();thumbprint=$sig.SignerCertificate.Thumbprint;untrusted_root=$untrusted}
+}
+ConvertTo-Json -InputObject $items -Compress
+'''
+    try:
+        result = _powershell_json(script, directory)
+    except (OSError, subprocess.TimeoutExpired):
+        return False
+    return isinstance(result, list) and len(result) == 3 and all(
+        item.get('thumbprint') == certificate['thumbprint'] and item.get('untrusted_root') and
+        item.get('status') in ('UnknownError', 'NotTrusted') for item in result)
+
+
+def confirm_certificate(certificate):
+    from PyQt5.QtWidgets import QApplication, QMessageBox
+    app = QApplication.instance() or QApplication([])
+    dialog = QMessageBox()
+    dialog.setWindowTitle('启用 MC Studio 登录身份')
+    dialog.setIcon(QMessageBox.Warning)
+    dialog.setText('Windows 尚未信任 mcpywrap 登录组件的发布者。')
+    dialog.setInformativeText(
+        '此组件会读取你在 MC Studio 中已登录的身份，用于启动本次游戏。\n\n'
+        '你可以将发布者证书加入当前 Windows 用户的信任列表，再试一次。'
+        '这也会信任同一证书签署的其他程序，并非只允许本次运行。\n\n'
+        '部分电脑仍会受智能应用控制或组织策略限制，安装证书不保证能够启用。'
+        '取消后仍可去掉 --mcs-auth 进行普通测试。')
+    dialog.setDetailedText('发布者：'+certificate['subject']+'\n证书指纹：'+certificate['thumbprint']+
+                           '\n有效期至：'+certificate['expires']+
+                           '\n仅安装公钥证书，不安装私钥，不关闭 Windows 安全保护。')
+    accept = dialog.addButton('信任此发布者并重试', QMessageBox.AcceptRole)
+    cancel = dialog.addButton('暂不启用', QMessageBox.RejectRole)
+    dialog.setDefaultButton(cancel)
+    dialog.exec_()
+    return dialog.clickedButton() is accept
+
+
+def install_certificate(certificate):
+    # Called only after the explicit consent above. No system-wide store or elevation.
+    command = str(Path(os.environ.get('WINDIR', r'C:\Windows'))/'System32/certutil.exe')
+    result = subprocess.run([command, '-user', '-addstore', 'Root', certificate['path']],
+                            capture_output=True, timeout=30, creationflags=subprocess.CREATE_NO_WINDOW)
+    if result.returncode:
+        raise ValueError('证书未能安装。可能缺少权限或被组织策略限制；你仍可不带 --mcs-auth 进行普通测试。')
+
+
+def show_failure(message):
+    from PyQt5.QtWidgets import QApplication, QMessageBox
+    app = QApplication.instance() or QApplication([])
+    QMessageBox.warning(None, '暂时无法使用 MC Studio 登录身份', message)

mcpywrap-0.3.5/mcpywrap/mcstudio/bridge_assets.py

@@ -0,0 +1,84 @@
+"""Install only the bridge payload shipped with this package, without changing trust."""
+import hashlib
+import json
+import os
+from pathlib import Path
+import shutil
+
+BINARIES = ('Injector.exe', 'Loader.dll', 'McpyMcsAuth.dll')
+PAYLOAD = Path(__file__).with_name('bridge_payload')
+
+
+def inspect_bridge():
+    """只检查组件文件；不复制缓存、不读取身份、不改变证书信任。"""
+    override = os.environ.get('MCPY_MCS_BRIDGE_DIR')
+    bundled = not override and (PAYLOAD/'manifest.json').is_file()
+    directory = (Path(override).expanduser().resolve() if override else PAYLOAD if bundled
+                 else Path.home()/'.local/share/mcpywrap/mcs-auth-bridge')
+    result = {'component_available': False, 'directory': str(directory),
+              'source': 'override' if override else 'package' if bundled else 'development',
+              'integrity_verified': False, 'trust_verified': False, 'login_verified': False,
+              'error': None, 'hint': None}
+    try:
+        if bundled:
+            payload_manifest()
+            result['integrity_verified'] = True
+        missing = [name for name in BINARIES if not (directory/name).is_file()]
+        if missing:
+            raise ValueError('缺少登录组件: ' + ', '.join(missing))
+        result['component_available'] = True
+    except (OSError, ValueError, KeyError, TypeError) as exc:
+        result.update(error=str(exc), hint='使用包含桥接组件的正式发布包；Git／可编辑安装需另行构建组件，'
+                      '并通过 MCPY_MCS_BRIDGE_DIR 指定目录。组件存在不表示已登录或系统策略允许启用。')
+    return result
+
+
+def digest(path):
+    return hashlib.sha256(path.read_bytes()).hexdigest()
+
+
+def payload_manifest():
+    manifest = json.loads((PAYLOAD/'manifest.json').read_text(encoding='utf-8'))
+    required = set(BINARIES) | {'publisher.cer'}
+    if set(manifest['files']) != required:
+        raise ValueError('登录组件包不完整，请重新安装 mcpywrap。')
+    for name, expected in manifest['files'].items():
+        if digest(PAYLOAD/name) != expected:
+            raise ValueError('登录组件校验失败，请从项目的正式发布重新安装 mcpywrap。')
+    return manifest
+
+
+def bridge_directory():
+    override = os.environ.get('MCPY_MCS_BRIDGE_DIR')
+    if override:
+        directory = Path(override).expanduser().resolve()
+    elif (PAYLOAD/'manifest.json').is_file():
+        manifest = payload_manifest()
+        version = digest(PAYLOAD/'manifest.json')[:16]
+        directory = Path.home()/'.local/share/mcpywrap/mcs-auth-bridge'/version
+        directory.mkdir(parents=True, exist_ok=True)
+        for name, expected in manifest['files'].items():
+            target = directory/name
+            if not target.is_file():
+                temporary = target.with_suffix(target.suffix+'.tmp')
+                shutil.copyfile(PAYLOAD/name, temporary)
+                os.replace(temporary, target)
+            if digest(target) != expected:
+                raise ValueError('本机登录组件已被更改，请删除组件缓存后重新运行。')
+    else:
+        directory = Path.home()/'.local/share/mcpywrap/mcs-auth-bridge'
+    if not all((directory/name).is_file() for name in BINARIES):
+        raise ValueError('此安装缺少登录组件，请重新安装正式版；源码开发者可运行 scripts/build_mcs_auth_bridge.py。')
+    return directory
+
+
+def trusted_certificate_candidate(directory):
+    """Never offer to trust certificates supplied by an arbitrary developer override."""
+    try:
+        manifest = payload_manifest()
+        if any(digest(directory/name) != expected for name, expected in manifest['files'].items()):
+            return None
+        return {'path': str(directory/'publisher.cer'), 'thumbprint': manifest['thumbprint'],
+                'subject': manifest['subject'], 'expires': manifest['expires']}
+    except (OSError, ValueError, KeyError):
+        return None