mcpywrap 0.7.0__tar.gz → 0.7.2__tar.gz

{mcpywrap-0.7.0 → mcpywrap-0.7.2}/CHANGELOG.md

@@ -1,5 +1,13 @@
 # 更新记录
 
+## 0.7.2
+
+- `mcpy host pair --url` 接受任意主机地址，不再限定 `127.0.0.1`。开发环境与 App 不共享回环网络时（如鸿蒙 PC 原生终端连接兼容容器中的 App）或局域网联调时，使用 App 实际可达的地址配对；后续宿主请求沿用该地址。
+
+## 0.7.1
+
+- `mcpy profile` 按引擎版本识别主循环区段：3.10 的 `Main app outer update` 与 3.9 的 `Main Update`，均缺失时回退到引擎通用的 `update`；最慢帧窗口只展示实际选用的主循环与服务端 tick。此前 3.10 游戏的报告缺少主循环分位数与最慢帧归因。
+
 ## 0.7.0
 
 性能分析标准化：用游戏内置的 Tracy 定位到具体函数，取代在 Mod 代码中加时间戳打点。

{mcpywrap-0.7.0 → mcpywrap-0.7.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcpywrap
-Version: 0.7.0
+Version: 0.7.2
 Summary: Complete mcpy desktop tools, powered by the shared mcpywrap-core
 Author-email: boybook <boybook@easecation.net>
 License-Expression: MIT
@@ -10,7 +10,7 @@ Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: THIRD_PARTY_NOTICES.md
-Requires-Dist: mcpywrap-core==0.7.0
+Requires-Dist: mcpywrap-core==0.7.2
 Requires-Dist: pip>=23
 Requires-Dist: build>=1.0
 Requires-Dist: watchdog>=2.0.0

mcpywrap-0.7.2/core/mcpywrap_core/_version.py

@@ -0,0 +1 @@
+__version__ = '0.7.2'

{mcpywrap-0.7.0 → mcpywrap-0.7.2}/desktop/mcpywrap.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcpywrap
-Version: 0.7.0
+Version: 0.7.2
 Summary: Complete mcpy desktop tools, powered by the shared mcpywrap-core
 Author-email: boybook <boybook@easecation.net>
 License-Expression: MIT
@@ -10,7 +10,7 @@ Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: THIRD_PARTY_NOTICES.md
-Requires-Dist: mcpywrap-core==0.7.0
+Requires-Dist: mcpywrap-core==0.7.2
 Requires-Dist: pip>=23
 Requires-Dist: build>=1.0
 Requires-Dist: watchdog>=2.0.0

{mcpywrap-0.7.0 → mcpywrap-0.7.2}/desktop/mcpywrap.egg-info/requires.txt

@@ -1,4 +1,4 @@
-mcpywrap-core==0.7.0
+mcpywrap-core==0.7.2
 pip>=23
 build>=1.0
 watchdog>=2.0.0

{mcpywrap-0.7.0 → mcpywrap-0.7.2}/desktop/mcpywrap_assets/bridge_payload/manifest.json

@@ -11,9 +11,9 @@
     "Loader.c": "f2f1f781ce82fc30c62a6ce22bb048d3b023f6ff500e6ec8228da28b4dbf1b4a"
   },
   "files": {
-    "Injector.exe": "9f80692ee5589715466a2fbc08a12650f70fb1088ccd8254114b0ada92271b6b",
-    "Loader.dll": "cfdae6b7e12eff13e6529792799db574d7ed0706043627f0b77355dcc49fdb9d",
-    "McpyMcsAuth.dll": "b9913e7ced63ce2089d981dc13448289807f36ba372bf44e7c82e29050005b85",
+    "Injector.exe": "39eb207615c2336c9949ccb1d64b08bef57c9e740d91dc6cf9f73d31a1ab7c76",
+    "Loader.dll": "50b8f61ab8b8351a2a16170166e82e7865f04a760c17bda5ae7030707236bb2b",
+    "McpyMcsAuth.dll": "1027b4777ead384e9fc906f7baf730e34f8ac14c725c024ff8e59b57275fac8f",
     "publisher.cer": "e5aa2ac39df40804ed8b08fe8e43c4a2b8923f0d02a360708486b2db5b6303d7"
   }
 }

{mcpywrap-0.7.0 → mcpywrap-0.7.2}/desktop/mcpywrap_assets/window_activation/manifest.json

@@ -1,6 +1,6 @@
 {
   "background_window_protocol": 1,
   "architecture": "x64",
-  "dll_sha256": "70fcb1788b2a1209e69abbd9db671e240f45d023e7caa232f845df8464abc8d7",
+  "dll_sha256": "e3679da96998b3e3441c46e4c28a387d0abf486b97e3c582617f4cb4bedc5412",
   "source_sha256": "03c1aab9e8d46c162e11f9448903c4907fbe3b87d1e77d8118b72c3e6b250ec5"
 }

{mcpywrap-0.7.0 → mcpywrap-0.7.2}/desktop/mcpywrap_assets/window_capture/manifest.json

@@ -1,5 +1,5 @@
 {
-  "executable_sha256": "5413bdf2c4e3b5d28cc53baa6f323eaa6e0f63cc7f796827bdb779c29ab222ed",
+  "executable_sha256": "404c1e80a2e53caa285d277d42eeb5995ad90d9d8dc264ef1b2aaf256bd50c51",
   "source_sha256": "64c9db4f31031fc794e4a41a3287a8382c5ac5599244824b6fd7d44971d68f05",
   "sources": {
     "ocr.h": "0b62eed9a41cdeec451283c24b140da4f333a47b59c581e26dd8f0d803e9cfd6",

{mcpywrap-0.7.0 → mcpywrap-0.7.2}/skills/mcpywrap/references/application-host.md

@@ -4,19 +4,19 @@
 
 ## 首次连接
 
-新版页面名为「开发」，旧版名为「开发工具」；使用同一套命令与协议。
-
-1. 用户打开 mcpy App 并授权作品目录后，新版默认开启仅监听 `127.0.0.1` 的开发连接；已主动暂停或使用旧版时，在「开发」恢复连接。页面直接显示本机地址、配对码和有效期，可以复制配对码、标准命令，或可选的 AI 说明。普通终端无需 AI；模型账号只在使用 Agent 时需要。
+1. 用户打开 mcpy App 并授权作品目录后，App 默认开启开发连接；主动暂停后在「开发」页恢复连接。页面直接显示连接地址、配对码和有效期，可以复制配对码、标准命令，或可选的 AI 说明。普通终端无需 AI；模型账号只在使用 Agent 时需要。
 2. 开发环境安装 Python、Git 和正式 `mcpywrap`。Minis 的 PRoot 使用 Alpine；优先使用其包管理器提供的 Python，再按标准 pip/uv 安装。解释器与虚拟环境放在该应用私有 Linux 目录，不能放在共享存储上。
 3. 让用户将内部存储 `mcpy` 目录挂载为可读写目录。Minis 1.14 在设置 → Mount External Folders 中选择目录，并授予 Minis 自身的“所有文件访问”；仅有文件夹选择授权仍可能看不到其他 App 写入的文件。常见路径为 `/var/minis/mounts/mcpy`，以实际探针结果为准；不能把同名私有副本当作共享目录。
 4. 完整安装技能并配对：
 
 ```sh
 mcpy skill install --directory /var/minis/skills/mcpywrap
-mcpy host pair --url http://127.0.0.1:17653 --code <App给出的短时配对码> --workspace <实际挂载路径> --label Minis
+mcpy host pair --url http://<App地址>:17653 --code <App给出的短时配对码> --workspace <实际挂载路径> --label Minis
 mcpy --project <挂载路径>/projects/<作品> host status --json
 ```
 
+`--url` 接受任意主机地址，默认 `http://127.0.0.1:17653`。开发环境与 App 在同一系统内时使用 `127.0.0.1`；跨容器（例如鸿蒙 PC 原生终端连接兼容容器中的 App，如 `http://172.17.1.2:17653`）或局域网联调时，使用 App 页面给出、从开发环境实际可达的地址。
+
 已有技能更新使用 `skill install --replace`。配对会验证双向读写，并等待用户通过临时确认卡、通知动作或 App 页面允许连接。有悬浮权限时可直接在开发工具上方确认，无权限时使用通知；不需要常驻悬浮图标。命令将长期凭据保存到私有配置，不打印到对话；不要读取或复制该配置中的 token。
 
 ## 日常开发
@@ -68,13 +68,13 @@ mcpy --project <作品目录> logs --session <sid> --follow --filter '[组件前
 
 `--filter` 是区分大小写的字面匹配，不是正则表达式。先筛选，再取 `tail`；`--summary` 统计扫描范围内完全相同的消息，客户端和服务端分开计数。统计模式不与持续跟随同用。每源每次最多扫描 512 KiB，响应提供 `available/scanned_lines/matched_lines/scan_truncated`；摘要超过 `tail` 时有 `summary_truncated`。无匹配只能说明该范围内没找到，不能证明模组正常。时间筛选不猜测缺少时间戳的消息，排除数量见 `excluded_without_timestamp`。持续读取按原始文件游标推进，未匹配记录也会推进游标。
 
-宿主在 `log_query` 中声明筛选能力，旧 App 缺失能力时明确要求升级，不静默忽略参数。桌面本地也支持字面过滤和统计，快照扫描 512 KiB，持续跟随首次历史读取为 256 KiB；Windows 旧 HTTP 服务继续使用原接口，由客户端筛选最近 10000 行，并明确返回该扫描范围。端侧与毫秒时间筛选需要支持结构化日志的宿主，不能从桌面原始文本猜测。
+宿主在 `log_query` 中声明筛选能力，未声明所需能力时明确报错并提示升级 App，不静默忽略参数。桌面本地也支持字面过滤和统计，快照扫描 512 KiB，持续跟随首次历史读取为 256 KiB；Windows HTTP 服务未声明筛选能力时，由客户端筛选最近 10000 行，并明确返回该扫描范围。端侧与毫秒时间筛选需要支持结构化日志的宿主，不能从桌面原始文本猜测。
 
 `restart` 返回新 `session`、`previous_session` 和 `session_changed=true`。立即更新后续日志、截图、Python 调试的目标；旧会话仍用于历史查询。等待用户恢复的重启请求同样携带会话交接信息。
 
 ## 启动证据与等待策略
 
-App 的 `run/restart --launch-timeout <秒>` 配置进程及画中画的确认等待，默认 45 秒，范围 5–120 秒；须由 `launch_options.ack_timeout` 声明支持。世界加载使用独立的 300 秒限制，超过确认等待不会自动重放启动、重新构建或新建世界。桌面及旧 Windows 服务未声明此参数时明确拒绝，保持原启动策略。
+App 的 `run/restart --launch-timeout <秒>` 配置进程及画中画的确认等待，默认 45 秒，范围 5–120 秒；须由 `launch_options.ack_timeout` 声明支持。世界加载使用独立的 300 秒限制，超过确认等待不会自动重放启动、重新构建或新建世界。桌面及 Windows 服务未声明此参数时明确拒绝，保持原启动策略。
 
 `status.launch_timeline` 返回已记录的部署、Activity、引擎及游戏阶段，各项有 `observed_at/age_ms/elapsed_ms/since_previous_ms`，保留有界历史并报告 `truncated`。旧会话只返回真实存在的记录，不补造阶段。`clientReady/serverReady` 描述宿主调试初始化证据，不证明任何业务系统或 UI 正常。
 

{mcpywrap-0.7.0 → mcpywrap-0.7.2}/skills/mcpywrap/references/profiling.md

@@ -19,7 +19,7 @@
    ```
    采集文件保存在项目 `.runtime/profiles/`，返回 `trace` 路径与报告摘要。只关心某个模块时加 `--filter <函数名或模块路径片段>`，需要更多条目加 `--top 30`。已有文件可用 `profile report <trace> --json` 重新汇总。
 3. **读摘要**：
-   - `main_loop`（`Main Update`，即客户端帧）与 `server_tick`（`serverUpdate`）：次/秒与 p50/p95/p99/最大耗时，先判断问题是持续偏慢（p50 高）还是偶发卡顿（p99/最大高）。
+   - `main_loop`（客户端帧；3.9 为 `Main Update`，3.10 为 `Main app outer update`，`zone` 字段给出实际名称）与 `server_tick`（`serverUpdate`）：次/秒与 p50/p95/p99/最大耗时，先判断问题是持续偏慢（p50 高）还是偶发卡顿（p99/最大高）。
    - `script`：脚本自身耗时（ms/秒）和脚本调用的内置函数耗时，衡量脚本整体占用。
    - `scripts`：脚本函数按总耗时排序，含 `source`（项目内源码路径）、`line`、调用者、所在线程。`self_ms` 高表示函数体本身慢；总耗时高而自身低时看它调用的函数（用 `--filter` 收窄）。
    - `script_spikes`：按单次最大耗时排序，用于定位偶发卡顿。
@@ -37,7 +37,7 @@
 - 每次 Python 调用都会记录，开销会放大调用频繁的小函数；看相对排名和前后变化，不把单个区段耗时当作无分析时的真实耗时。
 - 内置函数（如 `time`、`len`）单独成区段，位置是模块名、行号 0；它们的耗时不计入调用者的 `self_ms`。
 - `prepareFrame` 的自身耗时包含帧率等待；`sleep` 等等待类区段不是计算。其他线程里的等待出现在慢帧窗口中，不代表它导致了卡顿。
-- 游戏每帧打两次帧标记，帧时间以 `Main Update` 为准。
+- 游戏每帧打两次帧标记，帧时间以 `main_loop` 选用的主循环区段为准。
 - macOS 的渲染耗时受图形转译影响，不能当作 Windows 的结论；脚本函数的相对耗时可以参考。
 - 返回 `protocol_mismatch` 表示游戏内置 Tracy 已变化：停止并报告游戏版本，不要换用其他 Tracy 版本重试。
 

{mcpywrap-0.7.0 → mcpywrap-0.7.2}/tests/test_mobile_host.py

@@ -79,8 +79,10 @@ class MobileHostTests(unittest.TestCase):
     def test_paths_are_mount_relative(self):
         self.assertEqual(profiles.project_path(self.record,self.project),'projects/demo')
         with self.assertRaises(ValueError):profiles.project_path(self.record,self.root.parent/'outside')
-    def test_only_loopback_endpoints(self):
-        for url in ('http://192.168.1.1:17653','https://example.org','http://127.0.0.1:17653/unsafe','http://user:pass@127.0.0.1:17653'):
+    def test_endpoint_accepts_any_host(self):
+        for url in ('http://127.0.0.1:17653','http://172.17.1.2:17653/','http://192.168.1.1:17653'):
+            self.assertEqual(profiles.endpoint(url),url.rstrip('/'))
+        for url in ('ftp://127.0.0.1:17653','https://example.org','http://127.0.0.1:17653/unsafe','http://user:pass@127.0.0.1:17653'):
             with self.assertRaises(ValueError):profiles.endpoint(url)
     def test_host_distribution_provider_replaces_process_metadata(self):
         from mcpywrap_core.host import distribution

{mcpywrap-0.7.0 → mcpywrap-0.7.2}/tests/test_profiling.py

@@ -330,6 +330,17 @@ class AnalysisTests(unittest.TestCase):
         self.assertIn('slow_path', text)
         self.assertIn('最慢的 Main Update', text)
 
+    def test_main_loop_follows_engine_version_naming(self):
+        raw = raw_report()
+        raw['zones'][0]['name'] = 'Main app outer update'  # 3.10 的主循环区段名
+        raw['windows'] = [dict(raw['windows'][0], zone='Main app outer update'),
+                          {'zone': 'Main Update', 'slowest': []}, {'zone': 'update', 'slowest': []}]
+        summary = analysis.summarize(raw, None)
+        self.assertEqual(summary['main_loop']['zone'], 'Main app outer update')
+        self.assertEqual([w['zone'] for w in summary['windows']], ['Main app outer update'])
+        raw['zones'][0].update(name='update', file='Engine', line=0)  # 只有通用 update 时回退
+        self.assertEqual(analysis.summarize(raw, None)['main_loop']['zone'], 'update')
+
     def test_filter_limits_script_list(self):
         summary = analysis.summarize(raw_report(), None, filter='slow')
         self.assertEqual([s['name'] for s in summary['scripts']], ['slow_path'])
@@ -359,6 +370,9 @@ class AnalysisTests(unittest.TestCase):
                 analysis.load(trace)
                 analysis.load(trace)
                 self.assertEqual(len(calls), 1)
+                for name in analysis.WINDOWS:
+                    self.assertIn(name, calls[0])
+                self.assertEqual(calls[0][-1], str(trace.resolve()))
                 with patch.object(tools, 'installed_identity', return_value='two'):
                     analysis.load(trace)
                 self.assertEqual(len(calls), 2)

mcpywrap-0.7.0/core/mcpywrap_core/_version.py

@@ -1 +0,0 @@
-__version__ = '0.7.0'