mcpywrap 0.3.3__tar.gz → 0.3.4__tar.gz

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

@@ -1,5 +1,13 @@
 # 更新记录
 
+## 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.4}/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.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcpywrap
-Version: 0.3.3
+Version: 0.3.4
 Summary: A wrapper for Minecraft China Edition Addons management
 Author-email: boybook <boybook@easecation.net>
 License-Expression: MIT
@@ -144,6 +144,14 @@ port = 19132
 
 网络模式前台输出日志并显示日志文件路径，按 Ctrl+C 结束本次游戏。暂不支持 Map 项目、GUI、`--detach`、`--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 使用
 
 仓库提供标准 [mcpywrap Skill](https://github.com/EaseCation/mcpywrap/tree/main/skills/mcpywrap)，帮助 Agent 安装工具、管理依赖、
@@ -156,7 +164,7 @@ 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。
+请使用 mcpywrap 0.3.4 或更高版本；需要固定组合时，可从 `v0.3.4` 标签安装对应 Skill。
 
 安装后可直接描述任务：
 

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

@@ -117,6 +117,14 @@ port = 19132
 
 网络模式前台输出日志并显示日志文件路径，按 Ctrl+C 结束本次游戏。暂不支持 Map 项目、GUI、`--detach`、`--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 使用
 
 仓库提供标准 [mcpywrap Skill](https://github.com/EaseCation/mcpywrap/tree/main/skills/mcpywrap)，帮助 Agent 安装工具、管理依赖、
@@ -129,7 +137,7 @@ 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。
+请使用 mcpywrap 0.3.4 或更高版本；需要固定组合时，可从 `v0.3.4` 标签安装对应 Skill。
 
 安装后可直接描述任务：
 

mcpywrap-0.3.4/docs/mcs-auth.md

@@ -0,0 +1,43 @@
+# 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`；GUI 登录支持单人项目，网络目标继续使用 CLI。
+
+## 用户会看到什么
+
+- 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.4}/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.4}/mcpywrap/__init__.py

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

{mcpywrap-0.3.3 → mcpywrap-0.3.4}/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-',

mcpywrap-0.3.4/mcpywrap/commands/connect_cmd.py

@@ -0,0 +1,20 @@
+"""无项目的临时网络连接，可显式使用 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 身份')
+def connect_cmd(host, port, mcs_auth=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)

{mcpywrap-0.3.3 → mcpywrap-0.3.4}/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):
     """使用指定的实例运行游戏
     
     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 else
+                                    {'output_path': output_path} if output_path else {}))
 
     if not game_process:
         log_message("❌ 游戏启动失败", "error")
@@ -331,18 +341,20 @@ 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。
     """
@@ -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,6 +374,9 @@ 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:
@@ -395,6 +412,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,10 +465,11 @@ 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)
+        data = sessions.start(base_dir, config_path, level_id, engine_overrides,
+                              **({'auth_context': auth_context} if auth_context is not None else {}))
         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'),

{mcpywrap-0.3.3 → mcpywrap-0.3.4}/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.4/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.4/mcpywrap/mcstudio/bridge_assets.py

@@ -0,0 +1,60 @@
+"""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 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

mcpywrap-0.3.4/mcpywrap/mcstudio/bridge_payload/manifest.json

@@ -0,0 +1,19 @@
+{
+  "thumbprint": "A3DDD32BE2B56F6EAFE75EA836E8F34AB7C540D9",
+  "subject": "CN=mcpywrap Project Code Signing",
+  "expires": "2028-09-27T06:32:09.0000000Z",
+  "certificate_sha256": "e5aa2ac39df40804ed8b08fe8e43c4a2b8923f0d02a360708486b2db5b6303d7",
+  "bridge_version": 1,
+  "signed": true,
+  "sources": {
+    "Bridge.cs": "4e11328a416337b1bd22e524aa20d9ab78077a5e04539b9285e4db1452a1baf9",
+    "Injector.cs": "b43bc947703950f720ae9517e9fb53005d7bfc3a7543bc0337798e444220e74f",
+    "Loader.c": "f2f1f781ce82fc30c62a6ce22bb048d3b023f6ff500e6ec8228da28b4dbf1b4a"
+  },
+  "files": {
+    "Injector.exe": "02a57987e08ccb672230d25389c5564f47841aee306491ef0b3e50cd8454db4a",
+    "Loader.dll": "df2e3076768bc45487138ff99363738229ee6baf5e078c98b9855f4c11115a4c",
+    "McpyMcsAuth.dll": "f46f1b324ee1959dedb860fa8d45cb9e17610d9b598fe61b7973a8a816b66dce",
+    "publisher.cer": "e5aa2ac39df40804ed8b08fe8e43c4a2b8923f0d02a360708486b2db5b6303d7"
+  }
+}

{mcpywrap-0.3.3 → mcpywrap-0.3.4}/mcpywrap/mcstudio/file_logs.py

@@ -5,7 +5,8 @@ from .log_protocol import LogDecoder
 
 
 class FileLogServer:
-    def __init__(self, path):
+    def __init__(self, path, decoder_factory=LogDecoder):
+        self.decoder_factory = decoder_factory
         self.stream = open(path, 'a', encoding='utf-8')
         self.lock = threading.Lock()
         self.stop_event = threading.Event()
@@ -39,7 +40,7 @@ class FileLogServer:
             self.stream.flush()
 
     def _read(self, client):
-        decoder = LogDecoder()
+        decoder = self.decoder_factory()
         try:
             while not self.stop_event.is_set():
                 try:

{mcpywrap-0.3.3 → mcpywrap-0.3.4}/mcpywrap/mcstudio/game.py

@@ -20,7 +20,7 @@ except ImportError:
 
 
 def open_game(config_path, logging_ip="localhost", logging_port=8678, use_system_color=True, wait=True,
-              engine=None, project_dir=None, output_path=None):
+              engine=None, project_dir=None, output_path=None, capture_output=False):
     """
     打开MC Studio游戏引擎
 
@@ -38,6 +38,8 @@ def open_game(config_path, logging_ip="localhost", logging_port=8678, use_system
         return False
 
     try:
+        if output_path and capture_output:
+            raise ValueError('output_path 与 capture_output 不能同时使用')
         # 检查配置文件是否存在
         if not os.path.isfile(config_path):
             click.secho(f"❌ 配置文件不存在: {config_path}", fg="red", bold=True)
@@ -76,7 +78,8 @@ def open_game(config_path, logging_ip="localhost", logging_port=8678, use_system
                 [minecraft_exe, 'config=' + os.path.abspath(config_path),
                  'loggingIP=' + logging_ip, 'loggingPort=' + str(logging_port)],
                 cwd=engine_path, stdin=subprocess.DEVNULL,
-                stdout=output, stderr=output)
+                stdout=subprocess.PIPE if capture_output else output,
+                stderr=subprocess.STDOUT if capture_output else output)
 
         # 如果需要使用系统主题色且Win32API可用，使用定时器异步应用窗口样式
         if use_system_color and HAS_WIN32API and is_windows():