215 lines
10 KiB
Markdown
215 lines
10 KiB
Markdown
# HoloLake共享双桌面macOS桥接模块 · 简体中文人类工程语言版
|
||
|
||
> 这是 TCS/HLDP 原生源码的简体中文阅读投影，不是新的正本，也不授予执行权限。若本页与 `.tcs` 源码不一致，以经过校验的 `.tcs` 源码为准。
|
||
|
||
## 这是什么
|
||
|
||
这是一份 **模块** 声明，编号为 `TCS-MOD-HOLOLAKE-DESKTOP-BRIDGE-MACOS-0001`，版本为 `0.1.0`。转换器已先用 Stage-1 编译器校验原生源码，再把机器枚举翻译成汉语；原始编号保留在括号和字段路径中。
|
||
|
||
## 谁在这里
|
||
|
||
- **manifest** `manifest`
|
||
- **channel**：ICE-CH-ZC001 `manifest.channel`
|
||
- **display_name_zh**：HoloLake共享双桌面macOS桥接模块 `manifest.display_name_zh`
|
||
- **entry_program_id**：TCS-PROGRAM-MOTHER-BRAIN-DUAL-DESKTOP-OPEN-OBJECT-0001 `manifest.entry_program_id`
|
||
- **entry_source**：PENDING_TCS_PROGRAM `manifest.entry_source`
|
||
- **module_id**：TCS-MOD-HOLOLAKE-DESKTOP-BRIDGE-MACOS-0001 `manifest.module_id`
|
||
- **owner**：ICE-P-ZY001 `manifest.owner`
|
||
- **role**：SHARED_COMPUTER_STATE_OBJECT_ACTION_BRIDGE `manifest.role`
|
||
- **target_triple**：aarch64-apple-darwin `manifest.target_triple`
|
||
|
||
## 为什么开始
|
||
|
||
- **来源** `source`
|
||
- **来源编号**：BINGSHUO-HOLOLAKE-TCS-ENGINEERING-ANCHOR-20260823 `source.source_id`
|
||
- **来源角色**：人类直接语言来源（`DIRECT_HUMAN`） `source.source_role`
|
||
- **来源校验值**：a3dd8dbd2203b631bdb23f2693eb314d4ef86af68fdeaee8835e3cf0861ddd23 `source.source_sha256`
|
||
- **来源地址**：language-sources/direct-human/BINGSHUO-HOLOLAKE-TCS-ENGINEERING-ANCHOR-20260823.txt `source.source_uri`
|
||
|
||
## 发生了什么变化
|
||
|
||
源程序没有提供这一项，转换器不猜。
|
||
|
||
## 准备怎样执行
|
||
|
||
- **entry** `entry`
|
||
- **id**：TCS-PROGRAM-MOTHER-BRAIN-DUAL-DESKTOP-OPEN-OBJECT-0001 `entry.id`
|
||
- **kind**：PROGRAM `entry.kind`
|
||
- **capabilities** `capabilities`
|
||
- **provided** `capabilities.provided`
|
||
- HOLOLAKE.SHARED_COMPUTER_STATE
|
||
- HOLOLAKE.HUMAN_RENDERED_PROJECTION
|
||
- HOLOLAKE.PERSONA_TCS_PROJECTION
|
||
- **是否必需** `capabilities.required`
|
||
- DESKTOP.OBSERVE_OBJECT_TREE
|
||
- DESKTOP.RESOLVE_STABLE_OBJECT
|
||
- DESKTOP.EXECUTE_SEMANTIC_ACTION
|
||
- DESKTOP.READ_STATE_DIFF
|
||
- DESKTOP.VERIFY_TARGET_AND_RECEIPT
|
||
|
||
## 边界与异常处理
|
||
|
||
- **权限边界** `authority_ceiling`
|
||
- **maximum**：DEDICATED_TEST_DESKTOP_WITH_EXACT_PERMISSION_TICKET `authority_ceiling.maximum`
|
||
- **network**：否 `authority_ceiling.network`
|
||
- **pixel_coordinate_guess**：否 `authority_ceiling.pixel_coordinate_guess`
|
||
- **process**：是 `authority_ceiling.process`
|
||
- **semantic_action_requires_permission_ticket**：是 `authority_ceiling.semantic_action_requires_permission_ticket`
|
||
- **资源边界** `resource_ceiling`
|
||
- **concurrency**：1 `resource_ceiling.concurrency`
|
||
- **内存上限字节**：268435456 `resource_ceiling.memory_limit_bytes`
|
||
- **超时毫秒**：30000 `resource_ceiling.timeout_ms`
|
||
- **数据边界** `data_scope`
|
||
- **read** `data_scope.read`
|
||
- BOUNDED_ACTION_INTENT
|
||
- PERMISSION_TICKET
|
||
- STRUCTURED_OBJECT_TREE
|
||
- CANONICAL_COMPUTER_STATE
|
||
- **write** `data_scope.write`
|
||
- DEDICATED_TEST_DESKTOP_ACTION
|
||
- STATE_DIFF
|
||
- TARGET_READBACK
|
||
- TCS_RECEIPT
|
||
- **网络边界** `network_scope`
|
||
- **allowed**：否 `network_scope.allowed`
|
||
- **domains** `network_scope.domains`
|
||
- 无
|
||
- **回滚方案** `rollback`
|
||
- **action**：UNMOUNT_CANDIDATE_STOP_PERSONA_CURSOR_AND_PRESERVE_RECEIPTS `rollback.action`
|
||
- **preserve_receipts**：是 `rollback.preserve_receipts`
|
||
|
||
## 怎样算完成
|
||
|
||
- **自检** `self_test`
|
||
- **expect**：ONE_FIXED_OBJECT_OPENED_WITH_OBJECT_TREE_PERMISSION_STATE_DIFF_HUMAN_SURFACE_AND_TARGET_READBACK_RECEIPTS `self_test.expect`
|
||
- **program_id**：TCS-PROGRAM-MOTHER-BRAIN-DUAL-DESKTOP-OPEN-OBJECT-0001 `self_test.program_id`
|
||
|
||
## 下一次从哪里继续
|
||
|
||
源程序没有提供这一项，转换器不猜。
|
||
|
||
## 来源与校验
|
||
|
||
- **原生声明编号**：`TCS-MOD-HOLOLAKE-DESKTOP-BRIDGE-MACOS-0001`
|
||
- **原生声明类型**：`MODULE`
|
||
- **TCS 源码 SHA-256**：`ab7c1241fb6dc44c2dfb274c03a93868a829eaf24ef5af09a64660c7859202a0`
|
||
- **校验编译器**：`TCS-COMPILER-STAGE1-0001`
|
||
- **投影协议**：`GLS-HLDP-HUMAN-ENGINEERING-PROJECTION-0001`
|
||
|
||
## 原生结构逐项对照
|
||
|
||
下面保留源码的全部顶层结构和字段路径，供人类审计投影有没有漏掉信息。
|
||
|
||
- **权限边界** `authority_ceiling`
|
||
- **maximum**：DEDICATED_TEST_DESKTOP_WITH_EXACT_PERMISSION_TICKET `authority_ceiling.maximum`
|
||
- **network**：否 `authority_ceiling.network`
|
||
- **pixel_coordinate_guess**：否 `authority_ceiling.pixel_coordinate_guess`
|
||
- **process**：是 `authority_ceiling.process`
|
||
- **semantic_action_requires_permission_ticket**：是 `authority_ceiling.semantic_action_requires_permission_ticket`
|
||
- **capabilities** `capabilities`
|
||
- **provided** `capabilities.provided`
|
||
- HOLOLAKE.SHARED_COMPUTER_STATE
|
||
- HOLOLAKE.HUMAN_RENDERED_PROJECTION
|
||
- HOLOLAKE.PERSONA_TCS_PROJECTION
|
||
- **是否必需** `capabilities.required`
|
||
- DESKTOP.OBSERVE_OBJECT_TREE
|
||
- DESKTOP.RESOLVE_STABLE_OBJECT
|
||
- DESKTOP.EXECUTE_SEMANTIC_ACTION
|
||
- DESKTOP.READ_STATE_DIFF
|
||
- DESKTOP.VERIFY_TARGET_AND_RECEIPT
|
||
- **数据边界** `data_scope`
|
||
- **read** `data_scope.read`
|
||
- BOUNDED_ACTION_INTENT
|
||
- PERMISSION_TICKET
|
||
- STRUCTURED_OBJECT_TREE
|
||
- CANONICAL_COMPUTER_STATE
|
||
- **write** `data_scope.write`
|
||
- DEDICATED_TEST_DESKTOP_ACTION
|
||
- STATE_DIFF
|
||
- TARGET_READBACK
|
||
- TCS_RECEIPT
|
||
- **entry** `entry`
|
||
- **id**：TCS-PROGRAM-MOTHER-BRAIN-DUAL-DESKTOP-OPEN-OBJECT-0001 `entry.id`
|
||
- **kind**：PROGRAM `entry.kind`
|
||
- **语言头** `header`
|
||
- **正本路径**：language/modules/TCS-MOD-HOLOLAKE-DESKTOP-BRIDGE-MACOS-0001.tcs `header.canonical_uri`
|
||
- **compatibility** `header.compatibility`
|
||
- TCS-COMPILER-STAGE1-0001
|
||
- GIR/1
|
||
- TCS-MODULE-ABI-0001
|
||
- **语言**：TCS/0.1 `header.language`
|
||
- **生命周期**：CANDIDATE_UNMOUNTED `header.lifecycle`
|
||
- **英文名**：HoloLake Shared Dual Desktop macOS Bridge Module `header.name_en`
|
||
- **中文名**：HoloLake共享双桌面macOS桥接模块 `header.name_zh`
|
||
- **协议配置**：HLDP-NP/1 `header.profile`
|
||
- **protocols** `header.protocols`
|
||
- TCS-HOLOLAKE-SHARED-DESKTOP-OBJECT-ACTION-0001
|
||
- TCS-HOST-ABI-0001
|
||
- TCS-MODULE-ABI-0001
|
||
- **schema**：tcs.module/v1 `header.schema`
|
||
- **版本**：0.1.0 `header.version`
|
||
- **install** `install`
|
||
- **account_scoped**：是 `install.account_scoped`
|
||
- **activation_requires_self_test**：是 `install.activation_requires_self_test`
|
||
- **capability_registry_signed**：否 `install.capability_registry_signed`
|
||
- **module_abi_manifest_lock_install**：PENDING `install.module_abi_manifest_lock_install`
|
||
- **operation_registration_state**：NOT_REGISTERED_EXPECT_TCS_E2101 `install.operation_registration_state`
|
||
- **registration_is_installation**：否 `install.registration_is_installation`
|
||
- **manifest** `manifest`
|
||
- **channel**：ICE-CH-ZC001 `manifest.channel`
|
||
- **display_name_zh**：HoloLake共享双桌面macOS桥接模块 `manifest.display_name_zh`
|
||
- **entry_program_id**：TCS-PROGRAM-MOTHER-BRAIN-DUAL-DESKTOP-OPEN-OBJECT-0001 `manifest.entry_program_id`
|
||
- **entry_source**：PENDING_TCS_PROGRAM `manifest.entry_source`
|
||
- **module_id**：TCS-MOD-HOLOLAKE-DESKTOP-BRIDGE-MACOS-0001 `manifest.module_id`
|
||
- **owner**：ICE-P-ZY001 `manifest.owner`
|
||
- **role**：SHARED_COMPUTER_STATE_OBJECT_ACTION_BRIDGE `manifest.role`
|
||
- **target_triple**：aarch64-apple-darwin `manifest.target_triple`
|
||
- **网络边界** `network_scope`
|
||
- **allowed**：否 `network_scope.allowed`
|
||
- **domains** `network_scope.domains`
|
||
- 无
|
||
- **projection** `projection`
|
||
- **active**：否 `projection.active`
|
||
- **canonical_state**：ONE_COMPUTER_STATE `projection.canonical_state`
|
||
- **display_name_zh**：HoloLake共享双桌面macOS桥接模块 `projection.display_name_zh`
|
||
- **人类可读投影**：RENDERED_DESKTOP `projection.human_projection`
|
||
- **mounted**：否 `projection.mounted`
|
||
- **native_desktop_operations**：PENDING `projection.native_desktop_operations`
|
||
- **object_fields** `projection.object_fields`
|
||
- stable_object_id
|
||
- role
|
||
- name
|
||
- state
|
||
- available_actions
|
||
- permission_scope
|
||
- version_or_generation
|
||
- **persona_projection**：TCS_STRUCTURED_DESKTOP `projection.persona_projection`
|
||
- **real_desktop_action_executed**：否 `projection.real_desktop_action_executed`
|
||
- **receipt_fields** `projection.receipt_fields`
|
||
- object_tree_hash_before
|
||
- action_intent_hash
|
||
- permission_ticket_hash
|
||
- target_readback
|
||
- state_diff
|
||
- human_surface_observation
|
||
- object_tree_hash_after
|
||
- **technical_detail_default**：否 `projection.technical_detail_default`
|
||
- **资源边界** `resource_ceiling`
|
||
- **concurrency**：1 `resource_ceiling.concurrency`
|
||
- **内存上限字节**：268435456 `resource_ceiling.memory_limit_bytes`
|
||
- **超时毫秒**：30000 `resource_ceiling.timeout_ms`
|
||
- **回滚方案** `rollback`
|
||
- **action**：UNMOUNT_CANDIDATE_STOP_PERSONA_CURSOR_AND_PRESERVE_RECEIPTS `rollback.action`
|
||
- **preserve_receipts**：是 `rollback.preserve_receipts`
|
||
- **自检** `self_test`
|
||
- **expect**：ONE_FIXED_OBJECT_OPENED_WITH_OBJECT_TREE_PERMISSION_STATE_DIFF_HUMAN_SURFACE_AND_TARGET_READBACK_RECEIPTS `self_test.expect`
|
||
- **program_id**：TCS-PROGRAM-MOTHER-BRAIN-DUAL-DESKTOP-OPEN-OBJECT-0001 `self_test.program_id`
|
||
- **来源** `source`
|
||
- **来源编号**：BINGSHUO-HOLOLAKE-TCS-ENGINEERING-ANCHOR-20260823 `source.source_id`
|
||
- **来源角色**：人类直接语言来源（`DIRECT_HUMAN`） `source.source_role`
|
||
- **来源校验值**：a3dd8dbd2203b631bdb23f2693eb314d4ef86af68fdeaee8835e3cf0861ddd23 `source.source_sha256`
|
||
- **来源地址**：language-sources/direct-human/BINGSHUO-HOLOLAKE-TCS-ENGINEERING-ANCHOR-20260823.txt `source.source_uri`
|
||
|
||
---
|
||
|
||
本页只改变阅读顺序，不改变 TCS/HLDP 语义。
|