mcpywrap 0.7.1__tar.gz → 0.7.2__tar.gz

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

@@ -1,5 +1,9 @@
 # 更新记录
 
+## 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 游戏的报告缺少主循环分位数与最慢帧归因。

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcpywrap
-Version: 0.7.1
+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.1
+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.1 → mcpywrap-0.7.2}/desktop/mcpywrap.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcpywrap
-Version: 0.7.1
+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.1
+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.1 → mcpywrap-0.7.2}/desktop/mcpywrap.egg-info/requires.txt

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

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

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

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

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

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

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

{mcpywrap-0.7.1 → 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.1 → 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.1/core/mcpywrap_core/_version.py

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