mcpywrap 0.6.3__tar.gz → 0.6.4__tar.gz

{mcpywrap-0.6.3 → mcpywrap-0.6.4}/CHANGELOG.md

@@ -1,5 +1,13 @@
 # 更新记录
 
+## 0.6.4
+
+- 游戏依赖新增 `unbundled` 布尔标记，默认 false；设为 true 时 dev/run 照常加载，build/package 排除，支持本地 Addon 与通用 Git Addon/code。
+- 新增依赖图只读预览和仅恢复打包依赖的同步选项，按引用链保留共享节点；Git 锁区分新标记并兼容既有普通依赖，未安装的不打包节点不阻塞发布。
+- Qt 依赖管理提供“不随构建打包”复选框、已有依赖设置修改和发布预览；CLI、JSON 与内置 Skill 使用同一概念，配对 App 的预览保持相同结果结构。
+- dev 与 build 的同目标写入互斥，完整构建清除旧开发产物；阻止不随发布的代码覆盖发布模块，并明确消费者准备的适用边界。
+- macOS 默认运行包升级到 0.4.7：修复兼容层 `uname` 布局越界与 `getlogin`/`sysinfo` 缺失，游戏内置 Tracy 由引擎自行启动并默认仅监听 `127.0.0.1:8086`；终止桩不再覆盖已实现的接口。旧实例保留原运行包绑定。
+
 ## 0.6.3
 
 - Windows `run --clients 2` 默认自动加入并校验双方玩家；提供 `--join-mode manual` 保留手动操作，状态、Qt 会话页和 smoke 验收支持自动加入阶段。

{mcpywrap-0.6.3 → mcpywrap-0.6.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcpywrap
-Version: 0.6.3
+Version: 0.6.4
 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.6.3
+Requires-Dist: mcpywrap-core==0.6.4
 Requires-Dist: pip>=23
 Requires-Dist: build>=1.0
 Requires-Dist: watchdog>=2.0.0

mcpywrap-0.6.4/core/mcpywrap_core/_version.py

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

{mcpywrap-0.6.3 → mcpywrap-0.6.4}/desktop/mcpywrap.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcpywrap
-Version: 0.6.3
+Version: 0.6.4
 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.6.3
+Requires-Dist: mcpywrap-core==0.6.4
 Requires-Dist: pip>=23
 Requires-Dist: build>=1.0
 Requires-Dist: watchdog>=2.0.0

{mcpywrap-0.6.3 → mcpywrap-0.6.4}/desktop/mcpywrap.egg-info/SOURCES.txt

@@ -25,6 +25,7 @@ desktop/mcpywrap_assets/window_activation/mcpy-window-activation.dll
 desktop/mcpywrap_assets/window_capture/manifest.json
 desktop/mcpywrap_assets/window_capture/mcpy-window-capture.exe
 docs/code-libraries.md
+docs/dependency-packaging-design.md
 docs/deployment-recovery.md
 docs/engine-discovery.md
 docs/game-backends.md
@@ -62,6 +63,12 @@ native/runtime_input/README.md
 native/runtime_input/launcher-monotonic.patch
 native/runtime_input/manifest-monotonic.patch
 native/runtime_input/steady_clock.h
+native/tracy_profiler/README.md
+native/tracy_profiler/apply.py
+native/tracy_profiler/client-tracy.patch
+native/tracy_profiler/libc-shim-host-info.patch
+native/tracy_profiler/manifest-tracy.patch
+native/tracy_profiler/probe.py
 native/window_activation/README.md
 native/window_activation/window_activation.cpp
 native/window_capture/ocr.h
@@ -208,6 +215,7 @@ tests/test_screenshot.py
 tests/test_session_capabilities.py
 tests/test_shared_logs.py
 tests/test_skill_workflows.py
+tests/test_unbundled_dependencies.py
 tests/test_unified_skill_contract.py
 tests/test_window_activation.py
 tests/test_window_focus.py

{mcpywrap-0.6.3 → mcpywrap-0.6.4}/desktop/mcpywrap.egg-info/requires.txt

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

{mcpywrap-0.6.3 → mcpywrap-0.6.4}/desktop/mcpywrap_assets/bridge_payload/manifest.json

@@ -11,9 +11,9 @@
     "Loader.c": "f2f1f781ce82fc30c62a6ce22bb048d3b023f6ff500e6ec8228da28b4dbf1b4a"
   },
   "files": {
-    "Injector.exe": "c5f7279a7669e9d091f21992516c31daf05e0f9d14965bf30da1161a66a12f06",
-    "Loader.dll": "f56967fe7ce1151463eed6e0c839a5edc0f6b2ae1fc83821737b46f353b972ae",
-    "McpyMcsAuth.dll": "1a5bd521c38a02c1f095bc2c329053b40ad4445a9a4af873f4e5e356b7a8217e",
+    "Injector.exe": "ae038837e14f65131827b8e1a6aeaabc48a29c5513aa4506c8d0c6fd4613728f",
+    "Loader.dll": "ce459eab2daa5266302ff0f4449fe6124e4c38f86956ea20cdb1a29a58540432",
+    "McpyMcsAuth.dll": "3cb99a76bae9a655b321ef8dc698531dd093dfd7f725021a84d7d905621cbf09",
     "publisher.cer": "e5aa2ac39df40804ed8b08fe8e43c4a2b8923f0d02a360708486b2db5b6303d7"
   }
 }

{mcpywrap-0.6.3 → mcpywrap-0.6.4}/desktop/mcpywrap_assets/window_activation/manifest.json

@@ -1,6 +1,6 @@
 {
   "background_window_protocol": 1,
   "architecture": "x64",
-  "dll_sha256": "5f5205893096bef0f223830d93085297cbdbce538bc6771ed1d2904d24ab367f",
+  "dll_sha256": "21bb7012d92f556aa5572eb2b24d15ee9508e592cb0c0841797dbdd1f640b807",
   "source_sha256": "03c1aab9e8d46c162e11f9448903c4907fbe3b87d1e77d8118b72c3e6b250ec5"
 }

{mcpywrap-0.6.3 → mcpywrap-0.6.4}/desktop/mcpywrap_assets/window_capture/manifest.json

@@ -1,5 +1,5 @@
 {
-  "executable_sha256": "43637ac49c8d2ece3406568bd2c2e627741adb1153517478911853f4aaca0b98",
+  "executable_sha256": "e3bc6c8b8c45df6c8e07655dc207921ae6908a4a9d397471d359d1269bf126d4",
   "source_sha256": "64c9db4f31031fc794e4a41a3287a8382c5ac5599244824b6fd7d44971d68f05",
   "sources": {
     "ocr.h": "0b62eed9a41cdeec451283c24b140da4f333a47b59c581e26dd8f0d803e9cfd6",

mcpywrap-0.6.4/docs/dependency-packaging-design.md

@@ -0,0 +1,62 @@
+# 依赖的 unbundled 打包标记
+
+状态：已实现。默认 `unbundled = false`。日期：2026-10-30。
+
+## 契约
+
+`unbundled` 是依赖引用上的布尔值。false 表示随 build/package 发布；true 表示 dev/run 照常加载，但 build/package 排除。旧字符串形式的本地依赖、未填标记的 Git 依赖都默认 false。
+
+```toml
+[tool.mcpywrap]
+local_dependencies = ["../shared", { path = "../test-helper", unbundled = true }]
+
+[[tool.mcpywrap.git_dependencies]]
+name = "test-helper"
+git = "https://example.com/team/test-helper.git"
+rev = "0123456789abcdef0123456789abcdef01234567"
+unbundled = true
+```
+
+不引入 main/dev 依赖类别，避免与 dev 命令混淆；也不使用 Java 中通常表示合并依赖的 Shadow/Shade 命名。该标记只控制是否随产物发布，不表示 optional、外部宿主提供、源码替换或独立 Addon 加载。
+
+## 入口与反馈
+
+- `add --path/--git --unbundled` 设置 true；`--bundled` 设置 false。新依赖省略时默认 false；更新已有依赖省略时保留原值。
+- `dev`、本地 `run`、本地双客户端组和 Windows edit 选择运行图，包含根项目的 unbundled 引用。
+- `build`、`package` 选择发布图，组装前排除 unbundled 引用。package 从源码独立组装。
+- `deps --json` 只读预览运行图；`deps --bundled-only --json` 预览发布图。
+- 默认 sync 准备运行图；`sync --bundled-only` 恢复已锁定的发布图，保留未安装节点的锁记录。
+- 网络连接和远程运行保持原有端侧限制，不因这个标记自动向服务器安装依赖。
+
+UI 使用默认不勾选的“不随构建打包（unbundled）”复选框，列表显示是否随构建打包，允许修改已有设置与查看发布引用链。Python 工具包不显示此选项。
+
+add JSON 返回 `unbundled`、`previous_unbundled`、`included_in_release`。有效图包含 `purpose`（runtime/release）、`includes_unbundled`、节点 `unbundled`、`via` 和 `excluded`。节点布尔值由当前根项目的有效引用关系决定。
+
+## 传递与共享节点
+
+只有当前根项目的 unbundled 引用在运行图中启用。进入依赖项目后只跟随普通打包引用，不加载该依赖自己的 unbundled 辅助工具。
+
+```text
+P --false--> A --false--> C
+P --true---> B --false--> C
+                 +--false--> D
+A --true---> A-helper
+B --true---> B-helper
+```
+
+运行图为 A、B、C、D；发布图为 A、C。A-helper、B-helper 不自动启用。B 所需的 D 必须加载，“unbundled 不向消费者传递”不能被解释成 B 的正常子依赖也被排除。
+
+C 即使经不打包路径可达，也因为存在普通打包路径而进入发布。去重不能掩盖这条路径；预览必须解释它为什么仍会发布。相同源码但安装 target 不同，仍可成为不同安装节点。
+
+## 鲁棒性
+
+1. **先选择图。** 发布不读取未选中依赖的内容、校验其本地副本或发现其准备入口。未安装的 unbundled 路径和私有副本不阻塞发布；配置语法和锁拓扑仍需校验。
+2. **严格布尔值。** 拒绝 `"true"`、1、空值、错误字段与旧 scope 语法，不把输入错误当作 false。来源类型与打包标记独立；宿主 Python 包不使用此字段。
+3. **统一用途上下文。** 解析结果携带根项目与 runtime/release 用途，构建器拒绝复用错误项目或错误用途的 manager。准备、组装、部署和监控使用同一有效图。
+4. **Git 注册保留语义。** 同步时过滤上游自身 unbundled 引用；源码和安装节点身份不包含根引用上的标记。含新语义的锁用 v3，普通旧项目仍为 v2。
+5. **一份锁，按图恢复。** 运行图与发布图共享锁；部分恢复不删除、伪造或要求安装未选中的 unbundled 节点。build/package/run 不隐式联网、不更新版本。
+6. **防止残留和竞争。** build 完整替换输出，清理 dev 留下的不发布内容；dev 与 build 不能同时写同一目标。watcher 的增量和完整重建都保持运行图。package 独立组装。
+7. **保护正式模块。** unbundled 独占内容不能覆盖随发布的 Python 模块，已有代码 target 冲突规则继续生效；标记不改变现有资源合并和包身份规则。
+8. **限制有副作用的准备。** unbundled 独占依赖暂不支持 consumer_prepare；否则生成到主源码包的文件会绕过图筛选进入发布。未来支持需先提供输出归属、隔离和安全清理。根 hooks 的副作用仍需单独验收。
+9. **固定会话选择。** 热更沿用会话运行图，修改依赖或打包标记仍按生命周期重启。去掉依赖不会清除其写入世界的实体、方块和业务数据。
+10. **检查最终产物。** Python 动态导入无法全部静态验证。正式代码不能依赖被排除的模块，运行组装成功不代表 ZIP 已独立验收。

{mcpywrap-0.6.3 → mcpywrap-0.6.4}/docs/git-dependencies.md

@@ -83,3 +83,11 @@ v2 锁使用相同的大小写敏感路径排序；源码由 Git archive 提取
 终端只显示同步进度、结果和必要操作；`mcpy sync --json` 返回结构化结果。`--migrate-windows-lock` 和 JSON 中始终为空的 `git_lock_migrations` 仅保留旧脚本兼容。团队各设备应使用包含此修复的版本，并提交 sync 更新后的锁文件。
 
 测试入口见[测试说明](../tests/README.md)。
+
+## 不随构建打包：unbundled
+
+通用 Git Addon/code 支持布尔标记 `unbundled`，默认 false。它属于依赖引用，不参与源码或安装节点身份计算。true 时仅随运行图加载；发布图排除该引用，但仍保留其他普通路径需要的共享节点。
+
+含新标记语义的锁使用 v3；旧项目继续使用 v2。默认 sync 恢复完整运行图，部分恢复只安装发布节点并保留其余锁记录；build/package 只校验有效节点。上游项目自身的 unbundled 引用不自动获取。旧 code_libraries 和生成业务入口的框架快捷依赖继续随发布。
+
+CLI、配置和预览用法统一见 [Skill 的 unbundled 指引](../skills/mcpywrap/references/project-dependencies.md#不随构建打包unbundled)。

{mcpywrap-0.6.3 → mcpywrap-0.6.4}/docs/local-dependencies.md

@@ -39,3 +39,11 @@ shared-addon/
 这不代表游戏运行时的资源包优先级。修改依赖声明后重启 `mcpy dev`。
 
 遇到结构错误先核对目录和清单；查看参数使用 `mcpy add --help`。
+
+## 不随构建打包的运行依赖
+
+本地引用可带布尔标记 `unbundled`，默认 false。true 时 dev/run 仍加载，build/package 在组装前排除；普通字符串引用保持旧行为。该依赖正常需要的子依赖随运行加载，上游自身的不打包引用不向消费者传递；被普通发布路径同时引用的共享节点仍随发布。
+
+发布不要求被排除的本地路径存在。更改标记后需重启会话；停止 dev 后 build 完整替换输出，package 独立组装。仅通过 unbundled 引用的依赖暂不支持 consumer_prepare，以防生成文件残留到源码包。
+
+CLI、配置示例和 JSON 判断方法统一见 [Skill 的 unbundled 指引](../skills/mcpywrap/references/project-dependencies.md#不随构建打包unbundled)。

mcpywrap-0.6.4/native/tracy_profiler/README.md

@@ -0,0 +1,52 @@
+# macOS 运行包内置 Tracy 分析器
+
+运行包 0.4.7 起包含本目录补丁。网易开发者版 `libminecraftpe.so` 内置 Tracy 客户端，按 `TRACY_MANUAL_LIFETIME` 构建。引擎在首次给线程命名时自行调用 `tracy::StartupProfiler()`，没有配置开关，因此运行包只需要提供正确的宿主接口，不需要也不应主动启动。启动器再调用一次 `___tracy_startup_profiler` 会产生第二个独立实例并占用下一个端口。
+
+## 旧运行包的问题
+
+Tracy 工作线程在监听前依次调用 `uname`、`gethostname`、`getlogin`、`sysinfo`。旧运行包中：
+
+- `uname` 直接透传 Darwin 实现，按 5×256 字节布局写入 Bionic 调用方的 390 字节缓冲，造成栈溢出，工作线程卡死。
+- `getlogin`、`sysinfo` 是 DeveloperCompat 终止桩，调用即以 53 结束进程。
+
+结果是 `___tracy_profiler_started` 为 1 但端口从不监听。socket 层本身可用，不需要改动。
+
+## 补丁
+
+- `libc-shim-host-info.patch`：新增独立的 `src/host_info.cpp`（不与 `common.cpp` 共享 Darwin `sys/param.h` 宏环境）。`uname` 按字段截断转换为 Bionic 6×65 布局；新增 `sysinfo`（Darwin 取自 sysctl、Mach 虚拟内存统计与 libproc，Linux 宿主逐字段复制，其他宿主返回 `ENOSYS`）；`getlogin` 使用宿主实现。均经过 errno 转换。
+- `client-tracy.patch`：DeveloperCompat 终止桩改为只填补 libc-shim 缺失的接口，已提供 ABI 转换的实现不再被覆盖；加载游戏库前默认设置 `TRACY_ONLY_LOCALHOST=1`、`TRACY_ONLY_IPV4=1`，已存在的环境变量优先。
+- `manifest-tracy.patch`：`tests/libc_host_info.cpp` 以保护区校验三个接口不越界写入并返回有效值，纳入构建脚本的 CTest。
+- `apply.py`：三份补丁全部预检后才应用，已应用项跳过，失败回滚；不下载、构建或启动游戏。
+
+修复按符号进行，不含游戏版本相关的地址或偏移；新 APK 只要通过标准 libc 导入调用这些接口即可直接受益。
+
+核对基线：manifest `8b624579618a121c345dd4ff05748d426a0141fa`，client `350eb36f499fbb4bc2bcaf413bd7b2fefa1fb782`，libc-shim `8ca149814eba0c42fa0c1f945b76fb526f6f0694`。可与 [后台窗口补丁](../background_window/README.md) 同时应用，两者不修改相同的位置。
+
+## 构建
+
+源码准备与 [后台窗口补丁](../background_window/README.md#在-mac-构建测试包) 相同，额外执行：
+
+```sh
+python3 native/tracy_profiler/apply.py --manifest /path/to/runtime-source
+```
+
+然后用 `tools/build_macos_runtime.py` 构建新的运行包。Xcode SDK 升级后，旧 CMake 构建目录可能仍引用已删除的 SDK 路径，此时使用新的 `--build-dir`。
+
+## 连接与安全
+
+- 默认监听 `127.0.0.1:8086`；端口被占用时顺延到 8087–8105（例如多个本地实例）。
+- 需要从其他设备连接时，显式以 `TRACY_ONLY_LOCALHOST=0 TRACY_ONLY_IPV4=0` 启动；这会对所有网卡开放分析端口并发送 UDP 发现广播，只在可信网络使用。
+- viewer 版本必须与游戏内置 Tracy 的协议一致，协议随游戏版本变化。`probe.py` 是可选手动工具，列出本机端点及其协议号：
+
+```sh
+python3 native/tracy_profiler/probe.py
+```
+
+开发者包 3.9.100.297020 内置 Tracy 0.11.1，协议 69。
+
+## Mac 验收
+
+1. 用新运行包创建独立实例，确认引擎日志中没有 `Unimplemented Android interface`。
+2. `lsof -nP -a -p <pid> -iTCP -sTCP:LISTEN` 只出现 `127.0.0.1:8086`（单实例）。
+3. `probe.py` 返回 `status=welcome` 及协议号；用对应版本的 Tracy viewer 连接 `127.0.0.1` 并看到帧与区段数据。
+4. 以 `TRACY_ONLY_LOCALHOST=0` 启动时监听地址变为通配地址，未设置时不会出现。

mcpywrap-0.6.4/native/tracy_profiler/apply.py

@@ -0,0 +1,41 @@
+"""Apply the Tracy host-interface patches to an initialized runtime source tree."""
+import argparse
+from pathlib import Path
+import subprocess
+
+
+def apply(manifest):
+    root = Path(manifest).resolve(strict=True)
+    patches = Path(__file__).resolve().parent
+    targets = [(root/'libc-shim', patches/'libc-shim-host-info.patch'),
+               (root/'mcpelauncher-client', patches/'client-tracy.patch'),
+               (root, patches/'manifest-tracy.patch')]
+    pending = []
+    for repo, patch in targets:
+        if not (repo/'.git').exists():
+            raise RuntimeError('Initialize the Git checkout/submodule first: ' + str(repo))
+        command = ['git', '-C', str(repo), 'apply']
+        # 已应用的补丁跳过；其余全部预检通过后才写入
+        if subprocess.run(command + ['--reverse', '--check', str(patch)], capture_output=True).returncode == 0:
+            continue
+        result = subprocess.run(command + ['--check', str(patch)], capture_output=True, text=True)
+        if result.returncode:
+            raise RuntimeError('Patch preflight failed: ' + str(patch) + '\n' + result.stderr)
+        pending.append((command, patch))
+    applied = []
+    try:
+        for command, patch in pending:
+            subprocess.run(command + [str(patch)], check=True)
+            applied.append((command, patch))
+    except BaseException:
+        for command, patch in reversed(applied):
+            subprocess.run(command + ['--reverse', str(patch)], check=True)
+        raise
+    return len(applied)
+
+
+if __name__ == '__main__':
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument('--manifest', required=True, type=Path)
+    args = parser.parse_args()
+    print('Applied', apply(args.manifest), 'patches; build a new runtime before testing.')

mcpywrap-0.6.4/native/tracy_profiler/client-tracy.patch

@@ -0,0 +1,41 @@
+diff --git a/src/developer_compat.h b/src/developer_compat.h
+index aa4b983..d4a7c2d 100644
+--- a/src/developer_compat.h
++++ b/src/developer_compat.h
+@@ -57,9 +57,10 @@ inline void addLibCBindings(std::unordered_map<std::string, void*>& libC) {
+     // Deliberately terminating diagnostic bindings, not API emulation.
+     // These allow relocation to proceed without silently accepting calls
+     // for which Bionic/Darwin structures or semantics differ.
+-#define UNIMPLEMENTED_ANDROID(name) libC[#name] = (void*)+[]() { \
++    // libc-shim 已提供 ABI 转换的接口优先，终止桩只填补缺口。
++#define UNIMPLEMENTED_ANDROID(name) libC.emplace(#name, (void*)+[]() { \
+         Log::error("DeveloperCompat", "Unimplemented Android interface: " #name); \
+-        std::fflush(nullptr); _Exit(53); };
++        std::fflush(nullptr); _Exit(53); });
+     UNIMPLEMENTED_ANDROID(__libc_current_sigrtmin)
+     UNIMPLEMENTED_ANDROID(__libc_current_sigrtmax)
+     UNIMPLEMENTED_ANDROID(ttyname)
+@@ -68,8 +69,6 @@ inline void addLibCBindings(std::unordered_map<std::string, void*>& libC) {
+     UNIMPLEMENTED_ANDROID(getservbyport)
+     UNIMPLEMENTED_ANDROID(getprotobyname)
+     UNIMPLEMENTED_ANDROID(__get_h_errno)
+-    UNIMPLEMENTED_ANDROID(getlogin)
+-    UNIMPLEMENTED_ANDROID(sysinfo)
+ #undef UNIMPLEMENTED_ANDROID
+     libC["pthread_sigmask"] = (void*)+[](int, const void*, void*) -> int {
+         Log::error("DeveloperCompat", "Unimplemented Android interface: pthread_sigmask");
+diff --git a/src/main.cpp b/src/main.cpp
+index 525cf9d..130cea8 100644
+--- a/src/main.cpp
++++ b/src/main.cpp
+@@ -438,6 +438,10 @@ Hardware	: Qualcomm Technologies, Inc MSM8998
+     for(auto&& redir : shim::rewrite_filesystem_access) {
+         Log::trace("REDIRECT", "%s to %s", redir.first.data(), redir.second.data());
+     }
++    // 游戏内置的 Tracy 会在首次线程命名时自行启动；默认只监听本机 IPv4，
++    // 避免对局域网开放分析端口。显式设置的环境变量优先。
++    setenv("TRACY_ONLY_LOCALHOST", "1", 0);
++    setenv("TRACY_ONLY_IPV4", "1", 0);
+     auto libC = MinecraftUtils::getLibCSymbols();
+     ThreadMover::hookLibC(libC);
+     if(extendedBindings)

mcpywrap-0.6.4/native/tracy_profiler/libc-shim-host-info.patch

@@ -0,0 +1,213 @@
+diff --git a/CMakeLists.txt b/CMakeLists.txt
+index 44c6d1c..5f4dac0 100644
+--- a/CMakeLists.txt
++++ b/CMakeLists.txt
+@@ -2,7 +2,7 @@ cmake_minimum_required (VERSION 2.6...4.0.0)
+ 
+ project(libc-shim LANGUAGES C CXX)
+ 
+-add_library(libc-shim src/common.cpp src/pthreads.cpp src/pthreads.h src/meta.h src/common.h src/semaphore.cpp src/semaphore.h src/network.cpp src/network.h src/dirent.cpp src/dirent.h src/cstdio.cpp src/cstdio.h src/errno.cpp src/errno.h src/ctype_data.h src/ctype_data.cpp src/bionic/strlcpy.cpp src/stat.cpp src/stat.h src/file_misc.cpp src/file_misc.h src/sysconf.cpp src/sysconf.h src/system_properties.cpp src/system_properties.h src/iorewrite.cpp src/iorewrite.h src/statvfs.h src/statvfs.cpp src/sched.h src/sched.cpp)
++add_library(libc-shim src/common.cpp src/pthreads.cpp src/pthreads.h src/meta.h src/common.h src/semaphore.cpp src/semaphore.h src/network.cpp src/network.h src/dirent.cpp src/dirent.h src/cstdio.cpp src/cstdio.h src/errno.cpp src/errno.h src/ctype_data.h src/ctype_data.cpp src/bionic/strlcpy.cpp src/stat.cpp src/stat.h src/file_misc.cpp src/file_misc.h src/sysconf.cpp src/sysconf.h src/host_info.cpp src/host_info.h src/system_properties.cpp src/system_properties.h src/iorewrite.cpp src/iorewrite.h src/statvfs.h src/statvfs.cpp src/sched.h src/sched.cpp)
+ target_include_directories(libc-shim PUBLIC include/)
+ target_link_libraries(libc-shim PRIVATE logger)
+ 
+diff --git a/src/common.cpp b/src/common.cpp
+index 7b631da..ebd80a1 100644
+--- a/src/common.cpp
++++ b/src/common.cpp
+@@ -14,6 +14,7 @@
+ #include "stat.h"
+ #include "file_misc.h"
+ #include "sysconf.h"
++#include "host_info.h"
+ #include "system_properties.h"
+ #include "sched.h"
+ #include <cmath>
+@@ -1083,8 +1084,6 @@ void shim::add_setjmp_shimmed_symbols(std::vector<shim::shimmed_symbol> &list) {
+ 
+ void shim::add_misc_shimmed_symbols(std::vector<shim::shimmed_symbol> &list) {
+     list.insert(list.end(), {
+-        {"uname", uname}, // TODO: This may be wrong?
+-
+         {"utime", utime},
+ 
+         {"writev", writev},
+@@ -1131,6 +1130,7 @@ std::vector<shimmed_symbol> shim::get_shimmed_symbols() {
+     add_epoll_shimmed_symbols(ret);
+     add_misc_shimmed_symbols(ret);
+     add_sysconf_shimmed_symbols(ret);
++    add_host_info_shimmed_symbols(ret);
+     add_system_properties_shimmed_symbols(ret);
+     add_eventfd_shimmed_symbols(ret);
+     add_fnmatch_shimmed_symbols(ret);
+diff --git a/src/host_info.h b/src/host_info.h
+new file mode 100644
+index 0000000..333260a
+--- /dev/null
++++ b/src/host_info.h
+@@ -0,0 +1,49 @@
++#pragma once
++
++#include <libc_shim.h>
++
++namespace shim {
++
++    namespace bionic {
++
++        // Bionic/Linux 内核布局：6 个 65 字节字段。Darwin 为 5 个 256 字节字段，不能直接透传。
++        struct utsname {
++            char sysname[65];
++            char nodename[65];
++            char release[65];
++            char version[65];
++            char machine[65];
++            char domainname[65];
++        };
++        static_assert(sizeof(utsname) == 390, "bionic utsname layout");
++
++        // Bionic/Linux 内核 struct sysinfo；内存字段以 mem_unit 为单位。
++        struct sysinfo {
++            long uptime;
++            unsigned long loads[3];
++            unsigned long totalram;
++            unsigned long freeram;
++            unsigned long sharedram;
++            unsigned long bufferram;
++            unsigned long totalswap;
++            unsigned long freeswap;
++            unsigned short procs;
++            unsigned short pad;
++            unsigned long totalhigh;
++            unsigned long freehigh;
++            unsigned int mem_unit;
++#if !defined(__LP64__)
++            char _f[20 - 2 * sizeof(long) - sizeof(int)];
++#endif
++        };
++        static_assert(sizeof(sysinfo) == (sizeof(long) == 8 ? 112 : 64), "bionic sysinfo layout");
++
++    }
++
++    int uname(bionic::utsname *buf);
++
++    int sysinfo(bionic::sysinfo *info);
++
++    void add_host_info_shimmed_symbols(std::vector<shimmed_symbol> &list);
++
++}
+diff --git a/src/host_info.cpp b/src/host_info.cpp
+new file mode 100644
+index 0000000..4dbff5e
+--- /dev/null
++++ b/src/host_info.cpp
+@@ -0,0 +1,110 @@
++#include "no-fortify.h"
++#include "host_info.h"
++#include "common.h"
++#include "errno.h"
++
++#include <cerrno>
++#include <cstring>
++#include <ctime>
++#include <cstdlib>
++#include <unistd.h>
++#include <sys/utsname.h>
++#ifdef __linux__
++#include <sys/sysinfo.h>
++#endif
++#ifdef __APPLE__
++#include <libproc.h>
++#include <mach/mach.h>
++#include <sys/sysctl.h>
++#include <sys/time.h>
++#endif
++
++int shim::uname(bionic::utsname *buf) {
++    ::utsname host {};
++    if(::uname(&host) != 0)
++        return -1;
++    // 按字段截断复制，保证只写入调用方的 390 字节。
++    std::memset(buf, 0, sizeof(*buf));
++    bionic::strlcpy(buf->sysname, host.sysname, sizeof(buf->sysname));
++    bionic::strlcpy(buf->nodename, host.nodename, sizeof(buf->nodename));
++    bionic::strlcpy(buf->release, host.release, sizeof(buf->release));
++    bionic::strlcpy(buf->version, host.version, sizeof(buf->version));
++    bionic::strlcpy(buf->machine, host.machine, sizeof(buf->machine));
++#if defined(__linux__) && defined(_GNU_SOURCE)
++    bionic::strlcpy(buf->domainname, host.domainname, sizeof(buf->domainname));
++#endif
++    return 0;
++}
++
++int shim::sysinfo(bionic::sysinfo *info) {
++    if(!info) {
++        errno = EFAULT;
++        return -1;
++    }
++    std::memset(info, 0, sizeof(*info));
++#ifdef __linux__
++    struct ::sysinfo host {};
++    if(::sysinfo(&host) != 0)
++        return -1;
++    info->uptime = host.uptime;
++    for(int i = 0; i < 3; ++i)
++        info->loads[i] = host.loads[i];
++    info->totalram = host.totalram;
++    info->freeram = host.freeram;
++    info->sharedram = host.sharedram;
++    info->bufferram = host.bufferram;
++    info->totalswap = host.totalswap;
++    info->freeswap = host.freeswap;
++    info->procs = host.procs;
++    info->totalhigh = host.totalhigh;
++    info->freehigh = host.freehigh;
++    info->mem_unit = host.mem_unit;
++    return 0;
++#elif defined(__APPLE__)
++    // 字段取自宿主内核；无法获得的值保持 0，mem_unit 固定为 1 字节。
++    uint64_t memory = 0;
++    size_t size = sizeof(memory);
++    if(::sysctlbyname("hw.memsize", &memory, &size, nullptr, 0) != 0)
++        return -1;
++    info->totalram = (unsigned long)memory;
++    info->mem_unit = 1;
++    ::timeval boot {};
++    size = sizeof(boot);
++    int bootMib[2] = {CTL_KERN, KERN_BOOTTIME};
++    if(::sysctl(bootMib, 2, &boot, &size, nullptr, 0) == 0 && boot.tv_sec > 0)
++        info->uptime = (long)(::time(nullptr) - boot.tv_sec);
++    double loads[3];
++    if(::getloadavg(loads, 3) == 3) {
++        for(int i = 0; i < 3; ++i)
++            info->loads[i] = (unsigned long)(loads[i] * 65536.0); // SI_LOAD_SHIFT
++    }
++    mach_port_t host = mach_host_self();
++    vm_statistics64_data_t vm {};
++    mach_msg_type_number_t count = HOST_VM_INFO64_COUNT;
++    if(host_statistics64(host, HOST_VM_INFO64, (host_info64_t)&vm, &count) == KERN_SUCCESS)
++        info->freeram = (unsigned long)((uint64_t)vm.free_count * vm_kernel_page_size);
++    mach_port_deallocate(mach_task_self(), host);
++    xsw_usage swap {};
++    size = sizeof(swap);
++    if(::sysctlbyname("vm.swapusage", &swap, &size, nullptr, 0) == 0) {
++        info->totalswap = (unsigned long)swap.xsu_total;
++        info->freeswap = (unsigned long)swap.xsu_avail;
++    }
++    int processes = ::proc_listallpids(nullptr, 0);
++    if(processes > 0)
++        info->procs = (unsigned short)(processes > 0xffff ? 0xffff : processes);
++    return 0;
++#else
++    errno = ENOSYS;
++    return -1;
++#endif
++}
++
++void shim::add_host_info_shimmed_symbols(std::vector<shim::shimmed_symbol> &list) {
++    list.insert(list.end(), {
++        {"uname", WithErrnoUpdate(shim::uname)},
++        {"sysinfo", WithErrnoUpdate(shim::sysinfo)},
++        // char* 返回值与 Bionic ABI 一致，可直接使用宿主实现。
++        {"getlogin", WithErrnoUpdate(::getlogin)},
++    });
++}