213 lines
11 KiB
Markdown
213 lines
11 KiB
Markdown
|
# HoloLake虚拟共享双桌面TCS Provider模块 · 简体中文人类工程语言版
|
|||
|
|
|
|||
|
|
> 这是 TCS/HLDP 原生源码的简体中文阅读投影，不是新的正本，也不授予执行权限。若本页与 `.tcs` 源码不一致，以经过校验的 `.tcs` 源码为准。
|
|||
|
|
|
|||
|
|
## 这是什么
|
|||
|
|
|
|||
|
|
这是一份 **模块** 声明，编号为 `TCS-MOD-HOLOLAKE-DESKTOP-BRIDGE-0003`，版本为 `0.3.0`。转换器已先用 Stage-1 编译器校验原生源码，再把机器枚举翻译成汉语；原始编号保留在括号和字段路径中。
|
|||
|
|
|
|||
|
|
## 谁在这里
|
|||
|
|
|
|||
|
|
- **manifest** `manifest`
|
|||
|
|
- **channel**：ICE-CH-ZC001 `manifest.channel`
|
|||
|
|
- **display_name_zh**：HoloLake虚拟共享双桌面TCS Provider模块 `manifest.display_name_zh`
|
|||
|
|
- **entry_program_id**：TCS-PROVIDER-VIRTUAL-DESKTOP-OPEN-0001 `manifest.entry_program_id`
|
|||
|
|
- **entry_source**：language/programs/TCS-PROVIDER-VIRTUAL-DESKTOP-OPEN-0001.tcs `manifest.entry_source`
|
|||
|
|
- **module_id**：TCS-MOD-HOLOLAKE-DESKTOP-BRIDGE-0003 `manifest.module_id`
|
|||
|
|
- **owner**：ICE-P-ZY001 `manifest.owner`
|
|||
|
|
- **role**：TCS_PRODUCT_SEMANTIC_PROVIDER `manifest.role`
|
|||
|
|
|
|||
|
|
## 为什么开始
|
|||
|
|
|
|||
|
|
- **来源** `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`
|
|||
|
|
- **gir**：build/TCS-PROVIDER-VIRTUAL-DESKTOP-OPEN-0001.gir.json `entry.gir`
|
|||
|
|
- **gir_sha256**：fde42d5e33e486be5e6f24956415010fa04c28c544200ea4dcd54138eb58e577 `entry.gir_sha256`
|
|||
|
|
- **id**：TCS-PROVIDER-VIRTUAL-DESKTOP-OPEN-0001 `entry.id`
|
|||
|
|
- **kind**：TCS_PROVIDER_PROGRAM `entry.kind`
|
|||
|
|
- **lowers_product_behavior**：VIRTUAL_SHARED_DESKTOP_OBJECT_OPEN `entry.lowers_product_behavior`
|
|||
|
|
- **machine_operation**：CORE.APPLY_EXACT_STATE_TRANSITION `entry.machine_operation`
|
|||
|
|
- **capabilities** `capabilities`
|
|||
|
|
- **provided** `capabilities.provided`
|
|||
|
|
- DESKTOP.OBSERVE_OBJECT_TREE
|
|||
|
|
- DESKTOP.RESOLVE_STABLE_OBJECT
|
|||
|
|
- DESKTOP.EXECUTE_SEMANTIC_ACTION
|
|||
|
|
- DESKTOP.READ_STATE_DIFF
|
|||
|
|
- DESKTOP.VERIFY_TARGET_AND_RECEIPT
|
|||
|
|
- HOLOLAKE.SHARED_COMPUTER_STATE
|
|||
|
|
- **是否必需** `capabilities.required`
|
|||
|
|
- CORE.APPLY_EXACT_STATE_TRANSITION
|
|||
|
|
|
|||
|
|
## 边界与异常处理
|
|||
|
|
|
|||
|
|
- **权限边界** `authority_ceiling`
|
|||
|
|
- **maximum**：ONE_TCS_VIRTUAL_DEDICATED_TEST_OBJECT `authority_ceiling.maximum`
|
|||
|
|
- **network**：否 `authority_ceiling.network`
|
|||
|
|
- **process**：否 `authority_ceiling.process`
|
|||
|
|
- **real_macos_action**：否 `authority_ceiling.real_macos_action`
|
|||
|
|
- **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`
|
|||
|
|
- PERMISSION_TICKET
|
|||
|
|
- TCS_PROVIDER_GIR
|
|||
|
|
- CANONICAL_VIRTUAL_OBJECT_STATE
|
|||
|
|
- **write** `data_scope.write`
|
|||
|
|
- DEDICATED_TCS_TEST_OBJECT_STATE
|
|||
|
|
- HUMAN_PROJECTION
|
|||
|
|
- PERSONA_TCS_PROJECTION
|
|||
|
|
- EXACT_READBACK_RECEIPT
|
|||
|
|
- **网络边界** `network_scope`
|
|||
|
|
- **allowed**：否 `network_scope.allowed`
|
|||
|
|
- **domains** `network_scope.domains`
|
|||
|
|
- 无
|
|||
|
|
- **回滚方案** `rollback`
|
|||
|
|
- **action**：UNMOUNT_V3_ONLY_AND_PRESERVE_TCS_SOURCE_PROVIDER_GIR_AND_RECEIPTS `rollback.action`
|
|||
|
|
- **preserve_receipts**：是 `rollback.preserve_receipts`
|
|||
|
|
|
|||
|
|
## 怎样算完成
|
|||
|
|
|
|||
|
|
- **自检** `self_test`
|
|||
|
|
- **child_state_sha256**：9ac0849412509b876a4b194a22ab91246c96639526df823a904119d955ef1e08 `self_test.child_state_sha256`
|
|||
|
|
- **execution**：PASS `self_test.execution`
|
|||
|
|
- **人类可读投影**：OPEN `self_test.human_projection`
|
|||
|
|
- **outer_receipt_sha256**：acdbf02a09a06a25cb0944742a2985ab85f8f32d28f704462c2d45592132face `self_test.outer_receipt_sha256`
|
|||
|
|
- **persona_tcs_projection**：OPEN `self_test.persona_tcs_projection`
|
|||
|
|
- **program_id**：TCS-PROGRAM-LOAD-VIRTUAL-DESKTOP-PROVIDER-0001 `self_test.program_id`
|
|||
|
|
- **real_macos**：否 `self_test.real_macos`
|
|||
|
|
|
|||
|
|
## 下一次从哪里继续
|
|||
|
|
|
|||
|
|
源程序没有提供这一项，转换器不猜。
|
|||
|
|
|
|||
|
|
## 来源与校验
|
|||
|
|
|
|||
|
|
- **原生声明编号**：`TCS-MOD-HOLOLAKE-DESKTOP-BRIDGE-0003`
|
|||
|
|
- **原生声明类型**：`MODULE`
|
|||
|
|
- **TCS 源码 SHA-256**：`0943e36aeb11dd7dd23afb2cdb526dac5659ff14208278a51d785c9d7fd53126`
|
|||
|
|
- **校验编译器**：`TCS-COMPILER-STAGE4-CORE-STATE-PRIMITIVES-0001`
|
|||
|
|
- **投影协议**：`GLS-HLDP-HUMAN-ENGINEERING-PROJECTION-0001`
|
|||
|
|
|
|||
|
|
## 原生结构逐项对照
|
|||
|
|
|
|||
|
|
下面保留源码的全部顶层结构和字段路径，供人类审计投影有没有漏掉信息。
|
|||
|
|
|
|||
|
|
- **权限边界** `authority_ceiling`
|
|||
|
|
- **maximum**：ONE_TCS_VIRTUAL_DEDICATED_TEST_OBJECT `authority_ceiling.maximum`
|
|||
|
|
- **network**：否 `authority_ceiling.network`
|
|||
|
|
- **process**：否 `authority_ceiling.process`
|
|||
|
|
- **real_macos_action**：否 `authority_ceiling.real_macos_action`
|
|||
|
|
- **semantic_action_requires_permission_ticket**：是 `authority_ceiling.semantic_action_requires_permission_ticket`
|
|||
|
|
- **capabilities** `capabilities`
|
|||
|
|
- **provided** `capabilities.provided`
|
|||
|
|
- DESKTOP.OBSERVE_OBJECT_TREE
|
|||
|
|
- DESKTOP.RESOLVE_STABLE_OBJECT
|
|||
|
|
- DESKTOP.EXECUTE_SEMANTIC_ACTION
|
|||
|
|
- DESKTOP.READ_STATE_DIFF
|
|||
|
|
- DESKTOP.VERIFY_TARGET_AND_RECEIPT
|
|||
|
|
- HOLOLAKE.SHARED_COMPUTER_STATE
|
|||
|
|
- **是否必需** `capabilities.required`
|
|||
|
|
- CORE.APPLY_EXACT_STATE_TRANSITION
|
|||
|
|
- **数据边界** `data_scope`
|
|||
|
|
- **read** `data_scope.read`
|
|||
|
|
- PERMISSION_TICKET
|
|||
|
|
- TCS_PROVIDER_GIR
|
|||
|
|
- CANONICAL_VIRTUAL_OBJECT_STATE
|
|||
|
|
- **write** `data_scope.write`
|
|||
|
|
- DEDICATED_TCS_TEST_OBJECT_STATE
|
|||
|
|
- HUMAN_PROJECTION
|
|||
|
|
- PERSONA_TCS_PROJECTION
|
|||
|
|
- EXACT_READBACK_RECEIPT
|
|||
|
|
- **entry** `entry`
|
|||
|
|
- **gir**：build/TCS-PROVIDER-VIRTUAL-DESKTOP-OPEN-0001.gir.json `entry.gir`
|
|||
|
|
- **gir_sha256**：fde42d5e33e486be5e6f24956415010fa04c28c544200ea4dcd54138eb58e577 `entry.gir_sha256`
|
|||
|
|
- **id**：TCS-PROVIDER-VIRTUAL-DESKTOP-OPEN-0001 `entry.id`
|
|||
|
|
- **kind**：TCS_PROVIDER_PROGRAM `entry.kind`
|
|||
|
|
- **lowers_product_behavior**：VIRTUAL_SHARED_DESKTOP_OBJECT_OPEN `entry.lowers_product_behavior`
|
|||
|
|
- **machine_operation**：CORE.APPLY_EXACT_STATE_TRANSITION `entry.machine_operation`
|
|||
|
|
- **语言头** `header`
|
|||
|
|
- **正本路径**：packages/TCS-MOD-HOLOLAKE-DESKTOP-BRIDGE-0003/module.tcs `header.canonical_uri`
|
|||
|
|
- **compatibility** `header.compatibility`
|
|||
|
|
- TCS-COMPILER-STAGE4-CORE-STATE-PRIMITIVES-0001
|
|||
|
|
- GIR/1
|
|||
|
|
- **语言**：TCS/0.1 `header.language`
|
|||
|
|
- **生命周期**：SOURCE `header.lifecycle`
|
|||
|
|
- **英文名**：HoloLake Virtual Shared Dual Desktop TCS Provider Module `header.name_en`
|
|||
|
|
- **中文名**：HoloLake虚拟共享双桌面TCS Provider模块 `header.name_zh`
|
|||
|
|
- **协议配置**：HLDP-NP/1 `header.profile`
|
|||
|
|
- **protocols** `header.protocols`
|
|||
|
|
- TCS-GENERIC-EXACT-STATE-PRIMITIVE-0001
|
|||
|
|
- TCS-HOLOLAKE-SHARED-DESKTOP-FRAMEWORK-BEHAVIOR-0001
|
|||
|
|
- TCS-MODULE-ABI-0001
|
|||
|
|
- **schema**：tcs.module/v1 `header.schema`
|
|||
|
|
- **版本**：0.3.0 `header.version`
|
|||
|
|
- **install** `install`
|
|||
|
|
- **account_scoped**：是 `install.account_scoped`
|
|||
|
|
- **activation_requires_self_test**：是 `install.activation_requires_self_test`
|
|||
|
|
- **current_state**：SOURCE `install.current_state`
|
|||
|
|
- **provider_execution_readback**：PASS `install.provider_execution_readback`
|
|||
|
|
- **provider_gir_exists**：是 `install.provider_gir_exists`
|
|||
|
|
- **registration_is_installation**：否 `install.registration_is_installation`
|
|||
|
|
- **signature_state**：PENDING_CAPABILITY_REGISTRY_V2 `install.signature_state`
|
|||
|
|
- **manifest** `manifest`
|
|||
|
|
- **channel**：ICE-CH-ZC001 `manifest.channel`
|
|||
|
|
- **display_name_zh**：HoloLake虚拟共享双桌面TCS Provider模块 `manifest.display_name_zh`
|
|||
|
|
- **entry_program_id**：TCS-PROVIDER-VIRTUAL-DESKTOP-OPEN-0001 `manifest.entry_program_id`
|
|||
|
|
- **entry_source**：language/programs/TCS-PROVIDER-VIRTUAL-DESKTOP-OPEN-0001.tcs `manifest.entry_source`
|
|||
|
|
- **module_id**：TCS-MOD-HOLOLAKE-DESKTOP-BRIDGE-0003 `manifest.module_id`
|
|||
|
|
- **owner**：ICE-P-ZY001 `manifest.owner`
|
|||
|
|
- **role**：TCS_PRODUCT_SEMANTIC_PROVIDER `manifest.role`
|
|||
|
|
- **网络边界** `network_scope`
|
|||
|
|
- **allowed**：否 `network_scope.allowed`
|
|||
|
|
- **domains** `network_scope.domains`
|
|||
|
|
- 无
|
|||
|
|
- **projection** `projection`
|
|||
|
|
- **active**：否 `projection.active`
|
|||
|
|
- **compiled**：否 `projection.compiled`
|
|||
|
|
- **display_name_zh**：HoloLake虚拟共享双桌面TCS Provider模块 `projection.display_name_zh`
|
|||
|
|
- **fourth_generation_product_semantics**：否 `projection.fourth_generation_product_semantics`
|
|||
|
|
- **installed**：否 `projection.installed`
|
|||
|
|
- **mounted**：否 `projection.mounted`
|
|||
|
|
- **real_macos_action_executed**：否 `projection.real_macos_action_executed`
|
|||
|
|
- **来源**：是 `projection.source`
|
|||
|
|
- **tcs_product_semantics**：是 `projection.tcs_product_semantics`
|
|||
|
|
- **technical_detail_default**：否 `projection.technical_detail_default`
|
|||
|
|
- **verified**：否 `projection.verified`
|
|||
|
|
- **资源边界** `resource_ceiling`
|
|||
|
|
- **concurrency**：1 `resource_ceiling.concurrency`
|
|||
|
|
- **内存上限字节**：268435456 `resource_ceiling.memory_limit_bytes`
|
|||
|
|
- **超时毫秒**：30000 `resource_ceiling.timeout_ms`
|
|||
|
|
- **回滚方案** `rollback`
|
|||
|
|
- **action**：UNMOUNT_V3_ONLY_AND_PRESERVE_TCS_SOURCE_PROVIDER_GIR_AND_RECEIPTS `rollback.action`
|
|||
|
|
- **preserve_receipts**：是 `rollback.preserve_receipts`
|
|||
|
|
- **自检** `self_test`
|
|||
|
|
- **child_state_sha256**：9ac0849412509b876a4b194a22ab91246c96639526df823a904119d955ef1e08 `self_test.child_state_sha256`
|
|||
|
|
- **execution**：PASS `self_test.execution`
|
|||
|
|
- **人类可读投影**：OPEN `self_test.human_projection`
|
|||
|
|
- **outer_receipt_sha256**：acdbf02a09a06a25cb0944742a2985ab85f8f32d28f704462c2d45592132face `self_test.outer_receipt_sha256`
|
|||
|
|
- **persona_tcs_projection**：OPEN `self_test.persona_tcs_projection`
|
|||
|
|
- **program_id**：TCS-PROGRAM-LOAD-VIRTUAL-DESKTOP-PROVIDER-0001 `self_test.program_id`
|
|||
|
|
- **real_macos**：否 `self_test.real_macos`
|
|||
|
|
- **来源** `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 语义。
|