bingshuo/hololake-system-architecture
Watch
1
0
Fork
You've already forked hololake-system-architecture
 0
Code Issues Pull requests 1 Projects Releases Packages Wiki Activity
hololake-system-architecture/packages/TCS-MOD-HOLOLAKE-DESKTOP-BRIDGE-0002/module.human.zh-CN.md

10 KiB
Raw Blame History

HoloLake共享双桌面TCS对象动作桥第二阶段 · 简体中文人类工程语言版

这是 TCS/HLDP 原生源码的简体中文阅读投影，不是新的正本，也不授予执行权限。若本页与 .tcs 源码不一致，以经过校验的 .tcs 源码为准。

这是什么

这是一份 模块 声明，编号为 TCS-MOD-HOLOLAKE-DESKTOP-BRIDGE-0002，版本为 0.2.0。转换器已先用 Stage-1 编译器校验原生源码，再把机器枚举翻译成汉语；原始编号保留在括号和字段路径中。

谁在这里

  • manifest manifest
    • channel：ICE-CH-ZC001 manifest.channel
    • display_name_zh：HoloLake共享双桌面TCS对象动作桥第二阶段 manifest.display_name_zh
    • entry_program_id：TCS-PROGRAM-HOLOLAKE-TEST-DESKTOP-OBJECT-OPEN-0001 manifest.entry_program_id
    • entry_source：language/programs/TCS-PROGRAM-HOLOLAKE-TEST-DESKTOP-OBJECT-OPEN-0001.tcs manifest.entry_source
    • module_id：TCS-MOD-HOLOLAKE-DESKTOP-BRIDGE-0002 manifest.module_id
    • owner：ICE-P-ZY001 manifest.owner
    • role：SHARED_COMPUTER_STATE_OBJECT_ACTION_BRIDGE 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
    • id：TCS-PROGRAM-HOLOLAKE-TEST-DESKTOP-OBJECT-OPEN-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：ONE_TCS_VIRTUAL_DEDICATED_TEST_OBJECT authority_ceiling.maximum
    • network：否 authority_ceiling.network
    • pixel_coordinate_guess：否 authority_ceiling.pixel_coordinate_guess
    • 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
      • BOUNDED_ACTION_INTENT
      • PERMISSION_TICKET
      • STRUCTURED_OBJECT_TREE
      • CANONICAL_COMPUTER_STATE
    • write data_scope.write
      • DEDICATED_TCS_TEST_OBJECT_STATE
      • STATE_DIFF
      • TARGET_READBACK
      • TCS_RECEIPT
  • 网络边界 network_scope
    • allowed：否 network_scope.allowed
    • domains network_scope.domains
      • 无
  • 回滚方案 rollback
    • action：RESTORE_ONLY_TCS_VIRTUAL_TEST_OBJECT_TO_CLOSED_AND_PRESERVE_RECEIPTS rollback.action
    • preserve_receipts：是 rollback.preserve_receipts

怎样算完成

  • 自检 self_test
    • compile_expect：FIVE_ACTION_GRAPH_PASS self_test.compile_expect
    • current_execution：FAIL_CLOSED_UNTIL_GENERIC_MULTI_ACTION_LOADER_EXISTS self_test.current_execution
    • execution_expect：ONE_VIRTUAL_TEST_OBJECT_OPENED_WITH_STATE_DIFF_AND_TARGET_READBACK self_test.execution_expect
    • program_id：TCS-PROGRAM-HOLOLAKE-TEST-DESKTOP-OBJECT-OPEN-0001 self_test.program_id

下一次从哪里继续

源程序没有提供这一项，转换器不猜。

来源与校验

  • 原生声明编号：TCS-MOD-HOLOLAKE-DESKTOP-BRIDGE-0002
  • 原生声明类型：MODULE
  • TCS 源码 SHA-256：f40d72eb01d8b70ce076a5352cc970df8c3c0c4377f4780140a8229fc997e834
  • 校验编译器：TCS-COMPILER-STAGE2-LPM-DESKTOP-0001
  • 投影协议：GLS-HLDP-HUMAN-ENGINEERING-PROJECTION-0001

原生结构逐项对照

下面保留源码的全部顶层结构和字段路径，供人类审计投影有没有漏掉信息。

  • 权限边界 authority_ceiling
    • maximum：ONE_TCS_VIRTUAL_DEDICATED_TEST_OBJECT authority_ceiling.maximum
    • network：否 authority_ceiling.network
    • pixel_coordinate_guess：否 authority_ceiling.pixel_coordinate_guess
    • 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
      • 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_TCS_TEST_OBJECT_STATE
      • STATE_DIFF
      • TARGET_READBACK
      • TCS_RECEIPT
  • entry entry
    • id：TCS-PROGRAM-HOLOLAKE-TEST-DESKTOP-OBJECT-OPEN-0001 entry.id
    • kind：PROGRAM entry.kind
  • 语言头 header
    • 正本路径：packages/TCS-MOD-HOLOLAKE-DESKTOP-BRIDGE-0002/module.tcs header.canonical_uri
    • compatibility header.compatibility
      • TCS-COMPILER-STAGE2-LPM-DESKTOP-0001
      • GIR/1
    • 语言：TCS/0.1 header.language
    • 生命周期：SOURCE header.lifecycle
    • 英文名：HoloLake Shared Dual Desktop TCS Object Action Bridge Stage Two header.name_en
    • 中文名：HoloLake共享双桌面TCS对象动作桥第二阶段 header.name_zh
    • 协议配置：HLDP-NP/1 header.profile
    • protocols header.protocols
      • TCS-LPM-DESKTOP-OPERATION-REGISTRY-0001
      • TCS-HOLOLAKE-SHARED-DESKTOP-OBJECT-ACTION-0001
      • TCS-MODULE-ABI-0001
    • schema：tcs.module/v1 header.schema
    • 版本：0.2.0 header.version
  • install install
    • account_scoped：是 install.account_scoped
    • activation_requires_self_test：是 install.activation_requires_self_test
    • compiler_registration_state：STAGE2_REGISTERED install.compiler_registration_state
    • module_abi_package_state：SOURCE install.module_abi_package_state
    • registration_is_installation：否 install.registration_is_installation
    • runtime_multi_action_dispatch_state：MISSING install.runtime_multi_action_dispatch_state
    • signature_state：当前不存在（ABSENT） install.signature_state
  • manifest manifest
    • channel：ICE-CH-ZC001 manifest.channel
    • display_name_zh：HoloLake共享双桌面TCS对象动作桥第二阶段 manifest.display_name_zh
    • entry_program_id：TCS-PROGRAM-HOLOLAKE-TEST-DESKTOP-OBJECT-OPEN-0001 manifest.entry_program_id
    • entry_source：language/programs/TCS-PROGRAM-HOLOLAKE-TEST-DESKTOP-OBJECT-OPEN-0001.tcs manifest.entry_source
    • module_id：TCS-MOD-HOLOLAKE-DESKTOP-BRIDGE-0002 manifest.module_id
    • owner：ICE-P-ZY001 manifest.owner
    • role：SHARED_COMPUTER_STATE_OBJECT_ACTION_BRIDGE manifest.role
  • 网络边界 network_scope
    • allowed：否 network_scope.allowed
    • domains network_scope.domains
      • 无
  • projection projection
    • active：否 projection.active
    • canonical_state：ONE_COMPUTER_STATE projection.canonical_state
    • compiler_registration：PASS projection.compiler_registration
    • display_name_zh：HoloLake共享双桌面TCS对象动作桥第二阶段 projection.display_name_zh
    • 人类可读投影：RENDERED_DESKTOP projection.human_projection
    • installed：否 projection.installed
    • mounted：否 projection.mounted
    • native_desktop_execution：NOT_YET_PROVEN projection.native_desktop_execution
    • persona_projection：TCS_STRUCTURED_DESKTOP projection.persona_projection
    • real_macos_action_executed：否 projection.real_macos_action_executed
    • 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：RESTORE_ONLY_TCS_VIRTUAL_TEST_OBJECT_TO_CLOSED_AND_PRESERVE_RECEIPTS rollback.action
    • preserve_receipts：是 rollback.preserve_receipts
  • 自检 self_test
    • compile_expect：FIVE_ACTION_GRAPH_PASS self_test.compile_expect
    • current_execution：FAIL_CLOSED_UNTIL_GENERIC_MULTI_ACTION_LOADER_EXISTS self_test.current_execution
    • execution_expect：ONE_VIRTUAL_TEST_OBJECT_OPENED_WITH_STATE_DIFF_AND_TARGET_READBACK self_test.execution_expect
    • program_id：TCS-PROGRAM-HOLOLAKE-TEST-DESKTOP-OBJECT-OPEN-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 语义。